VersaTerm

A versatile serial terminal

Uploading the VersaTerm firmware to the Raspberry Pi Pico

Uploading firmware to the Raspberry Pi Pico is easy:

• Press and hold the button on the Raspberry Pi Pico (there is only one)
• While holding the button, connect the Raspberry Pi Pico via its micro-USB port to your computer
• Release the button
• Your computer should recognize the Pico as a storage device (like a USB stick) and mount it as a drive
• Copy the VersaTerm.uf2 file to the drive mounted in the previous step

Building the VersaTerm firmware from source

Requirements

• CMake 3.12 or later
• GCC (cross-)compiler: arm-none-eabi-gcc

Getting and building the source

git clone https://github.com/dhansel/VersaTerm.git
cd VersaTerm/software/lib
git submodule update --init
cd pico-sdk/lib
git submodule update --init
cd ../../..
mkdir build
cd build
cmake .. -DPICO_SDK_PATH=../lib/pico-sdk -DPICO_COPY_TO_RAM=1
make

This should create file VersaTerm/software/build/src/VersaTerm.uf2
Follow the "Uploading firmware to Raspberry Pi Pico" instructions above to upload the .uf2 file to the Pico.

TinyUSB updates

The version of TinyUSB currently (May 2022) included with the Pico SDK appears to have problems with USB hubs. These issues seem to be resolved in the latest updates though. To update TinyUSB to the latest version, do the following:

cd VersaTerm/lib/pico-sdk/lib/tinyusb
git fetch
git merge origin/master

Then just "cd" back to VersaTerm/software/build and type "make" to re-build.