Warning: Undefined array key "REMOTE_USER" in /var/www/html/wiki/lib/plugins/recaptcha2/action.php on line 120
Warning: Cannot modify header information - headers already sent by (output started at /var/www/html/wiki/lib/plugins/recaptcha2/action.php:120) in /var/www/html/wiki/inc/Action/Export.php on line 104
Warning: Cannot modify header information - headers already sent by (output started at /var/www/html/wiki/lib/plugins/recaptcha2/action.php:120) in /var/www/html/wiki/inc/Action/Export.php on line 104
Warning: Cannot modify header information - headers already sent by (output started at /var/www/html/wiki/lib/plugins/recaptcha2/action.php:120) in /var/www/html/wiki/inc/Action/Export.php on line 104
====== Layerone Demoscene Board - Getting Started ======
----
====== Power Up ======
There are two ways to power the Layerone Demoscene Board: USB microAB or External power.
=== USB microAB - 5V: ===
{{:usbpower.png?400|}}
=== External power input range: 4.75v to 15.0v: ===
{{:extpwr.png?400|}}
----
====== Development Environment ======
The Layerone Demoscene Board is based on the PIC24FJ256DA206. You can program this microcontroller using MPLAB X and the XC16 Compiler. You will need both.
__ Instructions:__
- MPLAB X Download Site: [[https://www.microchip.com/mplab/mplab-x-ide]]
- Click the "Downloads" tab near the bottom of the page and download the latest version of MPLAB X IDE
- Install MPLAX X IDE
- XC16 Compiler Download Site: [[https://www.microchip.com/mplab/compilers]]
- Click the "Downloads" tab near the bottom of the page and download the latest XC16 compiler
- Install the XC16 Compiler
----
====== Example C Code - Getting Started ======
__ Instructions: __
- Download the Example Project - L1Demo Getting Started: \\ [[https://github.com/arkorobotics/L1Demo_Getting_Started]]
- Open MPLAB X IDE
- Select"File->Open Project" and navigate to the "L1Demo_Getting_Started" folder
- Open the project "L1Demo_Getting_Started.X" \\ {{:mplabxide.png?400|}}
- Click the "Clean and Build Project" icon to build the hex file \\ {{:cleanbuild.png?400|}}
- The generated .hex file will be available at: \\ "L1Demo_Getting_Started/L1Demo_Getting_Started.X/dist/default/production/L1Demo_Getting_Started.X.production.hex"
----
====== Programming ======
Once you've compiled your code using MPLAB X, you can upload the ".hex" file using either method:
* **USB Programming via Bootloader** (default, requires no additional hardware)
* Pros: Free, easy to use
* Cons: No debug information
OR
* **Programming via PICKIT3 Programmer/Debugger** (highly-recommended, requires additional hardware)
* Pros: Debugging allows users to step through code, watch values of variables during run-time. Huge time-saver.
* Cons: Additional costs
==== USB Bootloader Programming ====
The Layerone Demoscene Board ships with a USB Bootloader programmed to Flash Memory so that anyone with a Mac or PC can program the board without any additional hardware such as a debugger.
__ Instructions: __
- Download and Install Mono: \\ [[https://www.mono-project.com/download/stable/]]
- Download and Install the L1Demo GUI Loader (Mac/Windows/Linux): \\ [[https://github.com/thedeltaflyer/L1Demo-GUI-Loader/releases/]]
- Windows Users will need to download and install drivers for the demoboard: [[https://l1demo.org/driver/Demox64.EXE | Win 64-bit]] or [[https://l1demo.org/driver/Demox86.EXE | Win 32-bit]] or Manual Install with [[https://l1demo.org/driver/L1DemoBoardDrivers.zip | INI file]]
- Run the "L1Demo GUI Loader" application. On newer Macs, you may need to right-click on the app icon and hit "Open".
- Connect the L1 Demoscene Board to your Mac/PC using a USB A to USB MicroAB cable {{:callouts_board.png?400|}}
- Connect the VGA Cable and Audio Jack from your monitor and speakers to the L1 Demoscene Board
- Power-up the L1 Demoscene Board using either USB or external power (see "Power Up" section)
- Click "Choose File" on GUI and navigate to the .hex file you wish to flash to the board: \\ {{:usbprogram.png?400|}}
- IMPORTANT: *The next sequence of events are time sensitive*
- Press the RESET button on the L1 Demoscene Board
- On the GUI, under the "Device" drop down, select the USB COM/tty port for the L1 Demoscene Board
- Press the RESET button on the L1 Demoscene Board again
- Click the "PROGRAM" button on the GUI: \\ {{:clickprogram.png?400|}}
- The program will Verify, Load, and Write the hex file to the board: \\ {{:done.png?400|}}
__ Additional Notes:__
- When you power up the board without a jumper, you have 5 seconds to upload your new hex file. After 5 seconds, the bootloader will automatically load the application from flash memory. If you need more than 5 seconds, you can place the Jumper on PGEC1 and PGED1 to force the bootloader to load indefinitely at reset: \\ {{:20150102_133814.png?500|}}
- To force the application to load, place a jumper on PGED1 and GND: \\ {{:20150109_132603.jpg?500|}}
==== PICKIT3 Programming ====
- **__WARNING:__ The following procedure will erase the bootloader on the board!**
- Purchase a PICKIT3: [[https://www.sparkfun.com/products/9973]] (or from your favorite vendor)
- Connect the PICKIT3 to the L1 Demoscene Board: \\ {{:20141227_163805.jpg?500|}}
- Open MPLAB X
- Select the PICKIT3 as the programming device
- For MPLAB X: Select PICKIT3 in the Project Properies -> Device
- Upload by clicking the "Download" button
----
====== Documentation ======
Datasheet for PIC24FJ256DA206: {{:pic24fj256da206.pdf|}}
Graphics Controller Module datasheet for PIC24FJ256DA206: {{:39731a.pdf|}}
----
====== Code ======
C Code Example: [[https://github.com/arkorobotics/L1Demo_Getting_Started|L1Demo Getting Started]]
Assembly Examples: [[https://github.com/arkorobotics/L1DemosceneBoard|L1 Demoscene Board]]
----
====== Hardware ======
Board and Schematic Files: [[https://github.com/arkorobotics/L1DemosceneBoard/tree/master/L1Demo-PCB|L1 Demoscene Board & Schematic]]