Skip to content

TinyDesk Shell 0.1.3

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Oct 15:53
v0.1.3
232a39f

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.3

  • nano fits the terminal: it asks the terminal for its size, so its
    status line (Ctrl+C shows the cursor position there) and help lines are
    no longer cut off in a terminal smaller than 80x24. On the boards and in
    the Linux program.
  • The factory password is named: while root still has it, passwd
    says the old password is TinyDesk (capital T and D), and ssh start
    and ftp start say so when they refuse to start.

Also since 0.1.0: the SD card at /sd (sd mount, 0.1.2), ping -c, and
tdsh.exe, a native Windows program (tinydesk-shell-windows-x64.zip).

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.3-esp32c6-factory.bin
esptool.py --chip esp32 write_flash 0x0 tinydesk-shell-0.1.3-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.3-esp32c6-factory.bin ESP32-C6 with 8 MB flash, built-in USB
tinydesk-shell-0.1.3-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