.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,145 @@
+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_disk.c
+    src/buttons.c
+    src/lipo.c
+    src/ble.c
+    src/lcd.c
+    src/text.c
+    src/image.c
+    src/state.c
+    src/volcano.c
+    src/serial.c
+    src/ring.c
+    src/models.c
+    src/state_scan.c
+    src/workflow.c
+    src/menu.c
+    src/state_volcano_workflow.c
+    src/state_volcano_run.c
+    src/crafty.c
+    src/state_crafty.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}/st7789/interface)
+target_include_directories(gadget PUBLIC ${CMAKE_CURRENT_LIST_DIR}/mcufont/decoder)
+target_include_directories(gadget PUBLIC ${CMAKE_CURRENT_LIST_DIR}/mcufont/fonts)
+target_include_directories(gadget PUBLIC ${CMAKE_CURRENT_LIST_DIR}/build)
+
+# compress source code and stuff we want to include
+add_custom_target(pack bash -c "./pack_data.sh"
+    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+    BYPRODUCTS "build/pack_data.h"
+)
+add_dependencies(gadget pack)
+
+# 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)
+set_source_files_properties(pico-sdk/lib/btstack/src/classic/avdtp_util.c PROPERTIES COMPILE_FLAGS -Wno-unused-parameter)
+set_source_files_properties(pico-sdk/lib/btstack/src/classic/goep_client.c PROPERTIES COMPILE_FLAGS -Wno-unused-parameter)
+set_source_files_properties(pico-sdk/lib/btstack/src/classic/goep_server.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
+    hardware_adc
+    hardware_gpio
+    hardware_pwm
+    pico_btstack_ble
+    pico_btstack_cyw43
+    pico_cyw43_arch_threadsafe_background
+)
+
+target_compile_definitions(gadget PUBLIC
+    RUNNING_AS_CLIENT=1
+    CYW43_LWIP=0
+)
+
+# 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)

COPYING

@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    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.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

README.md

