blob: a8f79850df11de92429815c1123cf113babfad46 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
## This Arduino sketch is licensed under the GNU GENERAL PUBLIC LICENSE Version 3 (GPL v3)
### This means that you are free to:
- use, modify and distribute this software, even commercially
### Under the following terms:
- state changes
- disclose source
- same license
### Limitations:
- Liability
- Warranty
More details: https://www.gnu.org/licenses/gpl-3.0.en.html
##
Every submodule has it's own setup_XX() function that configures the needed pins and a submenu that lets you choose what you want to do.
The code directly addresses the pins via the DDR, PIN and PORT registers.
Please also refer to the [pinout Open Office sheet](https://github.com/sanni/cartreader/blob/master/pinout.ods).
```
void setup_N64_Controller() {
// Output a low signal
PORTH &= ~(1 << 4);
// Set Controller Data Pin(PH4) to Input
DDRH &= ~(1 << 4);
}
```
Would be the same as this in a more traditional Arduino sketch:
```
int dataPin = 7;
void setup(){
// Output a low signal
digitalWrite(dataPin, LOW);
// Set controller data pin to input
pinMode(dataPin, INPUT);
}
```
To preserve memory every string is saved into the flash of the Arduino, also called progmem. This is done by using the F() macro.
```
println_Msg(F("Press Button."));
```
Also all the menus are stored in progmem and are only recalled to sram when needed.
```
// N64 controller menu items
const char N64ContMenuItem1[] PROGMEM = "Test Controller";
const char N64ContMenuItem2[] PROGMEM = "Read ControllerPak";
const char N64ContMenuItem3[] PROGMEM = "Write ControllerPak";
const char* const menuOptionsN64Controller[] PROGMEM = {N64ContMenuItem1, N64ContMenuItem2, N64ContMenuItem3, FSTRING_RESET};
```
In an effort to keep the codebase as portable as possible instead of using the functions supplied by the OLED library directly to print out text, auxiliary functions like `println_Msg` are being used. So if you want to change to another display library you don't need to change all the code but only the helper functions.
```
void print_Msg(long unsigned int message) {
if (ENABLE_OLED)
display.print(message);
if (ENABLE_SERIAL)
Serial.print(message);
}
```
Before uploading the code to your Arduino you need to select your hardware version in Cart_Reader.ino
```
//******************************************
// !!! CHOOSE HARDWARE VERSION !!!
//******************************************
// Remove // in front of the line with your hardware version
// #define HW5
// #define HW4
#define HW3
// #define HW2
// #define HW1
// #define SERIAL_MONITOR
```
For more info please have a look at [this wiki article](https://github.com/sanni/cartreader/wiki/How-to-flash-the-Arduino).
Needed libraries(already included in the portable Arduino IDE under Releases)
SD lib: https://github.com/greiman/SdFat
LCD lib: https://github.com/olikraus/U8g2_Arduino
Neopixel lib: https://github.com/adafruit/Adafruit_NeoPixel
Rotary Enc lib: https://github.com/mathertel/RotaryEncoder
SI5351 lib: https://github.com/etherkit/Si5351Arduino
RTC lib: https://github.com/adafruit/RTClib (needs BusIO lib: https://github.com/adafruit/Adafruit_BusIO)
Frequency Counter lib: https://github.com/PaulStoffregen/FreqCount
|