From 9b79bcd6d2763d5e88e46b20449e28ad60c7485d Mon Sep 17 00:00:00 2001 From: Zacck Osiemo Date: Thu, 11 Sep 2025 15:25:24 +0200 Subject: [PATCH 1/2] Update upduino bring up docs Signed-off-by: Zacck Osiemo --- docs/source/getting_started/first_steps.rst | 3 ++- docs/source/tutorials/blink_led.rst | 8 ++++++-- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/source/getting_started/first_steps.rst b/docs/source/getting_started/first_steps.rst index 500b8d0..c5f23ac 100644 --- a/docs/source/getting_started/first_steps.rst +++ b/docs/source/getting_started/first_steps.rst @@ -3,7 +3,8 @@ First Steps 1. When you receive your UPduino, make sure it works properly before you proceed further! A simple way to do this is to plug the UPduino into a standard micro USB cable attached to a standard USB power supply such as a computer or a phone charger. - You should see the green LED (D1) light up and also the 3 color LED go through a Red, Blue Green sequence. - - Also, if you are on a computer, you should see a new USB device called the "UPduino 3.0" show up in your list of USB devices. + - Also, if you are on a computer, you should see a new USB device called the "UPduino 3.0" show up in your list of USB devices. + - Do note on v3.1 you should see a FT232H "ID 0403:6014 Future Technology Devices International" - The board shows up as a serial port (COMxx on windows and /dev/ttyxx on Linux and Mac). 2. Download the toolchain of choice: Lattice Radiant and/or icestorm/apio. 3. Download the git repository for the UPduino and go the RTL/blink_led directory. diff --git a/docs/source/tutorials/blink_led.rst b/docs/source/tutorials/blink_led.rst index 435594e..6bda4fb 100644 --- a/docs/source/tutorials/blink_led.rst +++ b/docs/source/tutorials/blink_led.rst @@ -23,12 +23,16 @@ Then: ``iceprog rgb_blink.bin`` You should see the LED blink! -If you want to use apio, first type: ``apio init --board upduino3`` +If you want to use apio, first type: ``apio create --board upduino3`` -Then: ``apio verify`` to make sure your code works, and then finally: +Then: ``apio lint`` to make sure your code works, and then finally: ``apio build`` and ``apio upload`` +On recent versions of apio, ``upload`` is finicky however + +``iceprog _build/default/hardware.bin`` works. + The LED should blink now! Making Changes From 15a8ab462a8b4dd3b08fc4b5a98cdc2c0eb3f0ad Mon Sep 17 00:00:00 2001 From: Zacck Osiemo Date: Tue, 10 Feb 2026 20:27:39 +0200 Subject: [PATCH 2/2] Add correct package definition for people working through makefile Signed-off-by: Zacck Osiemo --- docs/source/features/specs.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/features/specs.rst b/docs/source/features/specs.rst index b058392..28dd26e 100644 --- a/docs/source/features/specs.rst +++ b/docs/source/features/specs.rst @@ -2,7 +2,7 @@ Specifications ================ The UPduino supports the following features: - - Lattice iCE40 UP5K UG48 FPGA + - Lattice iCE40 UP5K SG48 FPGA UPduino Pinout --------------