Skip to content

TinyDesk Shell 0.1.5

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Oct 08:42
· 6 commits to main since this release
v0.1.5
8456dd1

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

  • Only root changes the network policy: network mode and
    network autowifi with a value need root; any user still sees them.
    Before, any user could switch Wi-Fi or the LAN off for the whole board,
    or make it connect at boot.
  • Board configuration numbers are decimal or 0x hexadecimal, as
    documented: a leading zero no longer means octal (08 was rejected,
    010 read as 8).
  • New home: the code is at github.com/tinydesk-project and the
    documentation at https://tinydesk-project.github.io/.
    STANDARDS.md sets out names, code style, commands, board keys and
    release rules, also for community ports.

Also since 0.1.0: long command lines wrap and stay editable, and
board save keeps built-in pins (0.1.4); nano follows the terminal's
size (0.1.3); 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://tinydesk-project.github.io/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.5-esp32c6-factory.bin
esptool.py --chip esp32 write_flash 0x0 tinydesk-shell-0.1.5-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.5-esp32c6-factory.bin ESP32-C6 with 8 MB flash, built-in USB
tinydesk-shell-0.1.5-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://tinydesk-project.github.io/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