See the latest version on the documentation wiki.
You don’t need a Microchip programmer to develop firmware for the #twatch. You can use Microchip’s free development tools and upload code through the network bootloader. It’s a mini PIC 18F67J60 development board, but remember that the chip is only rated for 100 program cycles.
Compile instructions follow the break.
Next, download and install Microchip’s “free” TCP/IP stack. The stack is freely available from the website, but Microchip’s license doesn’t allow us to redistribute the code.
Finally, download a #twatch source code archive, or get the latest development version from SVN with a program like TortoiseSVN. Drag the source folder into the TCPIP stack install location (usually .\Microchip Solutions\).
Open the #twatch project in MPLAB. Compile the project. You may need to modify the compiler location when prompted, but MPLAB is getting better about making these changes automatically.
The compiled firmware must be exported in order to work with the bootloader. In MPLAB, go to File->Export… Make sure that the Program Memory and Configuration Bits boxes are checked. Change the export end address to 0x1dbbf, the bootloader lives in the space beyond 0x1dbbf. Make sure INHX32 (Intel 32bit HEX) is selected on the File Format tab. Click OK to export the firmware.
Bootload the firmware over TFTP using the normal upgrade process.
Note that source v0b works with TCP/IP stack v5.0, v0c works with v5.1+. Unfortunately Microchip doesn’t seem to have past stack versions available for download, and we can’t distribute the older versions, so we’re stuck using the latest and greatest stack Microchip makes available. Please write Microchip and tell them what a pain this is for people who want to learn to use their products.
How to use TortoiseSVN to check out the development source on Windows:
- Right click->SVN checkout on your desktop or Windows file explorer.
- Enter the SVN address (http://dangerous-prototypes-open-hardware.googlecode.com/svn/trunk/) and a directory to use. Choose anonymous check out.
- If you have commit permissions (you’ve been added as a developer on the project), then use the secure SVN address (https://dangerous-prototypes-open-hardware.googlecode.com/svn/trunk/). Give Tortoise your email address when prompted, your Google SVN password is different than your account password – get your Google SVN password here.
- TortoiseSVN will download the source.
- The developers work in the TRUNK folder. If you’re contributing to the project, make your changes, then right click on the modified file and choose SVN commit. If you added new files, first use SVN add, then use SVN commit.