Skip to main content

WeTTY Browser Terminal

The firmware image integrates WeTTY as an optional browser terminal for board-side maintenance.

Buildroot Integration

The active Pico Zero Buildroot defconfig enables:

The SDK-provided Buildroot tree is 2023.02.6 and builds Node.js 16.20.0. WeTTY 2.5.0 is pinned because later WeTTY releases require Node.js >=18, and [email protected] is pinned to avoid Node.js 20-only transitive releases. Optional npm dependencies are omitted so prebuilt non-ARM native addons are not copied into the target rootfs.

Run the Linux/image build from an x86 host:

./build_image.sh

The sysdrv stage builds Node.js and installs the pinned WeTTY npm module into the target rootfs.

Startup

WeTTY is managed by:

/etc/init.d/S57wetty start
/etc/init.d/S57wetty status
/etc/init.d/S57wetty restart

The service reads /etc/aiden_boot.conf. Set ENABLE_WETTY=0 to disable startup.

Default runtime values:

ParameterDefault
Host192.168.42.1
Port3000
Base path/wetty/
Command/bin/login
Log/var/log/wetty/wetty.log

Access

The config web page at http://192.168.42.1 includes a Terminal link. It opens:

http://192.168.42.1:3000/wetty/

The init script uses /bin/login, so authenticate with the board's Linux account credentials.