36 Commits
Author SHA1 Message Date
rich fec5a03358 palm-client: release workflow: a v* tag builds and tests the app and publishes visormesh-<tag>.prc with SHA256SUMS as a release; the toolchain install moves to tools/install_toolchain.sh so CI and the Dockerfile share the pinned versions
release / palm-client (push) Successful in 3m14s
2026-11-11 16:49:05 -05:00
rich 2c32033292 palm-client: check_ui.py fails the build when two drawn form objects overlap (a label running into its value or a button); it reads each object's usable bit so popup lists shown by the code don't count 2026-11-08 19:35:47 -05:00
rich 6c17e25a76 palm-client: the request retry rules are in request.c (session.c supplies the link), host-tested with a scripted link in tests/test_request.c: a frame that went out is sent again only while tries allows, one that didn't go is resent up to 4 times without using up tries, one cut off part way never is. check_source.py checks that the functions that send over the air or take a queued message (messages, reactions, adverts, syncs, logins, traces) only ever use tries 1 2026-11-08 19:34:16 -05:00
rich 359908e927 palm-client: make replay runs the bridge's frame capture through the app's parsers and fails on any frame of a code the app parses that doesn't parse, to catch a firmware layout change before it reaches the Visor. The bridge captures every frame in full with --capture (bridge.sh writes $TMPDIR/visor_frames.txt); captures hold real messages and stay local 2026-11-08 19:32:00 -05:00
rich f53f851b0e palm-client: with the Slot link, the radio's 'message waiting' push wakes the Visor. The slot interrupt handler (SbIrq) spots the frame as it drains the FIFO and, as the Springboard guide describes, holds IRQ* (THR empty) to have the system woken, then keeps it awake 10 s for the app to sync. With Check when closed on, the app leaves a copy of the handler in system-owned memory as it closes (SbWakeArm), with the module asleep between frames; it posts a card event whose handler sets the app's alarm for now, so the closed-app check runs at once. check_sections.py checks that the copied block (SbCoreStart..SbCoreEnd) is whole and refers only to itself. The Slot link no longer reconnects after sleep. Host-tested on the simulated module; untested on hardware 2026-11-08 19:17:30 -05:00
rich 6056339ad8 palm-client: the contact screen's login status is 'Logging in over the mesh...' (it ran off the edge) and its status line is cut rather than running off; Serial Ports' lines too. check_ui.py now measures literals passed to a screen's own one-line helpers, and fails on a new helper that draws its text until its width is listed 2026-11-08 19:00:40 -05:00
rich a79349eb76 palm-client: tools/check_source.py runs on every build and fails it on a static const inside a function in an extra code segment (garbage on the Visor), a menu item no code handles, a shortcut letter used twice on a menu bar or taken from the Edit menu, a form with no event handler, and an ID used twice in one form, menu bar or resource type 2026-11-08 18:53:49 -05:00
rich ff00ac1577 palm-client: tools/check_ui.py runs on every build and fails it when a form object or label goes past its form, an alert's buttons don't fit across it (Palm OS's layout, calibrated on the Stale Contacts alert), or a literal drawn with DrawCut would be cut. It flags the old Contact button row and Stale alert 2026-11-08 18:40:31 -05:00
rich 597c5ac080 palm-client: Map Picker (tools/map_picker.py): pick any area for the Map on a world map in the browser, see each zoom's tiles and the file's estimated size, and build VisorMeshMap.pdb. OpenStreetMap data is fetched per 0.25-degree cell (retrying a busy Overpass server) and cached. Runs on macOS, Windows and Linux with only Python 3; make_map.py is split into reusable steps (its output is unchanged) 2026-11-06 12:26:41 -05:00
rich ce700f1a17 palm-client: the Map's street-level zoom covers about 40 x 31 km (the Main Line to Cherry Hill, Chester to Cheltenham; the map is now 2.0 MB), and outside it the zoom below is shown enlarged instead of blank tiles (Ardmore was blank) 2026-11-06 12:02:26 -05:00
rich 50a5a486db palm-client: a fifth code segment, and Node, Settings, Font Preview and Add Channel move from vmcode2 (31.1 KB) to vmcode4, leaving vmcode2 room for the hooks the next features need. protocol2.c (vmcode5, host-tested) has the newer companion commands: trace path, stats, battery, a contact's route, plus meshcore:// share links and #hashtags in text 2026-11-05 14:43:50 -05:00
rich b9dc923e0f palm-client: screenshots (Options > Screenshot, Screenshot in 5 s; make shots)
The screen bits go into a VisorMeshShots record (shots.c, segment 1, no
globals: the delayed one runs from a procedure alarm inside whatever loop is
running, so menus and popups can be captured). make shots fetches the
database over HotSync and tools/shots.py writes PNGs to build/shots/.
2026-11-03 11:48:13 -05:00
rich aa09b1800d palm-client: tap and hold a channel on Home for Mute/Unmute, Channel Scope, Leave
RowList gets an optional hold callback: the pen still (3 px) on a row for half
a second unhighlights it, and lifting calls the callback (DMs fall back to a
tap). The channel actions take a slot, with the menu versions wrapping them.
2026-11-03 11:11:30 -05:00
rich be2d287ab2 palm-client: background check opens the channel and contact lists
Without them every channel lookup failed: the alert showed 'Channel N', channel
messages sounded as private and muted channels weren't skipped.
2026-11-03 10:55:55 -05:00
rich e3a3aa376e palm-client: new-message alert lists the count per conversation; icon from meshcore-visor-hair-1.png
Checks add the messages they pulled (outside muted channels) to a pending
table in unsaved prefs, with names looked up while they have globals; the
display launch lists up to five conversations and 'N more elsewhere'.
make_icon.sh takes a PNG and thresholds the 1-bit icons instead of dithering.
2026-11-03 10:48:53 -05:00
rich 966b0bdc1b palm-client: app icon from meshcore-visor-hair.svg (tools/make_icon.sh); background check status on Preferences
The alarm now stays set while the app is open (checks skip) and is set as
soon as the interval changes; each check records what it got to, shown as
'Last 8:11 no radio, next 8:16'.
2026-11-03 08:37:52 -05:00
rich 2eda7e1212 palm-client: fourth code segment (map, flood scopes); title status no longer leaves text behind 2026-11-02 13:12:30 -05:00
rich 6dd623f778 palm-client: glyphs for 12 common emoji, tap an emoji to see it enlarged 2026-11-02 13:07:01 -05:00
rich deec3112d4 palm-client: Map screen with an OSM basemap (tools/make_map.py) and positioned nodes 2026-11-02 12:33:52 -05:00
rich 1c3c9c3b25 fonts README: where 5x8.bdf comes from 2026-11-02 10:58:33 -05:00
rich b57c51feb7 palm-client: mute channels and a larger text option (5x8 font) on a Preferences screen 2026-11-02 10:58:16 -05:00
rich 80a0c90954 palm-client: bridge.sh to start, stop and check the Visor USB bridge 2026-11-02 09:55:11 -05:00
rich 55b77c84a7 palm-client: third code section (vmcode3); checker resolves COFF symbol sections
visormesh.def adds vmcode3 and sections.h VM_SECT3, ahead of new screens
(segment 2 is at 27 KB). check_sections.py checks every extra section, and
now maps COFF symbols' (sec N) to section names: before, it only resolved
section symbols such as .text, not named ones. sect2.py takes --sect3.
2026-11-01 21:49:29 -05:00
rich c713d8ba34 palm-client: modules into segment 2 with a build check; better Unicode display
Segment 1 was back at 27 KB. Settings, Contacts, Channel, Home, Node,
convos, messages, contacts, channels, rowlist and draw move to vmcode2:
segment 1 is now 10.3 KB, segment 2 23.4 KB. tools/sect2.py adds the
VM_SECT2 static declarations.

Checked in the compiled code, the rules in sections.h were too cautious:
literals in a vmcode2 function are emitted into vmcode2, a file's static
const data and calls to unannotated functions go through the __text__
base, and taking a vmcode2 function's address (event handlers, callbacks)
gives its real address. The real traps are shared extern const tables and
-fwritable-strings (PC-relative into .data). tools/check_sections.py runs
after every link and fails the build on any PC-relative reference from
vmcode2 to outside it; python3 added to the toolchain image for it.

Unicode: characters past Latin-1 all became '?', and Windows-1252 quotes
and dashes had no glyph in the small font. Now arrows, check marks, stars,
bullets and node-type marks map to the font's UI symbols, typographic
quotes and dashes to ASCII, any emoji to a new smiley glyph, and
variation selectors / zero-width joiners are dropped.
2026-11-01 17:29:20 -05:00
rich 40412223a4 palm-client: shared tables must not be const (prc-tools puts const in code)
The transcript wrapped after a few characters on the Visor: gSmallFontWidths
was const, so prc-tools placed it in .text, but text.c reached it through an
extern declaration A5-relative (lea %a5@(0)) as if it were data, and read
garbage widths. The same applied to gPresets. Both generators now emit
non-const tables, with a note why. Host tests can't see this.
2026-11-01 15:34:13 -05:00
rich 5249d7f5e6 palm-client: write the small font's NFNT directly (PilRC's was corrupt)
Font Preview showed garbled text: the bundled PilRC's FONT compiler writes
a broken NFNT header (first/last char words missing, later fields shifted,
height lost), reproduced with a two-glyph test font. gen_font.py now builds
the NFNT itself (header, glyph strip, location and offset/width tables),
decodes it back and checks every glyph, and PilRC includes it as a DATA
resource. Resources now rebuild when the font changes.
2026-11-01 15:15:46 -05:00
rich 1bae27fe9b palm-client: small 4x6 UI font and a Font Preview screen
tools/gen_font.py builds an NFNT (app font 0x80) from X.org's public-domain
misc-fixed 4x6 BDF plus hand-drawn MeshTerm-style symbols (star, node-type
marks, ack/fail/pending, lock) in 0x80-0x9F, reusing Windows-1252's slots for
ellipsis and angle quotes. It also writes glyphs.h and a width table for host
tests. src/ui/draw.c registers the font and adds section, chip, cut and
right-align helpers. Options > Font Preview draws sample screens so the font
can be judged on the Visor's LCD before the real screens use it.
2026-11-01 15:12:23 -05:00
rich d00d7fab26 palm-client: contacts (database + screen), command retry, PhillyMesh preset
Contacts: Refresh downloads GET_CONTACTS into a backed-up Palm database
(VisorMeshContacts), keeping the previous list if the download fails, and
sorts by name. The screen lists name with type and route, taps show
details (key prefix, last advert). Path lengths are decoded as hash size
(bits 7-6) + hop count (bits 5-0), since PhillyMesh uses 2-byte hashes.

