Programming Your Keypad¶
What is it?¶
PlatformIO is an IDE like the Arduino IDE but is integrated with your text editor!
Launch atom and press ctrl and comma which will open the settings menu. Click on install, type “platformio” into the search box and hit enter. Click install on “platformio-ide” and wait for it to install. It should ask if you want to install clang for auto-completion but it’s not necessary so you can just ignore it. When the installation finishes, you should see a button in the top right that tells you to restart to apply the changes. Hit restart and you’re good to go!
Download the Code¶
Click the link for your respective model to go to the GitHub page that contains the necessary code. Click the “clone or download” button and then select “download zip.” Extract it to wherever you like (I would recommend your desktop or documents folder.)
Uploading the code¶
Open the folder in Atom that you just extracted from the zip that contains the “platformio.ini” file and it should show up in the left panel under “Project.” It should be called <code>-master, but make sure it’s the one that contains platformio.ini since there can be two of the folders depending on how you extracted the zip. Click on the folder with the same title as the parent folder and open the file with the same title with the .ino extension (which should be something like trinketM0-master > trinketM0 > trinketM0.ino, the names will be different depending on the code you’re using). Make sure your keypad is plugged in and press F7. Type “upload” and select the correct option for your model (if you don’t select the model, it will try to upload all of them so make sure to do this.) You may need to try a few times and if it tells you that it can’t find the port, just try unplugging the keypad and plugging it back in. If all goes well, it should upload the code to the keypad!
ONLY for keypads purchased before 3/15/18¶
The Easy Way (Web Editor)¶
Arduino recently introduced their web-based editor, a more accessible version of the Arduino IDE that can run in your web browser. This is great for me because it’s a lot easier than installing the program, libraries, copying and pasting code, selecting the port, selecting the board, etc. Don’t worry about any of that, since we get to avoid all of it!
Browser: Chrome, Firefox, or Safari
Making an Arduino Account¶
Don’t worry, they won’t bombard you with emails (yet*) and you don’t need to give them any personal information, they just require an account so you can manage your code. You can make your account from this page here:
You will have to verify your account through your email (don’t use a fake one) and then you’re done!
Installing the browser plugin¶
Go to the Web Editor and you will be asked to install the plugin.
*On the welcome screen there’s a box you have to uncheck if you don’t want their emails:
If you’re on a Windows machine running Windows 8.1 or lower you’ll need drivers for your keypad to be recognized. The Arduino plugin should ask you to install them, but if it doesn’t, you can follow my driver installation guide here:
You’re almost done, all that’s left is loading the code. Fortunately, they have made this very easy. All you have to do is click on the share link for your corresponding keypad and add to sketchbook. It should then take you to the editor and tell you that Arduino Leonardo has been connected. You can now click on Upload (the right arrow) to upload the code to the keypad. If it works, you should see “Success: Done Uploading.” If not, make sure the keypad is plugged in and that you installed the drivers.
The Hard Way (Desktop IDE)¶
If you don’t want to use the Web IDE, you can download the tried-and-true desktop IDE instead. This is a little harder and requires a few extra steps, but you don’t need to make an account.
If you’re on a Windows machine running Windows 8.1 or lower you’ll need drivers for your keypad to be recognized.
Installing the Arduino IDE¶
The latest version of the Arduino IDE can be downloaded and installed from the Ardiono website here:
Configuring the IDE¶
A few things need to be done before you start. Firstly, you will need the libraries used in the code, otherwise it can’t compile because all of that code will be missing. This used to be a lot more difficult to install, but since version 1.6.5 they added the Library Manager, which allows you to install libraries directly from the IDE. To install libraries, launch the IDE open the Library Manager by going to Sketch > Include Library > Manage Libraries…
My code uses the Bounce2 and NeoPixel libraries, so just search “Bounce2” and “Adafruit NeoPixel” in the search bar and click Install on the result. After they are installed, you can close the Library Manager window.
Verifying and Uploading the Code¶
Delete the code in the main window of the Arduino IDE. Now, paste in the code for your corresponding keypad from my GitHub here:
Now we need to tell the IDE what it’s trying to compile for and communicate with. Go to Tools > Board and select Arduino Leonardo and go to Tools > Port and select the one that has (Arduino Leonardo) to the right of it.
Now you can click on the right arrow to compile and upload the code. Don’t worry about uploading broken code, if it fails to compile it won’t upload it to the microcontroller. It will ask you to save and you can either click cancel or choose a directory to save to, it will compile either way. If you didn’t get any errors, congratulations, you did it! If you did, make sure you’ve selected the board and the port and that there’s nothing left behind from the blank sketch or that you copied the code correctly.
Making Changes to the Firmware¶
There are some things you should familiarize yourself with before you get started. These are the most important functions/libararies.
digitalRead() for reading button inputs.
analogWrite() for controlling single-color LEDs.
The neopixel library for controlling RGB LEDs.
I wouldn’t recommend trying to change random variables unless you can actually follow the logic and see exactly what they’re changing. Some of them may tie in somewhere else and cause unexpected results.