Updated Appendix C: Firmware programming (markdown)

ploopyco 2020-10-19 20:18:04 -04:00
parent 2d90d7e6b0
commit 970c2e3694
1 changed files with 2 additions and 2 deletions

@ -41,7 +41,7 @@ If your board doesn't have a header soldered to it (i.e. there are holes that go
## Step 3: Add the Ploopy Trackball board definition to the Arduino IDE ## Step 3: Add the Ploopy Trackball board definition to the Arduino IDE
In this step, you'll add the Ploopy Trackball board definition to your install of the Arduino IDE. In this step, you'll add the Ploopy Trackball board definition to your install of the Arduino IDE.
1. Visit the [Ploopy Trackball Github firmware page](https://github.com/ploopyco/mouse/tree/master/firmware) and download the entire `hardware/ploopy/avr` directory onto your computer. 1. Visit the [Ploopy Trackball Github firmware page](https://github.com/ploopyco/trackball/tree/master/firmware) and download the entire `hardware/ploopy/avr` directory onto your computer.
2. Copy the `hardware/ploopy/avr` directory tree into your Arduino folder. 2. Copy the `hardware/ploopy/avr` directory tree into your Arduino folder.
- On Windows machines, this could be somewhere like `C:\Program Files\Arduino` or `C:\Program Files (x86)\Arduino`. - On Windows machines, this could be somewhere like `C:\Program Files\Arduino` or `C:\Program Files (x86)\Arduino`.
- If you're part of the Linux master race, look somewhere like `~/Arduino`. - If you're part of the Linux master race, look somewhere like `~/Arduino`.
@ -68,7 +68,7 @@ If the Arduino IDE reports that you successfully flashed the firmware onto the A
## Step 5: Program the Ploopy Trackball ## Step 5: Program the Ploopy Trackball
In this step, you'll use the Arduino Nano to program the Ploopy Trackball. In this step, you'll use the Arduino Nano to program the Ploopy Trackball.
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. 1. Visit the [Ploopy Trackball Github firmware page](https://github.com/ploopyco/trackball/tree/master/firmware) and download the entire `production` directory onto your computer.
- *NOTE THAT* not all of the firmware versions will work on all of the boards! - *NOTE THAT* not all of the firmware versions will work on all of the boards!
- First, check to see what kind of main board you have. Look at the board for a revision number (the board containing the sensor, the one that lies flat, not the vertical one). The code should look something like "R1.00X", where X is some number. - First, check to see what kind of main board you have. Look at the board for a revision number (the board containing the sensor, the one that lies flat, not the vertical one). The code should look something like "R1.00X", where X is some number.
- If that number is R1.004, R1.003 or, very rarely, R1.002, use the firmware in the ["r1.004" branch of the code](https://github.com/ploopyco/trackball/tree/r1.004). - If that number is R1.004, R1.003 or, very rarely, R1.002, use the firmware in the ["r1.004" branch of the code](https://github.com/ploopyco/trackball/tree/r1.004).