first building but not running state of C Pico SDK version

.gitignore

@@ -1,2 +1,9 @@
 web-app/*.js
+web-app/*/*.js
 __pycache__
+build
+build_debug
+*.stl
+*.sl1
+*.wow
+.directory

.gitmodules

@@ -0,0 +1,12 @@
+[submodule "pico-sdk"]
+	path = pico-sdk
+	url = https://github.com/raspberrypi/pico-sdk
+[submodule "fatfs"]
+	path = fatfs
+	url = https://github.com/abbrev/fatfs
+[submodule "mcufont"]
+	path = mcufont
+	url = https://github.com/mcufont/mcufont
+[submodule "st7789"]
+	path = st7789
+	url = https://github.com/hepingood/st7789

CMakeLists.txt

@@ -0,0 +1,112 @@
+cmake_minimum_required(VERSION 3.13)
+
+# build MCUFont encoder host tool and convert included example fonts
+execute_process(COMMAND make
+    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/mcufont/encoder
+)
+execute_process(COMMAND make
+    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/mcufont/fonts
+)
+
+# initialize pico-sdk from submodule
+include(pico-sdk/pico_sdk_init.cmake)
+
+project(gadget C CXX)
+set(CMAKE_C_STANDARD 11)
+set(CMAKE_CXX_STANDARD 17)
+
+# initialize the Raspberry Pi Pico SDK
+pico_sdk_init()
+
+# copy FatFS source files to build dir, so we can use our own ffconf.h
+configure_file(
+    ${CMAKE_CURRENT_SOURCE_DIR}/fatfs/source/ff.c
+    ${CMAKE_CURRENT_BINARY_DIR}/fatfs/ff.c
+    COPYONLY
+)
+configure_file(
+    ${CMAKE_CURRENT_SOURCE_DIR}/fatfs/source/ff.h
+    ${CMAKE_CURRENT_BINARY_DIR}/fatfs/ff.h
+    COPYONLY
+)
+configure_file(
+    ${CMAKE_CURRENT_SOURCE_DIR}/fatfs/source/diskio.h
+    ${CMAKE_CURRENT_BINARY_DIR}/fatfs/diskio.h
+    COPYONLY
+)
+configure_file(
+    ${CMAKE_CURRENT_SOURCE_DIR}/fatfs/source/ffunicode.c
+    ${CMAKE_CURRENT_BINARY_DIR}/fatfs/ffunicode.c
+    COPYONLY
+)
+
+add_executable(gadget)
+
+target_sources(gadget PUBLIC
+    src/main.c
+    src/console.c
+    src/log.c
+    src/util.c
+    src/usb.c
+    src/usb_cdc.c
+    src/usb_descriptors.c
+    src/usb_msc.c
+    src/fat_disk.c
+    src/debug.c
+    src/buttons.c
+
+    ${CMAKE_CURRENT_BINARY_DIR}/fatfs/ff.c
+    ${CMAKE_CURRENT_BINARY_DIR}/fatfs/ffunicode.c
+
+    st7789/src/driver_st7789.c
+
+    mcufont/decoder/mf_encoding.c
+    mcufont/decoder/mf_font.c
+    mcufont/decoder/mf_justify.c
+    mcufont/decoder/mf_kerning.c
+    mcufont/decoder/mf_rlefont.c
+    mcufont/decoder/mf_bwfont.c
+    mcufont/decoder/mf_scaledfont.c
+    mcufont/decoder/mf_wordwrap.c
+)
+
+# external dependency include directories
+target_include_directories(gadget PUBLIC ${CMAKE_CURRENT_LIST_DIR}/include)
+target_include_directories(gadget PUBLIC ${CMAKE_CURRENT_BINARY_DIR}/fatfs)
+target_include_directories(gadget PUBLIC ${CMAKE_CURRENT_LIST_DIR}/st7789/src)
+target_include_directories(gadget PUBLIC ${CMAKE_CURRENT_LIST_DIR}/mcufont/decoder)
+target_include_directories(gadget PUBLIC ${CMAKE_CURRENT_LIST_DIR}/mcufont/fonts)
+
+# enable generous warnings
+target_compile_options(gadget PUBLIC
+    -Wall
+    -Wextra
+    -Werror
+)
+
+# suppress some warnings for borked 3rd party files in Pico SDK
+set_source_files_properties(pico-sdk/lib/btstack/src/ble/sm.c PROPERTIES COMPILE_FLAGS -Wno-unused-parameter)
+set_source_files_properties(pico-sdk/lib/btstack/src/btstack_hid_parser.c PROPERTIES COMPILE_FLAGS -Wno-maybe-uninitialized)
+set_source_files_properties(pico-sdk/src/rp2_common/pico_cyw43_driver/cyw43_driver.c PROPERTIES COMPILE_FLAGS -Wno-unused-parameter)
+
+# pull in common dependencies
+target_link_libraries(gadget
+    pico_stdlib
+    pico_unique_id
+    tinyusb_device
+    tinyusb_board
+    hardware_spi
+    pico_btstack_ble
+    pico_btstack_cyw43
+    pico_cyw43_arch_none
+)
+
+target_compile_definitions(gadget PUBLIC
+    RUNNING_AS_CLIENT=1
+)
+
+# fix for Errata RP2040-E5 (the fix requires use of GPIO 15)
+target_compile_definitions(gadget PUBLIC PICO_RP2040_USB_DEVICE_ENUMERATION_FIX=1)
+
+# create map/bin/hex/uf2 file etc.
+pico_add_extra_outputs(gadget)

README.md

@@ -1,12 +1,115 @@
 # Pi Pico Volcano Remote Control Gadget
 
