Skip to content

TinyDesk Shell 0.1.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 28 Sep 09:26
· 5 commits to main since this release
v0.1.1
fc8190d

TinyDesk Shell developer preview

A Unix-like shell for microcontrollers, with users, networking and SSH, that
also runs on a PC. It is the shell inside
TinyDesk and works on its own too.

This release is a developer preview: expect rough edges, and please report
what breaks.

New in 0.1.1

  • Windows program: tinydesk-shell-windows-x64.zip has tdsh.exe, the
    shell as a native Windows console program for Windows Terminal (line
    editing, history, Tab completion, ifconfig, ping). Its files live in
    %LOCALAPPDATA%\tdsh\rootfs, apart from yours.
  • The release text shows the real version numbers.

Install

  • ESP boards, from the browser: https://schikani.github.io/tinydesk-docs/install/#shell/esp32c6
    (Chrome or Edge on a computer). Choose TinyDesk Shell and your board.

  • Without the browser: flash a *-factory.bin below at offset 0:

    esptool.py --chip esp32c6 write_flash 0x0 tinydesk-shell-0.1.1-esp32c6-factory.bin
esptool.py --chip esp32 write_flash 0x0 tinydesk-shell-0.1.1-esp32-factory.bin

  • Linux (x86_64, built on Ubuntu 22.04): tinydesk-shell-linux-x86_64.tar.gz,
    then ./tdsh. Its files live in ~/.local/share/tdsh/rootfs.

  • Windows (x64, Windows 10 or later): tinydesk-shell-windows-x64.zip, then
    tdsh.exe in Windows Terminal. Its files live in %LOCALAPPDATA%\tdsh\rootfs.

File Board
tinydesk-shell-0.1.1-esp32c6-factory.bin ESP32-C6 with 8 MB flash, built-in USB
tinydesk-shell-0.1.1-esp32-factory.bin any ESP32 with 4 MB flash or more; PSRAM is used when present

Check the files against SHA256SUMS.txt. The firmware is not signed. A
factory image erases users, Wi-Fi networks and the SSH host key.

Before connecting

Open the board's serial port in a UTF-8 terminal (115200 baud on the
ESP32, any speed on the ESP32-C6's USB port), or the web terminal at
https://schikani.github.io/tinydesk-docs/console/. You start as root:
run passwd locally (initial password: TinyDesk) before enabling remote
access. help lists the commands; .tdsh scripts are described in
docs/SCRIPTING.md.

Changes: see CHANGELOG.md.

Assets 10
Loading