@@ -0,0 +1,131 @@
+# Pi Pico Volcano Remote Control Gadget
+
+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).
+
+Adapted from the [tinyusb-cdc-example](https://github.com/hathach/tinyusb/blob/master/examples/device/cdc_msc/src/main.c), [adc example](https://github.com/raspberrypi/pico-examples/tree/master/adc/read_vsys), [standalone client example](https://github.com/raspberrypi/pico-examples/blob/master/pico_w/bt/standalone/client.c) and my [Trackball firmware](https://git.xythobuz.de/thomas/Trackball).
+
+## 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
+
+    cd ../.. # back to build_debug directory from before
+
+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
+
+    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
+
+    cd .. # back to build_debug directory from before
+
+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
+
+    load # program elf into flash
+    monitor reset init # put into clean initial state
+    continue # start program
+
+These commands have also been put in the `flash_swd.sh` and `debug_swd.sh` scripts, respectively.
+They require the `build_debug` folder where you checked out and built OpenOCD.
+Here are some [general GDB tips](https://beej.us/guide/bggdb/).
+
+## License
+
+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
+    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/>.

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_VolcanoRC_*
+
+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 --imap lfcrlf $SERIAL

debug_swd.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+echo Starting OpenOCD in background
+echo "\n\nstarting new openocd" >> openocd.log
+./build_debug/openocd/src/openocd -s build_debug/openocd/tcl -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000" -c "cmsis_dap_vid_pid 0x2e8a 0x000c" >> openocd.log 2>&1 &
+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" \
+-ex "tui new-layout default src 1 status 1 cmd 2" \
+-ex "tui layout default" \
+-ex "tui enable" \
+$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_VolcanoRC_*
+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,6 @@
+#!/bin/bash
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+./build_debug/openocd/src/openocd -s build_debug/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/ble.h

@@ -0,0 +1,61 @@
+/*
+ * ble.h
+ *
+ * Copyright (c) 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 __BLE_H__
+#define __BLE_H__
+
+#include "btstack.h"
+
+#define BLE_MAX_NAME_LENGTH 32
+#define BLE_MAX_DATA_LENGTH 26
+#define BLE_MAX_SCAN_RESULTS 32
+#define BLE_MAX_VALUE_LEN 64
+
+enum ble_scan_mode {
+    BLE_SCAN_OFF    = 0,
+    BLE_SCAN_ON     = 1,
+    BLE_SCAN_TOGGLE = 2,
+};
+
+struct ble_scan_result {
+    bool set;
+    uint32_t time;
+
+    bd_addr_t addr;
+    bd_addr_type_t type;
+    int8_t rssi;
+    char name[BLE_MAX_NAME_LENGTH + 1];
+    uint8_t data[BLE_MAX_DATA_LENGTH];
+    size_t data_len;
+};
+
+void ble_init(void);
+bool ble_is_ready(void);
+
+void ble_scan(enum ble_scan_mode mode);
+int32_t ble_get_scan_results(struct ble_scan_result *buf, uint16_t len);
+
+void ble_connect(bd_addr_t addr, bd_addr_type_t type);
+bool ble_is_connected(void);
+void ble_disconnect(void);
+
+int32_t ble_read(const uint8_t *characteristic, uint8_t *buff, uint16_t buff_len);
+int8_t ble_write(const uint8_t *service, const uint8_t *characteristic,
+                 uint8_t *buff, uint16_t buff_len);
+
+#endif // __BLE_H__

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,42 @@
+/*
+ * 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__
+
+#include <stdbool.h>
+
+enum buttons {
+    BTN_A = 0,
+    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_callback(void (*fp)(enum buttons, bool));
+void buttons_run(void);
+
+#endif // __BUTTONS_H__
+

include/config.h

@@ -0,0 +1,48 @@
+/*
+ * 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 MENU_PREFER_VOLCANO
+//#define MENU_PREFER_CRAFTY
+
+#define WATCHDOG_PERIOD_MS 1000
+
+// ASCII 0x18 = CAN (cancel)
+#define ENTER_BOOTLOADER_MAGIC 0x18
+
+//#define DISABLE_CDC_DTR_CHECK
+#define DEBOUNCE_DELAY_MS 5
+
+#define SERIAL_WRITES_BLOCK_WHEN_BUFFER_FULL
+
+#define DEBUG_DISK_WRITE_SOURCES
+
+#define DISK_BLOCK_SIZE 512
+
+#ifdef DEBUG_DISK_WRITE_SOURCES
+#define DISK_BLOCK_COUNT (256 + 128)
+#else // DEBUG_DISK_WRITE_SOURCES
+#define DISK_BLOCK_COUNT 256
+#endif // DEBUG_DISK_WRITE_SOURCES
+
+//#define TEST_VOLCANO_AUTO_CONNECT "xx:xx:xx:xx:xx:xx 1"
+//#define TEST_CRAFTY_AUTO_CONNECT "xx:xx:xx:xx:xx:xx 0"
+
+#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 uint8_t *buf, size_t len);
+
+#endif // __CONSOLE_H__

include/crafty.h

@@ -0,0 +1,38 @@
+/*
+ * crafty.h
+ *
+ * Copyright (c) 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 __CRAFTY_H__
+#define __CRAFTY_H__
+
+#include <stdint.h>
+#include <stdbool.h>
+
+// in 1/10th degrees C, or < 0 on error
+int16_t crafty_get_current_temp(void);
+int16_t crafty_get_target_temp(void);
+
+// v in 1/10th degrees C, returns < 0 on error
+int8_t crafty_set_target_temp(uint16_t v);
+
+// returns < 0 on error
+int8_t crafty_set_heater_state(bool value);
+
+// in percent, or < 0 on error
+int8_t crafty_get_battery_state(void);
+
+#endif // __CRAFTY_H__

include/debug_disk.h

@@ -0,0 +1,27 @@
+/*
+ * debug_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/>.
+ */
+
+#ifndef __DEBUG_DISK_H__
+#define __DEBUG_DISK_H__
+
+void debug_disk_init(void);
+
+int debug_disk_mount(void);
+int debug_disk_unmount(void);
+
+#endif // __DEBUG_DISK_H__

include/fat_disk.h

@@ -0,0 +1,21 @@
+/* 
+ * 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/>.
+ */
+
+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/image.h

@@ -0,0 +1,30 @@
+/*
+ * image.h
+ *
+ * Copyright (c) 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 __IMAGE_H__
+#define __IMAGE_H__
+
+#include "pico/stdlib.h"
+
+void image_draw(const char *data, uint width, uint height);
+
+void draw_splash(void);
+void draw_battery_indicator(void);
+void battery_run(void);
+
+#endif // __IMAGE_H__

include/lcd.h

@@ -0,0 +1,44 @@
+/*
+ * lipo.h
+ *
+ * Copyright (c) 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 __LCD_H__
+#define __LCD_H__
+
+#include <stdint.h>
+
+#define RGB_565(r, g, b) ( \
+      (((r) >> 3) << 11)   \
+    | (((g) >> 2) << 5)    \
+    |  ((b) >> 3)          \
+)
+#define RGB_565_REV(c)            \
+    ((c & 0xF800) >> 8) / 255.0f, \
+    ((c & 0x07E0) >> 3) / 255.0f, \
+    ((c & 0x001F) << 3) / 255.0f
+uint32_t from_hsv(float h, float s, float v);
+
+void lcd_init(void);
+
+uint16_t lcd_get_backlight(void);
+void lcd_set_backlight(uint16_t value);
+
+void lcd_clear(void);
+void lcd_write_point(uint16_t x, uint16_t y, uint32_t color);
+void lcd_write_rect(uint16_t left, uint16_t top, uint16_t right, uint16_t bottom, uint32_t color);
+
+#endif // __LCD_H__

include/lipo.h

@@ -0,0 +1,26 @@
+/*
+ * lipo.h
+ *
+ * Copyright (c) 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 __LIPO_H__
+#define __LIPO_H__
+
+bool lipo_charging(void);
+float lipo_voltage(void);
+float lipo_percentage(float voltage);
+
+#endif // __LIPO_H__

include/log.h

@@ -0,0 +1,48 @@
+/*
+ * 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 <stdarg.h>
+#include <stdbool.h>
+#include "pico/stdlib.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 debug_log_va(bool log, const char *format, va_list args);
+
+void log_dump_to_usb(void);
+void log_dump_to_uart(void);
+void log_dump_to_disk(void);
+
+void debug_handle_input(const uint8_t *buff, size_t len);
+
+#endif // __LOG_H__

include/main.h

@@ -0,0 +1,24 @@
+/*
+ * main.h
+ *
+ * Copyright (c) 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 __MAIN_H__
+#define __MAIN_H__
+
+void main_loop_hw(void);
+
+#endif // __MAIN_H__

include/menu.h

@@ -0,0 +1,37 @@
+/*
+ * menu.h
+ *
+ * Copyright (c) 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 __MENU_H__
+#define __MENU_H__
+
+#define MENU_MAX_LINES 5
+#define MENU_MAX_LEN (MENU_MAX_LINES * 32)
+
+struct menu_state {
+    int off;
+    int selection;
+    int length;
+    char *buff;
+};
+
+void menu_init(void (*enter)(int), void (*exit)(void));
+void menu_deinit(void);
+
+void menu_run(void (*cb)(struct menu_state *));
+
+#endif // __MENU_H__

include/models.h

@@ -0,0 +1,33 @@
+/*
+ * models.h
+ *
+ * Copyright (c) 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 __MODELS_H__
+#define __MODELS_H__
+
+#include <stdint.h>
+
+enum known_devices {
+    DEV_UNKNOWN = 0,
+    DEV_VOLCANO,
+    DEV_CRAFTY,
+};
+
+enum known_devices models_filter_name(const char *name);
+int8_t models_get_serial(const uint8_t *data, size_t data_len, char *buff, size_t buff_len);
+
+#endif // __MODELS_H__

include/ring.h

@@ -0,0 +1,43 @@
+/*
+ * ring.h
+ *
+ * Copyright (c) 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 __RING_BUFFER_H__
+#define __RING_BUFFER_H__
+
+#include <stddef.h>
+#include <stdint.h>
+#include <stdbool.h>
+
+struct ring_buffer {
+    uint8_t *buffer;
+    size_t size;
+    size_t head, tail;
+    bool full;
+};
+#define RB_INIT(b, s) { .buffer = b, .size = s, .head = 0, .tail = 0, .full = false }
+
+void rb_add(struct ring_buffer *rb, const uint8_t *data, size_t length);
+#define rb_push(rb, v) rb_add(rb, &v, 1)
+size_t rb_len(struct ring_buffer *rb);
+#define rb_space(rb) ((rb)->size - rb_len(rb))
+void rb_dump(struct ring_buffer *rb, void (*write)(const uint8_t *, size_t));
+void rb_move(struct ring_buffer *rb, void (*write)(const uint8_t *, size_t));
+uint8_t rb_peek(struct ring_buffer *rb);
+uint8_t rb_pop(struct ring_buffer *rb);
+
+#endif // __RING_BUFFER_H__

include/serial.h

@@ -0,0 +1,31 @@
+/*
+ * serial.h
+ *
+ * Copyright (c) 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 __SERIAL_H__
+#define __SERIAL_H__
+
+#include <stddef.h>
+#include <stdint.h>
+#include <stdbool.h>
+
+void serial_init(void);
+void serial_write(const uint8_t *buf, size_t count);
+void serial_set_reroute(bool reroute);
+void serial_run(void);
+
+#endif // __SERIAL_H__

include/state.h

@@ -0,0 +1,33 @@
+/*
+ * state.h
+ *
+ * Copyright (c) 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 __STATE_H__
+#define __STATE_H__
+
+enum system_state {
+    STATE_INIT = 0,
+    STATE_SCAN,
+    STATE_VOLCANO_WORKFLOW,
+    STATE_VOLCANO_RUN,
+    STATE_CRAFTY,
+};
+
+void state_switch(enum system_state next);
+void state_run(void);
+
+#endif // __STATE_H__

include/state_crafty.h

@@ -0,0 +1,30 @@
+/*
+ * state_crafty.h
+ *
+ * Copyright (c) 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 __STATE_CRAFTY_H__
+#define __STATE_CRAFTY_H__
+
+#include <ble.h>
+
+void state_crafty_target(bd_addr_t addr, bd_addr_type_t type);
+
+void state_crafty_enter(void);
+void state_crafty_exit(void);
+void state_crafty_run(void);
+
+#endif // __STATE_CRAFTY_H__

include/state_scan.h

@@ -0,0 +1,26 @@
+/*
+ * state_scan.h
+ *
+ * Copyright (c) 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 __STATE_SCAN_H__
+#define __STATE_SCAN_H__
+
+void state_scan_enter(void);
+void state_scan_exit(void);
+void state_scan_run(void);
+
+#endif // __STATE_SCAN_H__

include/state_volcano_run.h

@@ -0,0 +1,31 @@
+/*
+ * state_volcano_run.h
+ *
+ * Copyright (c) 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 __STATE_VOLCANO_RUN_H__
+#define __STATE_VOLCANO_RUN_H__
+
+#include <ble.h>
+
+void state_volcano_run_index(uint16_t index);
+void state_volcano_run_target(bd_addr_t addr, bd_addr_type_t type);
+
+void state_volcano_run_enter(void);
+void state_volcano_run_exit(void);
+void state_volcano_run_run(void);
+
+#endif // __STATE_VOLCANO_RUN_H__

include/state_volcano_workflow.h

@@ -0,0 +1,26 @@
+/*
+ * state_volcano_workflow.h
+ *
+ * Copyright (c) 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 __STATE_VOLCANO_WORKFLOW_H__
+#define __STATE_VOLCANO_WORKFLOW_H__
+
+void state_volcano_wf_enter(void);
+void state_volcano_wf_exit(void);
+void state_volcano_wf_run(void);
+
+#endif // __STATE_VOLCANO_WORKFLOW_H__

include/text.h

@@ -0,0 +1,53 @@
+/*
+ * text.h
+ *
+ * Copyright (c) 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 __TEXT_H__
+#define __TEXT_H__
+
+#include "mcufont.h"
+
+#define TEXT_BG_NONE -1
+
+struct text_font {
+    const char *fontname;
+    //int scale; // TODO not supported - requires somewhere to store scaled versions
+
+    const struct mf_font_s *font;
+};
+
+struct text_conf {
+    const char *text;
+    int x;
+    int y;
+    bool justify;
+    enum mf_align_t alignment;
+    int width;
+    int height;
+    int margin;
+    int fg;
+    int bg;
+
+    struct text_font *font;
+};
+
+void text_prepare_font(struct text_font *tf);
+void text_draw(struct text_conf *tc);
+
+void text_box(const char *s);
+
+#endif // __TEXT_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,29 @@
+/*
+ * 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__
+
+#include <stddef.h>
+#include <stdint.h>
+#include <stdbool.h>
+
+void usb_cdc_write(const uint8_t *buf, size_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,36 @@
+/*
+ * 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(const uint8_t *buff, size_t len);
+
+float map(float value, float leftMin, float leftMax, float rightMin, float rightMax);
+
+#endif // __UTIL_H__

include/volcano.h

@@ -0,0 +1,36 @@
+/*
+ * volcano.h
+ *
+ * Copyright (c) 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 __VOLCANO_H__
+#define __VOLCANO_H__
+
+#include <stdint.h>
+#include <stdbool.h>
+
+// in 1/10th degrees C, or < 0 on error
+int16_t volcano_get_current_temp(void);
+int16_t volcano_get_target_temp(void);
+
+// v in 1/10th degrees C, returns < 0 on error
+int8_t volcano_set_target_temp(uint16_t v);
+
+// returns < 0 on error
+int8_t volcano_set_heater_state(bool value);
+int8_t volcano_set_pump_state(bool value);
+
+#endif // __VOLCANO_H__

include/workflow.h

@@ -0,0 +1,60 @@
+/*
+ * workflow.h
+ *
+ * Copyright (c) 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 __WORKFLOW_H__
+#define __WORKFLOW_H__
+
+#include <stdint.h>
+
+enum wf_op {
+    OP_SET_TEMPERATURE = 0,
+    OP_WAIT_TEMPERATURE,
+    OP_WAIT_TIME,
+    OP_PUMP_TIME,
+};
+
+struct wf_step {
+    enum wf_op op;
+    uint16_t val;
+};
+
+enum wf_status {
+    WF_IDLE = 0,
+    WF_RUNNING,
+};
+
+struct wf_state {
+    enum wf_status status;
+
+    uint16_t index;
+    uint16_t count;
+    struct wf_step step;
+    uint16_t start_val, curr_val;
+};
+
+uint16_t wf_count(void);
+const char *wf_name(uint16_t index);
+const char *wf_author(uint16_t index);
+
+struct wf_state wf_status(void);
+void wf_start(uint16_t index);
+
+void wf_reset(void);
+void wf_run(void);
+
+#endif // __WORKFLOW_H__

mcufont

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

pack_data.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+set -euo pipefail
+
+cd "$(dirname "$0")"
+echo "Packing data"
+
+rm -rf build/src
+mkdir -p build/src
+cp COPYING build/src
+cp README.md build/src
+cp CMakeLists.txt build/src
+cp .gitmodules build/src/gitmodules
+cp -r include build/src
+cp -r src build/src
+
+cd build
+rm -rf data.tar data.tar.xz
+tar -f data.tar -c src
+xz -z -9 data.tar
+
+xxd -i data.tar.xz > pack_data.h
+sed -i 's/unsigned/static const unsigned/g' pack_data.h

pico-sdk

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

python-test/copy.sh

@@ -1,5 +1,21 @@
 #!/bin/bash
 
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
+
 BRANCH=`git symbolic-ref --short HEAD`
 HASH=`git rev-parse --short HEAD`
 DATE=`date "+%Y-%m-%d %H:%M:%S"`

python-test/lcd.py

@@ -1,3 +1,21 @@
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
+
 # https://www.waveshare.com/wiki/Pico-LCD-1.3
 # https://thepihut.com/blogs/raspberry-pi-tutorials/coding-graphics-with-micropython-on-raspberry-pi-pico-displays
 # https://api.arcade.academy/en/latest/_modules/arcade/draw_commands.html#draw_arc_filled
@@ -18,6 +36,9 @@ class KeyCheck:
     def once(self, k):
         return self.new[k] and not self.old[k]
 
+    def held(self, k):
+        return self.new[k]
+
 class LCD(framebuf.FrameBuffer):
     def __init__(self):
         self.pwm = PWM(Pin(13))
@@ -32,8 +53,6 @@ class LCD(framebuf.FrameBuffer):
 
         self.cs(1)
 
-        #self.spi = SPI(1)
-        #self.spi = SPI(1,   1_000_000)
         self.spi = SPI(1, 100_000_000, polarity=0, phase=0, sck=Pin(10), mosi=Pin(11), miso=None)
 
         self.dc = Pin(8, Pin.OUT)
@@ -77,6 +96,15 @@ class LCD(framebuf.FrameBuffer):
             "enter": False,
         }
 
+        self.curr_brightness = 0.0
+        try:
+            with open("_cur_bright.txt", "r") as f:
+                s = next(f).split()[0]
+                self.curr_brightness = float(s)
+        except:
+            pass
+        self.brightness(self.curr_brightness)
+
     def buttons(self):
         keys = {
             "a": self.keyA.value() == 0,
@@ -97,7 +125,25 @@ class LCD(framebuf.FrameBuffer):
     def color(self, R, G, B):
         return (((G & 0b00011100) << 3) + ((B & 0b11111000) >> 3) << 8) + (R & 0b11111000) + ((G & 0b11100000) >> 5)
 
+    def store_brightness(self):
+        old = -1.0
+        try:
+            with open("_cur_bright.txt", "r") as f:
+                s = next(f).split()[0]
+                old = float(s)
+        except:
+            pass
+        if self.curr_brightness != old:
+            with open("_cur_bright.txt", "w") as f:
+                s = "{}\n".format(self.curr_brightness)
+                f.write(s)
+
     def brightness(self, v):
+        if v < 0.0:
+            v = 0.0
+        if v > 1.0:
+            v = 1.0
+        self.curr_brightness = v
         self.pwm.duty_u16(int(v * 65535))
 
     def write_cmd(self, cmd):

python-test/ota.py

@@ -0,0 +1,187 @@
+#!/usr/bin/env python3
+
+# Uses the Gitea API to fetch the latest revision of the project from a repo.
+#
+# Inspired by:
+# https://github.com/olivergregorius/micropython_ota
+#
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
+
+import util
+import sys
+import os
+
+class StateUpdate:
+    def __init__(self, lcd):
+        self.host = "https://git.xythobuz.de"
+        self.repo = "thomas/sb-py"
+        self.branch = None
+        self.exe_path = "states.py"
+        self.blacklist = [
+            "README.md",
+            "COPYING",
+            ".gitignore",
+            "python-test/.gitignore",
+            "python-test/copy.sh",
+            "web-app/fetch.sh",
+        ]
+
+        self.lcd = lcd
+
+        self.get = None
+        self.version_file = "_ota_version"
+
+    def fetch(self, url):
+        # lazily initialize WiFi
+        if self.get == None:
+            self.get, post = util.getRequests()
+            if self.get == None:
+                return None
+
+        try:
+            #print("GET " + url)
+            r = self.get(url)
+
+            # explitic close on Response object not needed,
+            # handled internally by r.content / r.text / r.json()
+            # to avoid this automatic behaviour, first access r.content
+            # to trigger caching it in response object, then close
+            # socket.
+            tmp = r.content
+            if hasattr(r, "raw"):
+                if r.raw != None:
+                    r.raw.close()
+                    r.raw = None
+
+            return r
+        except Exception as e:
+            print()
+            print(url)
+            if hasattr(sys, "print_exception"):
+                sys.print_exception(e)
+            else:
+                print(e)
+            print()
+            return None
+
+    def get_stored_commit(self):
+        current = "unknown"
+        try:
+            f = open(self.version_file, "r")
+            current = f.readline().strip()
+            f.close()
+        except Exception as e:
+            print()
+            if hasattr(sys, "print_exception"):
+                sys.print_exception(e)
+            else:
+                print(e)
+            print()
+        return current
+
+    def get_previous_commit(self, commit):
+        r = self.fetch(self.host + "/" + self.repo + "/commit/" + commit).text
+        for line in r.splitlines():
+            if not (self.repo + "/commit/") in line:
+                continue
+
+            line = line[line.find("/commit/") : ][8 : ][ : 40]
+            if line != commit:
+                return line
+        return "unknown"
+
+    def check(self, verbose = False):
+        if self.branch == None:
+            # get default branch
+            r = self.fetch(self.host + "/api/v1/repos/" + self.repo).json()
+            self.branch = r["default_branch"]
+
+            if verbose:
+                print("Selected default branch " + self.branch)
+
+        # check for latest commit in branch
+        r = self.fetch(self.host + "/api/v1/repos/" + self.repo + "/branches/" + self.branch).json()
+        commit = r["commit"]["id"]
+
+        if verbose:
+            print("Latest commit is " + commit)
+
+        current = self.get_stored_commit()
+
+        if verbose:
+            if current != commit:
+                print("Current commit " + current + " is different!")
+            else:
+                print("No update required")
+
+        return (current != commit, commit)
+
+    def update_to_commit(self, commit, verbose = False):
+        # list all files for a commit
+        r = self.fetch(self.host + "/api/v1/repos/" + self.repo + "/git/trees/" + commit).json()
+
+        # TODO does not support sub-folders
+
+        if verbose:
+            if len(r["tree"]) > 0:
+                print(str(len(r["tree"])) + " files in repo:")
+                for f in r["tree"]:
+                    if f["path"] in self.blacklist:
+                        print("  - (IGNORED) " + f["path"])
+                    else:
+                        print("  - " + f["path"])
+            else:
+                print("No files in repo?!")
+
+        for f in r["tree"]:
+            if f["path"] in self.blacklist:
+                continue
+
+            # get a file from a commit
+            r = self.fetch(self.host + "/" + self.repo + "/raw/commit/" + commit + "/" + f["path"]).text
+
+            if verbose:
+                print("Writing " + f["path"])
+
+            # overwrite existing file
+            fo = open(f["path"], "w")
+            fo.write(r)
+            fo.close()
+
+            if f["path"] == self.exe_path:
+                if verbose:
+                    print("Writing " + f["path"] + " to main.py")
+
+                fo = open("./main.py", "w")
+                fo.write(r)
+                fo.close()
+
+        # Write new commit id to local file
+        f = open(self.version_file, "w")
+        f.write(commit + "\n")
+        f.close()
+
+def pico_ota_run():
+    print("Checking for updates")
+    newer, commit = ota.check(True)
+
+    if newer:
+        print("Updating to:", commit)
+        ota.update_to_commit(commit, True)
+
+        print("Resetting")
+        machine.soft_reset()

python-test/poll.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import uasyncio as asyncio
 import bluetooth

python-test/scan.py

@@ -1,3 +1,21 @@
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
+
 # https://github.com/micropython/micropython-lib/blob/master/micropython/bluetooth/aioble/examples/temp_client.py
 
 import uasyncio as asyncio

python-test/state_connect.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import uasyncio as asyncio
 from poll import cache_services_characteristics

python-test/state_heat.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import uasyncio as asyncio
 from poll import set_state, set_target_temp

python-test/state_notify.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import time
 import uasyncio as asyncio

python-test/state_pump.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import time
 import uasyncio as asyncio

python-test/state_scan.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import uasyncio as asyncio
 from scan import ble_scan
@@ -23,6 +39,8 @@ class StateScan:
         if self.lock.locked():
             self.lock.release()
 
+        self.lcd.store_brightness()
+
         return self.results[self.current][4]
 
     async def scan(self):
@@ -83,7 +101,7 @@ class StateScan:
             if self.current == i:
                 c2 = self.lcd.red
 
-            self.lcd.hline(0, off, self.lcd.width, self.lcd.blue)
+            self.lcd.hline(0, off - 3, self.lcd.width, self.lcd.blue)
             self.lcd.text(s1, 0, off + 2, c1)
             self.lcd.text(s2, 0, off + 12, c2)
 
@@ -106,6 +124,17 @@ class StateScan:
                     self.current = 0
                 else:
                     self.current += 1
+            elif keys.once("x"):
+                return 10
+            elif keys.held("left"):
+                v = self.lcd.curr_brightness - 0.05
+                if v < 0.05:
+                    v = 0.05
+                self.lcd.brightness(v)
+            elif keys.held("right"):
+                self.lcd.brightness(self.lcd.curr_brightness + 0.05)
+            elif keys.once("y"):
+                return 0
 
             if self.current != None:
                 while self.current < 0:
@@ -129,4 +158,7 @@ class StateScan:
 
             self.draw_list()
 
+        w = int(self.lcd.width * self.lcd.curr_brightness)
+        self.lcd.hline(0, 24, w, self.lcd.white)
+
         return -1

python-test/state_select.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import uasyncio as asyncio
 from workflows import workflows
@@ -13,6 +29,7 @@ class StateSelect:
         self.menuOff = 0
 
     def exit(self):
+        self.lcd.store_brightness()
         return self.client, workflows[self.current]
 
     def draw_list(self):
@@ -31,7 +48,7 @@ class StateSelect:
             if self.current == i:
                 c = self.lcd.red
 
-            self.lcd.hline(0, off, self.lcd.width, self.lcd.blue)
+            self.lcd.hline(0, off - 3, self.lcd.width, self.lcd.blue)
             self.lcd.text(s1, 0, off + 2, c)
             self.lcd.text(s2, 0, off + 12, c)
 
@@ -48,6 +65,13 @@ class StateSelect:
             self.current += 1
         elif keys.once("enter") or keys.once("a"):
             return 1
+        elif keys.held("left"):
+            v = self.lcd.curr_brightness - 0.05
+            if v < 0.05:
+                v = 0.05
+            self.lcd.brightness(v)
+        elif keys.held("right"):
+            self.lcd.brightness(self.lcd.curr_brightness + 0.05)
 
         while self.current < 0:
             self.current += len(workflows)
@@ -60,4 +84,7 @@ class StateSelect:
 
         self.draw_list()
 
+        w = int(self.lcd.width * self.lcd.curr_brightness)
+        self.lcd.hline(0, 24, w, self.lcd.white)
+
         return -1

python-test/state_wait_temp.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import uasyncio as asyncio
 from poll import set_target_temp, get_current_temp

python-test/state_wait_time.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 import time
 from state_wait_temp import draw_graph

python-test/states.py

@@ -1,4 +1,23 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
+
+from lcd import LCD
+lcd = LCD()
 
 import uasyncio as asyncio
 import io
@@ -7,13 +26,16 @@ import machine
 import os
 import gc
 import time
+from state_wait_temp import from_hsv, translate
 
 # https://github.com/pimoroni/pimoroni-pico/blob/main/micropython/examples/pico_lipo_shim/battery_pico.py
 # https://github.com/pimoroni/enviro/pull/146
 # TODO https://github.com/micropython/micropython/issues/11185
 
-full_battery = 4.2
+full_battery = 4.1
 empty_battery = 3.2
+batt_warn_limit = 15
+batt_reread_limit = 2.7
 
 charging = machine.Pin("WL_GPIO2", machine.Pin.IN)
 conversion_factor = 3 * 3.3 / 65535
@@ -35,7 +57,7 @@ def batteryVoltageAverage():
     old_pad = get_pad(29)
     set_pad(29, 128)  # no pulls, no output, no input
 
-    sample_count = 10
+    sample_count = 3
     voltage = 0
     for i in range(0, sample_count):
         voltage += batteryVoltageRead()
@@ -47,13 +69,17 @@ def batteryVoltageAverage():
 def batteryVoltage():
     global cachedVoltage, lastCaching
 
-    if ((time.time() - lastCaching) >= 2) or (cachedVoltage == None):
+    if ((time.time() - lastCaching) > 0) or (cachedVoltage == None):
         lastCaching = time.time()
         cachedVoltage = batteryVoltageAverage()
+        if cachedVoltage <= batt_reread_limit:
+            cachedVoltage = batteryVoltageAverage()
 
     percentage = 100.0 * ((cachedVoltage - empty_battery) / (full_battery - empty_battery))
-    if percentage > 100.0:
-        percentage = 100.0
+    if percentage >= 100.0:
+        percentage = 99.0
+    elif percentage < 0.0:
+        percentage = 0.0
 
     return cachedVoltage, percentage
 
@@ -70,20 +96,35 @@ class States:
         self.lcd.fill(self.lcd.black)
         self.lcd.text("Volcano Remote Control App", 0, 0, self.lcd.green)
 
-        r = await self.states[self.current].draw()
+        ret = await self.states[self.current].draw()
 
         voltage, percentage = batteryVoltage()
-        s = "Charging ({:.2f}V)".format(voltage)
-        c = self.lcd.green
+        s = "Charging"
+        c = self.lcd.white
         if charging.value() != 1:
             s = "{:.0f}% ({:.2f}V)".format(percentage, voltage)
-            c = self.lcd.white
-            if percentage <= 20:
+            if percentage <= batt_warn_limit:
                 c = self.lcd.red
-        self.lcd.text("Battery: {}".format(s), 0, self.lcd.height - 10, c)
+            else:
+                hue = translate(percentage, batt_warn_limit, 100, 0.0, 0.333)
+                r, g, b = from_hsv(hue, 1.0, 1.0)
+                c = self.lcd.color(r, g, b)
+        whole = "Batt: {}".format(s)
+        self.lcd.text(whole, 0, self.lcd.height - 10, c)
+
+        off = (len(whole) + 1) * 8
+        if percentage <= batt_warn_limit:
+            self.lcd.text("CHARGE NOW!", off, self.lcd.height - 10, self.lcd.red)
+        elif charging.value() != 1:
+            self.lcd.rect(off, self.lcd.height - 10, self.lcd.width - off, 8, c, False)
+            max_w = self.lcd.width - off - 2
+            w = int(percentage / 100.0 * max_w)
+            self.lcd.rect(off + 1, self.lcd.height - 9, w, 6, c, True)
+        else:
+            pass # TODO charge indicator (lightning bolt?)
 
         self.lcd.show()
-        return r
+        return ret
 
     def run(self):
         if self.current == None:
@@ -147,12 +188,14 @@ def state_machine(lcd):
     notify = StateNotify(lcd)
     states.add(notify)
 
+    # 10 - OTA Update
+    #from ota import StateUpdate
+    #update = StateUpdate(lcd)
+    #states.add(update)
+
     while True:
         states.run()
 
-from lcd import LCD
-lcd = LCD()
-
 def main():
     # splash screen
     from state_wait_temp import from_hsv
@@ -178,7 +221,6 @@ def main():
     lcd.textC(os.uname()[4][30 : 60], int(lcd.width / 2), lcd.height - 10, lcd.white, lcd.black)
 
     lcd.show()
-    lcd.brightness(1.0)
 
     # bootloader access with face buttons
     keys = lcd.buttons()

python-test/workflows.py

@@ -1,4 +1,20 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
+
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
 
 workflows = [
     {

src/ble.c

@@ -0,0 +1,770 @@
+/*
+ * ble.c
+ *
+ * https://github.com/raspberrypi/pico-examples/blob/master/pico_w/bt/standalone/client.c
+ * https://vanhunteradams.com/Pico/BLE/BTStack_HCI.html
+ *
+ * Copyright (c) 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/cyw43_arch.h"
+#include "hardware/watchdog.h"
+
+#include "config.h"
+#include "log.h"
+#include "main.h"
+#include "util.h"
+#include "ble.h"
+
+#define BLE_READ_TIMEOUT_MS (2 * 500)
+#define BLE_SRVC_TIMEOUT_MS (2 * 500)
+#define BLE_CHAR_TIMEOUT_MS (2 * 2000)
+#define BLE_WRTE_TIMEOUT_MS (2 * 500)
+#define BLE_MAX_SCAN_AGE_MS (10 * 1000)
+#define BLE_MAX_SERVICES 8
+#define BLE_MAX_CHARACTERISTICS 8
+
+enum ble_state {
+    TC_OFF = 0,
+    TC_IDLE,
+    TC_W4_SCAN,
+    TC_W4_CONNECT,
+    TC_READY,
+    TC_W4_READ,
+    TC_READ_COMPLETE,
+    TC_W4_SERVICE,
+    TC_W4_CHARACTERISTIC,
+    TC_W4_WRITE,
+    TC_WRITE_COMPLETE,
+};
+
+struct ble_characteristic {
+    bool set;
+    gatt_client_characteristic_t c;
+};
+
+struct ble_service {
+    bool set;
+    gatt_client_service_t service;
+    struct ble_characteristic chars[BLE_MAX_CHARACTERISTICS];
+};
+
+static btstack_packet_callback_registration_t hci_event_callback_registration;
+static hci_con_handle_t connection_handle;
+static enum ble_state state = TC_OFF;
+
+static struct ble_scan_result scans[BLE_MAX_SCAN_RESULTS] = {0};
+
+static uint16_t read_len = 0;
+static uint8_t data_buff[BLE_MAX_VALUE_LEN] = {0};
+
+static struct ble_service services[BLE_MAX_SERVICES] = {0};
+static uint8_t service_idx = 0;
+static uint8_t characteristic_idx = 0;
+
+static void hci_add_scan_result(bd_addr_t addr, bd_addr_type_t type, int8_t rssi) {
+    int unused = -1;
+
+    for (uint i = 0; i < BLE_MAX_SCAN_RESULTS; i++) {
+        if (!scans[i].set) {
+            if (unused < 0) {
+                unused = i;
+            }
+            continue;
+        }
+
+        if (memcmp(addr, scans[i].addr, sizeof(bd_addr_t)) == 0) {
+            // already in list, just update changing values
+            scans[i].time = to_ms_since_boot(get_absolute_time());
+            scans[i].rssi = rssi;
+            return;
+        }
+    }
+
+    if (unused < 0) {
+        debug("no space in scan results for %s", bd_addr_to_str(addr));
+        return;
+    }
+
+    debug("new device with addr %s", bd_addr_to_str(addr));
+    scans[unused].set = true;
+    scans[unused].time = to_ms_since_boot(get_absolute_time());
+    memcpy(scans[unused].addr, addr, sizeof(bd_addr_t));
+    scans[unused].type = type;
+    scans[unused].rssi = rssi;
+    scans[unused].name[0] = '\0';
+    scans[unused].data_len = 0;
+}
+
+static void hci_scan_result_add_name(bd_addr_t addr, const uint8_t *data, uint8_t data_size) {
+    for (uint i = 0; i < BLE_MAX_SCAN_RESULTS; i++) {
+        if (!scans[i].set) {
+            continue;
+        }
+        if (memcmp(addr, scans[i].addr, sizeof(bd_addr_t)) != 0) {
+            continue;
+        }
+
+        uint8_t len = data_size;
+        if (len > BLE_MAX_NAME_LENGTH) {
+            len = BLE_MAX_NAME_LENGTH;
+        }
+        memcpy(scans[i].name, data, len);
+        scans[i].name[len] = '\0';
+        scans[i].time = to_ms_since_boot(get_absolute_time());
+        return;
+    }
+
+    debug("no matching entry for %s to add name '%.*s' to", bd_addr_to_str(addr), data_size, data);
+}
+
+static void hci_scan_result_add_data(bd_addr_t addr, const uint8_t *data, uint8_t data_size) {
+    for (uint i = 0; i < BLE_MAX_SCAN_RESULTS; i++) {
+        if (!scans[i].set) {
+            continue;
+        }
+        if (memcmp(addr, scans[i].addr, sizeof(bd_addr_t)) != 0) {
+            continue;
+        }
+
+        uint8_t len = data_size;
+        if (len > BLE_MAX_DATA_LENGTH) {
+            len = BLE_MAX_DATA_LENGTH;
+        }
+        memcpy(scans[i].data, data, len);
+        scans[i].data_len = len;
+        scans[i].time = to_ms_since_boot(get_absolute_time());
+        return;
+    }
+
+    debug("no matching entry for %s to add data to", bd_addr_to_str(addr));
+}
+
+static void hci_event_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size) {
+    UNUSED(size);
+    UNUSED(channel);
+
+    //debug("type=0x%02X size=%d", packet_type, size);
+    //hexdump(packet, size);
+
+    if (packet_type != HCI_EVENT_PACKET) {
+        //debug("unexpected packet 0x%02X", packet_type);
+        return;
+    }
+
+    switch (hci_event_packet_get_type(packet)) {
+    case BTSTACK_EVENT_STATE:
+            if (btstack_event_state_get_state(packet) == HCI_STATE_WORKING) {
+                bd_addr_t local_addr;
+                gap_local_bd_addr(local_addr);
+                debug("BTstack up with %s", bd_addr_to_str(local_addr));
+                state = TC_IDLE;
+            } else {
+                debug("BTstack down (%d)", btstack_event_state_get_state(packet));
+                state = TC_OFF;
+            }
+        break;
+
+    case GAP_EVENT_ADVERTISING_REPORT: {
+        if (state != TC_W4_SCAN) {
+            debug("scan result in invalid state %d", state);
+            return;
+        }
+
+        bd_addr_t addr;
+        gap_event_advertising_report_get_address(packet, addr);
+
+        bd_addr_type_t type;
+        type = gap_event_advertising_report_get_address_type(packet);
+
+        int8_t rssi;
+        rssi = (int8_t)gap_event_advertising_report_get_rssi(packet);
+
+        // add data received so far
+        hci_add_scan_result(addr, type, rssi);
+
+        // get advertisement from report event
+        const uint8_t *adv_data = gap_event_advertising_report_get_data(packet);
+        uint8_t adv_len = gap_event_advertising_report_get_data_length(packet);
+
+        // iterate over advertisement data
+        ad_context_t context;
+        for (ad_iterator_init(&context, adv_len, adv_data);
+             ad_iterator_has_more(&context);
+             ad_iterator_next(&context)) {
+            uint8_t data_type = ad_iterator_get_data_type(&context);
+            uint8_t data_size = ad_iterator_get_data_len(&context);
+            const uint8_t *data = ad_iterator_get_data(&context);
+            switch (data_type) {
+            case BLUETOOTH_DATA_TYPE_SHORTENED_LOCAL_NAME:
+            case BLUETOOTH_DATA_TYPE_COMPLETE_LOCAL_NAME:
+                hci_scan_result_add_name(addr, data, data_size);
+                break;
+
+            case BLUETOOTH_DATA_TYPE_SERVICE_DATA:
+            case BLUETOOTH_DATA_TYPE_MANUFACTURER_SPECIFIC_DATA:
+                // TODO ugly
+                if (data_size == 12) {
+                    // Crafty+
+                    hci_scan_result_add_data(addr, data, data_size);
+                } else if (data_size == 26) {
+                    // Volcano
+                    hci_scan_result_add_data(addr, data, data_size);
+                }
+                break;
+
+            default:
+                //debug("Unexpected advertisement type 0x%02X from %s", data_type, bd_addr_to_str(addr));
+                //hexdump(data, data_size);
+                break;
+            }
+        }
+        break;
+    }
+
+    case HCI_EVENT_LE_META:
+        switch (hci_event_le_meta_get_subevent_code(packet)) {
+            case HCI_SUBEVENT_LE_CONNECTION_COMPLETE:
+                if (state != TC_W4_CONNECT) {
+                    return;
+                }
+                debug("connection complete");
+                connection_handle = hci_subevent_le_connection_complete_get_connection_handle(packet);
+                state = TC_READY;
+                break;
+
+            default:
+                //debug("unexpected LE meta event 0x%02X", hci_event_le_meta_get_subevent_code(packet));
+                break;
+        }
+        break;
+
+    case HCI_EVENT_DISCONNECTION_COMPLETE:
+        debug("disconnected");
+        connection_handle = HCI_CON_HANDLE_INVALID;
+        state = TC_IDLE;
+        break;
+
+    case GATT_EVENT_CHARACTERISTIC_VALUE_QUERY_RESULT:
+        if (state != TC_W4_READ) {
+            debug("gatt value query result in invalid state %d", state);
+            return;
+        }
+        uint16_t len = gatt_event_characteristic_value_query_result_get_value_length(packet);
+        if ((read_len + len) > BLE_MAX_VALUE_LEN) {
+            debug("not enough space for value (%d + %d > %d)", read_len, len, BLE_MAX_VALUE_LEN);
+            return;
+        }
+        memcpy(data_buff + read_len,
+               gatt_event_characteristic_value_query_result_get_value(packet),
+               len);
+        read_len += len;
+        break;
+
+    case GATT_EVENT_SERVICE_QUERY_RESULT:
+        if (state != TC_W4_SERVICE) {
+            debug("gatt service query result in invalid state %d", state);
+            return;
+        }
+        gatt_event_service_query_result_get_service(packet, &services[service_idx].service);
+        //debug("got service %s result", uuid128_to_str(services[service_idx].service.uuid128));
+        break;
+
+    case GATT_EVENT_CHARACTERISTIC_QUERY_RESULT:
+        if (state != TC_W4_CHARACTERISTIC) {
+            debug("gatt characteristic query result in invalid state %d", state);
+            return;
+        }
+        gatt_event_characteristic_query_result_get_characteristic(packet, &services[service_idx].chars[characteristic_idx].c);
+        //debug("got characteristic %s result", uuid128_to_str(services[service_idx].chars[characteristic_idx].c.uuid128));
+        break;
+
+    case GATT_EVENT_QUERY_COMPLETE: {
+        uint8_t att_status = gatt_event_query_complete_get_att_status(packet);
+        if (att_status != ATT_ERROR_SUCCESS){
+            debug("query result has ATT Error 0x%02x in %d", att_status, state);
+            state = TC_READY;
+            break;
+        }
+
+        switch (state) {
+        case TC_W4_READ:
+            state = TC_READ_COMPLETE;
+            break;
+
+        case TC_W4_SERVICE:
+            //debug("service %s complete", uuid128_to_str(services[service_idx].service.uuid128));
+            state = TC_READY;
+            break;
+
+        case TC_W4_CHARACTERISTIC:
+            //debug("characteristic %s complete", uuid128_to_str(services[service_idx].chars[characteristic_idx].c.uuid128));
+            state = TC_READY;
+            break;
+
+        case TC_W4_WRITE:
+            //debug("write complete");
+            state = TC_WRITE_COMPLETE;
+            break;
+
+        default:
+            debug("gatt query complete in invalid state %d", state);
+            break;
+        }
+        break;
+    }
+
+    default:
+        //debug("unexpected event 0x%02X", hci_event_packet_get_type(packet));
+        break;
+    }
+}
+
+void ble_init(void) {
+    cyw43_thread_enter();
+
+    state = TC_OFF;
+    for (uint i = 0; i < BLE_MAX_SCAN_RESULTS; i++) {
+        scans[i].set = false;
+    }
+    for (uint i = 0; i < BLE_MAX_SERVICES; i++) {
+        services[i].set = false;
+        for (uint j = 0; j < BLE_MAX_CHARACTERISTICS; j++) {
+            services[i].chars[j].set = false;
+        }
+    }
+
+    cyw43_thread_exit();
+
+    l2cap_init();
+    sm_init();
+    sm_set_io_capabilities(IO_CAPABILITY_NO_INPUT_NO_OUTPUT);
+
+    gatt_client_init();
+
+    hci_event_callback_registration.callback = &hci_event_handler;
+    hci_add_event_handler(&hci_event_callback_registration);
+
+    hci_power_control(HCI_POWER_ON);
+}
+
+bool ble_is_ready(void) {
+    cyw43_thread_enter();
+
+    bool v = (state != TC_OFF);
+
+    cyw43_thread_exit();
+    return v;
+}
+
+void ble_scan(enum ble_scan_mode mode) {
+    cyw43_thread_enter();
+
+    if (state == TC_OFF) {
+        cyw43_thread_exit();
+        return;
+    }
+
+    switch (mode) {
+    case BLE_SCAN_OFF:
+        debug("stopping BLE scan");
+        gap_stop_scan();
+        state = TC_IDLE;
+        break;
+
+    case BLE_SCAN_ON:
+        debug("starting BLE scan");
+        state = TC_W4_SCAN;
+        gap_set_scan_parameters(1, 0x0030, 0x0030);
+        gap_start_scan();
+        break;
+
+    case BLE_SCAN_TOGGLE:
+        switch (state) {
+        case TC_W4_SCAN:
+            cyw43_thread_exit();
+            ble_scan(0);
+            return;
+
+        case TC_IDLE:
+            cyw43_thread_exit();
+            ble_scan(1);
+            return;
+
+        default:
+            debug("invalid state %d", state);
+            break;
+        }
+        break;
+
+    default:
+        debug("invalid mode %d", mode);
+        break;
+    }
+
+    cyw43_thread_exit();
+}
+
+int32_t ble_get_scan_results(struct ble_scan_result *buf, uint16_t len) {
+    if (!buf || (len <= 0)) {
+        return -1;
+    }
+
+    cyw43_thread_enter();
+
+    if (state == TC_OFF) {
+        cyw43_thread_exit();
+        return -1;
+    }
+
+    uint16_t pos = 0;
+    for (uint16_t i = 0; i < BLE_MAX_SCAN_RESULTS; i++) {
+        if (!scans[i].set) {
+            continue;
+        }
+
+        // only age out entries while scanning, otherwise keep results cached
+        if (state == TC_W4_SCAN) {
+            uint32_t diff = to_ms_since_boot(get_absolute_time()) - scans[i].time;
+            if (diff >= BLE_MAX_SCAN_AGE_MS) {
+                //debug("removing %s due to age", bd_addr_to_str(scans[i].addr));
+                scans[i].set = false;
+            }
+        }
+
+        memcpy(buf + pos, scans + i, sizeof(struct ble_scan_result));
+        pos++;
+
+        if (pos >= len) {
+            break;
+        }
+    }
+
+    cyw43_thread_exit();
+    return pos;
+}
+
+void ble_connect(bd_addr_t addr, bd_addr_type_t type) {
+    cyw43_thread_enter();
+
+    switch (state) {
+    case TC_W4_SCAN:
+        cyw43_thread_exit();
+        ble_scan(0);
+        cyw43_thread_enter();
+        break;
+
+    case TC_READY:
+        gap_disconnect(connection_handle);
+        break;
+
+    case TC_IDLE:
+        break;
+
+    default:
+        debug("invalid state for connect %d", state);
+        cyw43_thread_exit();
+        return;
+    }
+
+    debug("connecting to %s", bd_addr_to_str(addr));
+    state = TC_W4_CONNECT;
+    gap_connect(addr, type);
+
+    cyw43_thread_exit();
+}
+
+bool ble_is_connected(void) {
+    cyw43_thread_enter();
+
+    bool v = (state == TC_READY)
+             || (state == TC_W4_READ)
+             || (state == TC_READ_COMPLETE)
+             || (state == TC_W4_SERVICE)
+             || (state == TC_W4_CHARACTERISTIC)
+             || (state == TC_W4_WRITE)
+             || (state == TC_WRITE_COMPLETE);
+
+    cyw43_thread_exit();
+    return v;
+}
+
+void ble_disconnect(void) {
+    cyw43_thread_enter();
+
+    if (state == TC_READY) {
+        debug("disconnecting");
+        gap_disconnect(connection_handle);
+    } else {
+        debug("invalid state for disconnect %d", state);
+    }
+
+    cyw43_thread_exit();
+}
+
+int32_t ble_read(const uint8_t *characteristic, uint8_t *buff, uint16_t buff_len) {
+    cyw43_thread_enter();
+
+    if (state != TC_READY) {
+        cyw43_thread_exit();
+        debug("invalid state for read (%d)", state);
+        return -1;
+    }
+
+    uint8_t r = gatt_client_read_value_of_characteristics_by_uuid128(hci_event_handler,
+                                                                     connection_handle,
+                                                                     0x0001, 0xFFFF,
+                                                                     characteristic);
+    if (r != ERROR_CODE_SUCCESS) {
+        cyw43_thread_exit();
+        debug("gatt read failed %d", r);
+        return -2;
+    }
+
+    state = TC_W4_READ;
+    read_len = 0;
+    cyw43_thread_exit();
+
+    uint32_t start_time = to_ms_since_boot(get_absolute_time());
+    while (1) {
+        sleep_ms(1);
+        main_loop_hw();
+
+        uint32_t now = to_ms_since_boot(get_absolute_time());
+        if ((now - start_time) >= BLE_READ_TIMEOUT_MS) {
+            debug("timeout waiting for read");
+            cyw43_thread_enter();
+            state = TC_READY;
+            cyw43_thread_exit();
+            return -3;
+        }
+
+        cyw43_thread_enter();
+        enum ble_state state_cached = state;
+        cyw43_thread_exit();
+
+        if (state_cached == TC_READ_COMPLETE) {
+            break;
+        }
+    }
+
+    cyw43_thread_enter();
+
+    state = TC_READY;
+
+    if (read_len > buff_len) {
+        debug("buffer too short (%d < %d)", buff_len, read_len);
+        cyw43_thread_exit();
+        return -4;
+    }
+
+    memcpy(buff, data_buff, read_len);
+
+    cyw43_thread_exit();
+    return read_len;
+}
+
+int8_t ble_write(const uint8_t *service, const uint8_t *characteristic,
+                  uint8_t *buff, uint16_t buff_len) {
+    cyw43_thread_enter();
+
+    if (state != TC_READY) {
+        cyw43_thread_exit();
+        debug("invalid state for write (%d)", state);
+        return -1;
+    }
+
+    // check if service has already been discovered
+    int srvc = -1, free_srvc = -1;
+    for (int i = 0; i < BLE_MAX_SERVICES; i++) {
+        if (!services[i].set) {
+            if (free_srvc < 0) {
+                free_srvc = i;
+            }
+            continue;
+        }
+
+        if (memcmp(services[i].service.uuid128, service, 16) == 0) {
+            srvc = i;
+            break;
+        }
+    }
+
+    // if this service has not been discovered yet, add it
+    if (srvc < 0) {
+        if (free_srvc < 0) {
+            debug("no space left for BLE service. overwriting.");
+            free_srvc = 0;
+        }
+        srvc = free_srvc;
+        services[srvc].set = true;
+
+        debug("discovering service %s at %d", uuid128_to_str(service), srvc);
+
+        uint8_t r = gatt_client_discover_primary_services_by_uuid128(hci_event_handler,
+                                                                     connection_handle,
+                                                                     service);
+        if (r != ERROR_CODE_SUCCESS) {
+            cyw43_thread_exit();
+            debug("gatt service discovery failed %d", r);
+            return -2;
+        }
+
+        state = TC_W4_SERVICE;
+        service_idx = srvc;
+        cyw43_thread_exit();
+
+        uint32_t start_time = to_ms_since_boot(get_absolute_time());
+        while (1) {
+            sleep_ms(1);
+            main_loop_hw();
+
+            uint32_t now = to_ms_since_boot(get_absolute_time());
+            if ((now - start_time) >= BLE_SRVC_TIMEOUT_MS) {
+                debug("timeout waiting for service");
+                cyw43_thread_enter();
+                state = TC_READY;
+                cyw43_thread_exit();
+                return -3;
+            }
+
+            cyw43_thread_enter();
+            enum ble_state state_cached = state;
+            cyw43_thread_exit();
+
+            if (state_cached == TC_READY) {
+                break;
+            }
+        }
+
+        cyw43_thread_enter();
+    }
+
+    // check if characteristic has already been discovered
+    int ch = -1, free_ch = -1;
+    for (int i = 0; i < BLE_MAX_CHARACTERISTICS; i++) {
+        if (!services[srvc].chars[i].set) {
+            if (free_ch < 0) {
+                free_ch = i;
+            }
+            continue;
+        }
+
+        if (memcmp(services[srvc].chars[i].c.uuid128, characteristic, 16) == 0) {
+            ch = i;
+            break;
+        }
+    }
+
+    // if this characteristic has not been discovered yet, add it
+    if (ch < 0) {
+        if (free_ch < 0) {
+            debug("no space left for BLE characteristic. overwriting.");
+            free_ch = 0;
+        }
+        ch = free_ch;
+        services[srvc].chars[ch].set = true;
+
+        debug("discovering characteristic %s at %d", uuid128_to_str(characteristic), ch);
+
+        uint8_t r = gatt_client_discover_characteristics_for_service_by_uuid128(hci_event_handler,
+                                                                                connection_handle,
+                                                                                &services[srvc].service,
+                                                                                characteristic);
+        if (r != ERROR_CODE_SUCCESS) {
+            cyw43_thread_exit();
+            debug("gatt characteristic discovery failed %d", r);
+            return -4;
+        }
+
+        state = TC_W4_CHARACTERISTIC;
+        characteristic_idx = ch;
+        cyw43_thread_exit();
+
+        uint32_t start_time = to_ms_since_boot(get_absolute_time());
+        while (1) {
+            sleep_ms(1);
+            main_loop_hw();
+
+            uint32_t now = to_ms_since_boot(get_absolute_time());
+            if ((now - start_time) >= BLE_CHAR_TIMEOUT_MS) {
+                debug("timeout waiting for characteristic");
+                cyw43_thread_enter();
+                state = TC_READY;
+                cyw43_thread_exit();
+                return -5;
+            }
+
+            cyw43_thread_enter();
+            enum ble_state state_cached = state;
+            cyw43_thread_exit();
+
+            if (state_cached == TC_READY) {
+                break;
+            }
+        }
+
+        cyw43_thread_enter();
+    }
+
+    if (buff_len > BLE_MAX_VALUE_LEN) {
+        buff_len = BLE_MAX_VALUE_LEN;
+    }
+    memcpy(data_buff, buff, buff_len);
+
+    uint8_t r = gatt_client_write_value_of_characteristic(hci_event_handler,
+                                                          connection_handle,
+                                                          services[srvc].chars[ch].c.value_handle,
+                                                          buff_len, data_buff);
+    if (r != ERROR_CODE_SUCCESS) {
+        cyw43_thread_exit();
+        debug("gatt write failed %d", r);
+        return -6;
+    }
+
+    state = TC_W4_WRITE;
+    cyw43_thread_exit();
+
+    uint32_t start_time = to_ms_since_boot(get_absolute_time());
+    while (1) {
+        sleep_ms(1);
+        main_loop_hw();
+
+        uint32_t now = to_ms_since_boot(get_absolute_time());
+        if ((now - start_time) >= BLE_WRTE_TIMEOUT_MS) {
+            debug("timeout waiting for write");
+            cyw43_thread_enter();
+            state = TC_READY;
+            cyw43_thread_exit();
+            return -7;
+        }
+
+        cyw43_thread_enter();
+        enum ble_state state_cached = state;
+        cyw43_thread_exit();
+
+        if ((state_cached == TC_WRITE_COMPLETE) || (state_cached == TC_READY)) {
+            break;
+        }
+    }
+
+    cyw43_thread_enter();
+
+    int8_t ret = (state == TC_WRITE_COMPLETE) ? 0 : -8;
+    state = TC_READY;
+
+    cyw43_thread_exit();
+    return ret;
+}

src/buttons.c

@@ -0,0 +1,80 @@
+/*
+ * 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];
+static void (*callback)(enum buttons, bool) = NULL;
+
+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_callback(void (*fp)(enum buttons, bool)) {
+    callback = fp;
+}
+
+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;
+                if (callback) {
+                    callback(i, state);
+                }
+            }
+        }
+
+        buttons[i].last_state = state;
+    }
+}

src/console.c

@@ -0,0 +1,552 @@
+/*
+ * 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 <unistd.h>
+#include <stdio.h>
+
+#include "pico/stdlib.h"
+#include "hardware/watchdog.h"
+
+#include "config.h"
+#include "log.h"
+#include "util.h"
+#include "usb_cdc.h"
+#include "usb_msc.h"
+#include "debug_disk.h"
+#include "lipo.h"
+#include "ble.h"
+#include "text.h"
+#include "lcd.h"
+#include "image.h"
+#include "volcano.h"
+#include "serial.h"
+#include "main.h"
+#include "models.h"
+#include "workflow.h"
+#include "console.h"
+#include "crafty.h"
+
+#define CNSL_BUFF_SIZE 64
+#define CNSL_REPEAT_MS 500
+
+#define DEV_AUTO_CONNECT(s) {                                     \
+    ble_scan(BLE_SCAN_OFF);                                       \
+    bd_addr_t addr;                                               \
+    bd_addr_type_t type;                                          \
+    const char *foo = s;                                          \
+    sscanf(foo, "%02hhX:%02hhX:%02hhX:%02hhX:%02hhX:%02hhX %hhu", \
+            &addr[0], &addr[1], &addr[2], &addr[3],               \
+            &addr[4], &addr[5], &type);                           \
+    ble_connect(addr, type);                                      \
+    while (!ble_is_connected()) {                                 \
+        sleep_ms(1);                                              \
+    }                                                             \
+}
+
+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("VolcanoRC Firmware Usage:");
+        println("");
+        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("  power - show Lipo battery status");
+        println("");
+        println("   scan - start or stop BLE scan");
+        println("scanres - print list of found BLE devices");
+        println("con M T - connect to (M)AC and (T)ype");
+        println(" discon - disconnect from BLE device");
+        println("");
+        println("  clear - blank screen");
+        println(" splash - draw image on screen");
+        println("  fonts - show font list");
+        println("   text - draw text on screen");
+        println("    bat - draw battery indicator");
+        println("");
+        println("   vrct - Volcano read current temperature");
+        println("   vrtt - Volcano read target temperature");
+        println(" vwtt X - Volcano write target temperature");
+        println("  vwh X - Set heater to 1 or 0");
+        println("  vwp X - Set pump to 1 or 0");
+        println("");
+        println("    wfl - List available workflows");
+        println("   wf X - Run workflow");
+        println("");
+        println("   crct - Crafty read current temperature");
+        println("   crtt - Crafty read target temperature");
+        println(" cwtt X - Crafty write target temperature");
+        println("  cwh X - Set heater to 1 or 0");
+        println("    crb - Crafty read battery state");
+        println("");
+        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 if (strcmp(line, "power") == 0) {
+        float volt = lipo_voltage();
+        println("Battery: %.2fV = %.1f%% @ %s",
+                volt, lipo_percentage(volt),
+                lipo_charging() ? "charging" : "draining");
+    } else if (strcmp(line, "scan") == 0) {
+        ble_scan(BLE_SCAN_TOGGLE);
+    } else if (strcmp(line, "scanres") == 0) {
+        struct ble_scan_result results[BLE_MAX_SCAN_RESULTS] = {0};
+        int n = ble_get_scan_results(results, BLE_MAX_SCAN_RESULTS);
+        if (n < 0) {
+            println("Error reading results (%d)", n);
+        } else {
+            println("%d results", n);
+            for (int i = 0; i < n; i++) {
+                char info[32] = "";
+                enum known_devices dev = models_filter_name(results[i].name);
+                if (dev != DEV_UNKNOWN) {
+                    models_get_serial(results[i].data, results[i].data_len,
+                                      info, sizeof(info));
+                }
+                uint32_t age = to_ms_since_boot(get_absolute_time()) - results[i].time;
+                println("addr=%s type=%d rssi=%d age=%.1fs name='%s' info='%s'",
+                        bd_addr_to_str(results[i].addr),
+                        results[i].type, results[i].rssi,
+                        age / 1000.0, results[i].name, info);
+            }
+        }
+    } else if (str_startswith(line, "con ")) {
+        bd_addr_t addr;
+        bd_addr_type_t type;
+        int r = sscanf(line, "con %02hhX:%02hhX:%02hhX:%02hhX:%02hhX:%02hhX %hhu",
+                       &addr[0], &addr[1], &addr[2], &addr[3],
+                       &addr[4], &addr[5], &type);
+
+        if (r == 7) {
+            debug("connecting");
+            ble_connect(addr, type);
+        } else {
+            debug("invalid input (%d)", r);
+        }
+    } else if (strcmp(line, "discon") == 0) {
+        ble_disconnect();
+    } else if (strcmp(line, "clear") == 0) {
+        lcd_clear();
+    } else if (strcmp(line, "splash") == 0) {
+        draw_splash();
+    } else if (strcmp(line, "fonts") == 0) {
+        const struct mf_font_list_s *f = mf_get_font_list();
+
+        debug("Font list:");
+        while (f) {
+            debug("full_name: %s", f->font->full_name);
+            debug("short_name: %s", f->font->short_name);
+            debug("size: %d %d", f->font->width, f->font->height);
+            debug("x_advance: %d %d", f->font->min_x_advance, f->font->max_x_advance);
+            debug("baseline: %d %d", f->font->baseline_x, f->font->baseline_y);
+            debug("line_height: %d", f->font->line_height);
+            debug("flags: %d", f->font->flags);
+            debug("fallback_character: %c", f->font->fallback_character);
+            debug("character_width: %p", f->font->character_width);
+            debug("render_character: %p", f->font->render_character);
+
+            f = f->next;
+            if (f) {
+                debug("");
+            }
+        }
+    } else if (strcmp(line, "text") == 0) {
+        uint16_t y_off = 0;
+        const struct mf_font_list_s *f = mf_get_font_list();
+        while (f) {
+            struct text_font font = {
+                .fontname = f->font->short_name,
+                //.scale = 1,
+                .font = f->font,
+            };
+            text_prepare_font(&font);
+
+            struct text_conf text = {
+                .text = font.fontname,
+                .x = 0,
+                .y = y_off,
+                .justify = false,
+                .alignment = MF_ALIGN_CENTER,
+                .width = 240,
+                .height = 240 - y_off,
+                .margin = 5,
+                .bg = TEXT_BG_NONE,
+                .font = &font,
+            };
+            text_draw(&text);
+
+            y_off = text.y;
+            f = f->next;
+        }
+    } else if (strcmp(line, "bat") == 0) {
+        draw_battery_indicator();
+    } else if (strcmp(line, "vrct") == 0) {
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+        DEV_AUTO_CONNECT(TEST_VOLCANO_AUTO_CONNECT);
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+        int16_t r = volcano_get_current_temp();
+        println("volcano current temp: %.1f", r / 10.0);
+
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+        ble_disconnect();
+#endif // TEST_VOLCANO_AUTO_CONNECT
+    } else if (strcmp(line, "vrtt") == 0) {
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+        DEV_AUTO_CONNECT(TEST_VOLCANO_AUTO_CONNECT);
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+        int16_t r = volcano_get_target_temp();
+        println("volcano target temp: %.1f", r / 10.0);
+
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+        ble_disconnect();
+#endif // TEST_VOLCANO_AUTO_CONNECT
+    } else if (str_startswith(line, "vwtt ")) {
+        float val;
+        int r = sscanf(line, "vwtt %f", &val);
+        if (r != 1) {
+            println("invalid input (%d)", r);
+        } else {
+            uint16_t v = val * 10.0;
+
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+            DEV_AUTO_CONNECT(TEST_VOLCANO_AUTO_CONNECT);
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+            int8_t r = volcano_set_target_temp(v);
+
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+            ble_disconnect();
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+            if (r < 0) {
+                println("error writing target temp %d", r);
+            } else {
+                println("success");
+            }
+        }
+    } else if (str_startswith(line, "vwh ")) {
+        int val;
+        int r = sscanf(line, "vwh %d", &val);
+        if ((r != 1) || ((val != 0) && (val != 1))) {
+            println("invalid input (%d %d)", r, val);
+        } else {
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+            DEV_AUTO_CONNECT(TEST_VOLCANO_AUTO_CONNECT);
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+            int8_t r = volcano_set_heater_state(val == 1);
+
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+            ble_disconnect();
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+            if (r < 0) {
+                println("error writing heater state %d", r);
+            } else {
+                println("success");
+            }
+        }
+    } else if (str_startswith(line, "vwp ")) {
+        int val;
+        int r = sscanf(line, "vwp %d", &val);
+        if ((r != 1) || ((val != 0) && (val != 1))) {
+            println("invalid input (%d %d)", r, val);
+        } else {
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+            DEV_AUTO_CONNECT(TEST_VOLCANO_AUTO_CONNECT);
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+            int8_t r = volcano_set_pump_state(val == 1);
+
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+            ble_disconnect();
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+            if (r < 0) {
+                println("error writing pump state %d", r);
+            } else {
+                println("success");
+            }
+        }
+    } else if (strcmp(line, "wfl") == 0) {
+        println("%d workflows", wf_count());
+        for (int i = 0; i < wf_count(); i++) {
+            println("  '%s' by %s", wf_name(i), wf_author(i));
+        }
+    } else if (str_startswith(line, "wf ")) {
+        int wf = -1;
+        for (int i = 0; i < wf_count(); i++) {
+            if (strcmp(wf_name(i), line + 3) == 0) {
+                wf = i;
+                break;
+            }
+        }
+
+        if (wf < 0) {
+            println("unknown workflow");
+        } else {
+            struct wf_state s = wf_status();
+            if (s.status != WF_IDLE) {
+                println("workflow in progress");
+            } else {
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+                DEV_AUTO_CONNECT(TEST_VOLCANO_AUTO_CONNECT);
+#endif // TEST_VOLCANO_AUTO_CONNECT
+
+                println("starting workflow");
+                wf_start(wf);
+
+                s = wf_status();
+                while (s.status != WF_IDLE) {
+                    main_loop_hw();
+                    wf_run();
+                    s = wf_status();
+                }
+
+                println("done");
+
+#ifdef TEST_VOLCANO_AUTO_CONNECT
+                ble_disconnect();
+#endif // TEST_VOLCANO_AUTO_CONNECT
+            }
+        }
+    } else if (strcmp(line, "crct") == 0) {
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+        DEV_AUTO_CONNECT(TEST_CRAFTY_AUTO_CONNECT);
+#endif // TEST_CRAFTY_AUTO_CONNECT
+
+        int16_t r = crafty_get_current_temp();
+        println("crafty current temp: %.1f", r / 10.0);
+
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+        ble_disconnect();
+#endif // TEST_CRAFTY_AUTO_CONNECT
+    } else if (strcmp(line, "crtt") == 0) {
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+        DEV_AUTO_CONNECT(TEST_CRAFTY_AUTO_CONNECT);
+#endif // TEST_CRAFTY_AUTO_CONNECT
+
+        int16_t r = crafty_get_target_temp();
+        println("crafty target temp: %.1f", r / 10.0);
+
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+        ble_disconnect();
+#endif // TEST_CRAFTY_AUTO_CONNECT
+    } else if (str_startswith(line, "cwtt ")) {
+        float val;
+        int r = sscanf(line, "cwtt %f", &val);
+        if (r != 1) {
+            println("invalid input (%d)", r);
+        } else {
+            uint16_t v = val * 10.0;
+
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+            DEV_AUTO_CONNECT(TEST_CRAFTY_AUTO_CONNECT);
+#endif // TEST_CRAFTY_AUTO_CONNECT
+
+            int8_t r = crafty_set_target_temp(v);
+
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+            ble_disconnect();
+#endif // TEST_CRAFTY_AUTO_CONNECT
+
+            if (r < 0) {
+                println("error writing target temp %d", r);
+            } else {
+                println("success");
+            }
+        }
+    } else if (str_startswith(line, "cwh ")) {
+        int val;
+        int r = sscanf(line, "cwh %d", &val);
+        if ((r != 1) || ((val != 0) && (val != 1))) {
+            println("invalid input (%d %d)", r, val);
+        } else {
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+            DEV_AUTO_CONNECT(TEST_CRAFTY_AUTO_CONNECT);
+#endif // TEST_CRAFTY_AUTO_CONNECT
+
+            int8_t r = crafty_set_heater_state(val == 1);
+
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+            ble_disconnect();
+#endif // TEST_CRAFTY_AUTO_CONNECT
+
+            if (r < 0) {
+                println("error writing heater state %d", r);
+            } else {
+                println("success");
+            }
+        }
+    } else if (strcmp(line, "crb") == 0) {
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+        DEV_AUTO_CONNECT(TEST_CRAFTY_AUTO_CONNECT);
+#endif // TEST_CRAFTY_AUTO_CONNECT
+
+        int16_t r = crafty_get_battery_state();
+        println("crafty battery: %d %%", r);
+
+#ifdef TEST_CRAFTY_AUTO_CONNECT
+        ble_disconnect();
+#endif // TEST_CRAFTY_AUTO_CONNECT
+    } 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';
+    }
+}
+
+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 uint8_t *buf, size_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 and local echo
+    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((const uint8_t *)"\b \b", 3);
+            serial_write((const uint8_t *)"\b \b", 3);
+
+            // check for another backspace in this space
+            i--;
+        } else {
+            usb_cdc_write((const uint8_t *)(cnsl_line_buff + i), 1);
+            serial_write((const uint8_t *)(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/crafty.c

@@ -0,0 +1,121 @@
+/*
+ * crafty.c
+ *
+ * Copyright (c) 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 "config.h"
+#include "log.h"
+#include "ble.h"
+#include "crafty.h"
+
+// serviceUuidCrafty1      "00000001-4c45-4b43-4942-265a524f5453"
+// characteristicWriteTemp "00000021-4c45-4b43-4942-265a524f5453"
+// charactersiticCurrTemp  "00000011-4c45-4b43-4942-265a524f5453"
+// characteristicPower     "00000041-4c45-4b43-4942-265a524f5453"
+// characteristicHeaterOn  "00000081-4c45-4b43-4942-265a524f5453"
+// characteristicHeaterOff "00000091-4c45-4b43-4942-265a524f5453"
+
+// "000000xx-4c45-4b43-4942-265a524f5453"
+static uint8_t uuid_base[16] = {
+    0x00, 0x00, 0x00, 0xFF, 0x4c, 0x45, 0x4b, 0x43,
+    0x49, 0x42, 0x26, 0x5a, 0x52, 0x4f, 0x54, 0x53,
+};
+static uint8_t uuid_base2[16] = {
+    0x00, 0x00, 0x00, 0xFF, 0x4c, 0x45, 0x4b, 0x43,
+    0x49, 0x42, 0x26, 0x5a, 0x52, 0x4f, 0x54, 0x53,
+};
+
+// Crafty UUIDs are always the same, except for the 4th byte
+#define UUID_WRITE_SRVC   0x01
+#define UUID_CURRENT_TEMP 0x11
+#define UUID_TARGET_TEMP  0x21
+#define UUID_BATTERY      0x41
+#define UUID_HEATER_ON    0x81
+#define UUID_HEATER_OFF   0x91
+
+int16_t crafty_get_current_temp(void) {
+    uuid_base[3] = UUID_CURRENT_TEMP;
+
+    uint8_t buff[2];
+    int32_t r = ble_read(uuid_base, buff, sizeof(buff));
+    if (r != sizeof(buff)) {
+        debug("ble_read unexpected value %ld", r);
+        return -1;
+    }
+
+    uint16_t *v = (uint16_t *)buff;
+    return *v;
+}
+
+int16_t crafty_get_target_temp(void) {
+    uuid_base[3] = UUID_TARGET_TEMP;
+
+    uint8_t buff[2];
+    int32_t r = ble_read(uuid_base, buff, sizeof(buff));
+    if (r != sizeof(buff)) {
+        debug("ble_read unexpected value %ld", r);
+        return -1;
+    }
+
+    uint16_t *v = (uint16_t *)buff;
+    return *v;
+}
+
+int8_t crafty_set_target_temp(uint16_t value) {
+    uuid_base[3] = UUID_WRITE_SRVC;
+    uuid_base2[3] = UUID_TARGET_TEMP;
+
+    uint8_t buff[2];
+    uint16_t *v = (uint16_t *)buff;
+    *v = value;
+
+    int8_t r = ble_write(uuid_base, uuid_base2, buff, sizeof(buff));
+    if (r != 0) {
+        debug("ble_write unexpected value %d", r);
+    }
+    return r;
+}
+
+int8_t crafty_set_heater_state(bool value) {
+    uuid_base[3] = UUID_WRITE_SRVC;
+
+    if (value) {
+        uuid_base2[3] = UUID_HEATER_ON;
+    } else {
+        uuid_base2[3] = UUID_HEATER_OFF;
+    }
+
+    uint16_t d = 0;
+    int8_t r = ble_write(uuid_base, uuid_base2, (uint8_t *)&d, sizeof(d));
+    if (r != 0) {
+        debug("ble_write unexpected value %d", r);
+    }
+    return r;
+}
+
+int8_t crafty_get_battery_state(void) {
+    uuid_base[3] = UUID_BATTERY;
+
+    uint8_t buff[2];
+    int32_t r = ble_read(uuid_base, buff, sizeof(buff));
+    if (r != sizeof(buff)) {
+        debug("ble_read unexpected value %ld", r);
+        return -1;
+    }
+
+    uint16_t *v = (uint16_t *)buff;
+    return *v;
+}

src/debug_disk.c

@@ -0,0 +1,147 @@
+/*
+ * debug_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 <stdio.h>
+
+#include "pico/stdlib.h"
+#include "ff.h"
+
+#include "config.h"
+#include "log.h"
+#include "debug_disk.h"
+
+#ifdef DEBUG_DISK_WRITE_SOURCES
+#include "pack_data.h"
+#endif // DEBUG_DISK_WRITE_SOURCES
+
+static FATFS fs;
+static bool mounted = false;
+
+static void write_readme(void) {
+    FIL file;
+    FRESULT 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, "See included 'src.tar.xz' for sources.\r\n");
+        pos += snprintf(readme + pos, 1024 - pos, "Repo 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);
+        }
+    }
+}
+
+#ifdef DEBUG_DISK_WRITE_SOURCES
+static void write_sources(void) {
+    FIL file;
+    FRESULT res = f_open(&file, "src.tar.xz", FA_CREATE_ALWAYS | FA_WRITE);
+    if (res != FR_OK) {
+        debug("error: f_open returned %d", res);
+    } else {
+        UINT bw;
+        UINT len = 0;
+        while (1) {
+            res = f_write(&file, data_tar_xz + len, data_tar_xz_len - len, &bw);
+            len += bw;
+            if (res != FR_OK) {
+                debug("error: f_write returned %d", res);
+                break;
+            } else if (bw == 0) {
+                debug("error: f_write did not write");
+                break;
+            } else if (bw == data_tar_xz_len) {
+                break;
+            }
+        }
+
+        res = f_close(&file);
+        if (res != FR_OK) {
+            debug("error: f_close returned %d", res);
+        }
+    }
+}
+#endif // DEBUG_DISK_WRITE_SOURCES
+
+void debug_disk_init(void) {
+    if (debug_disk_mount() != 0) {
+        debug("error mounting disk");
+        return;
+    }
+
+    // maximum length: 11 bytes
+    f_setlabel("DEBUG DISK");
+
+    write_readme();
+
+#ifdef DEBUG_DISK_WRITE_SOURCES
+    write_sources();
+#endif // DEBUG_DISK_WRITE_SOURCES
+
+    if (debug_disk_unmount() != 0) {
+        debug("error unmounting disk");
+    }
+}
+
+int debug_disk_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_disk_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,130 @@
+/* 
+ * 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 "pico/stdlib.h"
+#include "ff.h"
+#include "diskio.h"
+
+#include "config.h"
+#include "log.h"
+#include "debug_disk.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);
+    }
+}
+
+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/image.c

@@ -0,0 +1,152 @@
+/*
+ * image.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 <stdio.h>
+#include <string.h>
+
+#include "config.h"
+#include "lcd.h"
+#include "text.h"
+#include "lipo.h"
+#include "util.h"
+#include "image.h"
+
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wtrigraphs"
+#include "logo.h"
+#pragma GCC diagnostic pop
+
+#define BATT_INTERVAL_MS 777
+
+void image_draw(const char *data, uint width, uint height) {
+    for (uint x = 0; x < width; x++) {
+        for (uint y = 0; y < height; y++) {
+            uint32_t pixel[3];
+            HEADER_PIXEL(data, pixel);
+
+            uint32_t color = RGB_565(pixel[0], pixel[1], pixel[2]);
+            lcd_write_point(240 - x - 1, y, color);
+        }
+    }
+}
+
+void draw_splash(void) {
+    image_draw(logo_rgb_data, logo_width, logo_height);
+
+    struct text_font font_big = {
+        .fontname = "DejaVuSerif32",
+    };
+    text_prepare_font(&font_big);
+
+    struct text_font font_small = {
+        .fontname = "DejaVuSerif16",
+    };
+    text_prepare_font(&font_small);
+
+    struct text_conf text1 = {
+        .text = "xythobuz.de",
+        .x = 0,
+        .y = 0,
+        .justify = false,
+        .alignment = MF_ALIGN_CENTER,
+        .width = 240,
+        .height = 240,
+        .margin = 2,
+        .fg = RGB_565(0xFF, 0xFF, 0xFF),
+        .bg = RGB_565(0x00, 0x00, 0x00),
+        .font = &font_big,
+    };
+    text_draw(&text1);
+
+    struct text_conf text2 = {
+        .text = __DATE__ " @ " __TIME__,
+        .x = 0,
+        .y = 195,
+        .justify = false,
+        .alignment = MF_ALIGN_CENTER,
+        .width = 240,
+        .height = 240,
+        .margin = 2,
+        .fg = RGB_565(0xFF, 0xFF, 0xFF),
+        .bg = RGB_565(0x00, 0x00, 0x00),
+        .font = &font_small,
+    };
+    text_draw(&text2);
+}
+
+void draw_battery_indicator(void) {
+    static const float batt_warn_limit = 15.0f;
+    static char prev_s[30] = {0};
+    static uint32_t prev_c = 0;
+
+    char s[30] = {0};
+    float v = lipo_voltage();
+    uint32_t c = RGB_565(0xFF, 0x00, 0x00);
+    if (lipo_charging()) {
+        //                     "Batt:   99.9%   (4.20V)"
+        snprintf(s, sizeof(s), "Batt: Charging! (%.2fV)", v);
+        c = RGB_565(0xFF, 0xFF, 0x00);
+    } else {
+        float percentage = lipo_percentage(v);
+        snprintf(s, sizeof(s), "Batt:   %02.1f%%   (%.2fV)", percentage, v);
+
+        if (percentage > batt_warn_limit) {
+            float hue = map(percentage, batt_warn_limit, 100, 0.0, 0.333);
+            c = from_hsv(hue, 1.0, 1.0);
+        }
+    }
+
+    // only re-draw battery indicator when it has changed
+    if ((strcmp(s, prev_s) == 0) && (prev_c == c)) {
+        return;
+    }
+    strcpy(prev_s, s);
+    prev_c = c;
+
+    static struct text_font font = {
+        .fontname = "fixed_10x20",
+        .font = NULL,
+    };
+    if (font.font == NULL) {
+        text_prepare_font(&font);
+    }
+
+    struct text_conf text = {
+        .text = s,
+        .x = 0,
+        .y = 219,
+        .justify = false,
+        .alignment = MF_ALIGN_CENTER,
+        .width = 240,
+        .height = 240,
+        .margin = 2,
+        .fg = c,
+        .bg = RGB_565(0x00, 0x00, 0x00),
+        .font = &font,
+    };
+    text_draw(&text);
+}
+
+void battery_run(void) {
+    static uint32_t last_run = 0;
+    uint32_t now = to_ms_since_boot(get_absolute_time());
+    if ((now >= (last_run + BATT_INTERVAL_MS)) || (last_run == 0)) {
+        last_run = now;
+        draw_battery_indicator();
+    }
+}

src/lcd.c

@@ -0,0 +1,309 @@
+/*
+ * lcd.c
+ *
+ * Copyright (c) 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 <math.h>
+
+#include "pico/stdlib.h"
+#include "hardware/spi.h"
+#include "hardware/pwm.h"
+#include "driver_st7789.h"
+
+#include "config.h"
+#include "log.h"
+#include "lcd.h"
+
+#define LCD_PIN_DC 8
+#define LCD_PIN_CS 9
+#define LCD_PIN_CLK 10
+#define LCD_PIN_DIN 11
+#define LCD_PIN_RST 12
+#define LCD_PIN_BL 13
+
+#define ST7789_PICO_COLUMN                             240
+#define ST7789_PICO_ROW                                240
+
+#define ST7789_PICO_ACCESS                            (ST7789_ORDER_PAGE_TOP_TO_BOTTOM | \
+                                                       ST7789_ORDER_COLUMN_LEFT_TO_RIGHT | \
+                                                       ST7789_ORDER_PAGE_COLUMN_NORMAL | \
+                                                       ST7789_ORDER_LINE_TOP_TO_BOTTOM | \
+                                                       ST7789_ORDER_COLOR_RGB | \
+                                                       ST7789_ORDER_REFRESH_LEFT_TO_RIGHT)
+
+#define ST7789_PICO_RGB_INTERFACE_COLOR_FORMAT         0
+#define ST7789_PICO_CONTROL_INTERFACE_COLOR_FORMAT     ST7789_CONTROL_INTERFACE_COLOR_FORMAT_16_BIT
+
+#define ST7789_PICO_PORCH_NORMAL_BACK                  0x0C
+#define ST7789_PICO_PORCH_NORMAL_FRONT                 0x0C
+#define ST7789_PICO_PORCH_ENABLE                       ST7789_BOOL_FALSE
+#define ST7789_PICO_PORCH_IDEL_BACK                    0x03
+#define ST7789_PICO_PORCH_IDEL_FRONT                   0x03
+#define ST7789_PICO_PORCH_PART_BACK                    0x03
+#define ST7789_PICO_PORCH_PART_FRONT                   0x03
+
+#define ST7789_PICO_VGHS                               ST7789_VGHS_13P26_V
+#define ST7789_PICO_VGLS_NEGATIVE                      ST7789_VGLS_NEGATIVE_10P43
+
+#define ST7789_PICO_VCOMS                              0.725f
+
+#define ST7789_PICO_XMY                                ST7789_BOOL_FALSE
+#define ST7789_PICO_XBGR                               ST7789_BOOL_TRUE
+#define ST7789_PICO_XINV                               ST7789_BOOL_FALSE
+#define ST7789_PICO_XMX                                ST7789_BOOL_TRUE
+#define ST7789_PICO_XMH                                ST7789_BOOL_TRUE
+#define ST7789_PICO_XMV                                ST7789_BOOL_FALSE
+#define ST7789_PICO_XGS                                ST7789_BOOL_FALSE
+
+#define ST7789_PICO_VDV_VRH_FROM                       ST7789_VDV_VRH_FROM_CMD
+#define ST7789_PICO_VRHS                               4.45f
+#define ST7789_PICO_VDV                                0.0f
+
+#define ST7789_PICO_INVERSION_SELECTION                ST7789_INVERSION_SELECTION_DOT
+#define ST7789_PICO_FRAME_RATE                         ST7789_FRAME_RATE_60_HZ
+
+#define ST7789_PICO_AVDD                               ST7789_AVDD_6P8_V
+#define ST7789_PICO_AVCL_NEGTIVE                       ST7789_AVCL_NEGTIVE_4P8_V
+#define ST7789_PICO_VDS                                ST7789_VDS_2P3_V
+
+#define ST7789_PICO_POSITIVE_VOLTAGE_GAMMA            {0xD0, 0x04, 0x0D, 0x11, 0x13, 0x2B, 0x3F, \
+                                                       0x54, 0x4C, 0x18, 0x0D, 0x0B, 0x1F, 0x23}
+#define ST7789_PICO_NEGATIVA_VOLTAGE_GAMMA            {0xD0, 0x04, 0x0C, 0x11, 0x13, 0x2C, 0x3F, \
+                                                       0x44, 0x51, 0x2F, 0x1F, 0x1F, 0x20, 0x23}
+
+static st7789_handle_t gs_handle;
+static uint16_t bl_value = 0;
+
+static uint8_t st7789_interface_spi_init(void) {
+    // Use SPI1 at 100MHz
+    spi_init(spi1, 100 * 1000 * 1000);
+    gpio_set_function(LCD_PIN_CLK, GPIO_FUNC_SPI);
+    gpio_set_function(LCD_PIN_DIN, GPIO_FUNC_SPI);
+
+    // Chip select is active-low, so we'll initialise it to a driven-high state
+    gpio_init(LCD_PIN_CS);
+    gpio_set_dir(LCD_PIN_CS, GPIO_OUT);
+    gpio_put(LCD_PIN_CS, 1);
+
+    spi_set_format(spi1,
+                   8, // Number of bits per transfer
+                   0, // Polarity (CPOL)
+                   0, // Phase (CPHA)
+                   SPI_MSB_FIRST);
+
+    return 0;
+}
+
+static uint8_t st7789_interface_spi_deinit(void) {
+    spi_deinit(spi1);
+    gpio_deinit(LCD_PIN_CS);
+    return 0;
+}
+
+static uint8_t st7789_interface_spi_write_cmd(uint8_t *buf, uint16_t len) {
+    gpio_put(LCD_PIN_CS, 0);
+    spi_write_blocking(spi1, buf, len);
+    gpio_put(LCD_PIN_CS, 1);
+    return 0;
+}
+
+static void st7789_interface_delay_ms(uint32_t ms) {
+    sleep_ms(ms);
+}
+
+static void st7789_interface_debug_print(const char *const fmt, ...) {
+    va_list args;
+    va_start(args, fmt);
+    debug_log_va(true, fmt, args);
+    va_end(args);
+}
+
+static uint8_t st7789_interface_cmd_data_gpio_init(void) {
+    gpio_init(LCD_PIN_DC);
+    gpio_set_dir(LCD_PIN_DC, GPIO_OUT);
+    return 0;
+}
+
+static uint8_t st7789_interface_cmd_data_gpio_deinit(void) {
+    gpio_deinit(LCD_PIN_DC);
+    return 0;
+}
+
+static uint8_t st7789_interface_cmd_data_gpio_write(uint8_t value) {
+    gpio_put(LCD_PIN_DC, value);
+    return 0;
+}
+
+static uint8_t st7789_interface_reset_gpio_init(void) {
+    gpio_init(LCD_PIN_RST);
+    gpio_set_dir(LCD_PIN_RST, GPIO_OUT);
+    return 0;
+}
+
+static uint8_t st7789_interface_reset_gpio_deinit(void) {
+    gpio_deinit(LCD_PIN_RST);
+    return 0;
+}
+
+static uint8_t st7789_interface_reset_gpio_write(uint8_t value) {
+    gpio_put(LCD_PIN_RST, value);
+    return 0;
+}
+
+void lcd_init(void) {
+    uint8_t reg;
+
+    DRIVER_ST7789_LINK_INIT(&gs_handle, st7789_handle_t);
+    DRIVER_ST7789_LINK_SPI_INIT(&gs_handle, st7789_interface_spi_init);
+    DRIVER_ST7789_LINK_SPI_DEINIT(&gs_handle, st7789_interface_spi_deinit);
+    DRIVER_ST7789_LINK_SPI_WRITE_COMMAND(&gs_handle, st7789_interface_spi_write_cmd);
+    DRIVER_ST7789_LINK_COMMAND_DATA_GPIO_INIT(&gs_handle, st7789_interface_cmd_data_gpio_init);
+    DRIVER_ST7789_LINK_COMMAND_DATA_GPIO_DEINIT(&gs_handle, st7789_interface_cmd_data_gpio_deinit);
+    DRIVER_ST7789_LINK_COMMAND_DATA_GPIO_WRITE(&gs_handle, st7789_interface_cmd_data_gpio_write);
+    DRIVER_ST7789_LINK_RESET_GPIO_INIT(&gs_handle, st7789_interface_reset_gpio_init);
+    DRIVER_ST7789_LINK_RESET_GPIO_DEINIT(&gs_handle, st7789_interface_reset_gpio_deinit);
+    DRIVER_ST7789_LINK_RESET_GPIO_WRITE(&gs_handle, st7789_interface_reset_gpio_write);
+    DRIVER_ST7789_LINK_DELAY_MS(&gs_handle, st7789_interface_delay_ms);
+    DRIVER_ST7789_LINK_DEBUG_PRINT(&gs_handle, st7789_interface_debug_print);
+
+    st7789_init(&gs_handle);
+
+    st7789_set_column(&gs_handle, ST7789_PICO_COLUMN);
+
+    st7789_set_row(&gs_handle, ST7789_PICO_ROW);
+
+    st7789_set_memory_data_access_control(&gs_handle, ST7789_PICO_ACCESS);
+
+    st7789_set_interface_pixel_format(&gs_handle,
+                                      ST7789_PICO_RGB_INTERFACE_COLOR_FORMAT,
+                                      ST7789_PICO_CONTROL_INTERFACE_COLOR_FORMAT);
+
+    st7789_set_porch(&gs_handle,
+                     ST7789_PICO_PORCH_NORMAL_BACK,
+                     ST7789_PICO_PORCH_NORMAL_FRONT,
+                     ST7789_PICO_PORCH_ENABLE,
+                     ST7789_PICO_PORCH_IDEL_BACK,
+                     ST7789_PICO_PORCH_IDEL_FRONT,
+                     ST7789_PICO_PORCH_PART_BACK,
+                     ST7789_PICO_PORCH_PART_FRONT);
+
+    st7789_set_gate_control(&gs_handle, ST7789_PICO_VGHS, ST7789_PICO_VGLS_NEGATIVE);
+
+    st7789_vcom_convert_to_register(&gs_handle, ST7789_PICO_VCOMS, &reg);
+    st7789_set_vcoms(&gs_handle, reg);
+
+    st7789_set_lcm_control(&gs_handle,
+                           ST7789_PICO_XMY,
+                           ST7789_PICO_XBGR,
+                           ST7789_PICO_XINV,
+                           ST7789_PICO_XMX,
+                           ST7789_PICO_XMH,
+                           ST7789_PICO_XMV,
+                           ST7789_PICO_XGS);
+
+    st7789_set_vdv_vrh_from(&gs_handle, ST7789_PICO_VDV_VRH_FROM);
+
+    st7789_vrhs_convert_to_register(&gs_handle, ST7789_PICO_VRHS, &reg);
+    st7789_set_vrhs(&gs_handle, reg);
+
+    st7789_vdv_convert_to_register(&gs_handle, ST7789_PICO_VDV, &reg);
+    st7789_set_vdv(&gs_handle, reg);
+
+    st7789_set_frame_rate(&gs_handle, ST7789_PICO_INVERSION_SELECTION, ST7789_PICO_FRAME_RATE);
+
+    st7789_set_power_control_1(&gs_handle,
+                               ST7789_PICO_AVDD,
+                               ST7789_PICO_AVCL_NEGTIVE,
+                               ST7789_PICO_VDS);
+
+    uint8_t param_positive[14] = ST7789_PICO_POSITIVE_VOLTAGE_GAMMA;
+    st7789_set_positive_voltage_gamma_control(&gs_handle, param_positive);
+
+    uint8_t param_negative[14] = ST7789_PICO_NEGATIVA_VOLTAGE_GAMMA;
+    st7789_set_negative_voltage_gamma_control(&gs_handle, param_negative);
+
+    st7789_display_inversion_on(&gs_handle);
+
+    st7789_sleep_out(&gs_handle);
+
+    st7789_display_on(&gs_handle);
+
+    st7789_clear(&gs_handle);
+
+    // backlight
+    uint bl_slice = pwm_gpio_to_slice_num(LCD_PIN_BL);
+    uint bl_channel = pwm_gpio_to_channel(LCD_PIN_BL);
+    gpio_set_function(LCD_PIN_BL, GPIO_FUNC_PWM);
+    pwm_set_wrap(bl_slice, 0xFFFF);
+    pwm_set_clkdiv(bl_slice, 1.0f);
+    pwm_set_chan_level(bl_slice, bl_channel, bl_value);
+    pwm_set_enabled(bl_slice, true);
+}
+
+uint16_t lcd_get_backlight(void) {
+    return bl_value;
+}
+
+void lcd_set_backlight(uint16_t value) {
+    uint bl_slice = pwm_gpio_to_slice_num(LCD_PIN_BL);
+    uint bl_channel = pwm_gpio_to_channel(LCD_PIN_BL);
+    bl_value = value;
+    pwm_set_chan_level(bl_slice, bl_channel, bl_value);
+}
+
+void lcd_clear(void) {
+    st7789_clear(&gs_handle);
+}
+
+void lcd_write_point(uint16_t x, uint16_t y, uint32_t color) {
+    st7789_draw_point(&gs_handle, x, y, color);
+}
+
+void lcd_write_rect(uint16_t left, uint16_t top, uint16_t right, uint16_t bottom, uint32_t color) {
+    st7789_fill_rect(&gs_handle, left, top, right, bottom, color);
+}
+
+uint32_t from_hsv(float h, float s, float v) {
+    float i = floorf(h * 6.0f);
+    float f = h * 6.0f - i;
+    v *= 255.0f;
+    float p = v * (1.0f - s);
+    float q = v * (1.0f - f * s);
+    float t = v * (1.0f - (1.0f - f) * s);
+
+    switch (((uint32_t)i) % 6) {
+    case 0:
+        return RGB_565((uint32_t)v, (uint32_t)t, (uint32_t)p);
+
+    case 1:
+        return RGB_565((uint32_t)q, (uint32_t)v, (uint32_t)p);
+
+    case 2:
+        return RGB_565((uint32_t)p, (uint32_t)v, (uint32_t)t);
+
+    case 3:
+        return RGB_565((uint32_t)p, (uint32_t)q, (uint32_t)v);
+
+    case 4:
+        return RGB_565((uint32_t)t, (uint32_t)p, (uint32_t)v);
+
+    case 5:
+        return RGB_565((uint32_t)v, (uint32_t)p, (uint32_t)q);
+
+    default:
+        return RGB_565(0, 0, 0);
+    }
+}

src/lipo.c

@@ -0,0 +1,120 @@
+/*
+ * lipo.c
+ *
+ * https://github.com/raspberrypi/pico-examples/blob/master/adc/read_vsys/power_status.c
+ *
+ * Copyright (c) 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 <math.h>
+
+#include "stdbool.h"
+#include "hardware/adc.h"
+
+#include "config.h"
+#include "lipo.h"
+
+#if CYW43_USES_VSYS_PIN
+#include "pico/cyw43_arch.h"
+#endif
+
+#ifndef PICO_POWER_SAMPLE_COUNT
+#define PICO_POWER_SAMPLE_COUNT 3
+#endif
+
+// Pin used for ADC 0
+#define PICO_FIRST_ADC_PIN 26
+
+static const float full_battery = 4.1f;
+static const float empty_battery = 3.2f;
+static const float low_pass_factor = 0.9f;
+
+bool lipo_charging(void) {
+#if defined CYW43_WL_GPIO_VBUS_PIN
+    return cyw43_arch_gpio_get(CYW43_WL_GPIO_VBUS_PIN);
+#elif defined PICO_VBUS_PIN
+    gpio_set_function(PICO_VBUS_PIN, GPIO_FUNC_SIO);
+    return gpio_get(PICO_VBUS_PIN);
+#else
+#error "No VBUS Pin available!"
+#endif
+}
+
+float lipo_voltage(void) {
+#ifndef PICO_VSYS_PIN
+#error "No VSYS Pin available!"
+#endif
+
+#if CYW43_USES_VSYS_PIN
+    cyw43_thread_enter();
+    // Make sure cyw43 is awake
+    bool charging = cyw43_arch_gpio_get(CYW43_WL_GPIO_VBUS_PIN);
+#endif
+
+    // setup adc
+    adc_gpio_init(PICO_VSYS_PIN);
+    adc_select_input(PICO_VSYS_PIN - PICO_FIRST_ADC_PIN);
+
+    adc_fifo_setup(true, false, 0, false, false);
+    adc_run(true);
+
+    // We seem to read low values initially - this seems to fix it
+    int ignore_count = PICO_POWER_SAMPLE_COUNT;
+    while (!adc_fifo_is_empty() || ignore_count-- > 0) {
+        (void)adc_fifo_get_blocking();
+    }
+
+    // read vsys
+    uint32_t vsys = 0;
+    for(int i = 0; i < PICO_POWER_SAMPLE_COUNT; i++) {
+        uint16_t val = adc_fifo_get_blocking();
+        vsys += val;
+    }
+
+    adc_run(false);
+    adc_fifo_drain();
+
+    vsys /= PICO_POWER_SAMPLE_COUNT;
+
+#if CYW43_USES_VSYS_PIN
+    cyw43_thread_exit();
+#endif
+
+    // Generate voltage
+    const float conversion_factor = 3.3f / (1 << 12);
+    float v_now = vsys * 3 * conversion_factor;
+
+    static float v_prev = NAN;
+    if (charging) {
+        v_prev = NAN;
+        return v_now;
+    } else {
+        if (isnan(v_prev)) {
+            v_prev = v_now;
+        }
+        v_prev = (v_prev * low_pass_factor) + (v_now * (1.0f - low_pass_factor));
+        return v_prev;
+    }
+}
+
+float lipo_percentage(float voltage) {
+    float percentage = 100.0f * ((voltage - empty_battery) / (full_battery - empty_battery));
+    if (percentage >= 99.9f) {
+        percentage = 99.9f;
+    } else if (percentage < 0.0f) {
+        percentage = 0.0f;
+    }
+    return percentage;
+}

src/log.c

@@ -0,0 +1,142 @@
+/*
+ * 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 <stdio.h>
+
+#include "hardware/watchdog.h"
+#include "ff.h"
+
+#include "config.h"
+#include "main.h"
+#include "usb_cdc.h"
+#include "serial.h"
+#include "ring.h"
+#include "log.h"
+
+static uint8_t log_buff[4096] = {0};
+static struct ring_buffer log = RB_INIT(log_buff, sizeof(log_buff));
+
+static uint8_t line_buff[128] = {0};
+static volatile bool got_input = false;
+static FIL log_file_fat;
+
+static void add_to_log(const uint8_t *buff, size_t len) {
+    rb_add(&log, buff, len);
+}
+
+static void log_dump_to_x(void (*write)(const uint8_t *, size_t)) {
+    if (rb_len(&log) == 0) {
+        return;
+    }
+
+    int l = snprintf((char *)line_buff, sizeof(line_buff), "\r\n\r\nbuffered log output:\r\n");
+    if ((l > 0) && (l <= (int)sizeof(line_buff))) {
+        write(line_buff, l);
+    }
+
+    rb_dump(&log, write);
+
+    l = snprintf((char *)line_buff, sizeof(line_buff), "\r\n\r\nlive log:\r\n");
+    if ((l > 0) && (l <= (int)sizeof(line_buff))) {
+        write(line_buff, l);
+    }
+}
+
+void log_dump_to_usb(void) {
+    log_dump_to_x(usb_cdc_write);
+}
+
+void log_dump_to_uart(void) {
+    log_dump_to_x(serial_write);
+}
+
+static void log_file_write_callback(const uint8_t *data, size_t len) {
+    UINT bw;
+    FRESULT res = f_write(&log_file_fat, data, len, &bw);
+    if ((res != FR_OK) || (bw != len)) {
+        debug("error: f_write %u returned %d", len, res);
+    }
+}
+
+void log_dump_to_disk(void) {
+    FRESULT res = f_open(&log_file_fat, "log.txt", FA_CREATE_ALWAYS | FA_WRITE);
+    if (res != FR_OK) {
+        debug("error: f_open returned %d", res);
+        return;
+    }
+
+    rb_dump(&log, log_file_write_callback);
+
+    res = f_close(&log_file_fat);
+    if (res != FR_OK) {
+        debug("error: f_close returned %d", res);
+    }
+}
+
+void debug_log_va(bool log, const char *format, va_list args) {
+    int l = vsnprintf((char *)line_buff, sizeof(line_buff), format, args);
+
+    if (l < 0) {
+        // encoding error
+        l = snprintf((char *)line_buff, sizeof(line_buff), "%s: encoding error\r\n", __func__);
+    } else if (l >= (ssize_t)sizeof(line_buff)) {
+        // not enough space for string
+        l = snprintf((char *)line_buff, sizeof(line_buff), "%s: message too long (%d)\r\n", __func__, l);
+    }
+    if ((l > 0) && (l <= (int)sizeof(line_buff))) {
+        usb_cdc_write(line_buff, l);
+        serial_write(line_buff, l);
+
+        if (log) {
+            add_to_log(line_buff, l);
+        }
+    }
+}
+
+void debug_log(bool log, const char* format, ...) {
+    va_list args;
+    va_start(args, format);
+    debug_log_va(log, format, args);
+    va_end(args);
+}
+
+void debug_handle_input(const uint8_t *buff, size_t len) {
+    (void)buff;
+
+    if (len > 0) {
+        got_input = true;
+    }
+}
+
+void debug_wait_input(const char *format, ...) {
+    va_list args;
+    va_start(args, format);
+    debug_log_va(false, format, args);
+    va_end(args);
+
+    got_input = false;
+    usb_cdc_set_reroute(true);
+    serial_set_reroute(true);
+
+    while (!got_input) {
+        main_loop_hw();
+    }
+
+    usb_cdc_set_reroute(false);
+    serial_set_reroute(false);
+}

src/main.c

@@ -0,0 +1,112 @@
+/*
+ * 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 "pico/cyw43_arch.h"
+#include "hardware/watchdog.h"
+#include "hardware/adc.h"
+
+#include "config.h"
+#include "util.h"
+#include "console.h"
+#include "log.h"
+#include "usb.h"
+#include "fat_disk.h"
+#include "debug_disk.h"
+#include "buttons.h"
+#include "ble.h"
+#include "lcd.h"
+#include "text.h"
+#include "image.h"
+#include "state.h"
+#include "serial.h"
+#include "workflow.h"
+
+void main_loop_hw(void) {
+    watchdog_update();
+    usb_run();
+    serial_run();
+    heartbeat_run();
+}
+
+int main(void) {
+    // required for debug console
+    cnsl_init();
+    serial_init();
+    usb_init();
+
+    debug("lcd_init");
+    lcd_init();
+    draw_splash();
+    lcd_set_backlight(0x8000);
+
+    if (watchdog_caused_reboot()) {
+        debug("reset by watchdog");
+    }
+
+    debug("buttons_init");
+    buttons_init();
+
+    // required for LiPo voltage reading
+    debug("adc_init");
+    adc_init();
+
+    // required for BLE and LiPo voltage reading
+    debug("cyw43_arch_init");
+    if (cyw43_arch_init()) {
+        debug("cyw43_arch_init failed");
+    }
+
+    debug("heartbeat_init");
+    heartbeat_init();
+
+    debug("ble_init");
+    ble_init();
+
+    debug("fat_disk_init");
+    fat_disk_init();
+
+    debug("debug_disk_init");
+    debug_disk_init();
+
+    watchdog_enable(WATCHDOG_PERIOD_MS, 1);
+
+    debug("init done");
+    battery_run();
+    lcd_set_backlight(0x8000); // TODO dynamic
+
+    // wait for BLE stack to be ready before using it
+    debug("wait for bt stack");
+    while (!ble_is_ready()) {
+        sleep_ms(1);
+    }
+
+    debug("starting app");
+    state_switch(STATE_SCAN);
+
+    while (1) {
+        main_loop_hw();
+        buttons_run();
+        cnsl_run();
+        battery_run();
+        state_run();
+        wf_run();
+    }
+
+    return 0;
+}

src/menu.c

@@ -0,0 +1,105 @@
+/*
+ * menu.c
+ *
+ * Copyright (c) 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 "config.h"
+#include "buttons.h"
+#include "text.h"
+#include "menu.h"
+
+static char prev_buff[MENU_MAX_LEN] = {0};
+static char buff[MENU_MAX_LEN] = {0};
+static struct menu_state menu = { .off = 0, .selection = -1, .length = 0, .buff = buff };
+static void (*enter_callback)(int) = NULL;
+static void (*exit_callback)(void) = NULL;
+
+static void menu_buttons(enum buttons btn, bool state) {
+    if (state && (btn == BTN_LEFT)) {
+        // TODO brightness down
+        return;
+    } else if (state && (btn == BTN_RIGHT)) {
+        // TODO brightness up
+        return;
+    } else if (state && ((btn == BTN_ENTER) || (btn == BTN_A))) {
+        if (enter_callback) {
+            enter_callback(menu.selection);
+        }
+        return;
+    } else if (state && (btn == BTN_Y)) {
+        if (exit_callback) {
+            exit_callback();
+        }
+    } else if ((!state) || ((btn != BTN_UP) && (btn != BTN_DOWN))) {
+        return;
+    }
+
+    if (state && (btn == BTN_UP)) {
+        if (menu.selection < 0) {
+            menu.selection = menu.length - 1;
+        } else {
+            menu.selection -= 1;
+        }
+    } else if (state && (btn == BTN_DOWN)) {
+        if (menu.selection < 0) {
+            menu.selection = 0;
+        } else {
+            menu.selection += 1;
+        }
+    }
+
+    if (menu.selection < 0) {
+        menu.selection += menu.length;
+    }
+    if (menu.selection >= menu.length) {
+        menu.selection -= menu.length;
+    }
+    if (menu.selection >= 0) {
+        while (menu.selection < menu.off) {
+            menu.off -= 1;
+        }
+        while (menu.selection >= (menu.off + MENU_MAX_LINES)) {
+            menu.off += 1;
+        }
+    }
+}
+
+void menu_init(void (*enter)(int), void (*exit)(void)) {
+    menu.off = 0;
+    menu.selection = -1;
+    menu.length = 0;
+
+    enter_callback = enter;
+    exit_callback = exit;
+    buttons_callback(menu_buttons);
+}
+
+void menu_deinit(void) {
+    buttons_callback(NULL);
+}
+
+void menu_run(void (*draw)(struct menu_state *)) {
+    if (draw) {
+        draw(&menu);
+    }
+
+    if (strncmp(buff, prev_buff, MENU_MAX_LEN) != 0) {
+        strncpy(prev_buff, buff, MENU_MAX_LEN);
+        text_box(buff);
+    }
+}

src/models.c

@@ -0,0 +1,53 @@
+/*
+ * models.c
+ *
+ * Copyright (c) 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 <stddef.h>
+#include <string.h>
+
+#include "config.h"
+#include "log.h"
+#include "util.h"
+#include "models.h"
+
+enum known_devices models_filter_name(const char *name) {
+    if (name == NULL) {
+        return DEV_UNKNOWN;
+    } else if (strcmp(name, "S&B VOLCANO H") == 0) {
+        return DEV_VOLCANO;
+    } else if (strcmp(name, "STORZ&BICKEL") == 0) {
+        return DEV_CRAFTY;
+    } else {
+        return DEV_UNKNOWN;
+    }
+}
+
+int8_t models_get_serial(const uint8_t *data, size_t data_len, char *buff, size_t buff_len) {
+    if ((data == NULL) || (data_len <= 0) || (buff == NULL) || (buff_len <= 0)) {
+        return -1;
+    }
+
+    const size_t serial_len = 8;
+    const size_t serial_off = 2;
+    if ((data_len < (serial_len + serial_off)) || (buff_len < (serial_len + 1))) {
+        return -2;
+    }
+    memcpy(buff, data + serial_off, serial_len);
+    buff[serial_len] = '\0';
+
+    return 0;
+}

src/ring.c

@@ -0,0 +1,92 @@
+/*
+ * ring.c
+ *
+ * Copyright (c) 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 "config.h"
+#include "ring.h"
+
+void rb_add(struct ring_buffer *rb, const uint8_t *data, size_t length) {
+    for (size_t i = 0; i < length; i++) {
+        rb->buffer[rb->head] = data[i];
+
+        if (rb->full && (++(rb->tail) == rb->size)) {
+            rb->tail = 0;
+        }
+
+        if (++(rb->head) == rb->size) {
+            rb->head = 0;
+        }
+
+        rb->full = ((rb->head) == (rb->tail));
+    }
+}
+
+size_t rb_len(struct ring_buffer *rb) {
+    if (rb->head == rb->tail) {
+        if (rb->full) {
+            return rb->size;
+        } else {
+            return 0;
+        }
+    } else if (rb->head > rb->tail) {
+        return rb->head - rb->tail;
+    } else {
+        return rb->size - rb->tail + rb->head;
+    }
+}
+
+void rb_dump(struct ring_buffer *rb, void (*write)(const uint8_t *, size_t)) {
+    if (rb_len(rb) == 0) {
+        return;
+    }
+
+    if (rb->head > rb->tail) {
+        write(rb->buffer + rb->tail, rb->head - rb->tail);
+    } else {
+        write(rb->buffer + rb->tail, rb->size - rb->tail);
+        write(rb->buffer, rb->head);
+    }
+}
+
+void rb_move(struct ring_buffer *rb, void (*write)(const uint8_t *, size_t)) {
+    rb_dump(rb, write);
+    rb->head = 0;
+    rb->tail = 0;
+    rb->full = false;
+}
+
+uint8_t rb_peek(struct ring_buffer *rb) {
+    if (rb_len(rb) == 0) {
+        return 0;
+    }
+
+    uint8_t v = rb->buffer[rb->tail];
+    return v;
+}
+
+uint8_t rb_pop(struct ring_buffer *rb) {
+    if (rb_len(rb) == 0) {
+        return 0;
+    }
+
+    uint8_t v = rb->buffer[rb->tail++];
+    if (rb->tail >= rb->size) {
+        rb->tail = 0;
+    }
+
+    return v;
+}

src/serial.c

@@ -0,0 +1,157 @@
+/*
+ * serial.c
+ *
+ * https://github.com/raspberrypi/pico-examples/blob/master/uart/uart_advanced/uart_advanced.c
+ * https://forums.raspberrypi.com/viewtopic.php?t=343110
+ *
+ * Copyright (c) 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/>.
+ */
+
+// UART0, Tx GP0, Rx GP1
+#define UART_ID uart0
+#define UART_IRQ UART0_IRQ
+#define UART_TX_PIN 0
+#define UART_RX_PIN 1
+
+// Serial port parameters
+#define BAUD_RATE 115200
+#define DATA_BITS 8
+#define PARITY UART_PARITY_NONE
+#define STOP_BITS 1
+
+#define UART_RX_BUFF_LEN 64
+#define UART_TX_BUFF_LEN 128
+
+#include "hardware/uart.h"
+#include "hardware/gpio.h"
+
+#include "config.h"
+#include "console.h"
+#include "log.h"
+#include "util.h"
+#include "ring.h"
+#include "serial.h"
+
+static uint8_t rx_buff[UART_RX_BUFF_LEN] = {0};
+static struct ring_buffer rx = RB_INIT(rx_buff, sizeof(rx_buff));
+
+static uint8_t tx_buff[UART_TX_BUFF_LEN] = {0};
+static struct ring_buffer tx = RB_INIT(tx_buff, sizeof(tx_buff));
+
+static bool reroute_serial_debug = false;
+static bool tx_irq_state = false;
+static bool rx_irq_state = false;
+#define SET_TX_IRQ(v) {                 \
+    tx_irq_state = v;                   \
+    uart_set_irq_enables(UART_ID,       \
+                         rx_irq_state,  \
+                         tx_irq_state); \
+}
+#define SET_RX_IRQ(v) {                 \
+    rx_irq_state = v;                   \
+    uart_set_irq_enables(UART_ID,       \
+                         rx_irq_state,  \
+                         tx_irq_state); \
+}
+
+static void serial_irq(void) {
+    // Rx - read from UART FIFO to local buffer
+    while (uart_is_readable(UART_ID) && (rb_space(&rx) > 0)) {
+        uint8_t ch = uart_getc(UART_ID);
+        rb_push(&rx, ch);
+    }
+
+    // Tx - write to UART FIFO if needed
+    while (uart_is_writable(UART_ID)) {
+        if (rb_len(&tx) > 0) {
+            uart_putc_raw(UART_ID, rb_pop(&tx));
+        } else {
+            SET_TX_IRQ(false);
+            break;
+        }
+    }
+
+}
+
+void serial_init(void) {
+    uart_init(UART_ID, BAUD_RATE);
+
+    gpio_set_function(UART_TX_PIN, GPIO_FUNC_UART);
+    gpio_set_function(UART_RX_PIN, GPIO_FUNC_UART);
+
+    uart_set_hw_flow(UART_ID, false, false);
+    uart_set_format(UART_ID, DATA_BITS, STOP_BITS, PARITY);
+    uart_set_fifo_enabled(UART_ID, true);
+
+    irq_set_exclusive_handler(UART_IRQ, serial_irq);
+    irq_set_enabled(UART_IRQ, true);
+
+    SET_RX_IRQ(true);
+    SET_TX_IRQ(false);
+}
+
+void serial_write(const uint8_t *buf, size_t count) {
+    SET_TX_IRQ(false);
+
+    while ((rb_len(&tx) == 0) && uart_is_writable(UART_ID) && (count > 0)) {
+        uart_putc_raw(UART_ID, *buf++);
+        count--;
+    }
+
+    if (count == 0) {
+        return;
+    }
+
+    size_t off = 0;
+
+#ifdef SERIAL_WRITES_BLOCK_WHEN_BUFFER_FULL
+    while (count > rb_space(&tx)) {
+        size_t space = rb_space(&tx);
+        rb_add(&tx, buf + off, space);
+        count -= space;
+        off += space;
+
+        SET_TX_IRQ(true);
+
+        sleep_ms(1);
+
+        SET_TX_IRQ(false);
+    }
+#endif // SERIAL_WRITES_BLOCK_WHEN_BUFFER_FULL
+
+    rb_add(&tx, buf + off, count);
+
+    SET_TX_IRQ(true);
+}
+
+void serial_set_reroute(bool reroute) {
+    reroute_serial_debug = reroute;
+}
+
+void serial_run(void) {
+    SET_RX_IRQ(false);
+
+    if (rb_len(&rx) >= 1) {
+        if (rb_peek(&rx) == ENTER_BOOTLOADER_MAGIC) {
+            reset_to_bootloader();
+        } else if (reroute_serial_debug) {
+            rb_move(&rx, debug_handle_input);
+        } else {
+            rb_move(&rx, cnsl_handle_input);
+        }
+    }
+
+    SET_RX_IRQ(true);
+}

src/state.c

@@ -0,0 +1,115 @@
+/*
+ * state.c
+ *
+ * Copyright (c) 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 "config.h"
+#include "log.h"
+#include "state_scan.h"
+#include "state_volcano_workflow.h"
+#include "state_volcano_run.h"
+#include "state_crafty.h"
+#include "state.h"
+
+static enum system_state state = STATE_INIT;
+
+void state_switch(enum system_state next) {
+    if (state == next) {
+        return;
+    }
+
+    // clean up old state when leaving it
+    switch (state) {
+    case STATE_SCAN:
+        debug("leaving STATE_SCAN");
+        state_scan_exit();
+        break;
+
+    case STATE_VOLCANO_WORKFLOW:
+        debug("leaving STATE_VOLCANO_WORKFLOW");
+        state_volcano_wf_exit();
+        break;
+
+    case STATE_VOLCANO_RUN:
+        debug("leaving STATE_VOLCANO_RUN");
+        state_volcano_run_exit();
+        break;
+
+    case STATE_CRAFTY:
+        debug("leaving STATE_CRAFTY");
+        state_crafty_exit();
+        break;
+
+    default:
+        break;
+    }
+
+    // prepare new state on entering
+    switch (next) {
+    case STATE_SCAN:
+        debug("entering STATE_SCAN");
+        state_scan_enter();
+        break;
+
+    case STATE_VOLCANO_WORKFLOW:
+        debug("entering STATE_VOLCANO_WORKFLOW");
+        state_volcano_wf_enter();
+        break;
+
+    case STATE_VOLCANO_RUN:
+        debug("entering STATE_VOLCANO_RUN");
+        state_volcano_run_enter();
+        break;
+
+    case STATE_CRAFTY:
+        debug("entering STATE_CRAFTY");
+        state_crafty_enter();
+        break;
+
+    default:
+        break;
+    }
+
+    state = next;
+}
+
+void state_run(void) {
+    switch (state) {
+    case STATE_INIT:
+        break;
+
+    case STATE_SCAN:
+        state_scan_run();
+        break;
+
+    case STATE_VOLCANO_WORKFLOW:
+        state_volcano_wf_run();
+        break;
+
+    case STATE_VOLCANO_RUN:
+        state_volcano_run_run();
+        break;
+
+    case STATE_CRAFTY:
+        state_crafty_run();
+        break;
+
+    default:
+        debug("invalid main state %d", state);
+        state_switch(STATE_SCAN);
+        break;
+    }
+}

src/state_crafty.c

@@ -0,0 +1,127 @@
+/*
+ * state_crafty.c
+ *
+ * Copyright (c) 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 <stdio.h>
+#include <string.h>
+
+#include "config.h"
+#include "buttons.h"
+#include "crafty.h"
+#include "log.h"
+#include "state.h"
+#include "state_crafty.h"
+
+#include "menu.h"
+
+#define CRAFTY_UPDATE_TIME_MS 1000
+
+static bd_addr_t ble_addr = {0};
+static bd_addr_type_t ble_type = 0;
+static bool wait_for_connect = false;
+static bool wait_for_disconnect = false;
+static bool heater_state = false;
+static int16_t target_temp = 0;
+
+static void crafty_buttons(enum buttons btn, bool state) {
+    if (state && (btn == BTN_Y)) {
+        if ((!wait_for_connect) && (!wait_for_disconnect)) {
+            debug("crafty disconnect");
+            ble_disconnect();
+            wait_for_disconnect = true;
+        } else {
+            debug("invalid state for disconnect");
+        }
+    } else if (state && (btn == BTN_A)) {
+        heater_state = !heater_state;
+        debug("crafty heater %s", heater_state ? "on" : "off");
+        crafty_set_heater_state(heater_state);
+    } else if (state && (btn == BTN_LEFT)) {
+        target_temp -= 10;
+        if (target_temp < 400) {
+            target_temp = 400;
+        } else if (target_temp > 2100) {
+            target_temp = 2100;
+        }
+        debug("crafty temp to %.1f", target_temp / 10.0f);
+        crafty_set_target_temp(target_temp);
+    } else if (state && (btn == BTN_RIGHT)) {
+        target_temp += 10;
+        if (target_temp < 400) {
+            target_temp = 400;
+        } else if (target_temp > 2100) {
+            target_temp = 2100;
+        }
+        debug("crafty temp to %.1f", target_temp / 10.0f);
+        crafty_set_target_temp(target_temp);
+    }
+}
+
+void state_crafty_target(bd_addr_t addr, bd_addr_type_t type) {
+    memcpy(ble_addr, addr, sizeof(bd_addr_t));
+    ble_type = type;
+}
+
+void state_crafty_enter(void) {
+    debug("crafty connect");
+    ble_connect(ble_addr, ble_type);
+    wait_for_connect = true;
+
+    buttons_callback(crafty_buttons);
+}
+
+void state_crafty_exit(void) {
+    buttons_callback(NULL);
+}
+
+static void draw(struct menu_state *menu) {
+    if (wait_for_connect) {
+        snprintf(menu->buff, MENU_MAX_LEN, "Connecting...");
+    } else if (wait_for_disconnect) {
+        snprintf(menu->buff, MENU_MAX_LEN, "Disconnecting...");
+    } else {
+        target_temp = crafty_get_target_temp();
+        int16_t ct = crafty_get_current_temp();
+        int8_t bs = crafty_get_battery_state();
+
+        snprintf(menu->buff, MENU_MAX_LEN,
+                 "Target: %.1f C\n"
+                 "Current: %.1f C\n"
+                 "Battery: %d %%",
+                 target_temp / 10.0f, ct / 10.0f, bs);
+    }
+}
+
+void state_crafty_run(void) {
+    if (wait_for_connect && ble_is_connected()) {
+        wait_for_connect = false;
+        debug("crafty start");
+    }
+
+    static uint32_t last = 0;
+    uint32_t now = to_ms_since_boot(get_absolute_time());
+    if (((now - last) >= CRAFTY_UPDATE_TIME_MS) || (last == 0)) {
+        last = now;
+        menu_run(draw);
+    }
+
+    if (wait_for_disconnect && !ble_is_connected()) {
+        wait_for_disconnect = false;
+        debug("crafty done");
+        state_switch(STATE_SCAN);
+    }
+}

src/state_scan.c

@@ -0,0 +1,132 @@
+/*
+ * state_scan.c
+ *
+ * Copyright (c) 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 <stdio.h>
+#include <string.h>
+
+#include "config.h"
+#include "ble.h"
+#include "models.h"
+#include "menu.h"
+#include "state.h"
+#include "state_volcano_run.h"
+#include "state_crafty.h"
+#include "state_scan.h"
+
+static struct ble_scan_result results[BLE_MAX_SCAN_RESULTS] = {0};
+static int result_count = 0;
+
+static void enter_cb(int selection) {
+    int devs = 0;
+    for (int i = 0; i < result_count; i++) {
+        enum known_devices dev = models_filter_name(results[i].name);
+        if (dev == DEV_UNKNOWN) {
+            continue;
+        }
+
+        if (devs++ == selection) {
+            if (dev == DEV_VOLCANO) {
+                state_volcano_run_target(results[i].addr, results[i].type);
+                state_switch(STATE_VOLCANO_WORKFLOW);
+            } else if (dev == DEV_CRAFTY) {
+                state_crafty_target(results[i].addr, results[i].type);
+                state_switch(STATE_CRAFTY);
+            }
+            return;
+        }
+    }
+}
+
+void state_scan_enter(void) {
+    menu_init(enter_cb, NULL);
+    ble_scan(BLE_SCAN_ON);
+}
+
+void state_scan_exit(void) {
+    menu_deinit();
+    ble_scan(BLE_SCAN_OFF);
+}
+
+static void draw(struct menu_state *menu) {
+    result_count = ble_get_scan_results(results, BLE_MAX_SCAN_RESULTS);
+
+    int pos = 0, devs = 0;
+    for (int i = 0; i < result_count; i++) {
+        enum known_devices dev = models_filter_name(results[i].name);
+        if (dev == DEV_UNKNOWN) {
+            continue;
+        }
+
+        devs++;
+
+        if (((devs - 1) < menu->off)
+            || ((devs - 1 - menu->off) >= MENU_MAX_LINES)) {
+            continue;
+        }
+
+#if defined(MENU_PREFER_VOLCANO) || defined(MENU_PREFER_CRAFTY)
+        if (menu->selection < 0) {
+#ifdef MENU_PREFER_VOLCANO
+            if (dev == DEV_VOLCANO) {
+                menu->selection = devs - 1;
+            }
+#endif // MENU_PREFER_VOLCANO
+#ifdef MENU_PREFER_CRAFTY
+            if (dev == DEV_CRAFTY) {
+                menu->selection = devs - 1;
+            }
+#endif // MENU_PREFER_CRAFTY
+        }
+#endif // defined(MENU_PREFER_VOLCANO) || defined(MENU_PREFER_CRAFTY)
+
+        if ((devs - 1) == menu->selection) {
+            pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos, "> ");
+        } else {
+            pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos, "  ");
+        }
+
+        if (dev == DEV_VOLCANO) {
+            pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos, "Volcano ");
+        } else if (dev == DEV_CRAFTY) {
+            pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos, "Crafty+ ");
+        }
+
+        char info[32] = "";
+        if (models_get_serial(results[i].data, results[i].data_len,
+                              info, sizeof(info)) < 0) {
+            strcpy(info, "-error-");
+        }
+        pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos, "%s\n", info);
+    }
+
+    menu->length = devs;
+
+#if !defined(MENU_PREFER_VOLCANO) && !defined(MENU_PREFER_CRAFTY)
+    if ((menu->selection < 0) && (menu->length > 0)) {
+        menu->selection = 0;
+    }
+#endif // !defined(MENU_PREFER_VOLCANO) && !defined(MENU_PREFER_CRAFTY)
+
+    if (menu->length == 0) {
+        strncpy(menu->buff, "NONE", MENU_MAX_LEN);
+    }
+}
+
+void state_scan_run(void) {
+    menu_run(draw);
+}

src/state_volcano_run.c

@@ -0,0 +1,146 @@
+/*
+ * state_volcano_run.c
+ *
+ * Copyright (c) 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 <stdio.h>
+#include <string.h>
+
+#include "config.h"
+#include "buttons.h"
+#include "log.h"
+#include "volcano.h"
+#include "workflow.h"
+#include "state.h"
+#include "state_volcano_run.h"
+
+// only used to draw textbox, not for buttons
+#include "menu.h"
+
+static uint16_t wf_index = 0;
+static bd_addr_t ble_addr = {0};
+static bd_addr_type_t ble_type = 0;
+static bool wait_for_connect = false;
+static bool wait_for_disconnect = false;
+static bool aborted = false;
+
+void state_volcano_run_index(uint16_t index) {
+    wf_index = index;
+}
+
+void state_volcano_run_target(bd_addr_t addr, bd_addr_type_t type) {
+    memcpy(ble_addr, addr, sizeof(bd_addr_t));
+    ble_type = type;
+}
+
+static void volcano_buttons(enum buttons btn, bool state) {
+    if (state && (btn == BTN_Y)) {
+        if ((!wait_for_connect) && (!wait_for_disconnect)) {
+            debug("workflow abort");
+            aborted = true;
+            wf_reset();
+            volcano_set_pump_state(false);
+            volcano_set_heater_state(false);
+            ble_disconnect();
+            wait_for_disconnect = true;
+        }
+    }
+}
+
+void state_volcano_run_enter(void) {
+    menu_init(NULL, NULL);
+    buttons_callback(volcano_buttons);
+
+    debug("workflow connect");
+    ble_connect(ble_addr, ble_type);
+    wait_for_connect = true;
+
+    aborted = false;
+}
+
+void state_volcano_run_exit(void) {
+    menu_deinit();
+    wf_reset();
+}
+
+static void draw(struct menu_state *menu) {
+    struct wf_state state = wf_status();
+
+    int pos = 0;
+    pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos,
+                    "step %d / %d\n", state.index, state.count);
+
+    switch (state.step.op) {
+    case OP_SET_TEMPERATURE:
+        pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos,
+                        "\nset temp %.1f C", state.step.val / 10.0f);
+        break;
+
+    case OP_WAIT_TEMPERATURE:
+        pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos,
+                        "wait temp %.1f C\n", state.step.val / 10.0f);
+        pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos,
+                        "%.1f -> %.1f -> %.1f",
+                        state.start_val / 10.0f,
+                        state.curr_val / 10.0f,
+                        state.step.val / 10.0f);
+        break;
+
+    case OP_WAIT_TIME:
+    case OP_PUMP_TIME:
+        pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos,
+                        "%s time %.1f s\n",
+                        (state.step.op == OP_WAIT_TIME) ? "wait" : "pump",
+                        state.step.val / 1000.0f);
+        pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos,
+                        "%.1f -> %.1f -> %.1f",
+                        state.start_val / 1000.0f,
+                        state.curr_val / 1000.0f,
+                        state.step.val / 1000.0f);
+        break;
+    }
+
+    // TODO visualize
+}
+
+void state_volcano_run_run(void) {
+    // start workflow when connected
+    if (wait_for_connect && ble_is_connected()) {
+        wait_for_connect = false;
+        debug("workflow start");
+        wf_start(wf_index);
+    }
+
+    // visualize workflow status
+    menu_run(draw);
+
+    // auto disconnect when end of workflow is reached
+    if ((!wait_for_connect) && (!aborted)) {
+        struct wf_state state = wf_status();
+        if (state.status == WF_IDLE) {
+            debug("workflow disconnect");
+            ble_disconnect();
+            wait_for_disconnect = true;
+        }
+    }
+
+    // back to main menu when disconnected
+    if (wait_for_disconnect && !ble_is_connected()) {
+        wait_for_disconnect = false;
+        debug("workflow done");
+        state_switch(STATE_SCAN);
+    }
+}

src/state_volcano_workflow.c

@@ -0,0 +1,78 @@
+/*
+ * state_volcano_workflow.c
+ *
+ * Copyright (c) 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 <stdio.h>
+#include <string.h>
+
+#include "config.h"
+#include "menu.h"
+#include "workflow.h"
+#include "state.h"
+#include "state_volcano_run.h"
+#include "state_volcano_workflow.h"
+
+static void enter_cb(int selection) {
+    if ((selection >= 0) && (selection < wf_count())) {
+        state_volcano_run_index(selection);
+        state_switch(STATE_VOLCANO_RUN);
+    }
+}
+
+static void exit_cb(void) {
+    state_switch(STATE_SCAN);
+}
+
+void state_volcano_wf_enter(void) {
+    menu_init(enter_cb, exit_cb);
+}
+
+void state_volcano_wf_exit(void) {
+    menu_deinit();
+}
+
+static void draw(struct menu_state *menu) {
+    menu->length = wf_count();
+
+    int pos = 0;
+    for (uint16_t i = 0; i < menu->length; i++) {
+        if ((i < menu->off)
+            || ((i - menu->off) >= MENU_MAX_LINES)) {
+            continue;
+        }
+
+        if (i == menu->selection) {
+            pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos, "> ");
+        } else {
+            pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos, "  ");
+        }
+
+        pos += snprintf(menu->buff + pos, MENU_MAX_LEN - pos, "'%s' by %s\n", wf_name(i), wf_author(i));
+    }
+
+    if ((menu->selection < 0) && (menu->length > 0)) {
+        menu->selection = 0;
+    }
+
+    if (menu->length == 0) {
+        strncpy(menu->buff, "NONE", MENU_MAX_LEN);
+    }
+}
+
+void state_volcano_wf_run(void) {
+    menu_run(draw);
+}

src/text.c

@@ -0,0 +1,192 @@
+/*
+ * text.c
+ *
+ * Copyright (c) 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 "config.h"
+#include "log.h"
+#include "lcd.h"
+#include "text.h"
+
+typedef struct {
+    struct text_conf *options;
+    uint16_t anchor;
+} state_t;
+
+static uint32_t blend(uint32_t fg_c, uint32_t bg_c, uint8_t alpha) {
+    float bg[4] = { RGB_565_REV(bg_c), 1.0f };
+    float fg[4] = { RGB_565_REV(fg_c), alpha / 255.0f };
+    float r[4];
+    r[3] = 1.0f - (1.0f - fg[3]) * (1.0f - bg[3]);
+    if (r[3] < 1.0e-6f) {
+        r[0] = 0.0f;
+        r[1] = 0.0f;
+        r[2] = 0.0f;
+    } else {
+        r[0] = fg[0] * fg[3] / r[3] + bg[0] * bg[3] * (1.0f - fg[3]) / r[3];
+        r[1] = fg[1] * fg[3] / r[3] + bg[1] * bg[3] * (1.0f - fg[3]) / r[3];
+        r[2] = fg[2] * fg[3] / r[3] + bg[2] * bg[3] * (1.0f - fg[3]) / r[3];
+    }
+
+    return RGB_565((uint32_t)(r[0] * 255.0f),
+                   (uint32_t)(r[1] * 255.0f),
+                   (uint32_t)(r[2] * 255.0f));
+}
+
+static void pixel_callback(int16_t x, int16_t y, uint8_t count, uint8_t alpha,
+                           void *state) {
+    state_t *s = (state_t*)state;
+
+    if (y < 0 || y >= s->options->height) return;
+    if (x < 0 || x + count >= s->options->width) return;
+
+    while (count--) {
+        lcd_write_point(240 - y - 1, x,
+                        blend(s->options->fg, s->options->bg, alpha));
+        x++;
+    }
+}
+
+static uint8_t character_callback(int16_t x, int16_t y, mf_char character,
+                                  void *state) {
+    state_t *s = (state_t*)state;
+    uint8_t w = mf_render_character(s->options->font->font, x, y, character, pixel_callback, state);
+    return w;
+}
+
+static bool line_callback(const char *line, uint16_t count, void *state) {
+    state_t *s = (state_t*)state;
+
+    if (s->options->bg != TEXT_BG_NONE) {
+        int16_t width = mf_get_string_width(s->options->font->font, line, count, false) + 2 * s->options->margin;
+        int16_t line_height = s->options->font->font->line_height;
+
+        if (s->options->alignment == MF_ALIGN_LEFT) {
+            lcd_write_rect(240 - s->options->y - 1 - line_height,
+                           s->options->x,
+                           240 - s->options->y - 1,
+                           s->options->x + width,
+                           s->options->bg);
+        } else if (s->options->alignment == MF_ALIGN_CENTER) {
+            lcd_write_rect(240 - s->options->y - 1 - line_height,
+                           s->options->x + s->options->width / 2 - width / 2,
+                           240 - s->options->y - 1,
+                           s->options->x + s->options->width / 2 + width / 2,
+                           s->options->bg);
+        } else if (s->options->alignment == MF_ALIGN_RIGHT) {
+            lcd_write_rect(240 - s->options->y - 1 - line_height,
+                           s->options->x + s->options->width - width,
+                           240 - s->options->y - 1,
+                           s->options->x + s->options->width,
+                           s->options->bg);
+        }
+    }
+
+    if (s->options->justify) {
+        mf_render_justified(s->options->font->font, s->anchor + s->options->x, s->options->y,
+                            s->options->width - s->options->margin * 2,
+                            line, count, character_callback, state);
+    } else {
+        mf_render_aligned(s->options->font->font, s->anchor + s->options->x, s->options->y,
+                          s->options->alignment, line, count,
+                          character_callback, state);
+    }
+
+    s->options->y += s->options->font->font->line_height;
+    return true;
+}
+
+void text_prepare_font(struct text_font *tf) {
+    if (!tf) {
+        debug("invalid param");
+        return;
+    }
+
+    const struct mf_font_s *font = mf_find_font(tf->fontname);
+    if (!font) {
+        debug("No such font: %s", tf->fontname);
+        return;
+    }
+
+    tf->font = font;
+
+    // TODO
+    //struct mf_scaledfont_s scaledfont;
+    //if (tf->scale > 1) {
+    //    mf_scale_font(&scaledfont, font, tf->scale, tf->scale);
+    //    tf->font = scaledfont.font;
+    //}
+}
+
+void text_draw(struct text_conf *tc) {
+    if ((!tc) || (!tc->font) || (!tc->font->font)) {
+        debug("invalid param");
+        return;
+    }
+
+    state_t state;
+    state.options = tc;
+
+    if (tc->alignment == MF_ALIGN_LEFT) {
+        state.anchor = tc->margin;
+    } else if (tc->alignment == MF_ALIGN_CENTER) {
+        state.anchor = tc->width / 2;
+    } else if (tc->alignment == MF_ALIGN_RIGHT) {
+        state.anchor = tc->width - tc->margin;
+    }
+
+    mf_wordwrap(tc->font->font, tc->width - 2 * tc->margin,
+                tc->text, line_callback, &state);
+}
+
+void text_box(const char *s) {
+    static struct text_font font = {
+        .fontname = "fixed_10x20",
+        .font = NULL,
+    };
+    if (font.font == NULL) {
+        text_prepare_font(&font);
+    }
+
+    int x = 0;
+    int width = 240;
+
+    int y = 50;
+    int height = 120;
+
+    struct text_conf text = {
+        .text = "",
+        .x = x,
+        .y = y,
+        .justify = false,
+        .alignment = MF_ALIGN_CENTER,
+        .width = width,
+        .height = height,
+        .margin = 2,
+        .fg = RGB_565(0xFF, 0xFF, 0xFF),
+        .bg = RGB_565(0x00, 0x00, 0x00),
+        .font = &font,
+    };
+
+    lcd_write_rect(240 - y - 1 - height,
+                   x,
+                   240 - y - 1,
+                   x + width - 1,
+                   text.bg);
+
+    text.text = s;
+    text_draw(&text);
+}

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,115 @@
+/*
+ * 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 uint8_t *buf, size_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;
+}
+
+static 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] == ENTER_BOOTLOADER_MAGIC)) {
+            reset_to_bootloader();
+        } else if (reroute_cdc_debug) {
+            debug_handle_input((const uint8_t *)buf, count);
+        } else {
+            cnsl_handle_input((const uint8_t *)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 (0x2300 | _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,109 @@
+/*
+ * 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"
+
+#ifdef CYW43_WL_GPIO_LED_PIN
+#include "pico/cyw43_arch.h"
+#endif // CYW43_WL_GPIO_LED_PIN
+
+#include "config.h"
+#include "log.h"
+#include "util.h"
+
+#define HEARTBEAT_INTERVAL_MS 500
+
+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
+#ifdef CYW43_WL_GPIO_LED_PIN
+    cyw43_arch_gpio_put(CYW43_WL_GPIO_LED_PIN, 1);
+#endif // CYW43_WL_GPIO_LED_PIN
+}
+
+void heartbeat_run(void) {
+#if defined(PICO_DEFAULT_LED_PIN) || defined(CYW43_WL_GPIO_LED_PIN)
+    static uint32_t last_heartbeat = 0;
+    uint32_t now = to_ms_since_boot(get_absolute_time());
+    if (now >= (last_heartbeat + HEARTBEAT_INTERVAL_MS)) {
+        last_heartbeat = now;
+#ifdef PICO_DEFAULT_LED_PIN
+        gpio_xor_mask(1 << PICO_DEFAULT_LED_PIN);
+#endif // PICO_DEFAULT_LED_PIN
+#ifdef CYW43_WL_GPIO_LED_PIN
+        cyw43_arch_gpio_put(CYW43_WL_GPIO_LED_PIN, !cyw43_arch_gpio_get(CYW43_WL_GPIO_LED_PIN));
+#endif // CYW43_WL_GPIO_LED_PIN
+    }
+#endif // defined(PICO_DEFAULT_LED_PIN) || defined(CYW43_WL_GPIO_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(const 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();
+    }
+}
+
+float map(float value, float leftMin, float leftMax, float rightMin, float rightMax) {
+    float leftSpan = leftMax - leftMin;
+    float rightSpan = rightMax - rightMin;
+    float valueScaled = (value - leftMin) / leftSpan;
+    return rightMin + (valueScaled * rightSpan);
+}

src/volcano.c

@@ -0,0 +1,118 @@
+/*
+ * volcano.c
+ *
+ * Copyright (c) 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 "config.h"
+#include "log.h"
+#include "ble.h"
+#include "volcano.h"
+
+// Volcano UUIDs are always the same, except for the 4th byte
+#define UUID_WRITE_SRVC   0x00
+#define UUID_CURRENT_TEMP 0x01
+#define UUID_TARGET_TEMP  0x03
+#define UUID_HEATER_ON    0x0F
+#define UUID_HEATER_OFF   0x10
+#define UUID_PUMP_ON      0x13
+#define UUID_PUMP_OFF     0x14
+
+// "101100xx-5354-4f52-5a26-4249434b454c"
+static uint8_t uuid_base[16] = {
+    0x10, 0x11, 0x00, 0xFF, 0x53, 0x54, 0x4f, 0x52,
+    0x5a, 0x26, 0x42, 0x49, 0x43, 0x4b, 0x45, 0x4c,
+};
+static uint8_t uuid_base2[16] = {
+    0x10, 0x11, 0x00, 0xFF, 0x53, 0x54, 0x4f, 0x52,
+    0x5a, 0x26, 0x42, 0x49, 0x43, 0x4b, 0x45, 0x4c,
+};
+
+int16_t volcano_get_current_temp(void) {
+    uuid_base[3] = UUID_CURRENT_TEMP;
+
+    uint8_t buff[4];
+    int32_t r = ble_read(uuid_base, buff, sizeof(buff));
+    if (r != sizeof(buff)) {
+        debug("ble_read unexpected value %ld", r);
+        return -1;
+    }
+
+    uint32_t *v = (uint32_t *)buff;
+    return *v;
+}
+
+int16_t volcano_get_target_temp(void) {
+    uuid_base[3] = UUID_TARGET_TEMP;
+
+    uint8_t buff[4];
+    int32_t r = ble_read(uuid_base, buff, sizeof(buff));
+    if (r != sizeof(buff)) {
+        debug("ble_read unexpected value %ld", r);
+        return -1;
+    }
+
+    uint32_t *v = (uint32_t *)buff;
+    return *v;
+}
+
+int8_t volcano_set_target_temp(uint16_t value) {
+    uuid_base[3] = UUID_WRITE_SRVC;
+    uuid_base2[3] = UUID_TARGET_TEMP;
+
+    uint8_t buff[4];
+    uint32_t *v = (uint32_t *)buff;
+    *v = value;
+
+    int8_t r = ble_write(uuid_base, uuid_base2, buff, sizeof(buff));
+    if (r != 0) {
+        debug("ble_write unexpected value %d", r);
+    }
+    return r;
+}
+
+int8_t volcano_set_heater_state(bool value) {
+    uuid_base[3] = UUID_WRITE_SRVC;
+
+    if (value) {
+        uuid_base2[3] = UUID_HEATER_ON;
+    } else {
+        uuid_base2[3] = UUID_HEATER_OFF;
+    }
+
+    uint8_t d = 0;
+    int8_t r = ble_write(uuid_base, uuid_base2, &d, sizeof(d));
+    if (r != 0) {
+        debug("ble_write unexpected value %d", r);
+    }
+    return r;
+}
+
+int8_t volcano_set_pump_state(bool value) {
+    uuid_base[3] = UUID_WRITE_SRVC;
+
+    if (value) {
+        uuid_base2[3] = UUID_PUMP_ON;
+    } else {
+        uuid_base2[3] = UUID_PUMP_OFF;
+    }
+
+    uint8_t d = 0;
+    int8_t r = ble_write(uuid_base, uuid_base2, &d, sizeof(d));
+    if (r != 0) {
+        debug("ble_write unexpected value %d", r);
+    }
+    return r;
+}

src/workflow.c

@@ -0,0 +1,264 @@
+/*
+ * workflow.c
+ *
+ * Copyright (c) 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 "config.h"
+#include "log.h"
+#include "volcano.h"
+#include "workflow.h"
+
+#define WF_MAX_STEPS 42
+#define WF_MAX_FLOWS 6
+
+struct workflow {
+    const char *name;
+    const char *author;
+    struct wf_step steps[WF_MAX_STEPS];
+    uint16_t count;
+};
+
+#define NOTIFY \
+    { .op = OP_WAIT_TIME, .val = 1000 }, \
+    { .op = OP_PUMP_TIME, .val = 1000 }
+
+static const struct workflow wf[WF_MAX_FLOWS] = {
+    {
+        .name = "Default",
+        .author = "xythobuz",
+        .steps = {
+            { .op = OP_WAIT_TEMPERATURE, .val = 1850 },
+            { .op = OP_WAIT_TIME, .val = 10000 },
+            { .op = OP_PUMP_TIME, .val = 5000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 1950 },
+            { .op = OP_WAIT_TIME, .val = 5000 },
+            { .op = OP_PUMP_TIME, .val = 20000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 2050 },
+            { .op = OP_WAIT_TIME, .val = 5000 },
+            { .op = OP_PUMP_TIME, .val = 20000 },
+
+            NOTIFY, NOTIFY, NOTIFY, NOTIFY,
+
+            { .op = OP_SET_TEMPERATURE, .val = 1900 },
+        },
+        .count = 18,
+    }, {
+        .name = "Vorbi",
+        .author = "Rinor",
+        .steps = {
+            { .op = OP_WAIT_TEMPERATURE, .val = 1760 },
+            { .op = OP_WAIT_TIME, .val = 10000 },
+            { .op = OP_PUMP_TIME, .val = 6000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 1870 },
+            { .op = OP_WAIT_TIME, .val = 5000 },
+            { .op = OP_PUMP_TIME, .val = 10000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 2040 },
+            { .op = OP_WAIT_TIME, .val = 3000 },
+            { .op = OP_PUMP_TIME, .val = 10000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 2170 },
+            { .op = OP_WAIT_TIME, .val = 5000 },
+            { .op = OP_PUMP_TIME, .val = 10000 },
+        },
+        .count = 12,
+    }, {
+        .name = "Relaxo",
+        .author = "xythobuz",
+        .steps = {
+            { .op = OP_WAIT_TEMPERATURE, .val = 1750 },
+            { .op = OP_WAIT_TIME, .val = 10000 },
+            { .op = OP_PUMP_TIME, .val = 5000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 1850 },
+            { .op = OP_WAIT_TIME, .val = 5000 },
+            { .op = OP_PUMP_TIME, .val = 20000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 1950 },
+            { .op = OP_WAIT_TIME, .val = 5000 },
+            { .op = OP_PUMP_TIME, .val = 20000 },
+
+            NOTIFY, NOTIFY, NOTIFY, NOTIFY,
+
+            { .op = OP_SET_TEMPERATURE, .val = 1900 },
+        },
+        .count = 18,
+    }, {
+        .name = "Hotty",
+        .author = "xythobuz",
+        .steps = {
+            { .op = OP_WAIT_TEMPERATURE, .val = 1900 },
+            { .op = OP_WAIT_TIME, .val = 10000 },
+            { .op = OP_PUMP_TIME, .val = 5000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 2050 },
+            { .op = OP_WAIT_TIME, .val = 5000 },
+            { .op = OP_PUMP_TIME, .val = 20000 },
+
+            { .op = OP_WAIT_TEMPERATURE, .val = 2200 },
+            { .op = OP_WAIT_TIME, .val = 5000 },
+            { .op = OP_PUMP_TIME, .val = 20000 },
+
+            NOTIFY, NOTIFY, NOTIFY, NOTIFY,
+
+            { .op = OP_SET_TEMPERATURE, .val = 1900 },
+        },
+        .count = 18,
+    },
+};
+
+static const uint16_t count = 4;
+
+static enum wf_status status = WF_IDLE;
+static uint16_t wf_i = 0;
+static uint16_t step = 0;
+static uint32_t start_t = 0;
+static uint16_t start_val = 0;
+static uint16_t curr_val = 0;
+
+static void do_step(void) {
+    switch (wf[wf_i].steps[step].op) {
+    case OP_SET_TEMPERATURE:
+    case OP_WAIT_TEMPERATURE:
+        debug("workflow temp %.1f C", wf[wf_i].steps[step].val / 10.0);
+        start_val = volcano_get_current_temp();
+        volcano_set_target_temp(wf[wf_i].steps[step].val);
+        break;
+
+    case OP_PUMP_TIME:
+        volcano_set_pump_state(true);
+        start_t = to_ms_since_boot(get_absolute_time());
+        start_val = 0;
+        debug("workflow pump %.3f s", wf[wf_i].steps[step].val / 1000.0);
+        break;
+
+    case OP_WAIT_TIME:
+        start_t = to_ms_since_boot(get_absolute_time());
+        start_val = 0;
+        debug("workflow time %.3f s", wf[wf_i].steps[step].val / 1000.0);
+        break;
+    }
+
+    curr_val = start_val;
+}
+
+uint16_t wf_count(void) {
+    return count;
+}
+
+const char *wf_name(uint16_t index) {
+    if (index >= count) {
+        debug("invalid index %d", index);
+        return NULL;
+    }
+    return wf[index].name;
+}
+
+const char *wf_author(uint16_t index) {
+    if (index >= count) {
+        debug("invalid index %d", index);
+        return NULL;
+    }
+    return wf[index].author;
+}
+
+struct wf_state wf_status(void) {
+    struct wf_state s = {
+        .status = status,
+        .index = step,
+        .count = wf[wf_i].count,
+        .step = wf[wf_i].steps[step],
+        .start_val = start_val,
+        .curr_val = curr_val,
+    };
+    return s;
+}
+
+void wf_start(uint16_t index) {
+    if (status != WF_IDLE) {
+        debug("workflow already running");
+        return;
+    }
+    if (index >= count) {
+        debug("invalid index %d", index);
+        return;
+    }
+
+    status = WF_RUNNING;
+    wf_i = index;
+    step = 0;
+
+    // discover characteristics
+    volcano_set_pump_state(false);
+    volcano_set_heater_state(false);
+    volcano_set_target_temp(1850);
+
+    volcano_set_heater_state(true);
+
+    do_step();
+}
+
+void wf_reset(void) {
+    status = WF_IDLE;
+}
+
+void wf_run(void) {
+    if (status == WF_IDLE) {
+        return;
+    }
+
+    bool done = false;
+
+    switch (wf[wf_i].steps[step].op) {
+    case OP_SET_TEMPERATURE:
+        done = true;
+        break;
+
+    case OP_WAIT_TEMPERATURE: {
+        uint16_t temp = volcano_get_current_temp();
+        curr_val = temp;
+        done = (temp >= (wf[wf_i].steps[step].val - 5));
+        break;
+    }
+
+    case OP_PUMP_TIME:
+    case OP_WAIT_TIME: {
+        uint32_t now = to_ms_since_boot(get_absolute_time());
+        uint32_t diff = now - start_t;
+        curr_val = diff;
+        done = (diff >= wf[wf_i].steps[step].val);
+        break;
+    }
+    }
+
+    if (done) {
+        if (wf[wf_i].steps[step].op == OP_PUMP_TIME) {
+            volcano_set_pump_state(false);
+        }
+
+        step++;
+        if (step >= wf[wf_i].count) {
+            status = WF_IDLE;
+            volcano_set_heater_state(false);
+            debug("workflow finished");
+        } else {
+            do_step();
+        }
+    }
+}

st7789

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

web-app/fetch.sh

@@ -1,5 +1,21 @@
 #!/bin/bash
 
+# ----------------------------------------------------------------------------
+# Copyright (c) 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/>.
+# ----------------------------------------------------------------------------
+
 # https://github.com/beautify-web/js-beautify
 
 ROOT="https://app.storz-bickel.com"