-https://www.waveshare.com/wiki/Pico-LCD-1.3
+For use with Raspberry Pi Pico W boards with the [Waveshare Pico LCD 1.3](https://www.waveshare.com/wiki/Pico-LCD-1.3) and the [Pimoroni Pico Lipo Shim](https://shop.pimoroni.com/products/pico-lipo-shim).
 
-https://shop.pimoroni.com/products/pico-lipo-shim
+Adapted from the [tinyusb-cdc-example](https://github.com/hathach/tinyusb/blob/master/examples/device/cdc_msc/src/main.c).
+
+TODO other examples used
+
+## Quick Start
+
+When compiling for the first time, check out the required git submodules.
+
+    git submodule update --init
+    cd pico-sdk
+    git submodule update --init
+
+Then do this to build.
+
+    mkdir build
+    cd build
+    cmake -DPICO_BOARD=pico_w ..
+    make -j4 gadget
+
+And flash the resulting `gadget.uf2` file to your Pico as usual.
+
+For convenience you can use the included `flash.sh`, as long as you flashed the binary manually once before.
+
+    make -j4 gadget
+    ../flash.sh gadget.uf2
+
+This will use the mass storage bootloader to upload a new uf2 image.
+
+For old-school debugging a serial port will be presented by the firmware.
+Open it using eg. `picocom`, or with the included `debug.sh` script.
+
+For dependencies to compile, on Arch install these.
+
+    sudo pacman -S arm-none-eabi-gcc arm-none-eabi-newlib picocom cmake
+
+## Proper Debugging
+
+You can also use the SWD interface for proper hardware debugging.
+
+This follows the instructions from the [RP2040 Getting Started document](https://datasheets.raspberrypi.com/pico/getting-started-with-pico.pdf) from chapter 5 and 6.
+
+For ease of reading the disassembly, create a debug build.
+
+    mkdir build_debug
+    cd build_debug
+    cmake -DPICO_BOARD=pico_w -DCMAKE_BUILD_TYPE=Debug ..
+    make -j4 gadget
+
+You need a hardware SWD probe.
+This can be made from another Pico, see Appendix A in the document linked above.
+For this you need to compile the `picoprobe` firmware, like this.
+
+    git clone https://github.com/raspberrypi/picoprobe.git
+    cd picoprobe
+    git submodule update --init
+    mkdir build
+    cd build
+    PICO_SDK_PATH=../../../pico-sdk cmake ..
+    make -j4
+
+And flash the resulting `picoprobe.uf2` to your probe.
+Connect `GP2` of the probe to `SWCLK` of the target and `GP3` of the probe to `SWDIO` of the target.
+Of course you also need to connect GND between both.
+
+You need some dependencies, mainly `gdb-multiarch` and the RP2040 fork of `OpenOCD`.
+
+    sudo apt install gdb-multiarch   # Debian / Ubuntu
+    sudo pacman -S arm-none-eabi-gdb # Arch Linux
+
+    cd ../.. # back to build_debug directory from before
+
+    git clone https://github.com/raspberrypi/openocd.git --branch rp2040 --recursive --depth=1
+    cd openocd
+
+    # install udev rules
+    sudo cp contrib/60-openocd.rules /etc/udev/rules.d
+    sudo udevadm control --reload-rules && sudo udevadm trigger
+
+    ./bootstrap
+    ./configure --enable-ftdi --enable-sysfsgpio --enable-bcm2835gpio
+    make -j4
+
+Now we can flash a firmware image via OpenOCD.
+
+    ./openocd/src/openocd -s openocd/tcl -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000" -c "cmsis_dap_vid_pid 0x2e8a 0x000c" -c "program gadget.elf verify reset exit"
+
+And also start a GDB debugging session.
+
+    ./openocd/src/openocd -s openocd/tcl -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000" -c "cmsis_dap_vid_pid 0x2e8a 0x000c"
+    arm-none-eabi-gdb gadget.elf
+    target extended-remote localhost:3333
+
+These commands have also been put in the `flash_swd.sh` and `debug_swd.sh` scripts, respectively.
+Call them from the `build_debug` folder where you checked out and built OpenOCD.
 
 ## License
 
-This project is licensed as GPLv3.
+The firmware itself is licensed as GPLv3.
+I initially adapted it from my own [Trackball](https://git.xythobuz.de/thomas/Trackball) project.
+It uses the [Pi Pico SDK](https://github.com/raspberrypi/pico-sdk), licensed as BSD 3-clause, and therefore also [TinyUSB](https://github.com/hathach/tinyusb), licensed under the MIT license.
+Some code is adapted from the TinyUSB examples.
+And the project uses the [FatFS library](https://github.com/abbrev/fatfs), licensed as BSD 1-clause.
+Also included are the [MCUFont library](https://github.com/mcufont/mcufont) and the [st7789 library](https://github.com/hepingood/st7789), both licensed under the MIT license.
+It also uses the [BTstack](https://github.com/bluekitchen/btstack/blob/master/LICENSE) included with the Pico SDK, following their [license terms](https://github.com/raspberrypi/pico-sdk/blob/master/src/rp2_common/pico_btstack/LICENSE.RP).
+
+The case design is also licensed as GPLv3.
+It uses a [Pi Pico case model](https://www.printables.com/model/210898-raspberry-pi-pico-case) licensed as CC-BY-NC-SA.
+But this is only used for visualization purposes and doesn't influence the 3D model at all.
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by

case/case.scad

@@ -0,0 +1,33 @@
+// https://www.waveshare.com/wiki/Pico-LCD-1.3
+lcd_w = 52.0;
+lcd_h = 26.5;
+
+lcd_d = 1.0; // todo
+
+// https://www.printables.com/model/210898-raspberry-pi-pico-case
+use <pico_case.scad>
+p_w = 21;
+p_h = 51;
+p_t = 1.0;
+
+pico_header_h = 2.0; // todo
+lcd_header_h = 10.0; // todo
+
+header_h = pico_header_h + lcd_header_h;
+
+module lcd() {
+    color("blue")
+    translate([-lcd_h / 2, -lcd_w / 2, 0])
+    cube([lcd_h, lcd_w, lcd_d]);
+}
+
+module hw() {
+    translate([0, 0, header_h])
+    lcd();
+    
+    translate([p_w / 2, -p_h / 2, 0])
+    rotate([0, 180, 0])
+    pico();
+}
+
+hw();

case/pico_case.scad

@@ -0,0 +1,245 @@
+resolution = 20; //[10, 20, 30, 50, 100]
+$fn = resolution;
+
+show_frame = false; // [true, false]
+show_pico = true; // [true, false]
+show_lid = false; // [true, false]
+show_button = false; // [true, false]
+
+module rounded_plate(w, h, t, d) {
+    translate([0, (d/2), 0])
+    cube([w, (h-d), t]);
+    translate([(d/2), 0, 0])
+    cube([(w-d), h, t]);
+    translate([(d/2), (d/2), 0])
+    cylinder(h=t, d=d);
+    translate([w-(d/2), (d/2), 0])
+    cylinder(h=t, d=d);
+    translate([(d/2), h-(d/2), 0])
+    cylinder(h=t, d=d);
+    translate([w-(d/2), h-(d/2), 0])
+    cylinder(h=t, d=d);
+}
+
+module usb_port() {
+    translate([0.3, 0, 0])
+    color("grey")
+    difference() {
+        union() {
+            cube([7.4, 6, 2.7]);
+            translate([-0.3, 5.4, -0.1])
+            cube([8, 0.6, 2.9]);
+        }
+    }
+}
+
+module switch() {
+    color("grey")
+    cube([3.5, 4.5, 1]);
+    color("white")
+    translate([(3.5/2), (4.5/2), 0])
+    cylinder(h=1.5, d=3);
+}
+
+p_w = 21;
+p_h = 51;
+p_t = 1.0;
+os = 0.35;
+b = 2;
+
+module pico() {
+    translate([((p_w-8)/2), ((p_h+1.3)-6), p_t])
+    usb_port();
+
+    translate([5.25, 36.6, 0.6])
+    switch();
+
+    difference() {
+        color("green")
+        cube([p_w, p_h, 1]);
+
+        translate([((p_w/2)-5.7), 2, -0.01])
+        cylinder(h=p_t+0.02, d=2.1);
+       
+        translate([(p_w-((p_w/2)-5.7)), 2, -0.01])
+        cylinder(h=p_t+0.02, d=2.1);
+
+        translate([((p_w/2)-5.7), (p_h-2), -0.01])
+        cylinder(h=p_t+0.02, d=2.1);
+
+        translate([(p_w-((p_w/2)-5.7)), (p_h-2), -0.01])
+        cylinder(h=p_t+0.02, d=2.1);
+    }
+}
+
+if (show_pico) {
+    translate([(os+b), (os+b), 3.4])
+    pico();
+}
+
+if (show_frame) {
+    union() {
+        difference() {
+            // Outer frame
+            rounded_plate(p_w+(2*(os+b)), p_h+(2*(os+b)), 10, (2*(os+b)));
+            
+            // Board cut-out
+            translate([b, b, -1])
+            cube([p_w+(2*os), p_h+(2*os), 12]);
+            
+            // USB port cut-out
+//            translate([b+os+((p_w-10)/2), b+os+((p_h+1)-6), 3.4])
+//            cube([10, 8, 4.7]);
+            translate([b+os+((p_w-10)/2), b+(2*os)+p_h-1, 8.1])
+            rotate([-90, 0, 0])
+            rounded_plate(10, 4.7, 4.7, 2);
+            
+            // Lid release cut-out
+            difference() {
+                union() {
+                    translate([b+os+((p_w-10)/2), -1, 10-1])
+                    cube([10, 8, 2]);
+                    translate([b+os+((p_w-6)/2), -1, 10-1])
+                    rotate([-90, 0, 0])
+                    cylinder(h=4, d=2); 
+                    translate([b+os+((p_w-6)/2), -1, 10-2])
+                    cube([6, 8, 3]);
+                    translate([b+os+((p_w+6)/2), -1, 10-1])
+                    rotate([-90, 0, 0])
+                    cylinder(h=4, d=2); 
+                }
+                translate([b+os+((p_w+10)/2), -1, 10-1])
+                rotate([-90, 0, 0])
+                cylinder(h=4, d=2); 
+                translate([b+os+((p_w-10)/2), -1, 10-1])
+                rotate([-90, 0, 0])
+                cylinder(h=4, d=2); 
+            }
+            
+            // Outer frame
+            translate([1, 1, 10-1.2])
+            rounded_plate(p_w+(2*(os+b))-2, p_h+(2*(os+b))-2, 2, (2*(os+b))-2);
+
+            // Left top retainer cut-out
+            translate([b+os+(p_w/2)-(3.2/2)-7.1, b+p_h+(2*os), 10-3+0.2])
+            cube([3.2, 0.7, 1.0]);
+
+            // Right top retainer cut-out
+            translate([b+os+(p_w/2)-(3.2/2)+7.1, b+p_h+(2*os), 10-3+0.2])
+            cube([3.2, 0.7, 1.0]);
+
+            // Left bottom retainer cut-out
+            translate([b+os+(p_w/2)-(4/2)-7.1, b+os-0.7, 10-3+0.2])
+            cube([4, 0.7, 1.0]);
+
+            // Right bottom retainer cut-out
+            translate([b+os+(p_w/2)-(4/2)+7.1, b+os-0.7, 10-3+0.2])
+            cube([4, 0.7, 1.0]);
+
+            // Left retainer cut-out
+            translate([b-0.7, b+os+(p_h/2)-2, 10-3+0.2])
+            cube([0.7, 4, 1.0]);
+
+            // Right retainer cut-out
+            translate([b+(2*os)+p_w, b+os+(p_h/2)-2, 10-3+0.2])
+            cube([0.7, 4, 1.0]);
+        }
+        
+        // Left support rail
+        translate([b+os+(p_w/2)-(3/2)-5.5, 0, 0])
+        cube([3, p_h+(2*(os+b)), 3.4]);
+       
+        // Right support rail
+        translate([b+os+(p_w/2)-(3/2)+5.5, 0, 0])
+        cube([3, p_h+(2*(os+b)), 3.4]);
+
+        // Left top retainer
+        translate([b+os+(p_w/2)-(2.2/2)-6.1, b+p_h+(2*os)-0.6, 3.4+1+0.5])
+        cube([2.2, 0.6, 0.8]);
+
+        // Right top retainer
+        translate([b+os+(p_w/2)-(2.2/2)+6.1, b+p_h+(2*os)-0.6, 3.4+1+0.5])
+        cube([2.2, 0.6, 0.8]);
+
+        // Left bottom retainer
+        translate([b+os+(p_w/2)-(3/2)-5.7, b, 3.4+1+0.])
+        cube([3, 0.6, 0.8]);
+
+        // Right bottom retainer
+        translate([b+os+(p_w/2)-(3/2)+5.7, b, 3.4+1+0.5])
+        cube([3, 0.6, 0.8]);
+    }
+}
+
+if (show_lid) {
+    difference() {
+        union() {
+            translate([1+os, 1+os, 10-1.2])
+            rounded_plate(p_w+(2*b)-2, p_h+(2*b)-2, 1, (2*b)-2);
+            translate([(os+b), (os+b), 10-3])
+            rounded_plate(p_w, p_h, 2, (2*b)-3);
+            
+            // Left top retainer
+            translate([b+os+(p_w/2)-(2.2/2)-7.1, b+p_h+os, 10-3+0.4])
+            cube([2.2, 0.6, 0.6]);
+
+            // Right top retainer
+            translate([b+os+(p_w/2)-(2.2/2)+7.1, b+p_h+os, 10-3+0.4])
+            cube([2.2, 0.6, 0.6]);
+
+            // Left bottom retainer
+            translate([b+os+(p_w/2)-(3/2)-7.1, b+os-0.5, 10-3+0.3])
+            cube([3, 0.6, 0.6]);
+
+            // Right bottom retainer
+            translate([b+os+(p_w/2)-(3/2)+7.1, b+os-0.5, 10-3+0.3])
+            cube([3, 0.6, 0.6]);
+
+            // Left retainer
+            translate([b+os-0.6, b+os+(p_h/2)-1.5, 10-3+0.3])
+            cube([0.6, 3, 0.6]);            
+
+            // Right retainer
+            translate([b+os+p_w, b+os+(p_h/2)-1.5, 10-3+0.3])
+            cube([0.6, 3, 0.6]);            
+        }
+
+        // USB port cut-out
+        translate([b+os+((p_w-10)/2), b+p_h+(2*os)-2, 10-4.2])
+        cube([10, 8, 2.4]);
+
+        // Lid release cut-out
+        translate([b+os+((p_w-10)/2), -1, 10-4.2])
+        cube([10, 8, 3]);
+        
+        // Switch cut-out
+        translate([(os+b)+7, (os+b)+38.85, 0])
+        cylinder(h=10, d=5);
+        
+        // Inset
+        translate([(os+b)+1, (os+b)+1, 10-4])
+        cube([p_w-2, p_h-2, 3]);
+    }
+    // Switch surround
+    translate([(os+b), (os+b)+38.85-6, 10-2])
+    cube([p_w, 1, 1]);    
+
+    translate([(os+b), (os+b)+38.85+5, 10-2])
+    cube([p_w, 1, 1]);    
+
+}
+
+
+if (show_button) {
+    color("red")
+    union() {
+        translate([(os+b)+7, (os+b)+38.85, 7.5])
+        cylinder(h=2.3, d=4.4);
+        difference() {
+            translate([(os+b)+7, (os+b)+38.85, 6.5])
+            cylinder(h=2, d=7.6);
+            translate([(os+b)+7, (os+b)+38.85, 6.5])
+            cylinder(h=1, d=6.6);
+        }
+    }
+}

debug.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+set -euo pipefail
+
+SERIAL=/dev/serial/by-id/usb-xythobuz_Trackball_*
+
+echo -n Waiting for serial port to appear
+until [ -e $SERIAL ]
+do
+    echo -n .
+    sleep 1
+done
+echo
+
+echo Opening picocom terminal
+echo "[C-a] [C-x] to exit"
+echo
+
+picocom -q --omap crcrlf $SERIAL

debug_swd.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -euo pipefail
+
+echo Starting OpenOCD in background
+./openocd/src/openocd -s openocd/tcl -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000" -c "cmsis_dap_vid_pid 0x2e8a 0x000c" &
+OPENOCD_PID=$!
+
+# give OpenOCD some time to output stuff
+sleep 1
+
+echo -n Waiting for debugger to appear
+while ! netstat -tna | grep 'LISTEN\>' | grep -q ':3333\>'; do
+    echo -n .
+    sleep 1
+done
+
+echo Starting GDB
+arm-none-eabi-gdb -ex "set history save" -ex "show print pretty" -ex "target extended-remote localhost:3333" $1
+
+echo Killing OpenOCD instance in background
+kill $OPENOCD_PID

fatfs

@@ -0,0 +1 @@
+Subproject commit b11f08931929e5f2f1fe8a3a2c0bd16d222b5625

flash.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+set -euo pipefail
+
+SERIAL=/dev/serial/by-id/usb-xythobuz_Trackball_*
+DISK=/dev/disk/by-label/RPI-RP2
+MOUNT=/mnt/tmp
+
+if [ ! -e $DISK ]
+then
+    echo Resetting Raspberry Pi Pico
+    echo -n -e "\\x18" > $SERIAL
+fi
+
+echo -n Waiting for disk to appear
+until [ -e $DISK ]
+do
+    echo -n .
+    sleep 1
+done
+echo
+
+echo Mounting bootloader disk
+sudo mount $DISK $MOUNT
+
+echo Copying binary
+sudo cp $1 $MOUNT
+
+echo Done

flash_swd.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+set -euo pipefail
+
+./openocd/src/openocd -s openocd/tcl -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000" -c "cmsis_dap_vid_pid 0x2e8a 0x000c" -c "program $1 verify reset exit"

include/btstack_config.h

@@ -0,0 +1,58 @@
+#ifndef _PICO_BTSTACK_BTSTACK_CONFIG_H
+#define _PICO_BTSTACK_BTSTACK_CONFIG_H
+
+#ifndef ENABLE_BLE
+#error Please link to pico_btstack_ble
+#endif
+
+// BTstack features that can be enabled
+#define ENABLE_LE_PERIPHERAL
+#define ENABLE_LOG_INFO
+#define ENABLE_LOG_ERROR
+#define ENABLE_PRINTF_HEXDUMP
+
+// for the client
+#if RUNNING_AS_CLIENT
+#define ENABLE_LE_CENTRAL
+#define MAX_NR_GATT_CLIENTS 1
+#else
+#define MAX_NR_GATT_CLIENTS 0
+#endif
+
+// BTstack configuration. buffers, sizes, ...
+#define HCI_OUTGOING_PRE_BUFFER_SIZE 4
+#define HCI_ACL_PAYLOAD_SIZE (255 + 4)
+#define HCI_ACL_CHUNK_SIZE_ALIGNMENT 4
+#define MAX_NR_HCI_CONNECTIONS 1
+#define MAX_NR_SM_LOOKUP_ENTRIES 3
+#define MAX_NR_WHITELIST_ENTRIES 16
+#define MAX_NR_LE_DEVICE_DB_ENTRIES 16
+
+// Limit number of ACL/SCO Buffer to use by stack to avoid cyw43 shared bus overrun
+#define MAX_NR_CONTROLLER_ACL_BUFFERS 3
+#define MAX_NR_CONTROLLER_SCO_PACKETS 3
+
+// Enable and configure HCI Controller to Host Flow Control to avoid cyw43 shared bus overrun
+#define ENABLE_HCI_CONTROLLER_TO_HOST_FLOW_CONTROL
+#define HCI_HOST_ACL_PACKET_LEN (255+4)
+#define HCI_HOST_ACL_PACKET_NUM 3
+#define HCI_HOST_SCO_PACKET_LEN 120
+#define HCI_HOST_SCO_PACKET_NUM 3
+
+// Link Key DB and LE Device DB using TLV on top of Flash Sector interface
+#define NVM_NUM_DEVICE_DB_ENTRIES 16
+#define NVM_NUM_LINK_KEYS 16
+
+// We don't give btstack a malloc, so use a fixed-size ATT DB.
+#define MAX_ATT_DB_SIZE 512
+
+// BTstack HAL configuration
+#define HAVE_EMBEDDED_TIME_MS
+// map btstack_assert onto Pico SDK assert()
+#define HAVE_ASSERT
+// Some USB dongles take longer to respond to HCI reset (e.g. BCM20702A).
+#define HCI_RESET_RESEND_TIMEOUT_MS 1000
+#define ENABLE_SOFTWARE_AES128
+#define ENABLE_MICRO_ECC_FOR_LE_SECURE_CONNECTIONS
+
+#endif // _PICO_BTSTACK_BTSTACK_CONFIG_H

include/buttons.h

@@ -0,0 +1,39 @@
+/*
+ * buttons.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __BUTTONS_H__
+#define __BUTTONS_H__
+
+enum buttons {
+    BTN_A,
+    BTN_B,
+    BTN_X,
+    BTN_Y,
+    BTN_UP,
+    BTN_DOWN,
+    BTN_LEFT,
+    BTN_RIGHT,
+    BTN_ENTER,
+    NUM_BTNS // count
+};
+
+void buttons_init(void);
+void buttons_run(void);
+
+#endif // __BUTTONS_H__
+

include/config.h

@@ -0,0 +1,25 @@
+/*
+ * config.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __CONFIG_H__
+#define __CONFIG_H__
+
+//#define DISABLE_CDC_DTR_CHECK
+#define DEBOUNCE_DELAY_MS 5
+
+#endif // __CONFIG_H__

include/console.h

@@ -0,0 +1,26 @@
+/*
+ * console.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __CONSOLE_H__
+#define __CONSOLE_H__
+
+void cnsl_init(void);
+void cnsl_run(void);
+void cnsl_handle_input(const char *buf, uint32_t len);
+
+#endif // __CONSOLE_H__

include/debug.h

@@ -0,0 +1,28 @@
+/*
+ * debug.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __DEBUG_H__
+#define __DEBUG_H__
+
+int debug_msc_mount(void);
+int debug_msc_unmount(void);
+
+void debug_msc_stats(void);
+void debug_msc_pmw3360(void);
+
+#endif // __DEBUG_H__

include/fat_disk.h

@@ -0,0 +1,24 @@
+/* 
+ * fat_disk.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#define DISK_BLOCK_COUNT 256
+#define DISK_BLOCK_SIZE 512
+
+void fat_disk_init(void);
+
+uint8_t *fat_disk_get_sector(uint32_t sector);

include/ffconf.h

@@ -0,0 +1,296 @@
+/*---------------------------------------------------------------------------/
+/  Configurations of FatFs Module
+/---------------------------------------------------------------------------*/
+
+#define FFCONF_DEF	80286	/* Revision ID */
+
+/*---------------------------------------------------------------------------/
+/ Function Configurations
+/---------------------------------------------------------------------------*/
+
+#define FF_FS_READONLY	0
+/* This option switches read-only configuration. (0:Read/Write or 1:Read-only)
+/  Read-only configuration removes writing API functions, f_write(), f_sync(),
+/  f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree()
+/  and optional writing functions as well. */
+
+
+#define FF_FS_MINIMIZE	0
+/* This option defines minimization level to remove some basic API functions.
+/
+/   0: Basic functions are fully enabled.
+/   1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_truncate() and f_rename()
+/      are removed.
+/   2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1.
+/   3: f_lseek() function is removed in addition to 2. */
+
+
+#define FF_USE_FIND		0
+/* This option switches filtered directory read functions, f_findfirst() and
+/  f_findnext(). (0:Disable, 1:Enable 2:Enable with matching altname[] too) */
+
+
+#define FF_USE_MKFS		1
+/* This option switches f_mkfs() function. (0:Disable or 1:Enable) */
+
+
+#define FF_USE_FASTSEEK	0
+/* This option switches fast seek function. (0:Disable or 1:Enable) */
+
+
+#define FF_USE_EXPAND	0
+/* This option switches f_expand function. (0:Disable or 1:Enable) */
+
+
+#define FF_USE_CHMOD	0
+/* This option switches attribute manipulation functions, f_chmod() and f_utime().
+/  (0:Disable or 1:Enable) Also FF_FS_READONLY needs to be 0 to enable this option. */
+
+
+#define FF_USE_LABEL	1
+/* This option switches volume label functions, f_getlabel() and f_setlabel().
+/  (0:Disable or 1:Enable) */
+
+
+#define FF_USE_FORWARD	0
+/* This option switches f_forward() function. (0:Disable or 1:Enable) */
+
+
+#define FF_USE_STRFUNC	0
+#define FF_PRINT_LLI	1
+#define FF_PRINT_FLOAT	1
+#define FF_STRF_ENCODE	3
+/* FF_USE_STRFUNC switches string functions, f_gets(), f_putc(), f_puts() and
+/  f_printf().
+/
+/   0: Disable. FF_PRINT_LLI, FF_PRINT_FLOAT and FF_STRF_ENCODE have no effect.
+/   1: Enable without LF-CRLF conversion.
+/   2: Enable with LF-CRLF conversion.
+/
+/  FF_PRINT_LLI = 1 makes f_printf() support long long argument and FF_PRINT_FLOAT = 1/2
+/  makes f_printf() support floating point argument. These features want C99 or later.
+/  When FF_LFN_UNICODE >= 1 with LFN enabled, string functions convert the character
+/  encoding in it. FF_STRF_ENCODE selects assumption of character encoding ON THE FILE
+/  to be read/written via those functions.
+/
+/   0: ANSI/OEM in current CP
+/   1: Unicode in UTF-16LE
+/   2: Unicode in UTF-16BE
+/   3: Unicode in UTF-8
+*/
+
+
+/*---------------------------------------------------------------------------/
+/ Locale and Namespace Configurations
+/---------------------------------------------------------------------------*/
+
+#define FF_CODE_PAGE	850
+/* This option specifies the OEM code page to be used on the target system.
+/  Incorrect code page setting can cause a file open failure.
+/
+/   437 - U.S.
+/   720 - Arabic
+/   737 - Greek
+/   771 - KBL
+/   775 - Baltic
+/   850 - Latin 1
+/   852 - Latin 2
+/   855 - Cyrillic
+/   857 - Turkish
+/   860 - Portuguese
+/   861 - Icelandic
+/   862 - Hebrew
+/   863 - Canadian French
+/   864 - Arabic
+/   865 - Nordic
+/   866 - Russian
+/   869 - Greek 2
+/   932 - Japanese (DBCS)
+/   936 - Simplified Chinese (DBCS)
+/   949 - Korean (DBCS)
+/   950 - Traditional Chinese (DBCS)
+/     0 - Include all code pages above and configured by f_setcp()
+*/
+
+
+#define FF_USE_LFN		3
+#define FF_MAX_LFN		255
+/* The FF_USE_LFN switches the support for LFN (long file name).
+/
+/   0: Disable LFN. FF_MAX_LFN has no effect.
+/   1: Enable LFN with static  working buffer on the BSS. Always NOT thread-safe.
+/   2: Enable LFN with dynamic working buffer on the STACK.
+/   3: Enable LFN with dynamic working buffer on the HEAP.
+/
+/  To enable the LFN, ffunicode.c needs to be added to the project. The LFN function
+/  requiers certain internal working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and
+/  additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled.
+/  The FF_MAX_LFN defines size of the working buffer in UTF-16 code unit and it can
+/  be in range of 12 to 255. It is recommended to be set it 255 to fully support LFN
+/  specification.
+/  When use stack for the working buffer, take care on stack overflow. When use heap
+/  memory for the working buffer, memory management functions, ff_memalloc() and
+/  ff_memfree() exemplified in ffsystem.c, need to be added to the project. */
+
+
+#define FF_LFN_UNICODE	2
+/* This option switches the character encoding on the API when LFN is enabled.
+/
+/   0: ANSI/OEM in current CP (TCHAR = char)
+/   1: Unicode in UTF-16 (TCHAR = WCHAR)
+/   2: Unicode in UTF-8 (TCHAR = char)
+/   3: Unicode in UTF-32 (TCHAR = DWORD)
+/
+/  Also behavior of string I/O functions will be affected by this option.
+/  When LFN is not enabled, this option has no effect. */
+
+
+#define FF_LFN_BUF		255
+#define FF_SFN_BUF		12
+/* This set of options defines size of file name members in the FILINFO structure
+/  which is used to read out directory items. These values should be suffcient for
+/  the file names to read. The maximum possible length of the read file name depends
+/  on character encoding. When LFN is not enabled, these options have no effect. */
+
+
+#define FF_FS_RPATH		0
+/* This option configures support for relative path.
+/
+/   0: Disable relative path and remove related functions.
+/   1: Enable relative path. f_chdir() and f_chdrive() are available.
+/   2: f_getcwd() function is available in addition to 1.
+*/
+
+
+/*---------------------------------------------------------------------------/
+/ Drive/Volume Configurations
+/---------------------------------------------------------------------------*/
+
+#define FF_VOLUMES		1
+/* Number of volumes (logical drives) to be used. (1-10) */
+
+
+#define FF_STR_VOLUME_ID	0
+#define FF_VOLUME_STRS		"RAM","NAND","CF","SD","SD2","USB","USB2","USB3"
+/* FF_STR_VOLUME_ID switches support for volume ID in arbitrary strings.
+/  When FF_STR_VOLUME_ID is set to 1 or 2, arbitrary strings can be used as drive
+/  number in the path name. FF_VOLUME_STRS defines the volume ID strings for each
+/  logical drives. Number of items must not be less than FF_VOLUMES. Valid
+/  characters for the volume ID strings are A-Z, a-z and 0-9, however, they are
+/  compared in case-insensitive. If FF_STR_VOLUME_ID >= 1 and FF_VOLUME_STRS is
+/  not defined, a user defined volume string table is needed as:
+/
+/  const char* VolumeStr[FF_VOLUMES] = {"ram","flash","sd","usb",...
+*/
+
+
+#define FF_MULTI_PARTITION	0
+/* This option switches support for multiple volumes on the physical drive.
+/  By default (0), each logical drive number is bound to the same physical drive
+/  number and only an FAT volume found on the physical drive will be mounted.
+/  When this function is enabled (1), each logical drive number can be bound to
+/  arbitrary physical drive and partition listed in the VolToPart[]. Also f_fdisk()
+/  function will be available. */
+
+
+#define FF_MIN_SS		512
+#define FF_MAX_SS		512
+/* This set of options configures the range of sector size to be supported. (512,
+/  1024, 2048 or 4096) Always set both 512 for most systems, generic memory card and
+/  harddisk, but a larger value may be required for on-board flash memory and some
+/  type of optical media. When FF_MAX_SS is larger than FF_MIN_SS, FatFs is configured
+/  for variable sector size mode and disk_ioctl() function needs to implement
+/  GET_SECTOR_SIZE command. */
+
+
+#define FF_LBA64		0
+/* This option switches support for 64-bit LBA. (0:Disable or 1:Enable)
+/  To enable the 64-bit LBA, also exFAT needs to be enabled. (FF_FS_EXFAT == 1) */
+
+
+#define FF_MIN_GPT		0x10000000
+/* Minimum number of sectors to switch GPT as partitioning format in f_mkfs and
+/  f_fdisk function. 0x100000000 max. This option has no effect when FF_LBA64 == 0. */
+
+
+#define FF_USE_TRIM		0
+/* This option switches support for ATA-TRIM. (0:Disable or 1:Enable)
+/  To enable Trim function, also CTRL_TRIM command should be implemented to the
+/  disk_ioctl() function. */
+
+
+
+/*---------------------------------------------------------------------------/
+/ System Configurations
+/---------------------------------------------------------------------------*/
+
+#define FF_FS_TINY		0
+/* This option switches tiny buffer configuration. (0:Normal or 1:Tiny)
+/  At the tiny configuration, size of file object (FIL) is shrinked FF_MAX_SS bytes.
+/  Instead of private sector buffer eliminated from the file object, common sector
+/  buffer in the filesystem object (FATFS) is used for the file data transfer. */
+
+
+#define FF_FS_EXFAT		0
+/* This option switches support for exFAT filesystem. (0:Disable or 1:Enable)
+/  To enable exFAT, also LFN needs to be enabled. (FF_USE_LFN >= 1)
+/  Note that enabling exFAT discards ANSI C (C89) compatibility. */
+
+
+#define FF_FS_NORTC		1
+#define FF_NORTC_MON	1
+#define FF_NORTC_MDAY	1
+#define FF_NORTC_YEAR	2022
+/* The option FF_FS_NORTC switches timestamp feature. If the system does not have
+/  an RTC or valid timestamp is not needed, set FF_FS_NORTC = 1 to disable the
+/  timestamp feature. Every object modified by FatFs will have a fixed timestamp
+/  defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR in local time.
+/  To enable timestamp function (FF_FS_NORTC = 0), get_fattime() function need to be
+/  added to the project to read current time form real-time clock. FF_NORTC_MON,
+/  FF_NORTC_MDAY and FF_NORTC_YEAR have no effect.
+/  These options have no effect in read-only configuration (FF_FS_READONLY = 1). */
+
+
+#define FF_FS_NOFSINFO	0
+/* If you need to know correct free space on the FAT32 volume, set bit 0 of this
+/  option, and f_getfree() function at the first time after volume mount will force
+/  a full FAT scan. Bit 1 controls the use of last allocated cluster number.
+/
+/  bit0=0: Use free cluster count in the FSINFO if available.
+/  bit0=1: Do not trust free cluster count in the FSINFO.
+/  bit1=0: Use last allocated cluster number in the FSINFO if available.
+/  bit1=1: Do not trust last allocated cluster number in the FSINFO.
+*/
+
+
+#define FF_FS_LOCK		0
+/* The option FF_FS_LOCK switches file lock function to control duplicated file open
+/  and illegal operation to open objects. This option must be 0 when FF_FS_READONLY
+/  is 1.
+/
+/  0:  Disable file lock function. To avoid volume corruption, application program
+/      should avoid illegal open, remove and rename to the open objects.
+/  >0: Enable file lock function. The value defines how many files/sub-directories
+/      can be opened simultaneously under file lock control. Note that the file
+/      lock control is independent of re-entrancy. */
+
+
+#define FF_FS_REENTRANT	0
+#define FF_FS_TIMEOUT	1000
+/* The option FF_FS_REENTRANT switches the re-entrancy (thread safe) of the FatFs
+/  module itself. Note that regardless of this option, file access to different
+/  volume is always re-entrant and volume control functions, f_mount(), f_mkfs()
+/  and f_fdisk() function, are always not re-entrant. Only file/directory access
+/  to the same volume is under control of this featuer.
+/
+/   0: Disable re-entrancy. FF_FS_TIMEOUT have no effect.
+/   1: Enable re-entrancy. Also user provided synchronization handlers,
+/      ff_mutex_create(), ff_mutex_delete(), ff_mutex_take() and ff_mutex_give()
+/      function, must be added to the project. Samples are available in ffsystem.c.
+/
+/  The FF_FS_TIMEOUT defines timeout period in unit of O/S time tick.
+*/
+
+
+
+/*--- End of configuration options ---*/

include/log.h

@@ -0,0 +1,44 @@
+/*
+ * log.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __LOG_H__
+#define __LOG_H__
+
+#include <stdbool.h>
+
+// for output that is stored in the debug log.
+// will be re-played from buffer when terminal connects
+#define debug(fmt, ...) debug_log(true, \
+        "%08lu %s: " fmt "\r\n", \
+        to_ms_since_boot(get_absolute_time()), \
+        __func__, \
+        ##__VA_ARGS__)
+
+// for interactive output. is not stored or re-played.
+#define print(fmt, ...) debug_log(false, fmt, ##__VA_ARGS__)
+#define println(fmt, ...) debug_log(false, fmt "\r\n", ##__VA_ARGS__)
+
+void debug_log(bool log, const char *format, ...) __attribute__((format(printf, 2, 3)));
+void debug_wait_input(const char *format, ...) __attribute__((format(printf, 1, 2)));
+
+void log_dump_to_usb(void);
+void log_dump_to_disk(void);
+
+void debug_handle_input(char *buff, uint32_t len);
+
+#endif // __LOG_H__

include/tusb_config.h

@@ -0,0 +1,125 @@
+/*
+ * Extended from TinyUSB example code.
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Ha Thach (tinyusb.org)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ */
+
+#ifndef _TUSB_CONFIG_H_
+#define _TUSB_CONFIG_H_
+
+#ifdef __cplusplus
+ extern "C" {
+#endif
+
+//--------------------------------------------------------------------
+// COMMON CONFIGURATION
+//--------------------------------------------------------------------
+
+// defined by board.mk
+#ifndef CFG_TUSB_MCU
+  #error CFG_TUSB_MCU must be defined
+#endif
+
+// RHPort number used for device can be defined by board.mk, default to port 0
+#ifndef BOARD_DEVICE_RHPORT_NUM
+  #define BOARD_DEVICE_RHPORT_NUM     0
+#endif
+
+// RHPort max operational speed can defined by board.mk
+// Default to Highspeed for MCU with internal HighSpeed PHY (can be port specific), otherwise FullSpeed
+#ifndef BOARD_DEVICE_RHPORT_SPEED
+  #if (CFG_TUSB_MCU == OPT_MCU_LPC18XX || CFG_TUSB_MCU == OPT_MCU_LPC43XX || CFG_TUSB_MCU == OPT_MCU_MIMXRT10XX || \
+       CFG_TUSB_MCU == OPT_MCU_NUC505  || CFG_TUSB_MCU == OPT_MCU_CXD56 || CFG_TUSB_MCU == OPT_MCU_SAMX7X)
+    #define BOARD_DEVICE_RHPORT_SPEED   OPT_MODE_HIGH_SPEED
+  #else
+    #define BOARD_DEVICE_RHPORT_SPEED   OPT_MODE_FULL_SPEED
+  #endif
+#endif
+
+// Device mode with rhport and speed defined by board.mk
+#if   BOARD_DEVICE_RHPORT_NUM == 0
+  #define CFG_TUSB_RHPORT0_MODE     (OPT_MODE_DEVICE | BOARD_DEVICE_RHPORT_SPEED)
+#elif BOARD_DEVICE_RHPORT_NUM == 1
+  #define CFG_TUSB_RHPORT1_MODE     (OPT_MODE_DEVICE | BOARD_DEVICE_RHPORT_SPEED)
+#else
+  #error "Incorrect RHPort configuration"
+#endif
+
+#ifndef CFG_TUSB_OS
+#define CFG_TUSB_OS               OPT_OS_NONE
+#endif
+
+// CFG_TUSB_DEBUG is defined by compiler in DEBUG build
+// #define CFG_TUSB_DEBUG           0
+
+/* USB DMA on some MCUs can only access a specific SRAM region with restriction on alignment.
+ * Tinyusb use follows macros to declare transferring memory so that they can be put
+ * into those specific section.
+ * e.g
+ * - CFG_TUSB_MEM SECTION : __attribute__ (( section(".usb_ram") ))
+ * - CFG_TUSB_MEM_ALIGN   : __attribute__ ((aligned(4)))
+ */
+#ifndef CFG_TUSB_MEM_SECTION
+#define CFG_TUSB_MEM_SECTION
+#endif
+
+#ifndef CFG_TUSB_MEM_ALIGN
+#define CFG_TUSB_MEM_ALIGN          __attribute__ ((aligned(4)))
+#endif
+
+//--------------------------------------------------------------------
+// DEVICE CONFIGURATION
+//--------------------------------------------------------------------
+
+#ifndef CFG_TUD_ENDPOINT0_SIZE
+#define CFG_TUD_ENDPOINT0_SIZE    64
+#endif
+
+//------------- CLASS -------------//
+#define CFG_TUD_HID               0
+#define CFG_TUD_CDC               1
+#define CFG_TUD_MSC               1
+#define CFG_TUD_MIDI              0
+#define CFG_TUD_VENDOR            0
+
+// HID buffer size Should be sufficient to hold ID (if any) + Data
+#define CFG_TUD_HID_EP_BUFSIZE    16
+
+// CDC FIFO size of TX and RX
+#define CFG_TUD_CDC_RX_BUFSIZE   (TUD_OPT_HIGH_SPEED ? 512 : 64)
+#define CFG_TUD_CDC_TX_BUFSIZE   (TUD_OPT_HIGH_SPEED ? 512 : 64)
+
+// CDC Endpoint transfer buffer size, more is faster
+#define CFG_TUD_CDC_EP_BUFSIZE   (TUD_OPT_HIGH_SPEED ? 512 : 64)
+
+// MSC Buffer size of Device Mass storage
+#define CFG_TUD_MSC_EP_BUFSIZE   512
+
+#ifdef __cplusplus
+ }
+#endif
+
+#endif /* _TUSB_CONFIG_H_ */

include/usb.h

@@ -0,0 +1,25 @@
+/*
+ * usb.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __USB_H__
+#define __USB_H__
+
+void usb_init(void);
+void usb_run(void);
+
+#endif // __USB_H__

include/usb_cdc.h

@@ -0,0 +1,25 @@
+/*
+ * usb_cdc.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __USB_CDC_H__
+#define __USB_CDC_H__
+
+void usb_cdc_write(const char *buf, uint32_t count);
+void usb_cdc_set_reroute(bool reroute);
+
+#endif // __USB_CDC_H__

include/usb_descriptors.h

@@ -0,0 +1,24 @@
+/*
+ * usb_descriptors.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef USB_DESCRIPTORS_H_
+#define USB_DESCRIPTORS_H_
+
+void usb_descriptor_init_id(void);
+
+#endif /* USB_DESCRIPTORS_H_ */

include/usb_msc.h

@@ -0,0 +1,25 @@
+/*
+ * usb_msc.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __USB_MSC_H__
+#define __USB_MSC_H__
+
+bool msc_is_medium_available(void);
+void msc_set_medium_available(bool state);
+
+#endif // __USB_MSC_H__

include/util.h

@@ -0,0 +1,34 @@
+/*
+ * util.h
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __UTIL_H__
+#define __UTIL_H__
+
+void heartbeat_init(void);
+void heartbeat_run(void);
+
+int32_t convert_two_complement(int32_t b);
+
+bool str_startswith(const char *str, const char *start);
+
+void reset_to_bootloader(void);
+void reset_to_main(void);
+
+void hexdump(uint8_t *buff, size_t len);
+
+#endif // __UTIL_H__

mcufont

@@ -0,0 +1 @@
+Subproject commit 9f3aa41b231195e7b2b59f78d8f01d06460b6d35

pico-sdk

@@ -0,0 +1 @@
+Subproject commit 6a7db34ff63345a7badec79ebea3aaef1712f374

src/buttons.c

@@ -0,0 +1,72 @@
+/*
+ * buttons.c
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#include "pico/stdlib.h"
+
+#include "config.h"
+#include "buttons.h"
+
+static const uint gpio_num[NUM_BTNS] = {
+    15, // BTN_A
+    17, // BTN_B
+    19, // BTN_X
+    21, // BTN_Y
+     2, // BTN_UP
+    18, // BTN_DOWN
+    16, // BTN_LEFT
+    20, // BTN_RIGHT
+     3, // BTN_ENTER
+};
+
+struct button_state {
+    uint32_t last_time;
+    bool current_state, last_state;
+};
+
+static struct button_state buttons[NUM_BTNS];
+
+void buttons_init(void) {
+    for (uint i = 0; i < NUM_BTNS; i++) {
+        gpio_init(gpio_num[i]);
+        gpio_set_dir(gpio_num[i], GPIO_IN);
+        gpio_pull_up(gpio_num[i]);
+
+        buttons[i].last_time = 0;
+        buttons[i].current_state = false;
+        buttons[i].last_state = false;
+    }
+}
+
+void buttons_run(void) {
+    for (uint i = 0; i < NUM_BTNS; i++) {
+        bool state = !gpio_get(gpio_num[i]);
+        uint32_t now = to_ms_since_boot(get_absolute_time());
+
+        if (state != buttons[i].last_state) {
+            buttons[i].last_time = now;
+        }
+
+        if ((now - buttons[i].last_time) > DEBOUNCE_DELAY_MS) {
+            if (state != buttons[i].current_state) {
+                buttons[i].current_state = state;
+            }
+        }
+
+        buttons[i].last_state = state;
+    }
+}

src/console.c

@@ -0,0 +1,192 @@
+/*
+ * console.c
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#include <inttypes.h>
+#include <string.h>
+#include "pico/stdlib.h"
+#include <unistd.h>
+
+#include "config.h"
+#include "log.h"
+#include "util.h"
+#include "usb_cdc.h"
+#include "usb_msc.h"
+#include "debug.h"
+#include "console.h"
+
+#define CNSL_BUFF_SIZE 1024
+#define CNSL_REPEAT_MS 500
+
+//#define CNSL_REPEAT_PMW_STATUS_BY_DEFAULT
+
+static char cnsl_line_buff[CNSL_BUFF_SIZE + 1];
+static uint32_t cnsl_buff_pos = 0;
+
+static char cnsl_last_command[CNSL_BUFF_SIZE + 1];
+
+static char cnsl_repeated_command[CNSL_BUFF_SIZE + 1];
+static bool repeat_command = false;
+static uint32_t last_repeat_time = 0;
+
+static void cnsl_interpret(const char *line) {
+    if (strlen(line) == 0) {
+        if ((strlen(cnsl_last_command) > 0) && (strcmp(cnsl_last_command, "repeat") != 0)) {
+            // repeat last command once
+            println("repeating command \"%s\"", cnsl_last_command);
+            cnsl_interpret(cnsl_last_command);
+            println();
+        }
+        return;
+    } else if (strcmp(line, "repeat") == 0) {
+        if (!repeat_command) {
+            // mark last command to be repeated multiple times
+            strncpy(cnsl_repeated_command, cnsl_last_command, CNSL_BUFF_SIZE + 1);
+            last_repeat_time = to_ms_since_boot(get_absolute_time()) - 1001;
+            repeat_command = true;
+        } else {
+            // stop repeating
+            repeat_command = false;
+        }
+    } else if ((strcmp(line, "help") == 0)
+            || (strcmp(line, "h") == 0)
+            || (strcmp(line, "?") == 0)) {
+        println("Trackball Firmware Usage:");
+        println("  reset - reset back into this firmware");
+        println("   \\x18 - reset to bootloader");
+        println(" repeat - repeat last command every %d milliseconds", CNSL_REPEAT_MS);
+        println("   help - print this message");
+        println("  mount - make mass storage medium (un)available");
+        //println("    foo - bar");
+        println("Press Enter with no input to repeat last command.");
+        println("Use repeat to continuously execute last command.");
+        println("Stop this by calling repeat again.");
+    } else if (strcmp(line, "reset") == 0) {
+        reset_to_main();
+    } else if (strcmp(line, "mount") == 0) {
+        bool state = msc_is_medium_available();
+        println("Currently %s. %s now.",
+                state ? "mounted" : "unmounted",
+                state ? "Unplugging" : "Plugging in");
+        msc_set_medium_available(!state);
+    } else {
+        println("unknown command \"%s\"", line);
+    }
+
+    println();
+}
+
+void cnsl_init(void) {
+    cnsl_buff_pos = 0;
+    for (int i = 0; i < CNSL_BUFF_SIZE + 1; i++) {
+        cnsl_line_buff[i] = '\0';
+        cnsl_last_command[i] = '\0';
+        cnsl_repeated_command[i] = '\0';
+    }
+
+#ifdef CNSL_REPEAT_PMW_STATUS_BY_DEFAULT
+    strcpy(cnsl_repeated_command, "pmws");
+    repeat_command = true;
+#endif // CNSL_REPEAT_PMW_STATUS_BY_DEFAULT
+}
+
+static int32_t cnsl_find_line_end(void) {
+    for (uint32_t i = 0; i < cnsl_buff_pos; i++) {
+        if ((cnsl_line_buff[i] == '\r') || (cnsl_line_buff[i] == '\n')) {
+            return i;
+        }
+    }
+    return -1;
+}
+
+void cnsl_run(void) {
+    if (repeat_command && (strlen(cnsl_repeated_command) > 0)
+            && (strcmp(cnsl_repeated_command, "repeat") != 0)) {
+        uint32_t now = to_ms_since_boot(get_absolute_time());
+        if (now >= (last_repeat_time + CNSL_REPEAT_MS)) {
+            println("repeating command \"%s\"", cnsl_repeated_command);
+            cnsl_interpret(cnsl_repeated_command);
+            println();
+
+            last_repeat_time = now;
+        }
+    } else {
+        if (repeat_command) {
+            println("nothing to repeat");
+        }
+        repeat_command = false;
+    }
+}
+
+void cnsl_handle_input(const char *buf, uint32_t len) {
+    if ((cnsl_buff_pos + len) > CNSL_BUFF_SIZE) {
+        debug("error: console input buffer overflow! %lu > %u", cnsl_buff_pos + len, CNSL_BUFF_SIZE);
+        cnsl_init();
+    }
+
+    memcpy(cnsl_line_buff + cnsl_buff_pos, buf, len);
+    cnsl_buff_pos += len;
+
+    // handle backspace
+    for (ssize_t i = cnsl_buff_pos - len; i < (ssize_t)cnsl_buff_pos; i++) {
+        if ((cnsl_line_buff[i] == '\b') || (cnsl_line_buff[i] == 0x7F)) {
+            if (i > 0) {
+                // overwrite previous character and backspace
+                for (ssize_t j = i; j < (ssize_t)cnsl_buff_pos - 1; j++) {
+                    cnsl_line_buff[j - 1] = cnsl_line_buff[j + 1];
+                }
+                cnsl_buff_pos -= 2;
+            } else {
+                // just remove the backspace
+                for (ssize_t j = i; j < (ssize_t)cnsl_buff_pos - 1; j++) {
+                    cnsl_line_buff[j] = cnsl_line_buff[j + 1];
+                }
+                cnsl_buff_pos -= 1;
+            }
+
+            usb_cdc_write("\b \b", 3);
+
+            // check for another backspace in this space
+            i--;
+        } else {
+            usb_cdc_write(cnsl_line_buff + i, 1);
+        }
+    }
+
+    int32_t line_len = cnsl_find_line_end();
+    if (line_len < 0) {
+        // user has not pressed enter yet
+        return;
+    }
+
+    // convert line to C-style string
+    cnsl_line_buff[line_len] = '\0';
+
+    cnsl_interpret(cnsl_line_buff);
+
+    // store command for eventual repeats
+    strncpy(cnsl_last_command, cnsl_line_buff, CNSL_BUFF_SIZE + 1);
+
+    // clear string and move following data over
+    uint32_t cnt = line_len + 1;
+    if (cnsl_line_buff[line_len + 1] == '\n') {
+        cnt++;
+    }
+    memset(cnsl_line_buff, '\0', cnt);
+    memmove(cnsl_line_buff, cnsl_line_buff + cnt, sizeof(cnsl_line_buff) - cnt);
+    cnsl_buff_pos -= cnt;
+}

src/debug.c

@@ -0,0 +1,61 @@
+/*
+ * debug.c
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#include <string.h>
+#include "pico/stdlib.h"
+#include "ff.h"
+
+#include "config.h"
+#include "log.h"
+#include "debug.h"
+
+static FATFS fs;
+static bool mounted = false;
+
+int debug_msc_mount(void) {
+    if (mounted) {
+        debug("already mounted");
+        return 0;
+    }
+
+    FRESULT res = f_mount(&fs, "", 0);
+    if (res != FR_OK) {
+        debug("error: f_mount returned %d", res);
+        mounted = false;
+        return -1;
+    }
+
+    mounted = true;
+    return 0;
+}
+
+int debug_msc_unmount(void) {
+    if (!mounted) {
+        debug("already unmounted");
+        return 0;
+    }
+
+    FRESULT res = f_mount(0, "", 0);
+    if (res != FR_OK) {
+        debug("error: f_mount returned %d", res);
+        return -1;
+    }
+
+    mounted = false;
+    return 0;
+}

src/fat_disk.c

@@ -0,0 +1,170 @@
+/* 
+ * fat_disk.c
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#include <string.h>
+#include <stdlib.h>
+#include <stdio.h>
+
+#include "pico/stdlib.h"
+#include "ff.h"
+#include "diskio.h"
+
+#include "config.h"
+#include "log.h"
+#include "debug.h"
+#include "fat_disk.h"
+
+static uint8_t disk[DISK_BLOCK_COUNT * DISK_BLOCK_SIZE];
+
+void fat_disk_init(void) {
+    BYTE work[FF_MAX_SS];
+    FRESULT res = f_mkfs("", 0, work, sizeof(work));
+    if (res != FR_OK) {
+        debug("error: f_mkfs returned %d", res);
+        return;
+    }
+
+    if (debug_msc_mount() != 0) {
+        debug("error mounting disk");
+        return;
+    }
+
+    // maximum length: 11 bytes
+    f_setlabel("DEBUG DISK");
+
+    FIL file;
+    res = f_open(&file, "README.md", FA_CREATE_ALWAYS | FA_WRITE);
+    if (res != FR_OK) {
+        debug("error: f_open returned %d", res);
+    } else {
+        char readme[1024];
+        size_t pos = 0;
+        pos += snprintf(readme + pos, 1024 - pos, "# Volcano Remote Control Gadget\r\n");
+        pos += snprintf(readme + pos, 1024 - pos, "\r\n");
+        pos += snprintf(readme + pos, 1024 - pos, "Project by Thomas Buck <thomas@xythobuz.de>\r\n");
+        pos += snprintf(readme + pos, 1024 - pos, "Licensed under GPLv3.\r\n");
+        pos += snprintf(readme + pos, 1024 - pos, "Source at https://git.xythobuz.de/thomas/sb-py\r\n");
+
+        size_t len = strlen(readme);
+        UINT bw;
+        res = f_write(&file, readme, len, &bw);
+        if ((res != FR_OK) || (bw != len)) {
+            debug("error: f_write returned %d", res);
+        }
+
+        res = f_close(&file);
+        if (res != FR_OK) {
+            debug("error: f_close returned %d", res);
+        }
+    }
+
+    if (debug_msc_unmount() != 0) {
+        debug("error unmounting disk");
+    }
+}
+
+uint8_t *fat_disk_get_sector(uint32_t sector) {
+    return disk + (sector * DISK_BLOCK_SIZE);
+}
+
+/*
+ * FatFS ffsystem.c
+ */
+
+void* ff_memalloc(UINT msize) {
+    return malloc((size_t)msize);
+}
+
+void ff_memfree(void* mblock) {
+    free(mblock);
+}
+
+/*
+ * FatFS diskio.c
+ */
+
+DSTATUS disk_status(BYTE pdrv) {
+    if (pdrv != 0) {
+        debug("invalid drive number %d", pdrv);
+        return STA_NODISK;
+    }
+
+    return 0;
+}
+
+DSTATUS disk_initialize(BYTE pdrv) {
+    if (pdrv != 0) {
+        debug("invalid drive number %d", pdrv);
+        return STA_NODISK;
+    }
+
+    return 0;
+}
+
+DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) {
+    if (pdrv != 0) {
+        debug("invalid drive number %d", pdrv);
+        return RES_PARERR;
+    }
+
+    if ((sector + count) > DISK_BLOCK_COUNT) {
+        debug("invalid read ((%lu + %u) > %u)", sector, count, DISK_BLOCK_COUNT);
+        return RES_ERROR;
+    }
+
+    memcpy(buff, disk + (sector * DISK_BLOCK_SIZE), count * DISK_BLOCK_SIZE);
+    return RES_OK;
+}
+
+DRESULT disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count) {
+    if (pdrv != 0) {
+        debug("invalid drive number %d", pdrv);
+        return RES_PARERR;
+    }
+
+    if ((sector + count) > DISK_BLOCK_COUNT) {
+        debug("invalid read ((%lu + %u) > %u)", sector, count, DISK_BLOCK_COUNT);
+        return RES_ERROR;
+    }
+
+    memcpy(disk + (sector * DISK_BLOCK_SIZE), buff, count * DISK_BLOCK_SIZE);
+    return RES_OK;
+}
+
+DRESULT disk_ioctl(BYTE pdrv, BYTE cmd, void *buff) {
+    if (pdrv != 0) {
+        debug("invalid drive number %d", pdrv);
+        return RES_PARERR;
+    }
+
+    switch (cmd) {
+        case GET_SECTOR_COUNT:
+            *((LBA_t *)buff) = DISK_BLOCK_COUNT;
+            break;
+
+        case GET_SECTOR_SIZE:
+            *((WORD *)buff) = DISK_BLOCK_SIZE;
+            break;
+
+        case GET_BLOCK_SIZE:
+            *((DWORD *)buff) = 1; // non flash memory media
+            break;
+    }
+
+    return RES_OK;
+}

src/log.c

@@ -0,0 +1,169 @@
+/*
+ * log.c
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#include <stdarg.h>
+#include <stdio.h>
+
+#include "pico/stdlib.h"
+#include "hardware/watchdog.h"
+#include "ff.h"
+
+#include "config.h"
+#include "usb.h"
+#include "usb_cdc.h"
+#include "log.h"
+
+static char log_buff[4096];
+static size_t head = 0, tail = 0;
+static bool full = false;
+static bool got_input = false;
+
+static void add_to_log(const char *buff, int len) {
+    for (int i = 0; i < len; i++) {
+        log_buff[head] = buff[i];
+
+        if (full && (++tail == sizeof(log_buff))) {
+            tail = 0;
+        }
+
+        if (++(head) == sizeof(log_buff)) {
+            head = 0;
+        }
+
+        full = (head == tail);
+    }
+}
+
+void log_dump_to_usb(void) {
+    if (head == tail) {
+        return;
+    }
+
+    char buff[32];
+    int l = snprintf(buff, sizeof(buff), "\r\n\r\nbuffered log output:\r\n");
+    if ((l > 0) && (l <= (int)sizeof(buff))) {
+        usb_cdc_write(buff, l);
+    }
+
+    if (head > tail) {
+        usb_cdc_write(log_buff + tail, head - tail);
+    } else {
+        usb_cdc_write(log_buff + tail, sizeof(log_buff) - tail);
+        usb_cdc_write(log_buff, head);
+    }
+
+    l = snprintf(buff, sizeof(buff), "\r\n\r\nlive log:\r\n");
+    if ((l > 0) && (l <= (int)sizeof(buff))) {
+        usb_cdc_write(buff, l);
+    }
+}
+
+void log_dump_to_disk(void) {
+    FIL file;
+    FRESULT res = f_open(&file, "log.txt", FA_CREATE_ALWAYS | FA_WRITE);
+    if (res != FR_OK) {
+        debug("error: f_open returned %d", res);
+        return;
+    }
+
+    UINT bw;
+
+    if (head > tail) {
+        res = f_write(&file, log_buff + tail, head - tail, &bw);
+        if ((res != FR_OK) || (bw != head - tail)) {
+            debug("error: f_write (A) returned %d", res);
+        }
+    } else if (head < tail) {
+        res = f_write(&file, log_buff + tail, sizeof(log_buff) - tail, &bw);
+        if ((res != FR_OK) || (bw != sizeof(log_buff) - tail)) {
+            debug("error: f_write (B) returned %d", res);
+        } else {
+            res = f_write(&file, log_buff, head, &bw);
+            if ((res != FR_OK) || (bw != head)) {
+                debug("error: f_write (C) returned %d", res);
+            }
+        }
+    }
+
+    res = f_close(&file);
+    if (res != FR_OK) {
+        debug("error: f_close returned %d", res);
+    }
+}
+
+static int format_debug_log(char *buff, size_t len, const char *format, va_list args) {
+    int l = vsnprintf(buff, len, format, args);
+
+    if (l < 0) {
+        // encoding error
+        l = snprintf(buff, len, "%s: encoding error\r\n", __func__);
+    } else if (l >= (ssize_t)len) {
+        // not enough space for string
+        l = snprintf(buff, len, "%s: message too long (%d)\r\n", __func__, l);
+    }
+
+    return l;
+}
+
+void debug_log(bool log, const char* format, ...) {
+    static char line_buff[512];
+
+    va_list args;
+    va_start(args, format);
+    int l = format_debug_log(line_buff, sizeof(line_buff), format, args);
+    va_end(args);
+
+    if ((l > 0) && (l <= (int)sizeof(line_buff))) {
+        usb_cdc_write(line_buff, l);
+
+        if (log) {
+            add_to_log(line_buff, l);
+        }
+    }
+}
+
+void debug_handle_input(char *buff, uint32_t len) {
+    (void)buff;
+
+    if (len > 0) {
+        got_input = true;
+    }
+}
+
+void debug_wait_input(const char *format, ...) {
+    static char line_buff[512];
+
+    va_list args;
+    va_start(args, format);
+    int l = format_debug_log(line_buff, sizeof(line_buff), format, args);
+    va_end(args);
+
+    if ((l > 0) && (l <= (int)sizeof(line_buff))) {
+        usb_cdc_write(line_buff, l);
+    }
+
+    got_input = false;
+    usb_cdc_set_reroute(true);
+
+    while (!got_input) {
+        watchdog_update();
+        usb_run();
+    }
+
+    usb_cdc_set_reroute(false);
+}

src/main.c

@@ -0,0 +1,59 @@
+/*
+ * main.c
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#include "pico/stdlib.h"
+#include "hardware/watchdog.h"
+
+#include "config.h"
+#include "util.h"
+#include "console.h"
+#include "log.h"
+#include "usb.h"
+#include "fat_disk.h"
+#include "buttons.h"
+
+int main(void) {
+    heartbeat_init();
+    buttons_init();
+
+    cnsl_init();
+    usb_init();
+
+    if (watchdog_caused_reboot()) {
+        debug("reset by watchdog");
+    }
+
+    debug("fat_disk_init");
+    fat_disk_init();
+
+    // trigger after 500ms
+    watchdog_enable(500, 1);
+
+    debug("init done");
+
+    while (1) {
+        watchdog_update();
+
+        heartbeat_run();
+        buttons_run();
+        usb_run();
+        cnsl_run();
+    }
+
+    return 0;
+}

src/usb.c

@@ -0,0 +1,70 @@
+/*
+ * Extended from TinyUSB example code.
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Ha Thach (tinyusb.org)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ */
+
+#include "bsp/board.h"
+#include "tusb.h"
+
+#include "config.h"
+#include "log.h"
+#include "usb_descriptors.h"
+#include "usb_cdc.h"
+#include "usb.h"
+
+void usb_init(void) {
+    usb_descriptor_init_id();
+
+    board_init();
+    tusb_init();
+}
+
+void usb_run(void) {
+    tud_task();
+}
+
+// Invoked when device is mounted
+void tud_mount_cb(void) {
+    debug("device mounted");
+}
+
+// Invoked when device is unmounted
+void tud_umount_cb(void) {
+    debug("device unmounted");
+}
+
+// Invoked when usb bus is suspended
+// remote_wakeup_en : if host allow us  to perform remote wakeup
+// Within 7ms, device must draw an average of current less than 2.5 mA from bus
+void tud_suspend_cb(bool remote_wakeup_en) {
+    debug("device suspended wakeup=%d", remote_wakeup_en);
+}
+
+// Invoked when usb bus is resumed
+void tud_resume_cb(void) {
+    debug("device resumed");
+}

src/usb_cdc.c

@@ -0,0 +1,117 @@
+/*
+ * Extended from TinyUSB example code.
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Ha Thach (tinyusb.org)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ */
+
+#include "bsp/board.h"
+#include "tusb.h"
+
+#include "config.h"
+#include "console.h"
+#include "log.h"
+#include "util.h"
+#include "usb_descriptors.h"
+#include "usb_cdc.h"
+
+static bool reroute_cdc_debug = false;
+
+void usb_cdc_write(const char *buf, uint32_t count) {
+#ifndef DISABLE_CDC_DTR_CHECK
+    if (!tud_cdc_connected()) {
+        return;
+    }
+#endif // DISABLE_CDC_DTR_CHECK
+
+    // implemented similar to Pico SDK stdio usb
+    uint32_t len = 0;
+    while (len < count) {
+        uint32_t n = count - len;
+        uint32_t available = tud_cdc_write_available();
+
+        // only write as much as possible
+        if (n > available) {
+            n = available;
+        }
+
+        len += tud_cdc_write(buf + len, n);
+
+        // run tud_task to actually move stuff from FIFO
+        tud_task();
+        tud_cdc_write_flush();
+    }
+}
+
+void usb_cdc_set_reroute(bool reroute) {
+    reroute_cdc_debug = reroute;
+}
+
+void cdc_task(void) {
+    const uint32_t cdc_buf_len = 64;
+
+    if (tud_cdc_available()) {
+        char buf[cdc_buf_len + 1];
+        uint32_t count = tud_cdc_read(buf, cdc_buf_len);
+
+        if ((count >= 1) && (buf[0] == 0x18)) {
+            // ASCII 0x18 = CAN (cancel)
+            debug("switching to bootloader");
+            reset_to_bootloader();
+        } else if (reroute_cdc_debug) {
+            debug_handle_input(buf, count);
+        } else {
+            cnsl_handle_input(buf, count);
+        }
+    }
+}
+
+// invoked when cdc when line state changed e.g connected/disconnected
+void tud_cdc_line_state_cb(uint8_t itf, bool dtr, bool rts) {
+    (void) itf;
+    (void) rts;
+
+    static bool last_dtr = false;
+
+    if (dtr && !last_dtr) {
+        // clear left-over console input
+        cnsl_init();
+
+        // show past history
+        log_dump_to_usb();
+
+        debug("terminal connected");
+    } else if (!dtr && last_dtr) {
+        debug("terminal disconnected");
+    }
+
+    last_dtr = dtr;
+}
+
+// invoked when CDC interface received data from host
+void tud_cdc_rx_cb(uint8_t itf) {
+    (void) itf;
+    cdc_task();
+}

src/usb_descriptors.c

@@ -0,0 +1,229 @@
+/*
+ * Extended from TinyUSB example code.
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Ha Thach (tinyusb.org)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ */
+
+#include "pico/unique_id.h"
+#include "tusb.h"
+
+#include "config.h"
+#include "usb_descriptors.h"
+
+/*
+ * A combination of interfaces must have a unique product id,
+ * since PC will save device driver after the first plug.
+ * Same VID/PID with different interface e.g MSC (first),
+ * then CDC (later) will possibly cause system error on PC.
+ *
+ * Auto ProductID layout's Bitmap:
+ *   [MSB]         HID | MSC | CDC          [LSB]
+ */
+#define _PID_MAP(itf, n) ((CFG_TUD_##itf) << (n))
+#define USB_PID (0x4200 | _PID_MAP(CDC, 0) | _PID_MAP(MSC, 1) \
+    | _PID_MAP(HID, 2) | _PID_MAP(MIDI, 3) | _PID_MAP(VENDOR, 4) )
+
+#define USB_VID   0xCafe
+#define USB_BCD   0x0200
+
+//--------------------------------------------------------------------+
+// Device Descriptors
+//--------------------------------------------------------------------+
+
+tusb_desc_device_t const desc_device =
+{
+    .bLength            = sizeof(tusb_desc_device_t),
+    .bDescriptorType    = TUSB_DESC_DEVICE,
+    .bcdUSB             = USB_BCD,
+
+    /*
+     * Use Interface Association Descriptor (IAD) for CDC
+     * As required by USB Specs IAD's subclass must be common class (2)
+     * and protocol must be IAD (1)
+     */
+    .bDeviceClass       = TUSB_CLASS_MISC,
+    .bDeviceSubClass    = MISC_SUBCLASS_COMMON,
+    .bDeviceProtocol    = MISC_PROTOCOL_IAD,
+
+    .bMaxPacketSize0    = CFG_TUD_ENDPOINT0_SIZE,
+
+    .idVendor           = USB_VID,
+    .idProduct          = USB_PID,
+    .bcdDevice          = 0x0100,
+
+    .iManufacturer      = 0x01,
+    .iProduct           = 0x02,
+    .iSerialNumber      = 0x03,
+
+    .bNumConfigurations = 0x01
+};
+
+// Invoked when received GET DEVICE DESCRIPTOR
+// Application return pointer to descriptor
+uint8_t const * tud_descriptor_device_cb(void) {
+    return (uint8_t const *) &desc_device;
+}
+
+//--------------------------------------------------------------------+
+// Configuration Descriptor
+//--------------------------------------------------------------------+
+
+enum {
+    ITF_NUM_CDC = 0,
+    ITF_NUM_CDC_DATA,
+    ITF_NUM_MSC,
+    ITF_NUM_TOTAL
+};
+
+#define  CONFIG_TOTAL_LEN  (TUD_CONFIG_DESC_LEN + TUD_CDC_DESC_LEN + TUD_MSC_DESC_LEN)
+
+#define EPNUM_CDC_NOTIF 0x82
+#define EPNUM_CDC_OUT   0x02
+#define EPNUM_CDC_IN    0x83
+#define EPNUM_MSC_OUT   0x03
+#define EPNUM_MSC_IN    0x84
+
+uint8_t const desc_configuration[] = {
+    // Config number, interface count, string index, total length, attribute, power in mA
+    TUD_CONFIG_DESCRIPTOR(1, ITF_NUM_TOTAL, 0, CONFIG_TOTAL_LEN, TUSB_DESC_CONFIG_ATT_REMOTE_WAKEUP, 100),
+
+    // Interface number, string index, EP notification address and size, EP data address (out, in) and size.
+    TUD_CDC_DESCRIPTOR(ITF_NUM_CDC, 4, EPNUM_CDC_NOTIF, 8, EPNUM_CDC_OUT, EPNUM_CDC_IN, 64),
+
+    // Interface number, string index, EP Out & EP In address, EP size
+    TUD_MSC_DESCRIPTOR(ITF_NUM_MSC, 5, EPNUM_MSC_OUT, EPNUM_MSC_IN, 64),
+};
+
+#if TUD_OPT_HIGH_SPEED
+// Per USB specs: high speed capable device must report device_qualifier and other_speed_configuration
+
+// other speed configuration
+uint8_t desc_other_speed_config[CONFIG_TOTAL_LEN];
+
+// device qualifier is mostly similar to device descriptor since we don't change configuration based on speed
+tusb_desc_device_qualifier_t const desc_device_qualifier = {
+    .bLength            = sizeof(tusb_desc_device_qualifier_t),
+    .bDescriptorType    = TUSB_DESC_DEVICE_QUALIFIER,
+    .bcdUSB             = USB_BCD,
+
+    .bDeviceClass       = TUSB_CLASS_MISC,
+    .bDeviceSubClass    = MISC_SUBCLASS_COMMON,
+    .bDeviceProtocol    = MISC_PROTOCOL_IAD,
+
+    .bMaxPacketSize0    = CFG_TUD_ENDPOINT0_SIZE,
+    .bNumConfigurations = 0x01,
+    .bReserved          = 0x00
+};
+
+// Invoked when received GET DEVICE QUALIFIER DESCRIPTOR request
+// Application return pointer to descriptor, whose contents must exist long enough for transfer to complete.
+// device_qualifier descriptor describes information about a high-speed capable device that would
+// change if the device were operating at the other speed. If not highspeed capable stall this request.
+uint8_t const* tud_descriptor_device_qualifier_cb(void) {
+    return (uint8_t const*) &desc_device_qualifier;
+}
+
+// Invoked when received GET OTHER SEED CONFIGURATION DESCRIPTOR request
+// Application return pointer to descriptor, whose contents must exist long enough for transfer to complete
+// Configuration descriptor in the other speed e.g if high speed then this is for full speed and vice versa
+uint8_t const* tud_descriptor_other_speed_configuration_cb(uint8_t index) {
+    (void) index; // for multiple configurations
+
+    // other speed config is basically configuration with type = OHER_SPEED_CONFIG
+    memcpy(desc_other_speed_config, desc_configuration, CONFIG_TOTAL_LEN);
+    desc_other_speed_config[1] = TUSB_DESC_OTHER_SPEED_CONFIG;
+
+    // this example use the same configuration for both high and full speed mode
+    return desc_other_speed_config;
+}
+
+#endif // highspeed
+
+// Invoked when received GET CONFIGURATION DESCRIPTOR
+// Application return pointer to descriptor
+// Descriptor contents must exist long enough for transfer to complete
+uint8_t const * tud_descriptor_configuration_cb(uint8_t index) {
+    (void) index; // for multiple configurations
+
+    // This example use the same configuration for both high and full speed mode
+    return desc_configuration;
+}
+
+//--------------------------------------------------------------------+
+// String Descriptors
+//--------------------------------------------------------------------+
+
+char string_pico_serial[2 * PICO_UNIQUE_BOARD_ID_SIZE_BYTES + 1];
+
+void usb_descriptor_init_id(void) {
+    pico_get_unique_board_id_string(string_pico_serial, sizeof(string_pico_serial));
+}
+
+// array of pointer to string descriptors
+char const* string_desc_arr [] = {
+    (const char[]) { 0x09, 0x04 }, // 0: is supported language is English (0x0409)
+    "xythobuz",                    // 1: Manufacturer
+    "VolcanoRC",                   // 2: Product
+    string_pico_serial,            // 3: Serials, should use chip ID
+    "Debug Serial",                // 4: CDC Interface
+    "Debug Memory",                // 5: MSC Interface
+};
+
+static uint16_t _desc_str[32];
+
+// Invoked when received GET STRING DESCRIPTOR request
+// Application return pointer to descriptor, whose contents must exist long enough for transfer to complete
+uint16_t const* tud_descriptor_string_cb(uint8_t index, uint16_t langid) {
+    (void) langid;
+
+    uint8_t chr_count;
+
+    if ( index == 0) {
+        memcpy(&_desc_str[1], string_desc_arr[0], 2);
+        chr_count = 1;
+    } else {
+        // Note: the 0xEE index string is a Microsoft OS 1.0 Descriptors.
+        // https://docs.microsoft.com/en-us/windows-hardware/drivers/usbcon/microsoft-defined-usb-descriptors
+
+        if ( !(index < sizeof(string_desc_arr)/sizeof(string_desc_arr[0])) ) return NULL;
+
+        const char* str = string_desc_arr[index];
+
+        // Cap at max char
+        chr_count = strlen(str);
+        if ( chr_count > 31 ) chr_count = 31;
+
+        // Convert ASCII string into UTF-16
+        for(uint8_t i=0; i<chr_count; i++) {
+            _desc_str[1+i] = str[i];
+        }
+    }
+
+    // first byte is length (including header), second byte is string type
+    _desc_str[0] = (TUSB_DESC_STRING << 8 ) | (2*chr_count + 2);
+
+    return _desc_str;
+}

src/usb_msc.c

@@ -0,0 +1,215 @@
+/*
+ * Extended from TinyUSB example code.
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Ha Thach (tinyusb.org)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#include "bsp/board.h"
+#include "tusb.h"
+
+#include "config.h"
+#include "fat_disk.h"
+#include "log.h"
+
+static bool ejected = false;
+static bool medium_available = false;
+
+bool msc_is_medium_available(void) {
+    return medium_available;
+}
+
+void msc_set_medium_available(bool state) {
+    medium_available = state;
+    if (state) {
+        ejected = false;
+    }
+}
+
+// Invoked when received SCSI_CMD_INQUIRY
+// Application fill vendor id, product id and revision
+// with string up to 8, 16, 4 characters respectively
+void tud_msc_inquiry_cb(uint8_t lun, uint8_t vendor_id[8],
+        uint8_t product_id[16], uint8_t product_rev[4]) {
+    (void) lun;
+
+    const char vid[] = "xythobuz";
+    const char pid[] = "Debug Storage";
+    const char rev[] = "0.01";
+
+    memcpy(vendor_id  , vid, strlen(vid));
+    memcpy(product_id , pid, strlen(pid));
+    memcpy(product_rev, rev, strlen(rev));
+}
+
+// Invoked when received Test Unit Ready command.
+// return true allowing host to read/write this LUN e.g SD card inserted
+bool tud_msc_test_unit_ready_cb(uint8_t lun) {
+    if (!medium_available) {
+        // Additional Sense 3A-00 is NOT_FOUND
+        tud_msc_set_sense(lun, SCSI_SENSE_NOT_READY, 0x3a, 0x00);
+    }
+
+    return medium_available;
+}
+
+// Invoked when received SCSI_CMD_READ_CAPACITY_10 and
+// SCSI_CMD_READ_FORMAT_CAPACITY to determine the disk size
+// Application update block count and block size
+void tud_msc_capacity_cb(uint8_t lun, uint32_t* block_count, uint16_t* block_size) {
+    (void) lun;
+
+    if (!medium_available) {
+        *block_count = 0;
+        *block_size = 0;
+    } else {
+        *block_count = DISK_BLOCK_COUNT;
+        *block_size  = DISK_BLOCK_SIZE;
+    }
+}
+
+// Invoked when received Start Stop Unit command
+// - Start = 0 : stopped power mode, if load_eject = 1 : unload disk storage
+// - Start = 1 : active mode, if load_eject = 1 : load disk storage
+bool tud_msc_start_stop_cb(uint8_t lun, uint8_t power_condition,
+        bool start, bool load_eject) {
+    (void) lun;
+    (void) power_condition;
+
+    if (start) {
+        // load disk storage
+        debug("load disk storage %d", load_eject);
+    } else {
+        // unload disk storage
+        debug("unload disk storage %d", load_eject);
+        if (load_eject) {
+            medium_available = false;
+        }
+    }
+
+    return true;
+}
+
+// Callback invoked when received READ10 command.
+// Copy disk's data to buffer (up to bufsize) and return number of copied bytes.
+int32_t tud_msc_read10_cb(uint8_t lun, uint32_t lba,
+        uint32_t offset, void* buffer, uint32_t bufsize) {
+    (void) lun;
+
+    // out of ramdisk
+    if (lba >= DISK_BLOCK_COUNT) {
+        return -1;
+    }
+
+    // TODO better range checking and length calculation?
+
+    uint8_t const* addr = fat_disk_get_sector(lba) + offset;
+    memcpy(buffer, addr, bufsize);
+
+    return (int32_t) bufsize;
+}
+
+bool tud_msc_is_writable_cb (uint8_t lun) {
+    (void) lun;
+
+    return true;
+}
+
+// Callback invoked when received WRITE10 command.
+// Process data in buffer to disk's storage and return number of written bytes
+int32_t tud_msc_write10_cb(uint8_t lun, uint32_t lba,
+        uint32_t offset, uint8_t* buffer, uint32_t bufsize) {
+    (void) lun;
+
+    // out of ramdisk
+    if (lba >= DISK_BLOCK_COUNT) {
+        return -1;
+    }
+
+    // TODO better range checking and length calculation?
+
+    uint8_t* addr = fat_disk_get_sector(lba) + offset;
+    memcpy(addr, buffer, bufsize);
+
+    return (int32_t) bufsize;
+}
+
+// Callback invoked when received an SCSI command not in built-in list below
+// - READ_CAPACITY10, READ_FORMAT_CAPACITY, INQUIRY, MODE_SENSE6, REQUEST_SENSE
+// - READ10 and WRITE10 has their own callbacks and MUST not be handled here
+int32_t tud_msc_scsi_cb (uint8_t lun, uint8_t const scsi_cmd[16],
+        void* buffer, uint16_t bufsize) {
+    void const* response = NULL;
+    int32_t resplen = 0;
+
+    // most scsi handled is input
+    bool in_xfer = true;
+
+    switch (scsi_cmd[0]) {
+    case 0x1E:
+        // Prevent/Allow Medium Removal
+        if (scsi_cmd[4] & 0x01) {
+            // Prevent medium removal
+            if (!medium_available) {
+                debug("Host wants to lock non-existing medium. Not supported.");
+                resplen = -1;
+            } else {
+                debug("Host wants to lock medium.");
+            }
+        } else {
+            // Allow medium removal
+            if (medium_available) {
+                debug("Host ejected medium. Unplugging disk.");
+                medium_available = false;
+            } else {
+                debug("host ejected non-existing medium. Not supported.");
+                resplen = -1;
+            }
+        }
+        break;
+
+    default:
+        // Set Sense = Invalid Command Operation
+        tud_msc_set_sense(lun, SCSI_SENSE_ILLEGAL_REQUEST, 0x20, 0x00);
+
+        // negative means error -> tinyusb could stall and/or response with failed status
+        resplen = -1;
+        break;
+    }
+
+    // return resplen must not larger than bufsize
+    if (resplen > bufsize) {
+        resplen = bufsize;
+    }
+
+    if (response && (resplen > 0)) {
+        if (in_xfer) {
+            memcpy(buffer, response, (size_t) resplen);
+        } else {
+            // SCSI output
+        }
+    }
+
+    return (int32_t) resplen;
+}

src/util.c

@@ -0,0 +1,93 @@
+/*
+ * util.c
+ *
+ * Copyright (c) 2022 - 2023 Thomas Buck (thomas@xythobuz.de)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * See <http://www.gnu.org/licenses/>.
+ */
+
+#include <string.h>
+#include "pico/stdlib.h"
+#include "pico/bootrom.h"
+#include "hardware/watchdog.h"
+
+#include "config.h"
+#include "log.h"
+#include "util.h"
+
+#define HEARTBEAT_INTERVAL_MS 500
+
+#ifdef PICO_DEFAULT_LED_PIN
+static uint32_t last_heartbeat = 0;
+#endif // PICO_DEFAULT_LED_PIN
+
+void heartbeat_init(void) {
+#ifdef PICO_DEFAULT_LED_PIN
+    gpio_init(PICO_DEFAULT_LED_PIN);
+    gpio_set_dir(PICO_DEFAULT_LED_PIN, GPIO_OUT);
+    gpio_put(PICO_DEFAULT_LED_PIN, 1);
+#endif // PICO_DEFAULT_LED_PIN
+}
+
+void heartbeat_run(void) {
+#ifdef PICO_DEFAULT_LED_PIN
+    uint32_t now = to_ms_since_boot(get_absolute_time());
+    if (now >= (last_heartbeat + HEARTBEAT_INTERVAL_MS)) {
+        last_heartbeat = now;
+        gpio_xor_mask(1 << PICO_DEFAULT_LED_PIN);
+    }
+#endif // PICO_DEFAULT_LED_PIN
+}
+
+bool str_startswith(const char *str, const char *start) {
+    size_t l = strlen(start);
+    if (l > strlen(str)) {
+        return false;
+    }
+    return (strncmp(str, start, l) == 0);
+}
+
+int32_t convert_two_complement(int32_t b) {
+    if (b & 0x8000) {
+        b = -1 * ((b ^ 0xffff) + 1);
+    }
+    return b;
+}
+
+void reset_to_bootloader(void) {
+#ifdef PICO_DEFAULT_LED_PIN
+    reset_usb_boot(1 << PICO_DEFAULT_LED_PIN, 0);
+#else // ! PICO_DEFAULT_LED_PIN
+    reset_usb_boot(0, 0);
+#endif // PICO_DEFAULT_LED_PIN
+}
+
+void reset_to_main(void) {
+    watchdog_enable(1, 1);
+    while (1) {
+        // wait 1ms until watchdog kills us
+        asm volatile("nop");
+    }
+}
+
+void hexdump(uint8_t *buff, size_t len) {
+    for (size_t i = 0; i < len; i += 16) {
+        for (size_t j = 0; (j < 16) && ((i + j) < len); j++) {
+            print("0x%02X", buff[i + j]);
+            if ((j < 15) && ((i + j) < (len - 1))) {
+                print(" ");
+            }
+        }
+        println();
+    }
+}

st7789

@@ -0,0 +1 @@
+Subproject commit 1b211accf9d626666f0d4aad5edffba2791398a2