Differences

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

--- demoboard_getting_started [2018/04/08 03:47] – arko
+++ demoboard_getting_started [2023/02/19 02:35] (current) – external edit 127.0.0.1
@@ 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.
-  - MPLAB X Download Site: [[http://www.microchip.com/mplab/mplab-x-ide]]
-  - XC16 Compiler: [[http://www.microchip.com/mplab/compilers]]
 __ Instructions:__
-  - Click the "Downloads" tab and download the latest version of MPLAB X
+  - MPLAB X Download Site: [[https://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: [[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 Code ======
+====== Example C 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 ======
 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 ====
@@ Line 52: / Line 61: @@
 __ Instructions: __
-  - Download and Install Mono: \\ [[http://www.mono-project.com/download/stable/]]
+  - 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/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: [[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 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|}}
   - 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
+  - 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|}}
@@ Line 72: / Line 83: @@
   - **__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|}}
+  - Connect the PICKIT3 to the L1 Demoscene Board: \\ {{:20141227_163805.jpg?500|}}
   - Open MPLAB X
   - Select the PICKIT3 as the programming device
@@ Line 92: / Line 103: @@
 ====== 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]]
 ----