SOP for building bootloader, OT2IT Ethernet

OT2IT_Ethernet_SOP_Prelim.txt

@@ -0,0 +1,34 @@
+1. Install the bootloader
+	Bootloader bin (https://github.com/ADLINK/OT2IT/blob/main/bootloader-ot2it.bin)
+
+2. Setup Arduino environment with ADLINK SAMD Boards Installed
+	JSON File (https://raw.githubusercontent.com/ADLINK/OT2IT/main/packages_adlink_ot2it.json)
+
+3. Copy the SAME54 CMSIS Files into arduino core:
+	CMSIS Files - https://github.com/ADLINK/OT2IT/tree/main/arduino/tools/CMSIS-Atmel/1.2.0/CMSIS/Device/ATMEL
+	Copy the CMSIS files into $(Arduino Directory)\packages\arduino\tools\CMSIS-Atmel\1.2.0\CMSIS\Device\ATMEL
+	For Ex: $(Arduino Directory) - C:\Users\adlin\AppData\Local\Arduino15\
+
+4. Install the OT2ITEthernet Library
+	File - (https://github.com/ADLINK/OT2IT/blob/main/OT2ITEth.zip)
+	Using Sketch->Include Library -> Add .Zip Library
+
+5. Open the Ethernet Sample Sketch in Arduino
+	Sketch - https://github.com/ADLINK/OT2IT/blob/main/OT2ITEth/examples/ethernet_rec/ethernet_rec.ino
+
+6. Select the OT2IT board & Port
+	Board Selection : Tools -> Boards -> Adlink SAMD Boards -> Adlink OT2IT
+	Port Selection : Tools -> Ports -> COM with Adlink OT2IT
+
+7. Compile the Sketch
+	Using Sketch -> Verify / Compile
+
+8. Upload the sketch into the board
+	Double click the reset button of OT2IT board to make the board to enter into upload mode
+	Then Upload the sketch : Sketch -> Upload
+
+9. Open the serial monitor
+	Tools -> Serial Monitor
+	In monitor, OT2IT assigned with IP Address will be displayed.
+	To Test -> ping the IP address from Host machine
+	To Test web -> enter http://<OT2IT IP Address> on the web browser

bootloader_ot2it_sop.txt

@@ -0,0 +1,40 @@
+uf2-samdx1 bootloader build instructions
+========================================
+
+Host PC Environment
+-------------------
+
+  - $ UBUNTU 22.04 LTS 
+
+cross-compiler setup
+--------------------
+
+  - Download the arm-none-eabi-gcc from https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 into ~/Downloads
+  - $ cd /opt/
+  - $ sudo tar jxvf ~/Downloads/gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2
+  - $ export PATH=/opt/gcc-arm-none-eabi-10.3-2021.10/bin/:$PATH
+
+Download the uf2-samdx1 bootloader
+----------------------------------
+
+  - $ cd ~
+  - $ git clone https://github.com/microsoft/uf2-samdx1
+  - $ cd ~/uf2-samdx1
+
+Download & Apply the patches
+-----------------------------
+
+  - $ cd ~
+  - $ git clone https://github.com/ADLINK/OT2IT
+  - $ cd ~/uf2-samdx1
+  - $ patch -p1 < ~/OT2IT/uf2_patches/001-ot2it-board-support.patch 
+  - $ patch -p1 < ~/OT2IT/uf2_patches/002-clock-config-ethernet.patch
+  - $ patch -p1 < ../OT2IT/uf2_patches/003-USB-detect-issue-fixed.patch
+
+Build the uf2-samdx1
+--------------------
+
+  - $ export PATH=/opt/gcc-arm-none-eabi-10.3-2021.10/bin/:$PATH
+  - $ cd ~/uf2-samdx1
+  - $ make BOARD=ot2it
+  - $ after successful build, bootloader of ot2it will present at build/ot2it/bootloader-ot2it-<git revision>.bin (for ex: build/ot2it/bootloader-ot2it-v3.4.0-83-g4c90034-dirty.bin)