MirrorMirror
/
classic-trackball
mirror of https://github.com/ploopyco/classic-trackball.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

updated with changes for clarity

ploopyco 2019-10-30 13:46:54 -04:00
parent 392ae6fb46
commit b47b56f4e6
1 changed files with 27 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
Appendix-C:-Firmware-programming.md

@ -5,13 +5,13 @@ The Arduino Nano offers a very simple and easy way of programming the microcontr
## Step 1: Get the necessary tools
- The Arduino IDE
- [The Arduino IDE](https://www.arduino.cc/en/main/software)
- A base PCB with all components soldered
- An Arduino Nano
- A USB mini-B to USB A cable
- Hookup wire
- A 10uF capacitor
- A breadboard
- [An Arduino Nano](https://store.arduino.cc/usa/arduino-nano) (I get them on Amazon)
- A USB mini-B to USB A cable (something like [this](https://www.amazon.ca/UGREEN-Players-Digital-Navigation-Receiver/dp/B00P0GI68M))
- Hookup wire (something like [this](https://www.amazon.ca/Elegoo-120pcs-Multicolored-Breadboard-arduino/dp/B01EV70C78); any breadboard jumper wire or 24AWG hookup wire will do fine)
- A 10uF capacitor (something like [this](https://www.amazon.ca/SODIAL-Radial-Aluminum-Electrolytic-Capacitors/dp/B00X3LP44K))
- A breadboard (something like [this](https://www.amazon.ca/Breadboard-Solderless-Prototype-Distribution-Connecting/dp/B01EV6LJ7G))
## Step 2: Hook up the base PCB to the Arduino Nano
@ -23,7 +23,7 @@ The base PCB has a 6-pin ICSP header. The pins are numbered like this:
5 -> o o <- 6
```
Note that pin 1 is a square pad on the board. Also, this is the way the header looks when viewed from the *top* of the board (i.e. when the microcontroller is visible).
Note that pin 1 is a square pad on the board. Also, this is the way the header looks when viewed from the *top* of the board (i.e. when the microcontroller is visible). [Here's a picture of what it looks like](https://i.imgur.com/nh6e5tQ.jpg).
Make the following connections using hookup wire:
@ -66,12 +66,15 @@ If the Arduino IDE reports that you successfully flashed the firmware onto the A
## Step 5: Program the Ploopy Trackball
In this step, you'll use the Arduino Nano to program the Ploopy Trackball.
1. Ensure that a 10uF capacitor is placed between RST and GND on the Arduino Nano.
2. Double-check the hookups between the Arduino Nano and the Ploopy Trackball ICSP header.
3. In the Arduino IDE, set `Tools > Board` to `Ploopy Trackball` and `Tools > Programmer` to `Arduino as ISP`.
4. If necessary, burn the Arduino bootloader onto the Ploopy Trackball by selecting `Tools > Burn Bootloader`.
1. Visit the [Ploopy Trackball Github firmware page](https://github.com/ploopyco/mouse/tree/master/firmware) and download the entire `production` directory onto your computer.
2. If it's not running, start the Arduino IDE.
3. Open the Ploopy firmware by selecting `File -> Open` and selecting `production.ino`.
4. Ensure that a 10uF capacitor is placed between RST and GND on the Arduino Nano. (The polarity of the capacitor doesn't matter. So, if you're using an [electrolytic capacitor](https://media.rs-online.com/t_large/F5194059-01.jpg), it doesn't matter which way you plug it in.)
5. Double-check the hookups between the Arduino Nano and the Ploopy Trackball ICSP header.
6. In the Arduino IDE, set `Tools > Board` to `Ploopy Trackball` and `Tools > Programmer` to `Arduino as ISP`.
7. If necessary, burn the Arduino bootloader onto the Ploopy Trackball by selecting `Tools > Burn Bootloader`.
- You only have to do this once. Don't do this every time you reflash the microcontroller.
5. Go to `Sketch > Upload Using Programmer` to upload a sketch to the Ploopy Trackball.
8. Go to `Sketch > Upload Using Programmer` to upload a sketch to the Ploopy Trackball.
If the Arduino IDE reports that you successfully flashed the firmware onto the Ploopy Trackball, then you're done.
@ -106,4 +109,15 @@ In general, the Arduino boards play very nicely with the Arduino IDE. If you can
**What's going on?**
Hate to say it, but you probably hooked something up wrong. Generally, `Device signature = 0x000000` means that the microcontroller (on the Ploopy Trackball) isn't being powered. So, either you swapped a few of the ICSP pins, or you missed a solder connection somewhere. One thing you could try to do is use a multimeter to verify whether power is being supplied to the Ploopy Trackball board.
Hate to say it, but you probably hooked something up wrong. Generally, `Device signature = 0x000000` means that the microcontroller (on the Ploopy Trackball) isn't being powered. So, either you swapped a few of the ICSP pins, or you missed a solder connection somewhere. One thing you could try to do is use a multimeter to verify whether power is being supplied to the Ploopy Trackball board.
**Q: Okay, but now I'm getting an error that looks slightly different:**
avrdude: Device signature = 0xffffff
avrdude: Yikes! Invalid device signature.
Double check connections and try again, or use -F to override
this check.
**Huh?**
If this is happening, it's likely that your hookup wire isn't making perfect contact with the header on the Ploopy board. Make sure that all of the wires are touching the holes well, and then try again.