From f1159d6f489c5c9f7fbfe46569ed7e5bdfe0a70e Mon Sep 17 00:00:00 2001 From: "Rich O." Date: Sun, 1 Nov 2026 10:32:20 -0500 Subject: [PATCH] palm-client: install via the Debian 13 Mac mini instead of a Pi Rename pi-install.sh to cradle-install.sh, default SYNC_HOST to the Mac mini, and look for pilot-link in ~/.local (it's no longer packaged in Debian 13). make install now depends on all, so it works when the build runs in Docker. --- docs/progress.md | 2 +- palm-client/Makefile | 14 ++++++------- palm-client/README.md | 21 ++++++++++++------- .../{pi-install.sh => cradle-install.sh} | 7 +++++-- 4 files changed, 27 insertions(+), 17 deletions(-) rename palm-client/tools/{pi-install.sh => cradle-install.sh} (76%) diff --git a/docs/progress.md b/docs/progress.md index fc88c38..db28b55 100644 --- a/docs/progress.md +++ b/docs/progress.md @@ -22,7 +22,7 @@ ### Palm client - [x] Toolchain set up: prc-tools-remix 2.3.6 + PilRC + Palm OS 3.5 SDK in Docker (`palm-client/Dockerfile`) - [x] Scaffold: builds `visormesh.prc` (main form + "Query radio" → CMD_DEVICE_QUERY); protocol framing with host tests -- [ ] Pi install path: visor driver + pilot-link on the Pi, `make install` tested +- [ ] Sync host (Mac mini, Debian 13): visor driver present ✓, build pilot-link into ~/.local, `make install` tested - [ ] Emulator: CloudpilotEmu with a Palm OS 3.5 ROM (the Visor isn't emulated); optionally POSE + a Visor Neo ROM in a Windows VM - [ ] Original Handspring SDK headers (Springboard `HsCard*` APIs; the PalmOne `HsExt.h` lacks them), needed for module-ROM work only - [ ] Port springSD bus routines; SC16IS740 driver diff --git a/palm-client/Makefile b/palm-client/Makefile index 74c5626..691f687 100644 --- a/palm-client/Makefile +++ b/palm-client/Makefile @@ -2,7 +2,7 @@ # # make build build/visormesh.prc (in Docker if the toolchain isn't installed) # make test run the host-side protocol tests -# make install copy the .prc to the Pi and install it over the USB cradle +# make install copy the .prc to the sync host and install it over the USB cradle # make clean APP = visormesh @@ -16,9 +16,9 @@ CC = m68k-palmos-gcc CFLAGS = -palmos3.5 -O2 -Wall -Isrc PILRC = pilrc -# Pi with the Visor cradle attached (see tools/pi-install.sh). -PI ?= visormesh-pi -PI_PORT ?= /dev/ttyUSB1 +# Linux host with the Visor USB cradle attached (see tools/cradle-install.sh). +SYNC_HOST ?= roberholtzer@10.3.0.150 +SYNC_PORT ?= /dev/ttyUSB1 DOCKER_IMAGE = visormesh-palm DOCKER_RUN = docker run --rm --platform linux/amd64 -v "$(CURDIR)":/src -w /src $(DOCKER_IMAGE) @@ -58,9 +58,9 @@ build: endif -install: build/$(APP).prc - scp -q build/$(APP).prc $(PI):/tmp/$(APP).prc - ssh -t $(PI) "bash -s -- /tmp/$(APP).prc $(PI_PORT)" < tools/pi-install.sh +install: all + scp -q build/$(APP).prc $(SYNC_HOST):/tmp/$(APP).prc + ssh $(SYNC_HOST) "bash -s -- /tmp/$(APP).prc $(SYNC_PORT)" < tools/cradle-install.sh clean: rm -rf build diff --git a/palm-client/README.md b/palm-client/README.md index 2beafd5..ded3f6f 100644 --- a/palm-client/README.md +++ b/palm-client/README.md @@ -32,19 +32,26 @@ Creator ID is `VMsh`. The database has the backup bit set, so HotSync keeps a co ## Install on the Visor -The Visor's USB cradle is plugged into a Raspberry Pi. `make install` copies the `.prc` to the Pi and runs `tools/pi-install.sh` there, which waits for you to press the HotSync button and then runs `pilot-xfer -i`. +The Visor's USB cradle is plugged into a Linux sync host: the Mac mini running Debian 13 at `roberholtzer@10.3.0.150`. `make install` builds the `.prc`, copies it there, and runs `tools/cradle-install.sh`. That script waits for you to press the HotSync button and then runs `pilot-xfer -i`. ```sh -make install PI=user@pi-hostname # default PI is visormesh-pi -make install PI=... PI_PORT=usb: # if pilot-link uses libusb +make install # default SYNC_HOST is the Mac mini +make install SYNC_HOST=user@host SYNC_PORT=usb: # another host, or pilot-link via libusb ``` -The Pi needs: -- the kernel `visor` USB-serial driver (`modprobe visor`; the Visor appears as `/dev/ttyUSB1` during HotSync) -- `pilot-link` (`pilot-xfer`) +The sync host needs: +- the kernel `visor` USB-serial driver. Debian 13 ships it as a module that loads when the Visor connects, and the Visor appears as `/dev/ttyUSB1` during HotSync. +- membership in the `dialout` group to open the tty +- `pilot-xfer`, from pilot-link. Debian 13 no longer packages it, so build https://github.com/desrod/pilot-link (maintained by pilot-link's original author) into `~/.local`: + + ```sh + git clone https://github.com/desrod/pilot-link.git ~/src/pilot-link + cd ~/src/pilot-link + ./autogen.sh --prefix=$HOME/.local && make -j"$(nproc)" && make install + ``` - SSH key login from your dev machine -**The Pi setup isn't done or tested yet.** +**Not tested end to end yet.** ## Testing without hardware diff --git a/palm-client/tools/pi-install.sh b/palm-client/tools/cradle-install.sh similarity index 76% rename from palm-client/tools/pi-install.sh rename to palm-client/tools/cradle-install.sh index e795f62..a020273 100755 --- a/palm-client/tools/pi-install.sh +++ b/palm-client/tools/cradle-install.sh @@ -1,12 +1,15 @@ #!/bin/bash -# Runs on the Pi (piped over ssh by `make install`): installs a .prc onto the +# Runs on the sync host (piped over ssh by `make install`): installs a .prc onto the # Visor through its USB cradle using pilot-link. # -# Usage: pi-install.sh FILE.prc [PORT] +# Usage: cradle-install.sh FILE.prc [PORT] # PORT defaults to /dev/ttyUSB1 (the kernel visor driver's HotSync port). # Use "usb:" instead if pilot-link was built with libusb. set -euo pipefail +# pilot-link is built from source into ~/.local (not packaged in Debian 13). +export PATH="$HOME/.local/bin:$PATH" + prc="$1" port="${2:-/dev/ttyUSB1}"