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.
This commit is contained in:
rich committed 2026-11-01 10:32:20 -05:00
1 parent cc989cf357
commit f1159d6f48
4 files changed
+27 -17

No files matched your search

+1 -1
View File
@@ -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
+7 -7
View File
@@ -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
+14 -7
View File
@@ -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
@@ -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}"