Hardware Checkpoints

3 checkpoints 

There are 3 checkpoints in this section. Each tests one hardware block of the RGB Matrix kit: the LED Matrix, the buttons, and the sound.

Installing the Custom libraries 

The libraries needed for this kit were made here at Thimble and be downloaded at the links below. Don't unzip them. They can be added to the Arduino IDE as ZIP files. To do this open up the Arduino IDE. Go to Sketch > Include Library > Add .ZIP library and add the three libraries one by one.

Masterscreen

rgbSprite

usbKeyboard

LED Matrix 

The code below tests the RGB matrix and its components. Upload the code to your finished kit. If the Matrix display is working properly, the code below will display a Rainbow. If you don't see this then disconnect your Arduino and double check your solder joints around the shift registers, resistor packs, and all headers.

Download file Copy to clipboard
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
#include <RGB_sprite.h>
#include <masterScreen.h>

/* rainbow.ino
 *  Benchmark test, displays one color per horizonal
 *  line. Used easily verify the hardware is working.
 *
 * Expected Output:
 *  white
 *  light blue
 *  purple
 *  blue
 *  yellow
 *  green
 *  red
 *  off
 */

masterScreen screen;

void setup() {
  tone(8,200);
  screen.createScreen();
  rainbow();
}

void loop() {

}

void rainbow()
{
  for(byte x = 0; x <= 7; x++)
  {
    for(byte y = 0; y <=7; y++)
    {
      screen.modifyScreen(x, y, y);
    }
  }
}

Button Benchmark 

After uploading, open up the serial monitor and start pressing buttons. Every button has a unique name.

Download file Copy to clipboard
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
/*rowcolScan.ino
 *  Button hardware check
 *
 * Expected Output:
 *   Pressed button will pop up in the serial monitor
 */

int leftInputs[] = {A0, A1}; //INPUT_PULLUP reading pins
int leftOutputs[] = {A2, A3, A4}; //Column HIGH or LOW pins
String leftButtons[2][3] = { //Used to translate  the reading to a real button
  {"LL", "LU", "SELECT"},
  {"LR", "LD", "LShoulder"}
};

int rightInputs[] = {10, A5}; //INPUT_PULLUP reading pins
int rightOutputs[] = {11, 12, 13}; //Column HIGH or LOW pins
String rightButtons[2][3] = {
  {"RL", "RU", "START"},
  {"RR", "RD", "RShoulder"}
};

void setup() {
  //Set inputs
  for (int i = 0; i < 2; i++) {
    pinMode(leftInputs[i], INPUT_PULLUP);
    pinMode(rightInputs[i], INPUT_PULLUP);
  }

  //Set outputs
  for (int i = 0; i < 3; i++) {
    pinMode(leftOutputs[i], OUTPUT);
    digitalWrite(leftOutputs[i], HIGH);
    pinMode(rightOutputs[i], OUTPUT);
    digitalWrite(rightOutputs[i], HIGH);
  }

  Serial.begin(9600); //For debugging
}

void loop() {

    // Left side
  for (int y = 0; y < 3; y++) { //Outputs
    digitalWrite(leftOutputs[y], LOW); //Turn column on
    for (int x = 0; x < 2 ; x++) { //Inputs
      if (!digitalRead(leftInputs[x])) { //Read row
        //Button is pressed
        Serial.println(leftButtons[x][y]);
      }
    }//End of y
    digitalWrite(leftOutputs[y], HIGH); //turn column off
  }//End of x

    // Right side
  for (int y = 0; y < 3; y++) { //Outputs
    digitalWrite(rightOutputs[y], LOW); //Turn column on
    for (int x = 0; x < 2 ; x++) { //Inputs
      if (!digitalRead(rightInputs[x])) { //Read row
        //Button is pressed
        Serial.println(rightButtons[x][y]);
      }
    }//End of y
    digitalWrite(rightOutputs[y], HIGH); //turn column off
  }//End of x
}

Sound System Benchmark 

This tests the speaker and potentiometer components. After uploading, it will play a little melody. If you don't hear anything first check that the potentiometer is dialed to the left.

Download file Copy to clipboard
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
/*sound_benchmark.ino
 *  Sound System hardware benchmark.
 *
 * Expected Output:
 *   A some tones will be played, the Volume Pot
 *   may need to be rotated to turn up the Volume.
 */
