User Tools

Site Tools


demoboard_getting_started

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
demoboard_getting_started [2018/04/07 20:47]
arko
demoboard_getting_started [2018/04/10 20:14] (current)
arko
Line 21: Line 21:
  
 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. 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.
- 
-  - MPLAB X Download Site: [[http://​www.microchip.com/​mplab/​mplab-x-ide]] 
-  - XC16 Compiler: [[http://​www.microchip.com/​mplab/​compilers]] 
  
 __ Instructions:​__ ​ __ Instructions:​__ ​
  
-  - Click the "​Downloads"​ tab and download the latest version of MPLAB X +  ​- MPLAB X Download Site: [[http://​www.microchip.com/​mplab/​mplab-x-ide]] 
-  - Click the "​Downloads ​Archive" tab and download the latest ​X16 compiler+  ​- 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: [[http://​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 Code ======+====== Example ​Code - Getting Started ​======
  
-L1 Demoscene Board - Getting Started Example Code - GitHub Repository:+__ Instructions__
  
-https://​github.com/​arkorobotics/​L1Demo_Getting_Started+  - 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 ====== ====== Programming ======
  
 Once you've compiled your code using MPLAB X, you can upload the "​.hex"​ file using either method: Once you've compiled your code using MPLAB X, you can upload the "​.hex"​ file using either method:
-  ​USB Progamming ​via Bootloader (default, requires no additional hardware) +  ​* **USB Programming ​via Bootloader** (default, requires no additional hardware) 
-  ​Programming via PICKIT3 (highly-recommended,​ requires 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 ==== ==== USB Bootloader Programming ====
  
Line 53: Line 62:
  
   - Download and Install Mono: \\ [[http://​www.mono-project.com/​download/​stable/​]]   - Download and Install Mono: \\ [[http://​www.mono-project.com/​download/​stable/​]]
-  - Download and Install the L1Demo GUI Loader (Mac/​Windows/​Linux):​ \\ [[https://​github.com/​thedeltaflyer/​L1Demo-GUI-Loader/​releases/​tag/v1.0.1]]+  - 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: [[http://l1demo.org/​driver/​Demox64.EXE | Win 64-bit]] or [[http://​l1demo.org/​driver/​Demox86.EXE | Win 32-bit]] or Manual Install with [[http://​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"​.   - Run the "​L1Demo GUI Loader"​ application. On newer Macs, you may need to right-click on the app icon and hit "​Open"​.
-  - Connect ​your L1 Demoscene Board to your Mac/PC using a USB A to USB MicroAB cable +  - Connect ​the L1 Demoscene Board to your Mac/PC using a USB A to USB MicroAB cable {{:​callouts_board.png?​400|}} 
-  - Power-up the L1 Demoscene Board using either USB or external power (see "Power Up" section)+  - 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|}}   - 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*   - IMPORTANT: *The next sequence of events are time sensitive*
   - Press the RESET button on the L1 Demoscene Board   - 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   - 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+  - Press the RESET button on the L1 Demoscene Board again
   - Click the "​PROGRAM"​ button on the GUI: \\ {{:​clickprogram.png?​400|}}   - 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|}}   - The program will Verify, Load, and Write the hex file to the board: \\ {{:​done.png?​400|}}
Line 72: Line 83:
   - **__WARNING:​__ The following procedure will erase the bootloader on the board!**   - **__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)   - 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|}}+  - Connect the PICKIT3 to the L1 Demoscene Board: ​\\ {{:​20141227_163805.jpg?​500|}}
   - Open MPLAB X   - Open MPLAB X
   - Select the PICKIT3 as the programming device ​   - Select the PICKIT3 as the programming device ​
Line 92: Line 103:
 ====== Code ====== ====== Code ======
  
-L1 Demoscene Board Github: [[https://​github.com/​arkorobotics/​L1DemosceneBoard|L1 Demoscene Board]]+C Code Example: [[https://​github.com/​arkorobotics/​L1Demo_Getting_Started|L1Demo Getting Started]]
  
-Getting Started Demo Github: [[https://​github.com/​arkorobotics/​https://​github.com/​arkorobotics/​L1Demo_Getting_Started|L1Demo Getting Started]]+Assembly Examples: [[https://​github.com/​arkorobotics/​L1DemosceneBoard|L1 Demoscene Board]]
  
 ---- ----
demoboard_getting_started.1523159227.txt.gz · Last modified: 2018/04/07 20:47 by arko