Skip to content

N810 first-boot inputs

The SD image supplies Debian, the maintained kernel and modules, and touchscreen setup tools. Its first boot creates SSH host keys and a machine identity. The owner supplies an SSH public key and chooses the local account password while building the image.

Touchscreen

The TSC2005 driver reports raw stylus coordinates. A userspace transform maps those coordinates onto the 800 by 480 display. Maemo's /etc/pointercal uses tslib's linear-transform format. Pocket stores its transform as JSON with the detected input-device identity, axis ranges and display geometry.

n810-setup-touch converts a seven-integer tslib transform into Pocket's format. It checks /etc/pointercal, /mnt/maemo/etc/pointercal and /media/maemo/etc/pointercal. The owner checks an imported mapping using the stylus preview before accepting it. An unavailable or rejected mapping leads to fresh five-target calibration. The historical collector records four corners and a center target; the fitter checks the center independently and rejects excessive error.

The shipped kernel has CONFIG_JFFS2_FS disabled. Maemo's internal root filesystem therefore requires a separate recovery/export procedure before its files can be made available here. The first-boot service uses available files and the stylus calibration fallback. It leaves internal flash alone.

The resulting profile is /etc/n810/touch-calibration.json. The image creates a link at ~/.local/state/current-world/touch-calibration.json for the selected account, matching the existing Pocket session path. The first-boot service runs on tty1 before the login prompt. A skipped or failed calibration can be repeated with sudo n810-setup-touch; --recalibrate collects new targets. To use a previously exported file from your own tablet, run sudo n810-setup-touch --pointercal /path/to/pointercal.

Wireless and other device inputs

Component Current input path and setup boundary
Wi-Fi The builder acquires and validates 3826.arm. The kernel supplies a compiled default EEPROM image and supports an optional override. The Maemo WLAN CAL emulation harness is a research tool with recorded limitations.
Bluetooth The Nokia driver requests nokia/bc4fw.bin. The existing n810-bluetooth-address helper can preserve a supplied address or generate a stable locally administered address. The builder installs the firmware, address helper and BlueZ ordering.
Touch The first-boot service reuses an available tslib transform after visual confirmation or collects a fresh mapping.
Battery and power CAL inspection includes the BME PMM block used during power research. Automatic import of that block into a Debian power-management service remains unimplemented.
SSH and account identity The builder installs the owner's public key. First boot generates host keys and machine identity.

The firmware reference records acquisition sources and license findings. Pocket supervisor installation and device acceptance remain work items in the status page.

Verification

On 7 November 2026, the initial Docker Make target built the real Linux 5.15.224 kernel with 199 modules and 35 symbol checks. A clean build with caching disabled produced a 2 GiB ext4 partition in a 2,148,532,224-byte SD image. The kit hashes, partition contents, filesystem, and first-boot identity settings passed checks.

Touch setup conversion tests cover normal, swapped and inverted axes, invalid coefficients, and the current Pocket profile schema. The ARM collector is cross-compiled with warnings treated as errors. Stylus collection and first-boot service behavior require attended tablet verification.