#define NOTE_B0  31
#define NOTE_C1  33
#define NOTE_CS1 35
#define NOTE_D1  37
#define NOTE_DS1 39
#define NOTE_E1  41
#define NOTE_F1  44
#define NOTE_FS1 46
#define NOTE_G1  49
#define NOTE_GS1 52
#define NOTE_A1  55
#define NOTE_AS1 58
#define NOTE_B1  62
#define NOTE_C2  65
#define NOTE_CS2 69
#define NOTE_D2  73
#define NOTE_DS2 78
#define NOTE_E2  82
#define NOTE_F2  87
#define NOTE_FS2 93
#define NOTE_G2  98
#define NOTE_GS2 104
#define NOTE_A2  110
#define NOTE_AS2 117
#define NOTE_B2  123
#define NOTE_C3  131
#define NOTE_CS3 139
#define NOTE_D3  147
#define NOTE_DS3 156
#define NOTE_E3  165
#define NOTE_F3  175
#define NOTE_FS3 185
#define NOTE_G3  196
#define NOTE_GS3 208
#define NOTE_A3  220
#define NOTE_AS3 233
#define NOTE_B3  247
#define NOTE_C4  262
#define NOTE_CS4 277
#define NOTE_D4  294
#define NOTE_DS4 311
#define NOTE_E4  330
#define NOTE_F4  349
#define NOTE_FS4 370
#define NOTE_G4  392
#define NOTE_GS4 415
#define NOTE_A4  440
#define NOTE_AS4 466
#define NOTE_B4  494
#define NOTE_C5  523
#define NOTE_CS5 554
#define NOTE_D5  587
#define NOTE_DS5 622
#define NOTE_E5  659
#define NOTE_F5  698
#define NOTE_FS5 740
#define NOTE_G5  784
#define NOTE_GS5 831
#define NOTE_A5  880
#define NOTE_AS5 932
#define NOTE_B5  988
#define NOTE_C6  1047
#define NOTE_CS6 1109
#define NOTE_D6  1175
#define NOTE_DS6 1245
#define NOTE_E6  1319
#define NOTE_F6  1397
#define NOTE_FS6 1480
#define NOTE_G6  1568
#define NOTE_GS6 1661
#define NOTE_A6  1760
#define NOTE_AS6 1865
#define NOTE_B6  1976
#define NOTE_C7  2093
#define NOTE_CS7 2217
#define NOTE_D7  2349
#define NOTE_DS7 2489
#define NOTE_E7  2637
#define NOTE_F7  2794
#define NOTE_FS7 2960
#define NOTE_G7  3136
#define NOTE_GS7 3322
#define NOTE_A7  3520
#define NOTE_AS7 3729
#define NOTE_B7  3951
#define NOTE_C8  4186
#define NOTE_CS8 4435
#define NOTE_D8  4699
#define NOTE_DS8 4978

#define melodyPin   9

int high_melody[] = {
  NOTE_E7, NOTE_E7, 0, NOTE_E7,
  0, NOTE_C7, NOTE_E7, 0,
  NOTE_G7, 0, 0,  0,
};
int high_tempo[] = {
  12, 12, 12, 12,
  12, 12, 12, 12,
  12, 12, 12, 12,
  12
};


int low_melody[] = {
  NOTE_C4, NOTE_B0, NOTE_A3, NOTE_B0
};

int low_tempo[] = {12, 12, 12, 12};

int size_var = 0;

void setup(void)
{
  pinMode(melodyPin, OUTPUT);

}
void loop()
{
  sound(1);
  sound(1);
  sound(2);
}

void sound(int sel) {

 switch(sel){

  case 1:
    size_var = sizeof(high_melody) / sizeof(int);

    for (int thisNote = 0; thisNote < size_var; thisNote++) {
      int noteDuration = 1000 / high_tempo[thisNote];

      tone(melodyPin, high_melody[thisNote], noteDuration);

      int pauseBetweenNotes = noteDuration * 1.50;
      delay(pauseBetweenNotes);

      // stop the tone playing:
      tone(melodyPin, 0, noteDuration);
    }
  break;

  case 2:
    size_var = sizeof(low_melody) / sizeof(int);
    for (int thisNote = 0; thisNote < size_var; thisNote++) {

      int noteDuration = 1000 / low_tempo[thisNote];

      tone(melodyPin, low_melody[thisNote], noteDuration);

      int pauseBetweenNotes = noteDuration * 1.50;
      delay(pauseBetweenNotes);

      // stop the tone playing:
      tone(melodyPin, 0, noteDuration);

    }
  }
}

Actually Programming the Game 

Full Code

The full code for the pong game can be downloaded here.

Outro
Outro video