Open Hardware Miniconf - User contributions [en]

OHMC2023

2023-03-12T22:51:41Z

Geekscape: /* Workshop materials */

== EO2023 Open Hardware Workshop location ==

'''Monday, 13th March 2023''' at the [https://www.hackmelbourne.org Connected Community HackerSpace] 
'''Address:''' 5 Kent Lane, Hawthorn, Victoria. ''Note: Kent Lane, not Kent Street'' 
'''Parking:''' [https://goo.gl/maps/c99ByYTS1EMZDKLT6 Hawthorn Town Hall car park] (free for 2 hours or outside of business hours, $6.50 for 8 hours during business hours) 
'''Public transport:'''

: The HackerSpace is a two minute walk from the Glenferrie train station. From the Flinders Street train station in the city, use the
: Lilydale / Ringwood / Belgrave train line: 15 minutes / 5 stops direct or 20 minutes / 8 stops via the City Loop ... and double-check
: that you haven't caught an express train that skips Glenferrie (there is an express train to Box Hill, avoid this!). There are many good
: lunch and dinner options nearby.

'''Breakfast / Lunch / Dinner options:'''

: Nearby Glenferrie Road (3 minutes walk) is the beating heart of Hawthorn with a broad range of restaurants, cafes, take-away, supermarkets, etc. There are several good pubs close by and a rooftop bar. Whilst it is a public holiday on Monday in Victoria, there should still be a good selection of places open ... perhaps some may shut, but it'll be a good day for them to be doing business.
: The HackerSpace has a microwave, kettle, drinks fridge and snacks. Along with a very small sink area. It is basic, but some very modest self-catering is possible !

== Workshop sessions ==

: The workshop is a full day of project activities for both the SwagBadge 2022 (based on microPython) and the FPGA Rockling hardware.
: It is highly recommended to be there for both the morning and afternoon sessions, there is a lot to cover and do.
: However for interstate travellers, we will start the afternoon session with a brief recap to get you up-to-speed.
: Interested EO2023 attendees who didn't order the LCA2022 hardware kit are welcome to join us and check things out.

'''Morning:''' Setup from 9:00am. Be ready to start at 10am sharp 
'''Lunch:''' 12:00pm to 1:00pm 
'''Afternoon:''' Setup from 12:30pm for those arriving only for the afternoon. Be ready to start at 1 pm sharp.

'''Evening social event:''' 5:00 pm (approximately) 
: At the end of the day, the workshop will morph into an informal EO2023 social event. The HackerSpace is very close to several pubs and a good variety of restaurants. Depending on numbers and preferences, we can have food / drinks at the HackerSpace or move to a local venue.

== Workshop materials ==

* '''[[SwagBadge2022_Installation|SwagBadge2022 installation instructions]]'''

: ESP32 development board with color LCD screen, touch sliders, SAO / Rockling connectors

* '''[[Rocking_FPGA_SAO_Installation|Rockling FPGA SAO installation instructions]]'''

: Lattice iCE40 UP5K FPGA with STGL-5000 Audio Codec and Theremin input

=== Bonus: Distributed, embedded system using MQTT as the transport ===

* '''[https://github.com/geekscape/aiko_services Aiko Services GitHub repository]'''

: Distributed service framework using asynchronous messages supporting AIoT, Machine Learning, Robotics and Video

: Host-side software for the SwagBadges (and lots more)

== Useful resources ==

=== SwagBadge / microPython ===

Many of these resources are for the OHMC2021 version of the SwagBadge, but the hardware (except for the LCD screen) is functionally very similar so large parts are still relevant.

* [[SwagBadge2021|SwagBadge2021 for LCA2021 OHMC]]: Overview page for the 2021 badge.
* [[Swagbadge2021_Newcomers|SwagBadge2021 Newcomers Guide]]: Basic information aimed at those without much prior electronics experience.
* [[Swagbadge2021_GettingStarted|SwagBadge2021 GettingStarted]]: First steps to connecting your SwagBadge to a network.
* [[Swagbadge2021_SoftwareDev|SoftwareDev]]: Badge Software Development.
* [[Swagbadge2021_MQTT|MQTT]]: Talking via MQTT.
* [[Swagbadge2021_SAO|SAO development]]: How to make your own Simple Add-On for the badge.
* [[Swagbadge2021_Dagbadge|DagBadge]]: build your own badge using readily available parts.
* [[Swagbadge2021_community|SwagBadge2021 Community]]: See what others have made with the 2021 and 2022 SwagBadges and SAOs.

=== Rockling / UP5K FPGA ===

* Tim Ansell's FOMU FPGA workshop: [https://workshop.fomu.im/en/latest/ workshop.fomu.im/en/latest]
* Use ChatGPT with prompts to write Verilog to create FPGA gateware !
* Use ChatGPT with prompts to write migen (Python) to create FPGA gateware !
* Use ChatGPT with prompts to write LiteX (Python) to create complete System On Chip (SoC) !

== Project technical support ==

'''GitLab Discussions:''' [https://github.com/OpenHardwareConf/LCA2022/discussions https://github.com/OpenHardwareConf/LCA2022/discussions]

: Best for longer discussions or reporting a technical issue ... very similar to forums

'''[https://matrix.org Matrix Secure Instant Messaging]:''' Channel (Room): OpenHWConf (#openhwconf:matrix.org)

: Best for interactive discussions with whomever is on-line.
: Suggested client [https://matrix.org/clients Element (desktop, Android and iOS versions)]

OHMC2023

2023-03-12T20:03:41Z

Geekscape: /* Rockling / UP5K FPGA */

== EO2023 Open Hardware Workshop location ==

'''Monday, 13th March 2023''' at the [https://www.hackmelbourne.org Connected Community HackerSpace] 
'''Address:''' 5 Kent Lane, Hawthorn, Victoria. ''Note: Kent Lane, not Kent Street'' 
'''Parking:''' [https://goo.gl/maps/c99ByYTS1EMZDKLT6 Hawthorn Town Hall car park] (free for 2 hours or outside of business hours, $6.50 for 8 hours during business hours) 
'''Public transport:'''

: The HackerSpace is a two minute walk from the Glenferrie train station. From the Flinders Street train station in the city, use the
: Lilydale / Ringwood / Belgrave train line: 15 minutes / 5 stops direct or 20 minutes / 8 stops via the City Loop ... and double-check
: that you haven't caught an express train that skips Glenferrie (there is an express train to Box Hill, avoid this!). There are many good
: lunch and dinner options nearby.

'''Breakfast / Lunch / Dinner options:'''

: Nearby Glenferrie Road (3 minutes walk) is the beating heart of Hawthorn with a broad range of restaurants, cafes, take-away, supermarkets, etc. There are several good pubs close by and a rooftop bar. Whilst it is a public holiday on Monday in Victoria, there should still be a good selection of places open ... perhaps some may shut, but it'll be a good day for them to be doing business.
: The HackerSpace has a microwave, kettle, drinks fridge and snacks. Along with a very small sink area. It is basic, but some very modest self-catering is possible !

== Workshop sessions ==

: The workshop is a full day of project activities for both the SwagBadge 2022 (based on microPython) and the FPGA Rockling hardware.
: It is highly recommended to be there for both the morning and afternoon sessions, there is a lot to cover and do.
: However for interstate travellers, we will start the afternoon session with a brief recap to get you up-to-speed.
: Interested EO2023 attendees who didn't order the LCA2022 hardware kit are welcome to join us and check things out.

'''Morning:''' Setup from 9:00am. Be ready to start at 10am sharp 
'''Lunch:''' 12:00pm to 1:00pm 
'''Afternoon:''' Setup from 12:30pm for those arriving only for the afternoon. Be ready to start at 1 pm sharp.

'''Evening social event:''' 5:00 pm (approximately) 
: At the end of the day, the workshop will morph into an informal EO2023 social event. The HackerSpace is very close to several pubs and a good variety of restaurants. Depending on numbers and preferences, we can have food / drinks at the HackerSpace or move to a local venue.

== Workshop materials ==

* '''[[SwagBadge2022_Installation|SwagBadge2022 installation instructions]]'''

: ESP32 development board with color LCD screen, touch sliders, SAO / Rockling connectors

* '''[[Rocking_FPGA_SAO_Installation|Rockling FPGA SAO installation instructions]]'''

: Lattice iCE40 UP5K FPGA with STGL-5000 Audio Codec and Theremin input

== Useful resources ==

=== SwagBadge / microPython ===

Many of these resources are for the OHMC2021 version of the SwagBadge, but the hardware (except for the LCD screen) is functionally very similar so large parts are still relevant.

* [[SwagBadge2021|SwagBadge2021 for LCA2021 OHMC]]: Overview page for the 2021 badge.
* [[Swagbadge2021_Newcomers|SwagBadge2021 Newcomers Guide]]: Basic information aimed at those without much prior electronics experience.
* [[Swagbadge2021_GettingStarted|SwagBadge2021 GettingStarted]]: First steps to connecting your SwagBadge to a network.
* [[Swagbadge2021_SoftwareDev|SoftwareDev]]: Badge Software Development.
* [[Swagbadge2021_MQTT|MQTT]]: Talking via MQTT.
* [[Swagbadge2021_SAO|SAO development]]: How to make your own Simple Add-On for the badge.
* [[Swagbadge2021_Dagbadge|DagBadge]]: build your own badge using readily available parts.
* [[Swagbadge2021_community|SwagBadge2021 Community]]: See what others have made with the 2021 and 2022 SwagBadges and SAOs.

=== Rockling / UP5K FPGA ===

* Tim Ansell's FOMU FPGA workshop: [https://workshop.fomu.im/en/latest/ workshop.fomu.im/en/latest]
* Use ChatGPT with prompts to write Verilog to create FPGA gateware !
* Use ChatGPT with prompts to write migen (Python) to create FPGA gateware !
* Use ChatGPT with prompts to write LiteX (Python) to create complete System On Chip (SoC) !

== Project technical support ==

'''GitLab Discussions:''' [https://github.com/OpenHardwareConf/LCA2022/discussions https://github.com/OpenHardwareConf/LCA2022/discussions]

: Best for longer discussions or reporting a technical issue ... very similar to forums

'''[https://matrix.org Matrix Secure Instant Messaging]:''' Channel (Room): OpenHWConf (#openhwconf:matrix.org)

: Best for interactive discussions with whomever is on-line.
: Suggested client [https://matrix.org/clients Element (desktop, Android and iOS versions)]

Rocking FPGA SAO Installation

2023-03-12T20:00:43Z

Geekscape:

= Overview =

'''GitHub repository:''' [https://github.com/geekscape/ohmc2022-firmware https://github.com/geekscape/ohmc2022-firmware]

This project utilizes the excellent prior work from the [https://workshop.fomu.im/en/latest FOMU FPGA] project ... with substantial addition work by [https://github.com/andykitchen/ohmc2022-firmware Andy Kitchen].

FPGA gateware and firmware for the Rockling FPGA SAO (''codec'' branch) currently supports the Theremin input (dual input frequency counters), the FPGA running a soft RISC-V processor and hardware peripherals. However, the STGL-5000 audio codec IC integration is still a work-in-progress.

= Set-up USB hot-plug UDEV rules (for Linux only) =

When the Rockling is connected to the computer's USB port, the dynamically created device file <code>/dev/bus/usb/001/...</code> will need to have the correct permissions set by the UDEV rules.

From [https://workshop.fomu.im/en/latest/requirements/drivers.html FOMU workshop instructions]

sudo groupadd plugdev
sudo usermod -a -G plugdev $USER

Log out and log in again

sudo bash
vi /etc/group # Add users to "plugdev:x:46:$USER"
vi /etc/udev/rules.d/99-fomu.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="1209", ATTRS{idProduct}=="5bf0", MODE="0664", GROUP="plugdev"
udevadm control --reload-rules
udevadm trigger

= Install DFU utility for flashing FPGA gateware (bitstream) =

sudo apt-get install dfu-util # Avoid using FOMU ToolChain version
dfu-util -l # Version 0.11

= Install build tools =

sudo apt-get update
sudo apt-get install python3-venv
sudo apt-get install meson # ninja-build

= Download YoSYS FPGA EDA tools from https://github.com/YosysHQ =

OS_TYPE=linux # or darwin or windows
wget https://github.com/YosysHQ/oss-cad-suite-build/releases/download/2021-05-29/oss-cad-suite-$OS-x64-20210529.tgz
tar -zxpf oss-cad-suite-$OS-x64-20210529.tgz
mv oss-cad-suite-$OS-x64 oss-cad-suite

= Download FOMU development tool chain, includes RISC-V cross-compiling toolchain =

wget https://github.com/im-tomu/fomu-toolchain/releases/download/v1.6/fomu-toolchain-linux_x86_64-v1.6.tar.gz
tar -zxpf ../fomu-toolchain-linux_x86_64-v1.6.tar.gz

= Download and install FPGA development software =

git clone https://github.com/geekscape/ohmc2022-firmware.git --branch codec
cd ohmc2022-firmware
git submodule update --init --recursive

Create and prepare virtual environment

rm -rf venv
./setup-venv.sh # Doesn't work if "oss-cad-suite/environment" and $PATH already set-up

Everything above here needs to be done just once ... now set-up and ready to go !

= Build Rockling FPGA gateware and firmware =

source venv/bin/activate

cd ..
source oss-cad-suite/environment
cd -

export PATH=$HOME/play/fpga/fomu/fomu-toolchain-linux_x86_64-v1.6/bin:$PATH

make all BITSTREAM_FLAGS="--with-analyzer"
# python rockling.py

= Download FPGA gateware (bitstream) on to Rocking SAO =

Connect Rockling FPGA SAO to USB host port: Fish eye should be slowly pulsing with cyan color

/usr/bin/dfu-util -l

Fish eye will quickly pulse with green color

/usr/bin/dfu-util -D build/rockling/gateware/rockling.bin

Upon success fish eye will quickly pulse with white color or upon failure quickly pulse with red color

Rockling should be now running the RISC-V processor with firmware running on top of that

= Test to see correct firmware "debug_status" =

riscv64-unknown-elf-readelf -s build/rockling/software/bios/bios.elf | egrep '(debug_status|global_counter)'
wishbone-tool 0x01000010
INFO [wishbone_tool::bridge::usb] opened USB device device 120 on bus 001
Value at 01000010: a0110060 # I2C DAC and Audio Codec found
Value at 01000010: a011ffff # Error: Only I2C Audio Codec found
Value at 01000010: ffff0060 # Error: I2C DAC found
Value at 01000010: ffffffff # Error: I2C no devices found

= Test using wishbone bus via shell commands =

Will show what I2C peripherals are available on I2C bus 1 ... Audio Codec and DAC

python tools/i2c_probe.sh

= Test reading Theremin dual input frequency counting via Python script =

wishbone-tool --server=wishbone # terminal session 1
python tools/read_freq.py # terminal session 2

= Reset (reboot) Rockling FPGA =

Run this script or sometimes need to power cycle the hardware

./tools/reboot.sh

Rocking FPGA SAO Installation

2023-03-12T19:58:01Z

Geekscape:

Rocking FPGA SAO Installation

2023-03-12T19:52:29Z

Geekscape:

= Overview =

'''GitHub repository:''' [https://github.com/geekscape/ohmc2022-firmware https://github.com/geekscape/ohmc2022-firmware]

This project utilizes the excellent prior work from the [https://workshop.fomu.im/en/latest FOMU FPGA] project ... with substantial addition work by [https://github.com/andykitchen/ohmc2022-firmware Andy Kitchen].

FPGA gateware and firmware for the Rockling FPGA SAO (''codec'' branch) currently supports the Theremin input (dual input frequency counters), the FPGA running a soft RISC-V processor and hardware peripherals. However, the STGL-5000 audio codec IC integration is still a work-in-progress.

= Set-up USB hot-plug UDEV rules (for Linux only) =

When the Rockling is connected to the computer's USB port, the dynamically created device file <code>/dev/bus/usb/001/...</code> will need to have the correct permissions set by the UDEV rules.

From [https://workshop.fomu.im/en/latest/requirements/drivers.html FOMU workshop instructions]

sudo groupadd plugdev
sudo usermod -a -G plugdev $USER

Log out and log in again

sudo bash
vi /etc/group # Add users to "plugdev:x:46:$USER"
vi /etc/udev/rules.d/99-fomu.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="1209", ATTRS{idProduct}=="5bf0", MODE="0664", GROUP="plugdev"
udevadm control --reload-rules
udevadm trigger

= Install DFU utility for flashing FPGA gateware (bitstream) =

sudo apt-get install dfu-util # Avoid using FOMU ToolChain version
dfu-util -l # Version 0.11

= Install build tools =

sudo apt-get update
sudo apt-get install python3-venv
sudo apt-get install meson # ninja-build

= Download FOMU development tool chain, includes RISC-V cross-compiling toolchain =

wget https://github.com/im-tomu/fomu-toolchain/releases/download/v1.6/fomu-toolchain-linux_x86_64-v1.6.tar.gz
tar -zxpf ../fomu-toolchain-linux_x86_64-v1.6.tar.gz

= Download and install FPGA development software =

git clone https://github.com/geekscape/ohmc2022-firmware.git --branch codec
cd ohmc2022-firmware
git submodule update --init --recursive

Create and prepare virtual environment

rm -rf venv
./setup-venv.sh # Doesn't work if "oss-cad-suite/environment" and $PATH already set-up

Everything above here needs to be done just once ... now set-up and ready to go !

= Build Rockling FPGA gateware and firmware =

source venv/bin/activate

cd ..
source oss-cad-suite/environment
cd -

export PATH=$HOME/play/fpga/fomu/fomu-toolchain-linux_x86_64-v1.6/bin:$PATH

make all BITSTREAM_FLAGS="--with-analyzer"
# python rockling.py

= Download FPGA gateware (bitstream) on to Rocking SAO =

Connect Rockling FPGA SAO to USB host port: Fish eye should be slowly pulsing with cyan color

/usr/bin/dfu-util -l

Fish eye will quickly pulse with green color

/usr/bin/dfu-util -D build/rockling/gateware/rockling.bin

Upon success fish eye will quickly pulse with white color or upon failure quickly pulse with red color

Rockling should be now running the RISC-V processor with firmware running on top of that

= Test to see correct firmware "debug_status" =

riscv64-unknown-elf-readelf -s build/rockling/software/bios/bios.elf | egrep '(debug_status|global_counter)'
wishbone-tool 0x01000010
INFO [wishbone_tool::bridge::usb] opened USB device device 120 on bus 001
Value at 01000010: a0110060 # I2C DAC and Audio Codec found
Value at 01000010: a011ffff # Error: Only I2C Audio Codec found
Value at 01000010: ffff0060 # Error: I2C DAC found
Value at 01000010: ffffffff # Error: I2C no devices found

= Test using wishbone bus via shell commands =

Will show what I2C peripherals are available on I2C bus 1 ... Audio Codec and DAC

python tools/i2c_probe.sh

= Test reading Theremin dual input frequency counting via Python script =

wishbone-tool --server=wishbone # terminal session 1
python tools/read_freq.py # terminal session 2

Rocking FPGA SAO Installation

2023-03-12T19:48:55Z

Geekscape:

= Overview =

'''GitHub repository:''' [https://github.com/geekscape/ohmc2022-firmware https://github.com/geekscape/ohmc2022-firmware]

This project utilizes the excellent prior work from the [https://workshop.fomu.im/en/latest FOMU FPGA] project ... with substantial addition work by [https://github.com/andykitchen/ohmc2022-firmware Andy Kitchen].

FPGA gateware and firmware for the Rockling FPGA SAO (''codec'' branch) currently supports the Theremin input (dual input frequency counters), the FPGA running a soft RISC-V processor and hardware peripherals. However, the STGL-5000 audio codec IC integration is still a work-in-progress.

= Set-up USB hot-plug UDEV rules (for Linux only) =

When the Rockling is connected to the computer's USB port, the dynamically created device file <code>/dev/bus/usb/001/...</code> will need to have the correct permissions set by the UDEV rules.

From [https://workshop.fomu.im/en/latest/requirements/drivers.html FOMU workshop instructions]

sudo groupadd plugdev
sudo usermod -a -G plugdev $USER

Log out and log in again

sudo bash
vi /etc/group # Add users to "plugdev:x:46:$USER"
vi /etc/udev/rules.d/99-fomu.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="1209", ATTRS{idProduct}=="5bf0", MODE="0664", GROUP="plugdev"
udevadm control --reload-rules
udevadm trigger

= Install DFU utility for flashing FPGA gateware (bitstream) =

sudo apt-get install dfu-util # Avoid using FOMU ToolChain version
dfu-util -l # Version 0.11

= Install build tools =

sudo apt-get update
sudo apt-get install python3-venv
sudo apt-get install meson # ninja-build

= Download and install FPGA development software =

git clone https://github.com/geekscape/ohmc2022-firmware.git --branch codec
cd ohmc2022-firmware
git submodule update --init --recursive

Create and prepare virtual environment

rm -rf venv
./setup-venv.sh # Doesn't work if "oss-cad-suite/environment" and $PATH already set-up

Everything above here needs to be done just once ... now set-up and ready to go !

= Build Rockling FPGA gateware and firmware =

source venv/bin/activate

cd ..
source oss-cad-suite/environment
cd -

export PATH=$HOME/play/fpga/fomu/fomu-toolchain-linux_x86_64-v1.6/bin:$PATH

make all BITSTREAM_FLAGS="--with-analyzer"
# python rockling.py

= Download FPGA gateware (bitstream) on to Rocking SAO =

Connect Rockling FPGA SAO to USB host port: Fish eye should be slowly pulsing with cyan color

/usr/bin/dfu-util -l

Fish eye will quickly pulse with green color

/usr/bin/dfu-util -D build/rockling/gateware/rockling.bin

Upon success fish eye will quickly pulse with white color or upon failure quickly pulse with red color

Rockling should be now running the RISC-V processor with firmware running on top of that

= Test to see correct firmware "debug_status" =

riscv64-unknown-elf-readelf -s build/rockling/software/bios/bios.elf | egrep '(debug_status|global_counter)'
wishbone-tool 0x01000010
INFO [wishbone_tool::bridge::usb] opened USB device device 120 on bus 001
Value at 01000010: a0110060 # I2C DAC and Audio Codec found
Value at 01000010: a011ffff # Error: Only I2C Audio Codec found
Value at 01000010: ffff0060 # Error: I2C DAC found
Value at 01000010: ffffffff # Error: I2C no devices found

= Test using wishbone bus via shell commands =

Will show what I2C peripherals are available on I2C bus 1 ... Audio Codec and DAC

python tools/i2c_probe.sh

= Test reading Theremin dual input frequency counting via Python script =

wishbone-tool --server=wishbone # terminal session 1
python tools/read_freq.py # terminal session 2

Rocking FPGA SAO Installation

2023-03-12T19:48:12Z

Geekscape:

= Overview =

'''GitHub repository:''' [https://github.com/geekscape/ohmc2022-firmware https://github.com/geekscape/ohmc2022-firmware]

This project utilizes the excellent prior work from the [https://workshop.fomu.im/en/latest FOMU FPGA] project ... with substantial addition work by [https://github.com/andykitchen/ohmc2022-firmware Andy Kitchen].

FPGA gateware and firmware for the Rockling FPGA SAO (''codec'' branch) currently supports the Theremin input (dual input frequency counters), the FPGA running a soft RISC-V processor and hardware peripherals. However, the STGL-5000 audio codec IC integration is still a work-in-progress.

= Set-up USB hot-plug UDEV rules (for Linux only) =

When the Rockling is connected to the computer's USB port, the dynamically created device file <code>/dev/bus/usb/001/...</code> will need to have the correct permissions set by the UDEV rules.

From [https://workshop.fomu.im/en/latest/requirements/drivers.html FOMU workshop instructions]

sudo groupadd plugdev
sudo usermod -a -G plugdev $USER

Log out and log in again

sudo bash
vi /etc/group # Add users to "plugdev:x:46:$USER"
vi /etc/udev/rules.d/99-fomu.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="1209", ATTRS{idProduct}=="5bf0", MODE="0664", GROUP="plugdev"
udevadm control --reload-rules
udevadm trigger

= Install DFU utility for flashing FPGA gateware (bitstream) =

sudo apt-get install dfu-util # Avoid using FOMU ToolChain version
dfu-util -l # Version 0.11

= Install build tools =

sudo apt-get update
sudo apt-get install python3-venv
sudo apt-get install meson # ninja-build

= Download and install FPGA development software =

git clone https://github.com/geekscape/ohmc2022-firmware.git --branch codec
cd ohmc2022-firmware
git submodule update --init --recursive

Create and prepare virtual environment

rm -rf venv
./setup-venv.sh # Doesn't work if "oss-cad-suite/environment" and $PATH already set-up

Everything above here needs to be done just once ... now set-up and ready to go !

= Build Rockling FPGA gateware and firmware =

source venv/bin/activate

cd ..
source oss-cad-suite/environment
cd -

export PATH=$HOME/play/fpga/fomu/fomu-toolchain-linux_x86_64-v1.6/bin:$PATH

make all BITSTREAM_FLAGS="--with-analyzer"
# python rockling.py

= Download FPGA gateware (bitstream) on to Rocking SAO =

Connect Rockling FPGA SAO to USB host port: Fish eye should be slowly pulsing with cyan color

/usr/bin/dfu-util -l

Fish eye will quickly pulse with green color

/usr/bin/dfu-util -D build/rockling/gateware/rockling.bin

Upon success fish eye will quickly pulse with white color or upon failure quickly pulse with red color

Rockling should be now running the RISC-V processor with firmware running on top of that

= Test to see correct firmware "debug_status" =

riscv64-unknown-elf-readelf -s build/rockling/software/bios/bios.elf | egrep '(debug_status|global_counter)'
wishbone-tool 0x01000010
INFO [wishbone_tool::bridge::usb] opened USB device device 120 on bus 001
Value at 01000010: a0110060 # I2C DAC and Audio Codec found
Value at 01000010: a011ffff # Error: Only I2C Audio Codec found
Value at 01000010: ffff0060 # Error: I2C DAC found
Value at 01000010: ffffffff # Error: I2C no devices found

= Test using wishbone bus via shell commands =

Will show what I2C peripherals are available on I2C bus 1 ... Audio Codec and DAC

python tools/i2c_probe.sh

= Test reading Theremin dual input frequency counting

wishbone-tool --server=wishbone # terminal session 1
python tools/read_freq.py # terminal session 2

2023-03-12T01:40:02Z

Geekscape:

OHMC2023

2023-03-07T02:30:32Z

Geekscape:

== EO2023 Open Hardware Workshop details ==

'''Monday, 13th March 2023''' at the [https://www.hackmelbourne.org Connected Community HackerSpace] 
'''Address:''' 5 Kent Lane, Hawthorn, Victoria. ''Note: Kent Lane, not Kent Street'' 
'''Parking:''' [https://goo.gl/maps/c99ByYTS1EMZDKLT6 Hawthorn Town Hall car park] (free for 2 hours or outside of business hours, $6.50 for 8 hours during business hours) 
'''Morning session:''' From 9:00 am to 9:30 am (set-up), 10 am sharp (start) 
'''Afternoon session:''' 12:30 pm (set-up), 1 pm sharp (start)

: The HackerSpace is a two minute walk from the Glenferrie train station. From the Flinders Street train station in the city, use the Lilydale / Ringwood / Belgrave train line: 15 minutes / 5 stops direct or 20 minutes / 8 stops via the City Loop ... and double-check that you haven't caught an express train that skips Glenferrie (there is an express train to Box Hill, avoid !). There are many good lunch and dinner options near by.

: The workshop is a full day of project activities for both the SwagBadge 2022 (based on microPython) and the FPGA Rockling hardware.

: It is highly recommended to be there for both the morning and afternoon sessions, there is a lot to cover and do.
: However for interstate travellers, we will start the afternoon session with a brief recap to get you up-to-speed.
: Interested EO2023 attendees who didn't order the LCA2022 hardware kit are welcome to join us and check things out

'''Social event:''' 5:00 pm (approximately)

: At the end of the day, the workshop will morph into an informal EO2023 social event. The HackerSpace is very close to several pubs and a good variety of restaurants. Depending on numbers and preferences, we can have food / drinks at the HackerSpace or move to a local venue.

== Project technical support ==

'''GitLab Discussions:''' [https://github.com/OpenHardwareConf/LCA2022/discussions https://github.com/OpenHardwareConf/LCA2022/discussions]

: Best for longer discussions or reporting a technical issue ... very similar to forums

'''[https://matrix.org Matrix Secure Instant Messaging]:''' Channel (Room): OpenHWConf (#openhwconf:matrix.org)

: Best for interactive discussions with whomever is on-line.
: Suggested client [https://matrix.org/clients Element (desktop, Android and iOS versions)]

== Project software ==

'''Aiko Engine:''' [https://github.com/geekscape/aiko_engine_mp https://github.com/geekscape/aiko_engine_mp]

: MicroPython Firmware for the SwagBadge 2021 and SwagBadge 2022

'''FPGA Rockling:''' (URL to be provided)

: Gateware for Lattice iCE40 UP5K FPGA with STGL-5000 Audio Codec and Theremin input

OHMC2023

2023-03-07T02:16:26Z

2022-01-08T08:27:37Z

Geekscape: