Summary table of all available plugins. Documentation on TBD usage can be found here (Google Docs) Tutorial videos in YouTube playlist
Easiest way to update is to use the ready made releases from github. Flash the ctag-tbd.bin and storage.bin from the TBD web ui (within the configuration menu). Alternatively you can connect a USB cable to the TBD and use the serial flasher from esp idf (see how to flash below). In order to use the sample rom, you can upload from the edit sample rom page factory sample data (sample-rom.tbd).
NEW!!! You can build custom firmwares with plugin subsets and to increase sample-rom using the cloud compiler. No need for a toolchain on your own system.
For developing your own plugins / make TBD yours, you need C/C++ skills. You may want to check the TBD simulator for easy plugin development without TBD hardware.
You can build the firmware using a Github action. Just fork the ctag-tbd repo to your Github account and enable the supplied Github action. Enter the Github actions menu and select e.g. the "draft-release" action. Click the "Run workflow" button. Upon successful completion, your binaries will be available as .zip archive as output of your run.
If you prefer to have a dev environment on your own, install espressif esp-idf, instructions are here. Then clone the ctag-tbd repo with all dependencies and build firmware with cmake. Firmware release v1.0.0 was build with ESP-IDF 5.1.1 release.
Devcontainers allow users to develop in an isolated container, with all the dependencies installed and with the features of an IDE. Currently there are two methods supported.
Currently both devcontainers are using release/v4.4 version of esp-idf
Gitpod offers free online workspaces, just by pressing this button, you'll have access to a development environment for ctag-tbd in a browser tab:
Visual Studio Code also offers developing inside a Container, but for this approach, the user will need to install:
Open the repository folder with Visual Studio Code and open the container, there are several ways to open the container:
Reopen in Container
Remote-Containers: Reopen in Container
Reopen in Container
By default, the image will be pulled from esp-idf-env, but users can also build
it from the Dockerfile by editing the .devcontainer.json
The tbd cloud compiler allows you to reduce the size of the ctag-tbd firmware, therefore making up more free space for your samples, by removing one or multiple plug-ins that you don't want to use with your module via a web ui. It makes use of GitHub actions running in your own forked repository and therefore doesn't depend on any toolchain installed on your own system. For more information take a look at the user guide.
Either use the binaries available from the releases at github to flash through the TBD's web ui.
Or use ESP Tool to flash through a USB connection with your PC (check this script).
If you have ESP IDF installed (the whole development environment), use:
idf.py flash monitor