session.c keeps unread received bytes across waits; before, bytes after a
completed frame in the same read were dropped, which would lose
back-to-back frames like the contact list. Settings commands get two tries
(the Visor's USB link can drop while idle). Ports moves to an Options menu.
Local presets (tools/local-presets.json, PhillyMesh) are listed before
MeshCore's and survive gen_presets.py --fetch.
2026-11-01 14:54:53 -05:00
rich 5a347be52d palm-client: Node Settings screen (name, radio preset/params, TX power, path hash)
Settings validates against the firmware's limits before sending anything,
then sends only what changed (SET_ADVERT_NAME, SET_RADIO_PARAMS with the
client-repeat byte passed through from DEVICE_INFO, SET_RADIO_TX_POWER,
SET_PATH_HASH_MODE), requires RESP_OK for each and names the step that
failed, then re-reads DEVICE_INFO/SELF_INFO.

The preset pop-up uses a snapshot of MeshCore's suggested presets
(api.meshcore.nz, 27 entries) in tools/meshcore-presets.json; src/presets.c
is generated from it by tools/gen_presets.py with exact decimal conversion.
Radio state moves into session.c; TX power is now signed; adds
fixed-point decimal parse/format helpers with host tests.
2026-11-01 12:03:48 -05:00
rich c9f6aaeae4 Connect screen verified on the Visor; update bridge prompt 2026-11-01 11:57:44 -05:00
rich f4bab463d1 palm-client: USB bench link works end to end
Query radio on the Visor Neo got DEVICE_INFO from the XIAO via USB
cradle -> visor_bridge.py -> FTDI -> D6/D7 UART. The app's HsUd driver
sends on the Visor's HOTSYNC USB port (2), not GENERIC, so the bridge
listens on every port and replies on the one in use; stalled endpoints
are cleared instead of ending the session. The app waits after SrmOpen
and retries sends that time out while the bridge attaches. make install
stops the bridge, which would otherwise grab the Visor during HotSync.
2026-11-01 11:46:04 -05:00
rich 8a118e4cac palm-client: USB link to the radio via the Visor's HsUd port and a Mac bridge
The Ports screen showed the Neo's Serial Manager drivers, including
'HsUd' (USB, the GENERIC port). The app gets a Serial/USB link switch
(USB default); Query radio retries since the bridge needs a moment to
attach, and SrmSendWait is gone (it can block over USB with no host).
tools/visor_bridge.py (stdlib + libusb via ctypes) finds the GENERIC
port from the Visor's connection info and forwards bytes to the radio's
serial port, logging each companion frame. Ports shows one line per
driver so all of them fit.
2026-11-01 11:32:22 -05:00
rich decded0375 palm-client: pilot-link patch for Visor USB on macOS, verified link
macOS briefly holds the Visor right after HotSync enumerates it, so
pilot-link's single USBDeviceOpen failed with kIOReturnExclusiveAccess
and the Visor reported the connection couldn't be established. The
patch retries the open for up to 2 s. pilot-xfer -l now lists the
Visor Neo's databases.
2026-11-01 10:52:12 -05:00
rich 6ff51bea14 palm-client: install from the dev Mac over USB, drop the remote sync host
pilot-link's macOS backend talks to the cradle through IOKit (port usb:),
so make install runs pilot-xfer locally.
2026-11-01 10:37:31 -05:00
rich f1159d6f48 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.
2026-11-01 10:32:20 -05:00
rich cc989cf357 palm-client: Docker toolchain, app scaffold and protocol framing
prc-tools-remix 2.3.6 + PilRC + Palm OS 3.5 SDK (pinned) in a Docker
image; make builds visormesh.prc there when the toolchain isn't local.
App has a main form whose Query button sends CMD_DEVICE_QUERY over the
Serial Manager transport. Companion framing is plain C with host tests.
make install pushes the .prc to a Pi with the USB cradle (untested).
2026-11-01 10:19:33 -05:00