start instruction

This commit is contained in:
grizzly 2024-07-09 16:17:23 -04:00
parent c4b87b2235
commit 30569e56a0

View file

@ -0,0 +1,76 @@
#set enum(numbering: "1.a.i.")
#align(center)[#text(size:2em, weight:"bold")[EET Boxes Setup Instruction]]
#outline()
= Preparation
Each box is composed of a few components:
- The base board where the FPGA, microcontroller, and ethernet port are installed.
- The adapter board that plugs in the base board and provide the input and output power connectors.
- The case, composed of the bottom and top plastic parts and the front and back metal plates.
- The hardware: screws, spacers, spings.
When fully setup, the box should have all the software and the complete case installed.
Before starting the setup, it is recomended to reset the boxe to wipe any remaining configuration.
To do so, provide power to the box by plugging in the ethernet cable and use a jumper cable to connect the 3.3V and ERASE pads on the base board for five seconds.
After removeing the jumber connection, power cycle the device.
= Flashing FPGA
The FGPA is the largest square ship on the base board.
The port to flash the FGPA is the vertical receptacle located the closest to the FPGA.
Here are the steps to follow to flash the FPGA.
+ Power ON the box using the ethernet cable.
+ Connect the FPGA adapter cable to the FPGA port on the base board and to a USB port on the PC.
+ If using a virtual machine, go to `Device` #sym.arrow `USB` and tick the box next to `FPGA Programmer Cable`. If the Latice Diamond software xwas already running, restart it.
+ Start the Latice Diamond software and open the `palidaq` project.
+ Go to `tools` #sym.arrow `Programmer`.
+ For the first time, change the file name to `fpga/src/impl1/palidaq_imp1.jed`.
+ For the first time, change the `Operation` to `FLASH Erase, Program, Verify, Secure`.
+ Save this configuration with `ctrl+s`.
+ On the right under `Cable Settings` select `Detect Cable` and verify that there is no error in the console. If you do have an error, make sure the box is receiving power.
+ Flash the firmware with the `Program` icon (down green arrow button above the operation line).
Congratulation, the FPGA is ready now.
= Flashing Base Firmware
The base firmware is common to all boxes.
To flash the base firmware to the Atmel microcontroller, follow these steps:
+ Power ON the box using the ethernet cable.
+ Connect the Atmel adapter to the base board using thevertical port closest to the Atml chip.
+ If using a virtual machine, enable the USB device as for the FPGA.
+ Open the Microchip software.
+ Select `Tools` #sym.arrow `Device Programming`.
+ ??
+ In the Device dropdown select your device based on the final characters etched on the Atmel chip:
+ ATSAMV71Q19B for the Q19
+ ATSAME70Q20B for the Q20
+ ATMSAME70Q21B for the Q21
+ Select `SWD` in the interface dropdown. Make surethe cable from the adapter to the board is connected to the SWD port.
+ Press `Apply`.
+ Press `Read` next to the `Device Signature` box and make sure the device ID updated.
+ Select `Memories` in the left sidebar.
+ Ensure the selected file is `application.elf` either in the `Debug` or `Debug_V71Q19B` folder.
+ Press `Programm`
#text(fill:red)[Add instructions for reseting the security bits to 0x42]
To set the security bits that diable recovery of the firmware, select `Security` in the left sidebar of the `Devide Programming` menu and press `Set`.
= Registering Device
The firmware of the box contains the information for the conecting to the server.
To get these information, you first need to register the new box in Palitronica's system.
= Flashing Firmware
= IoT Hub Setup
= Verification