Skip to content

Nokia console installation

The portable source release runs through make n810 on the Nokia as well as on a desktop when Make is installed. Without Make, run python3 shell/launch.py --instance default, the same entrypoint. Python 3.11 or newer is required for the portable shell. Optional native composition improves performance on the Nokia.

For an N810 already using the guarded Pocket console supervisor, build an installable version with:

python3 tools/package_nokia.py --files --platform-release /path/to/5e63c3f/nokia.tar.gz --native-reticulum /path/to/tested-arm-build

The platform archive is an explicit build input, not a neighboring source checkout. The packager verifies its original manifest and engine identity, reuses the original platform libraries when compositor sources are unchanged. For a rebuilt compositor, supply --native-compositor /path/to/arm-build; the packager verifies its source hashes, binary hash and ARM soft-float ABI. All Python application code comes from the committed active tree. The runtime payload excludes tests, benchmarks, packet-test fixtures and compile-only Doom and native Reticulum sources. Licenses, runtime feature assets and source inputs required for native-library verification remain. The default --profile release also removes development-only diagnostic blocks before packaging and omits the draw-metrics, pointer-trace and Flurry trial modules. Render Debug and their command-line switches are absent from that artifact. --profile dev retains those tools for deliberate device debugging; it still excludes tests and build-only dependencies. The selected profile is recorded in build-info.json.

This export is independent of Python -O and -OO. Those options do not remove arbitrary unused code; they remove assertions, and -OO also removes docstrings. The release exporter preserves ordinary assertions and error handling.

CONTENTS.json lists the included/excluded file accounting. Full development sources remain in the repository and source archive, outside the app payload. Build that target with python3 tools/build_native.py --arm-headers /path/to/extracted/usr/include --output /path/to/arm-build in a Linux environment with the ARM soft-float cross compiler and Debian ARM Python 3.11 development headers. Add --arm-vfp for the N810 ARM1136 VFP unit, retaining the soft-float calling convention. Verify vfp in the target CPU features and run the native scene output tests before installing that build. The build records compiler flags, CPU requirements and header hashes.

Nokia releases require the native microReticulum/microLXMF library. The packager refuses a missing library or mismatched ARM provenance. See the native build instructions for the cross-compile procedure. Python RNS/LXMF is not a Nokia runtime dependency and is not a fallback: unsupported connections report an error. Nokia packages omit the desktop Python stack loader. Shared owner code remains because the native backend uses its service and messaging policies too. The shared source retains the desktop Python backend and interoperability tests. A desktop launch with make n810 is still a desktop process; the Make target name does not select the Nokia release policy.

For development, --files produces a files/ tree, installer scripts and an INSTALL.json receipt under dist/pocket-COMMIT-files. Sync them directly:

python3 tools/sync_nokia.py dist/pocket-COMMIT-files --ssh-key /path/to/n810-key

The sync uses compressed rsync with content comparisons and the installed app as a local copy basis. Only changed file data crosses SSH; unchanged native libraries and bundled resources are copied locally into staging. The running app tree is not modified during transfer. No app archive is transferred or unpacked. The command prints the staging directory. Stop Pocket and its app-tree owners, run that directory's install.py as root, then restart the same owners and Pocket. Keep normal reference-data sync separate from app changes.

Omit --files when an archive is specifically needed for distribution. That output includes nokia.tar.gz and uses the same installer and verification. The platform session-entry update is reused when already current. The installer uses the installed supervisor's existing locks, validation and rollback catalog. It preserves the previous release, calibration, keyboard setup, owner configuration, identities, messages and receiver services. It refuses mismatched supervisor contracts or an occupied console. After registration, it verifies each installed source hash and prepares timestamp-validated Python caches. Imports check source modification time and size without rereading every source file. Release sources and caches are root-owned; install a new release instead of editing them in place. The cache receipt records each source and generated cache hash. Unchanged verified Python bytecode is reused even when staging gives its source a different modification time.

Start normally with sudo -n /usr/local/sbin/n810-pocket-console run. Connections opens first and configured local services attach in the background. Remote device connections remain explicit. Attaching to a Reticulum management owner does not activate its radio; Radio Connect remains a separate action in Reticulum. An already running owner's state is displayed without reconfiguring it.

This adapter requires the existing supervisor and fixed map-pack installation; it is not a general installer for an unconfigured Nokia. A new computer can run the portable shell without those components. Roll back with the existing n810-pocket-version selector after closing the desktop.

Product versions and the current package policy are documented in versioning. Offline reference snapshots are installed separately at /usr/share/pocket/data; POCKET_DATA_ROOT can explicitly select another dataset. User state is separate.