Backlog
The work ahead and done.
Open · 51
A device base derives its parts' measured fields from its own runs (a derive-parts record that devlab gather runs)
device-templateAfter the move a device's runs are filed into its own base, while parts.measured/measured_run were derived by docs from docs' test_results (derive-support-status) and only seeded at the move. Without…
The device template names bringup and ships a [boot] table in device.toml
device-templateAGENTS.md says where a device's first-boot images are made (lab-tools bringup, followed by pin, never a scripts folder of its own, never an edit of the tool); device.toml gets [boot] in pmOS deviceinf…
device.toml read off a running phone
device-templatedevlab reads a running phone (compatible, sound cards, signal processors, inputs) and proposes its device.toml, [health] included - the onboarding step of the device-template design (linux-phone-oco/d…
A second phone through the template
device-templateThe proof that surya is not the mould: a second postmarketOS phone's lab made by Use this template, reaching healthy with only its device.toml filled.
Switching the phone shell, a word of devlab
device-templatesurya-lab ui/switch.sh switches the shell in place (postmarketOS UI packages, tinydm session, reboot, then the shell, DSP and speaker checked); nothing in it is surya own. As devlab shell switch NAME…
The lab's USB wake lock, carried by devlab
device-templateEvery lab phone on USB needs devlab-usb-awake (a suspend attempt drops the link); surya carries it as its own overlay. It belongs to devlab, written at flash for any phone.
The template's device.toml is the generated one, naming the pinned schema, and its CI checks it
device-template proven by device-template CI validates device.toml against the schema of the pinned releaseA new phone's lab then gets completion, hover and the check from its first commit; the header's claim that unknown fields are refused becomes true.
A second phone in the lab
docsOne phone serialises everything that changes it: four sessions now share surya, and devlab holds the phone so that changes queue. A second phone doubles what can be tried at once and proves the device…
How a device row names a docs component or feature: the about rule works within one base
docsOpen: proposal is docs:ID in text and a local components list in the device base seeded from docs; decide with the first device base. Owner: idealkb (ikb) with docs.
What Android does on the same phone, measured once and kept
docsThe project's goal is phones as good as Android; the face says it from tests that prove parts present or working, but nothing measures 'as good'. ArtCraft keeps reference corpora an oracle compares ag…
Briefs say when a session ends and how questions route: hand-over into the domain's how-it-stands row, end before compaction, ask the record, then the live owner directly, then a consult
docsDecision 2026-11-17-experts-written-not-standing. Next: orchestration edits prompts/bring-up.md, feature-research.md and orchestration.md; the first how-it-stands rows are audio-mic's and deep-sleep's…
A custom render.py that draws support_status as a real device x component matrix, not one page-section per row
docsThe generic engine renders it as plain rows for now (it has no reason to detect this shape specially); a matrix is much easier to scan at a glance once there is more than one device.
A device template: the conveyor any phone's support is built on
docsAsked for 2026-11-10: the conveyor as a repo of its own, so anyone can bring support to another phone with the same conveyors, CI, tests, tad page and automatic integration into the grand picture; sur…
soc-sleeps also reads ddr and says which rung is missing (lab-tools)
docs proven by soc-sleepsNo phone. In lab-tools health/suite/checks/base/90-sleep.sh: read ddr Count and the DDR LPM stat too, and name the rung reached (cluster S2 usage, cxsd, aosd, ddr). Today a pass needs cxsd or aosd and…
Fork sm7150-mainline/linux into linux-phone-oco and wire it into the lab's build and boot route (devlab)
docsUpstream: surya's capture joins sm7150-mainline PR 60
docssm7150-mainline/linux PR 60 (davinci, open since 2026-08) already carries the swr_tx_data mux, the TX wakeup IRQ, the port numbering and the capture DAI 1. Step: review and test it on surya, comment w…
A board for linux-phone-oco
docsThe user's idea: a shared board for the org, like the one the retired lab-agent kept. Later.
The device toolset in Rust, for any phone
docsAsked for 2026-11-10: tooling must not be tied to surya - surya is the test subject; the work is a conveyor for any phone, built as one Rust toolset (rust-script for small scripts) as we go, informed…
Sensors upstream: configs at the vendor mtime, SM7150 data to hexagonrpc
docsDecided 2026-11-17 (research-sensor-hub, decision 2026-11-17-sensors-registry-kept-current). After sensors-without-crash. Offer: firmware-xiaomi-surya (sm7150-mainline) and pmaports install the sensor…
The start weight per role, a number on the face
docsHousekeeping (ideal-agent practice 45) measures the bytes a fresh session reads per role (scripts/start-weight). Next: a table or named record for the measurement (role, bytes, date), filed by the pat…
Write the summaries tad q about shows as due: deep-sleep, dl-reaches, sensors
docs proven by tad q about shows none of them as summary dueOn 2026-11-17, after audio-mic's: deep-sleep 15.7 KB in 17 records, dl-reaches 10.9 KB in 15, sensors 11.3 KB in 10. Each is written by the session that next records into it, or its keeper at hand-ove…
The author's TTY-first shell
docsHis own shell for Linux, mobile first and at home on a desktop: built from nothing, on the best existing parts or their reimplementation in Rust. It starts as the raw console the lab's agent uses for…
Upstream: tqftpserv >= 1.2 in Alpine v3.24-stable
docs waits on the author: a request to Alpine is made in his nameFound 2026-11-17 on surya (bring-up): Alpine v3.24 (postmarketOS v26.06) ships tqftpserv 1.1.1, which never writes the modem's short state files, so SM7150/SM7125 modems never come online and their SI…
Upstream: the ADSP must not boot before the in-kernel PD mapper
docsFound 2026-11-17 on surya (bring-up): remoteproc's qcom_common only adds an auxiliary pd-mapper device when it prepares a remote processor; qcom_pd_mapper is a module that udev loads later, so on abou…
Upstream: tas2562 sets the I2S slot length from the sample width
docsKernel patch on linux-phone-oco/linux branch fix/tas2562-i2s-slot-length (one commit, compiles for arm64, verified on surya as a module built from the exact v7.1_rc3 source). Send to sm7150-mainline a…
Upstream: tas2562 digital volume writes do not reach the chips
docsSee plasma-silent. Reproduce: set the Digital Volume Control, read page 2 registers 0x0c-0x0f live with i2cget. Then a driver fix (write through, or restore on power-up) and a report. Fixed 2026-11-10…
Upstream: stereo speaker UCM profile for surya
docssurya-lab ucm/Xiaomi/surya/HiFi.conf: two channels, top amplifier (0x4d) left, bottom (0x4c) right. For alsa-ucm-conf (Xiaomi/surya), once the kernel fix is accepted or at least posted.
A spec record: what the observer learned, with evidence kind, file, hash, command
docsWanted before the first part that needs clean-room observation (display panel init is the likely first). Ask the ikb session to add a spec record (fields from research 2026-11-17-cleanroom-agents); fi…
bringup: the host tool that makes a device's first boot images (boot image pack, unpack, swap, check; initramfs)
lab-toolsDecided 2026-11-17 (decision 2026-11-17-bringup-in-lab-tools): lpoco-bringup, a workspace member of lab-tools run as 'lpoco bringup' under one roof - the lpoco dispatcher (lpoco-dispatcher), one pin,…
The bring-up init under lpoco bringup: configfs gadget (ECM, ACM, mass storage window), DHCP, shell and the FunctionFS ACM console, from the device's data
lab-tools proven by google-walleye-lab build/selftest-initramfs.sh (QEMU, dummy_hcd) passes with the init lpoco bringup makes from walleye's device.toml and none of walleye's own init files (to adapt)walleye carries ~20 init variants in build/initramfs*/ and ffs-acm-rs; lpoco bringup already makes the cpio (bringup/src/initramfs.rs) with the gadget address a variable. The generic init and console…
devlab and tone declare their command lines with argenv, not clap
lab-toolsPractice 43: a program on clap moves to argenv when it is next changed; devlab changed 2026-11-17 (lab-tools 71, 72, 79, 80, 81) and still parses with clap, as does tone; lpoco-health already moved. E…
A turn does not end with unlanded changes
lab-toolsA Stop hook (devlab guard stop) that refuses to end a turn while a place the session worked in holds changes not landed: the places are read off the transcript (the cwd of its Bash calls and the files…
The checks surya-lab ran from the lab, carried into the suite
lab-toolssurya-lab tests/automatic/checks.sh retired on 2026-11-17 (its decision 2026-11-17-the-lab-s-own-conveyor-retires); four of its checks are not yet in the phone suite: bt-sees-devices (a 6 s bluetoothc…
The microphone, placed on notice
lab-toolsThe microphone can be relied on when it is placed by the phone. Before any listening test the agent notifies its keeper and waits for his word; only then is the test run, with --placed, and counted. T…
The phone's own microphone, heard the same way
lab-toolsThe lab plays a tone, the phone records it: the instrument for the long-open microphone work. And a second lab microphone, to tell left from right.
Listening by itself, at decent hours
lab-toolsThe watcher stays silent: a tone after every start could sound at night. For it to listen unasked the lab needs to say when sound is welcome.
A room of exact zero means the microphone did not record
lab-toolsRight after a reboot the room recorded at -240 dBFS (digital silence) and the tones still passed. devlab hear should refuse in that case.
Modules no entry boots with, taken away
lab-toolsSeen 2026-11-17: removing bring-up's ear try proved remove keeps shared modules (it removed ear's entry only; mic stays). Left on surya: /lib/modules/7.1.0-rc3-sm7150-wcd, from the wcdswr experiment r…
lpoco host, the rest: lab group for headless, watcher units, cross targets, host commands, foreign rules named, NCM
lab-tools proven by per part, a plan test from fixtures that lists it and changes nothing without the verb; this run: part (2), devlab-watch@ user units planned for every device found, lab-machine setup/devlab-watch.sh named as replaced2026-11-18, lab-tools-builder: part (2b) done (lab-tools #146, main 9b0cd88): an enabled devlab-watch@ unit that is not running (systemctl --user is-active exits 3) is started by prepare; plan names i…
device.toml declared once in Rust: one manifest crate all lpoco programs read, unknown fields refused everywhere, its JSON Schema projected per release
lab-tools proven by manifest/tests/schema.rs a_misspelled_table_is_refused ([[flash.overlays]] refused - fails against today's devlab Device), schema_is_current (the committed schema equals the projection), every_lab_manifest_validates (surya, walleye and template fixtures) (to write, the first failing first)Decision 2026-11-18-device-manifest-schema-from-rust. Today devlab, host and bringup each parse device.toml in their own shape and devlab ignores a misspelled table. One crate (lpoco-manifest) holds t…
Half-manual tests
lab-toolsSequential tests with an observer - a person now, a rig later.
lpoco host check names a stale phone-side piece, from the phone's last gathered report
lab-tools proven by host/tests/phone_pieces.rs check_names_a_stale_phone_piece, check_names_a_package_off_its_pin_and_passes_a_current_phone (to write, failing first)Write the failing test first: the full text is in docs research/phone-side-pieces/2026-11-18/inventory.md (not landed - lab-tools has no ignored/expected-fail convention and it does not compile until…
Phone-side pieces under the roof: carried by the lab-tools package, named by token in device.toml, a stale copy named by lpoco host check
lab-tools proven by host/tests/phone_pieces.rs check_names_a_stale_phone_piece and check_names_a_package_off_its_pin_and_passes_a_current_phone pass; acceptance: on the lab, lpoco host check names no stale piece of surya while surya holds the wake lock from the package, with no /usr/local/bin/devlab-usb-awakeDecision 2026-11-18-phone-side-pieces-under-the-roof. Steps: phone-pieces-drift-named (its failing test first), health-reports-pieces, lpoco-awake; then surya-awake-from-package on the phone. The mani…
Built on postmarketOS's conventions
lab-toolsdevice.toml from deviceinfo; tests in the shape of pmOS's initramfs CI; bootrr.
A proper rig
lab-toolsAsked for by the author, for the future: a microphone fixed in place, a webcam that sees the screen, servos that press the buttons and touch the glass - so the tests that need a hand, an eye or an ear…
Build, sign and publish the sxmo-utils lab apk as the sxmo-utils@lab repository
lab-tools proven by suspend-retry-backs-off waits on a conveyor tag (linux-package-distribution-oco/conveyor alpi…Blocked on the conveyor (linux-package-distribution-oco/conveyor, alpine.yml v1), not on lab-tools. Read 2026-11-18: it takes a declaration input and a tag, but (1) it copies only the APKBUILD into th…
bringup_bisect_runs_declared_series fails in a parallel workspace run, passes alone
lab-tools proven by cargo test --workspace passes 20 runs in a row with default parallelismSign (coordinator, 2026-11-18): failed once in a parallel workspace run, passes alone. Likely shared state between tests (a fixed temp path, cwd, or env var); give each test its own dir/env.
hold::tests::the_phone_is_held_by_one_change_at_a_time fails in a parallel workspace run, passes alone
lab-tools proven by cargo test --workspace passes 20 runs in a row with default parallelismSign (coordinator, 2026-11-18): failed once in a parallel workspace run, passes alone. Likely a shared lease file or lock path across tests; give each test its own.
surya keeps awake by the package's lpoco-awake: the hand copy and its overlay gone
surya-lab proven by the generic awake check passes across a reboot, lpoco host check names no stale piece of surya, and no suspend loop for an hour on USB (dmesg PM: suspend entry count 0)By the keeper: suite put brings the package with the awake unit; disable devlab-usb-awake.service, remove /usr/local/bin/devlab-usb-awake and its unit; surya-lab drops the two [[flash.overlay]] entrie…
surya's device.toml names the pinned schema and its CI checks it
surya-lab proven by surya-lab CI fails a branch whose device.toml misspells a table, and passes mainOne #:schema line at the top, pinned to the lpoco release surya follows; a CI step validates (lpoco lab manifest check or taplo lint).
More phones
sxmo-deviceprofilesProfiles for other devices, made the same way.
In progress · 8
docs holds only what helps every device; each device has its own open base; docs derives progress from them
docsBoth lanes record only in their own base (google-walleye-lab #15, surya-lab #136; docs #353, #360); docs pulls their parts daily (feed-device-bases, #355; surya's base named #361) and the face reads t…
How a device repository takes later changes of device-template beyond idealkb's generic files
docsDecided 2026-11-17 (idealkb decision 2026-11-17-chain-follow-by-slice): the same pin-and-follow slice as idealkb, not a fork, subtree or Copier. Done: device-template lists what it gives (generic) and…
The audio DSP sleeps when nothing plays
docs proven by soc-sleeps waits on a deeper decision: what on the Apps/AOSS side holds CX and A…2026-11-17 keeper-6: two floor tests (adsp stopped; adsp+cdsp+modem stopped) still gave cxsd 0, aosd 0, ddr 0 - the DSP is not what holds the SoC (research 2026-11-17-adsp-stopped-cx-aosd-ddr-stay-0).…
Our own forks of each upstream we patch: fixes worked and proven there, carried until upstream takes them, mailed as working patches by the author
docsDecision 2026-11-18-upstream-forks. Forks live under grenudi (grenudi/sxmo-utils, grenudi/linux; transferred from the org); three fixes written on topic branches (sxmo series of 3, kernel RFC series o…
Upstream work is kept as records: upstreams and upstream_items (idealkb 0.8), the upstream-* items headed in them
docsSeeded 2026-11-17: six upstreams, nine items (sxmo profile sent; tas2562 x2, WCD series, UCM, pd-mapper, tqftpserv, PR 60 comment as drafts); patches and messages copied into upstream/UPSTREAM/ITEM/.…
Start the upstreams lane: one lane coordinator for the forks and every outgoing series
docsLane coordinator upstreams-coordinator started 2026-11-18. Forks: grenudi/sxmo-utils (mirror of sr.ht ~mil/sxmo-utils), grenudi/linux (fork of sm7150-mainline/linux). Where each series stands: sxmo se…
lpoco-health: the one health suite on the phone, with switches and run-time detection
lab-toolsLanded 2026-11-17: lab-tools #75, #77 (compat names), package default (next); put on surya by the keeper, runs gathered (docs #213). Open: the surya-lab checks call the new names (keeper repointing);…
sxmo-utils from our fork as a lab apk: an APKBUILD forked from Alpine's, all subpackages, source the fork's lab tag, signed, installed as sxmo-utils@lab
lab-tools proven by suspend-retry-backs-offDeclaration landed (lab-tools PR 157): packaging/sxmo-utils/APKBUILD, 1.18.1_p20261118, source tag lab-20261118.1, every subpackage; proof check .github/check-sxmo-utils-apk.sh in CI. Not yet built or…
Done · 112
device-template follows idealkb 0.14.0 (pinned at 0.9.1)
device-template proven by idealkb.toml pins 0.14.0 and the base's verify (tad check, make verify) passes on mainDone 2026-11-18: device-template main pins idealkb 0.14.0 (PR #17, build: ideal-knowledge-base 0.14.0, landed by the idealkb update-pins run while this item was in work; read back: idealkb.toml versio…
The template, made from what surya proved
device-templatedevice.toml with every section devlab reads (connection, provision, flash, health) and what to change; tests/health for a phone's own checks; tests/results for its reports; AGENTS.md conventions; CI f…
surya-lab re-based onto the template
device-templatesurya-lab keeps scripts the template no longer needs (lib/phone.sh, tests/run.sh, tests/to-docs.sh, tests/automatic/checks.sh, flash/, provision/provision.sh): each one retires once devlab does its wo…
The ADSP crashes every 13-25 s, restarting audio each time
docsCause found 2026-11-09 by tracing every request the ADSP makes (a verbose hexagonrpcd build on the phone): the sensors service (hexagonrpcd -s) attaches the ADSP sensor process, whose registry init re…
The audio DSP crashes right after resume from suspend
docsTrigger found 2026-11-10, one change at a time: with hexagonrpcd's RootPD helper (a FastRPC client) attached, the audio DSP dies on every suspend attempt - 24 of 24 (fatal error EX:kernel:0x0:IST46:0x…
The agent specifics of linux-phone-oco in their own folder, ideal-agent-linux-phone-oco/: prompts/ moved there with git mv, the domain part of practice 42 beside them, extending ideal-agent
docsDone 2026-11-17: prompts/ moved with git mv into ideal-agent-linux-phone-oco/ beside phone-keeper.md, with a README holding practice 42's domain part and the table of briefs; pointers fixed in the bri…
One cold boot came up without audio services
docsWith the sensors service off, one boot (2026-11-09) never announced the ADSP audio services, so no sound card until the ADSP was restarted by hand. Not reproduced in two further valid cold boots (audi…
The bring-up brief over budget (13.3 KB, budget 8 KB): its detail behind summaries and queries
docsDone 2026-11-17 (orchestration): bring-up folded into phone-keeper.md (5.7 KB) and bring-up.md left as a pointer (0.4 KB); the keeper's first paragraph is its whole start - purpose and the exact comma…
Call audio both ways: q6voice, with the uplink from the microphone
docsResearched (research call-audio-on-surya) and decided (2026-11-17-calls-proven-by-echo-call); the work continues as calls-q6voice-kernel, calls-voice-ucm-uplink, calls-first-call and calls-echo-check.
Calls 4: call-echo, the daily automatic echo call
docs waits on calls-first-callA telephony-layer check in surya-lab tests/health (generic in lab-tools once a second phone calls): skip as unknown without modem, SIM, registration, voice, call-audio-path, a number in the manifest,…
Calls 3: the first supervised call - tone line, then echo line
docs waits on calls-voice-ucm-uplink; the author's wordWith the author's word (2026-11-11-modem-read-only-first), the bring-up session calls +49 89 721010 99702 (blueSIP's tone line) and then +49 89 721010 99701 (blueSIP's echo) through mmcli, 20 s each,…
Calls 1: q6voice and the VoiceMMode1 link in surya's kernel
docsFirst step of 2026-11-17-calls-proven-by-echo-call. On linux-phone-oco/linux, a branch with q6voice (q6mvm, q6cvs, q6cvp, the voice DAI) from sdm845-mainline and pulpoff/linux-surya's SM7150 changes (…
Calls 2: UCM Voice Call, TX topology 0x10F70, the 1-channel uplink capture
docs waits on calls-q6voice-kernelIn surya-lab ucm/: a Voice Call verb (earpiece and speaker, bottom mic; 'VoiceMMode1 TX Topology' 0x10F70), and a small service that runs a 1-channel capture on TX_CODEC_DMA_TX_3 for as long as ModemM…
The check counts crashes on resume wrongly
docsThe check's pattern used \| in sed, which the phone's BusyBox sed does not have: it matched nothing and always counted 0. Rewritten in awk alone - a crash between "suspend entry" and two seconds after…
device-template gets a tad base: tables.toml following idealkb, the parts contract (status, evidence, date), next and phone-queue queries, ikb
docsLanded 2026-11-17 (linux-phone-oco/device-template #4, read back from main): data/ (12 empty tables), tables.toml (own: backlog + needs/proof/rank, devices, parts, test_runs, test_results), idealkb 0.…
Open docs items that need a phone go onto that phone's own queue (its base), or say they wait for a phone
docsDone 2026-11-18 (orchestration-renewed): devlab-fastboot-boot-reads-slots, floor-dsps-never-started, floor-read-holders, floor-no-ignore-unused, mic-ucm-capture, microphone and sleep-measured-once are…
Earpiece: through the WCD9375's EAR amplifier, proven by the top microphone
docsTaken up 2026-11-17 (bring-up), after the microphones work on the kept kernel. The earpiece is driven by the WCD9375's EAR amplifier (pulpoff/linux-surya: MultiMedia3 -> RX_CODEC_DMA_RX_0 -> RX macro…
A domain's expert primer: one named query that shows a fresh session everything docs knows of a component - research, decisions, backlog, tests, sources, support status, its how-it-stands row
docsDone 2026-11-17 by kb-about-link: tad q about --subject COMPONENT is the primer - status, research (its how-it-stands row once written with --about), decisions, open work, log, tests and the sources c…
docs pulls each registered device base's parts over HTTPS in CI and derives support_status; stale or missing shows as not known yet
docs waits on device-template-baseLanded. Surya: when its rows have moved to surya-lab (data/parts.json non-empty), run: tad r device-base --device xiaomi-surya --base linux-phone-oco/surya-lab in the same change; until then docs keep…
Boot with the DSPs never started, then cycle 15 bt-on
docs proven by soc-sleepsDone 2026-11-17 (keeper-9): DSPs never started (remoteproc nodes disabled in a one-shot dtb), cycle 15 bt-on: cxsd/aosd/ddr 0 -> 0, soc-sleeps fails, processors never asleep: none. No DSP vote is the…
Drop clk_ignore_unused / pd_ignore_unused if the cmdline has them
docs proven by soc-sleeps waits on floor-read-holdersClosed 2026-11-17 (keeper-9): the cmdline has no clk_ignore_unused or pd_ignore_unused (floor-read-holders), nothing to drop.
Read what is held before and at a cycle: cmdline, clocks, regulators, icc, genpd
docs proven by soc-sleepsDone 2026-11-17 (keeper-9): read at idle and before way-back.sh cycle 15 bt-on, research/deep-sleep/2026-11-17-floor-holders/README.md; what is held inside late suspend is not known yet (floor-suspend…
Known gaps shown as gaps on the face, not as failures
docsThe phone's own verdict leaves out the known gaps (surya: fingerprint, sensors, both cameras - healthy, 4 in known gaps), but test_runs counts them as failed, so every bar on the Tests page carries re…
A coverage query: each device's parts with no test proving works
docsDone 2026-11-17 (orchestration): queries/coverage.sql - tad q coverage [--device D] lists every part of a device whose work no test on that device proves, with its best proof (present or none), its st…
grenudi/ideal-knowledge-base: a new repository that pins tad's release and adds the knowledge-base layer - the file-or-table rule, the about link, the generic queries (about, next, find, recent), the short AGENTS.md entry and the standing tables (backlog, session_log, decisions, research); with tad init in tad for a bare database, and text-as-data-template retired with a pointer once its reasons are carried over
docsDone 2026-11-17: tad init in tad 0.7.0 (tad-engine decision 2026-11-17-tad-init); grenudi/ideal-knowledge-base made and released 0.1.0 (public, oco-project, its own tad base: concepts, decisions, rese…
Record into docs with ikb: one command per record, one page (IKB.md)
docsdocs follows idealkb 0.6.1 and ikb 0.1.1; IKB.md generated, kept fresh by make verify; machine records named in idealkb.toml.
Every record names what it is about, checked: an about field on research, backlog, session_log and concepts (decisions has one, free text in four spellings), one references rule to components, features, milestones and devices, backfilled; and the query about SUBJECT
docsDone 2026-11-17: about on research, backlog, session_log and concepts beside decisions, one references rule per table (components, features, milestones, devices, backlog); 11 drifted spellings in deci…
AGENTS.md is the one entry: under 3 KB, an orientation table from typical question to the command that answers it, tad statements for the rest, never read data/ or docs/ to answer; CLAUDE.md is @AGENTS.md; editing recipes move to CONTRIBUTING
docsDone 2026-11-17: AGENTS.md is 2.1 KB - two lines, linux-phone's own questions and idealkb's generic part (the orientation table, the rule never to read data/ or docs/); the editing recipes are in CONT…
A summary over many records, and research kept aside, from idealkb 0.3.0
docsDone by summary-and-research-layers on 2026-11-17: pin 0.3.0; docs' own about, research record and tables.toml take summaries, material and supersedes; audio-mic summarised (15.9 KB to 4.8 KB); Open H…
Lane launchers and briefs work in the device repository and ask its own base (tad q next, phone-queue); docs' lane-next stays for the general queue
docs waits on move-device-rowsDone in the moves: the walleye and surya coordinator briefs, phone-keeper.md, the walleye-keeper/research/builder and surya-keeper/research launchers and the waker work in the lab repository and ask i…
Keep the DMIC experiment out: surya has no digital mics
docsBring-up's experiment commits (DMIC pins at mux 1, TX DMIC routing, VA DMIC clocks on a module switch, clock p…
The microphones held across boots
docsThe mic kernel is the phone's default (devlab kernel keep) and audio-mic is out of surya's known gaps (surya…
Capture through the sound server: a UCM profile for both mics, the headset mic when plugged
docsFirst step of decision 2…
Microphone: check, and make it work
docs proven by mic-hears-speakerTaken up 2026-11-17 by the bring-up session, as the weakest link the data shows: audio-mic and audio-earpiece are both broken and two milestones rest on them (surya-sound, and the calls of…
Move device rows to the device bases: backlog, research, decisions, log by device and project, test_runs and test_results
docs waits on device-template-baseBoth lanes moved: walleye (google-walleye-lab #15, docs #353) and surya (surya-lab, docs, 2026-11-17); rule: decision 2026-11-17-moving-a-lane.
The patrol measures the start weight each run and files bring-up-brief-light-like items when over budget
docsDone 2026-11-17 (orchestration): the linux-phone-patrol round measures the start with ideal-agent's scripts/start-weight on docs at main each run, and files one backlog item about agent-folder when a…
Plasma Mobile: speakers silent, the chain playing
docsPlasma Mobile (fresh Nura image, sound fixes applied on the phone): speakers were silent with the whole chain playing. Two causes, both confirmed: (1) the image restores a saved mixer state with both…
Bluetooth dies across a suspend and hangs the resume
docs proven by soc-sleeps2026-11-17 (surya-keeper-4): not seen again. With Bluetooth unblocked and the serial's wakeup off, 3 cycles of 5-15 s resumed in time and hci0 scanned afterwards (no tx timeout, no QCA retries in dmes…
Deep sleep measured once: the SoC's own counters across one suspend
docs proven by soc-sleepsDone 2026-11-17 by surya-keeper: one cycle by hand, soc-sleeps = fail (cxsd 0, aosd 0, adsp never asleep, cluster S2 never entered). Research 2026-11-17-surya-first-s2idle-cycle. The phone woke after…
Why the first s2idle woke after 2.4 s, not 60
docs proven by soc-sleepsAnswered 2026-11-17: IRQ 157, the serial at 88c000 (research 2026-11-17-surya-s2idle-wakes-at-once); the fix is sleep-wake-uart.
Suspend ends at once: the serial's interrupt 157 is a wake source and a storm
docs proven by soc-sleeps2026-11-17 (surya-keeper-4): done. The wake was irq 158, the UART's RX wake pin, armed by the serial's power/wakeup; way-back.sh cycle SLEEP bt-on turns it off for the cycle with Bluetooth unblocked.…
SMS: the phone texts itself and receives it, after every boot or daily
docs waits on the SIM's own phone number (the SIM does not store it)Opened 2026-11-17 (bring-up), with mobile data working (Vodafone.de network, a 1&1 SIM). A check sends a short SMS from the phone to its own number with mmcli and waits for it to arrive - proving mode…
Support status read off the suite's results
docsderive/support-status.sql: broken on a failing latest run, works on a passing test that proves the part works, otherwise judged; tried beside the hand-written status - naive reading disagreed on 8 of…
Upstream: the Sxmo device profile for surya
docsWritten and in use (2026-11-10): both panel variants, values from a running Sxmo, shellcheck clean; Sxmo loads it (SXMO_DEVICE_NAME=xiaomi,surya-huaxing, scale 3). Kept on linux-phone-oco/sxmo-utils,…
The phone kept reconnecting on the host's USB
docsOn USB a suspend cannot complete (the link cannot go idle): each attempt aborts at once, and a shell that suspends when idle retried every 12 seconds, each time dropping the link - 26 USB disconnects…
WCD937x device tree: drop aoncc, clock the VA macro from q6afecc
docsThe boot hang (RCU stalls) with the WCD937x patch is the aoncc clock controller at 0x03380000, an SM8250 address with nothing near it in the SM7150 tree: with only aoncc disabled the phone boots (2026…
bringup bisect FILE: a declared series of swaps (walleye's s0, s0n, s1, s2, s3), and the lz4 frame kernel part
lab-tools proven by bringup-bisect-runs-declared-seriesBuilt and landed (lab-tools#123, 0bb6fdf on main): lpoco-bringup image bisect SERIES --out DIR; a TOML series (control, [[image]] name/kernel/dtb/ramdisk/cmdline/lz4/footer), each image counted agains…
bringup image swap: one part of a control image replaced, the AVB hash footer kept, and what differs said
lab-tools proven by bringup-swap-s0-reproduces-controlBuilt and landed (lab-tools#110): lpoco-bringup image swap CONTROL --out IMG [--ramdisk|--kernel|--dtb|--cmdline]; proof bringup_swap_s0_reproduces_control passes. Bisect series and lz4 kernel are bri…
bringup image info|unpack|pack|check for header v0, packed byte for byte as mkbootimg
lab-tools proven by bringup-pack-matches-mkbootimgLanded in lab-tools PR 85 (https://github.com/linux-phone-oco/lab-tools/pull/85): crate lpoco-bringup (lib+bin, argenv, family version 0.1.7, release-plz version_group), image info|unpack|pack|check f…
bringup initramfs build: a reproducible newc cpio, the gadget address as a variable, xz or gzip by the device
lab-tools proven by bringup-cpio-matches-gen-init-cpioReplaces build-initramfs.sh. Test: from the walleye spec (busybox, /init, udhcpd.conf, device nodes) the archive is byte for byte what the kernel's gen_init_cpio -t 0 makes, then compressed with the c…
bringup follows by pin and extends by hooks: [tools] version check, manifest-named step hooks, a library API a rust-script can use
lab-tools proven by bringup-refuses-wrong-pinLanded in lab-tools PR 88 (squash on main). Proof bringup-refuses-wrong-pin: bringup/tests/pin_and_hooks.rs (pin refusal, matching pin, parts hook changes ramdisk, failing/missing hook stops) and rust…
bringup is released by release-plz (a bringup-vX.Y.Z tag) and installs on a lab host from the tag
lab-tools proven by bringup-installs-from-tagDone: cargo install --git --tag per package, proven by bringup-installs-from-tag against 0.2.0 (lab-tools #90, read back from main f4e55b0).
devlab fastboot boot reads the slot variables before and after a try and says what changed
lab-tools proven by a test that fails when devlab reports a slot change as only refusedDone 2026-11-17 by lab-tools PR 80 (d510232), recorded there as fastboot-slots-told: devlab fastboot boot now reads current-slot and slot-unbootable/successful/retry-count of a and b before and after,…
devlab reaches a phone over fastboot (walleye speaks nothing else until Linux runs)
lab-toolsDone 2026-11-17 (lab-tools PR 79, device-template fastboot-serial): device.toml [fastboot] serial + writes (false unless said); devlab fastboot state | getvar NAME | boot now BOOT.IMG | reboot now [--…
devlab mcp: the phone for any agent
lab-toolsdevlab mcp (rmcp 3.10, stdio): run, put, get, health_report, health_run, kernel_install, kernel_try, kernel_status, reboot - each the function the command line calls; nothing but the protocol on stand…
fastboot: a phone out of fastboot found by its serial or USB port, else gone from USB
lab-toolsDone 2026-11-17 (lab-tools PR 81, f904196), asked by walleye-coordinator: after a boot try devlab took surya's postmarketOS gadget (18d1:d001) and a shared address for walleye's Linux while walleye ha…
fastboot boot says where the phone went and the slots' flags; set-active gated
lab-toolsDone 2026-11-17 (lab-tools PR 80, d510232), asked by walleye-coordinator after research walleye-first-fastboot-boot-tries: boot now reads current-slot and slot-unbootable/successful/retry-count of a a…
Flashing
lab-toolsdevlab flash did its first real flash (2026-11-10): the pristine stock image, the manifest's fixes baked in, the device tree fingerprinted (a43d069d0a49adcd), the phone back with all 20 checks passing…
A known gap counted apart from a failure, when a run is filed
lab-toolsdevlab gather files each run test_runs row with gaps: failures in the manifest [health] gaps, counted apart from failed, as the phone own verdict counts them (docs gaps-on-the-face). Columns are named…
devlab gather files a device's runs and results into its own base
lab-tools waits on move-device-rowsdevlab gather files into the lab's own base when it has a devicebase.toml (same test-run record; filed() and derivations from the lab; land lands the lab alone); --docs keeps the old path; the output…
Gathered once the phone is quiet, landed again if main moved
lab-toolsMeasured 2026-11-17 (conveyor session): in about 2 h the watch gathered 5 times and 2 landings failed, other sessions having landed in docs and surya-lab meanwhile; each boot cost two PRs, two CI roun…
The ways, held for agents: devlab guard
lab-toolsClaude Code hooks on the lab call devlab guard: PreToolUse refuses git push to main, python/pip, and ssh/scp/sftp/rsync/sshpass to a phone address devlab has met (each manifest leaves its addresses in…
Health, after every boot
lab-toolsdevlab test, health, watch: regressions raise one board task.
Every change ends with the health report
lab-toolsEvery change devlab makes ends with the phone's health: phone reboot and kernel try wait for the report the new boot writes by itself (the test kernel's boot is measured like any other), provision run…
devlab-health tone make|find on the phone, the awk Goertzels retired
lab-toolsDone 2026-11-17 (conveyor-health): devlab-health is a multi-call binary. tone make|find links lab-tools' tone crate (its clap command a feature now; one WAV reader shared by tone, devlab hear and the…
devlab-health as an Alpine package
lab-toolsDone 2026-11-17: surya takes the suite from its Alpine package. devlab suite put now (lab-tools #51) adds lab-tools' signed repository and key to the phone once, installs or upgrades devlab-health, an…
The mobile-data check made generic, counting its bytes against a budget
lab-toolsDone 2026-11-17 (conveyor-health): telephony/10-mobile-data.sh in the generic suite (lab-tools #60, fixed by #62 to measure the data bearer and never IMS), with devlab-health data plan|spent keeping t…
Gathering is one command
lab-toolsdevlab gather now: the phone's reports into the device lab's tests/results, every unfiled run into docs' test_results and test_runs. Proven 2026-11-17: 5 reports brought from surya, 9 runs filed (5 fr…
The phone checks its own health after every boot
lab-toolsdevlab-health (static Rust runner, health/) and the generic checks: storage, kernel (oops, new warnings, processor crashes, failed units), signal processors, sound cards, Wi-Fi, modem, Bluetooth, disp…
lpoco-health reports what lab pieces the phone holds: each package's version and each declared file's git blob id
lab-tools proven by health/tests/pieces_report.rs under LPOCO_HEALTH_ROOT: a made-up phone with one declared file and one package reports both rows with the blob id git hash-object gives for that file (to write)Done: lab-tools PR 150 (feat(health): lab-pieces check reports each declared file's blob id and package version), read back from main; released with the family after 0.12.1. The phone's report is prov…
One controlled suspend and wake in the suite
lab-tools proven by fixture tests of the verb (plan with no phone, counters parsed before/after, refuses without a declared way back); then one cycle on surya through surya-lab's queue, the report's soc-sleeps turning from skip to pass or fail2026-11-18: built and released in lab-tools v0.4.1 (PR 125): lpoco-health suspend plan|cycle, manifest [health] suspend_guard (way back) + suspend_quiet, soc-sleeps reads the boot's cycle; 10 fixture…
The telephony layer: checks that cost something, at most once a day
lab-toolsPer decision 2026-11-17-health-checks-shell-and-rust, asked by bring-up for surya's SMS loopback and mobile data: devlab-health 0.1.1 runs a third layer after base and shell, telephony (a call, an SMS…
The lab's ear
lab-toolsdevlab hear and devlab health --hear work: a tone on each channel, recorded through the lab's microphone, measured against the silent room; heard checks join the one baseline when listened for. Its fi…
devlab hear asks for the word first
lab-toolsdevlab hear and devlab health --hear refuse without --placed, and say the procedure: tell the microphone's keeper, wait for their word. The lab's microphone can stay named: nothing plays by accident.
lpoco host gives each declared gadget node a group the lab user already holds, so access does not wait on the seat's uaccess ACL
lab-tools proven by a plan test from fixtures: the rule line carries GROUP and MODE 0660 from lab.toml beside TAG+=uaccess; check says which group and that the lab user is in it; then walleye's next z try reads /dev/ttyACM0 as the lab user (walleye lab's queue)Landed in lab-tools PR 129 (main 6530e82): lab.toml gadget_group adds GROUP and MODE 0660 to each gadget rule line; check says the group and that the lab user is in it (list or primary gid). Proof: ho…
lpoco host prepare installs each tool by writing a new file and renaming it into place
lab-tools proven by a host test: a script tool being run while prepare replaces it finishes with its old text (the new file is renamed over, never written in place); cargo installs likewise land by renameLanded in lab-tools #162 (read back from main): prepare writes each tool, rev stamp and watcher unit beside the old file, fsyncs, renames over it (replace_file in host/src/main.rs). Proof: host test a…
lpoco host reads lab.toml from lab-machine's origin/main, as it reads each device.toml
lab-tools proven by a plan test from a fixture clone whose working lab.toml is behind origin/main: the plan reads origin/main's pins and says which rev it read, the working file ignoredDone 2026-11-18: lab-tools #127 (released v0.5.0, #128). lpoco host reads lab.toml through the same declared_text as device.toml: origin/main, rev named, differing working file ignored. Proof: host/te…
lpoco host check names a gadget that enumerated with a serial no device declares
lab-tools proven by a check test from a fixture kernel log: a 1d6b gadget with SerialNumber walleye-banner while device.toml declares walleye-first-boot is reported (device, serial seen, serial declared, when); a declared one is notDone in lpoco-host 0.6.1 (lab-tools PR 131/132): proof tests check_names_a_gadget_that_enumerated_with_a_serial_no_device_declares and check_does_not_report_a_gadget_whose_serial_a_device_declares. No…
lpoco host watches only the devices whose device.toml asks to be watched
lab-tools proven by a plan test from fixtures: a device with [host] watch = true gets its devlab-watch@ instance enabled; one without it gets none, and an enabled instance of a device that no longer asks is named in the plan (never stopped silently); surya-lab's device.toml declaring watch = true is the lane's change, read from origin/mainLanded lab-tools #135, released v0.7.0 (#134), read back from main. Open for others: surya-lab device.toml needs [host] watch = true before the lab's prepare.
Safe test kernels
lab-toolsdevlab kernel: one try by boot counting, a timeout that falls back to stock.
devlab kernel: make a proven test kernel the phone's default
lab-toolsDone 2026-11-17 (orchestration, lab-tools kernel-keep): devlab kernel keep NAME now rewrites the test kernel's entry to sort ahead of stock with 3 tries and systemd-bless-boot no longer masked; its fi…
kernel remove never takes modules another kernel boots with
lab-toolsAsked by bring-up, 2026-11-17: its ear try is the same 7.1.0-sm7150-mic+ build as the kept mic kernel, so removing ear could have taken the default kernel's modules. Now install says the release in th…
A device-tree change is one boot: kernel try --dtb
lab-toolsAsked by bring-up, 2026-11-17: a device-tree experiment on the kept kernel took unkeep, a stock reboot, try and keep again. devlab kernel try NAME --dtb FILE now boots installed kernel NAME's kernel,…
The lab's devlab (and tone) move from 0.1.0 in ~/.local/bin to the family pin 0.2.1, between surya keeper runs
lab-toolsDone 2026-11-17 23:12 in the surya lane's window (keeper idle, lease released): the 0.1.0 copy is kept as ~/.local/bin/devlab-0.1.0; lpoco-lab and lpoco-tone are cargo-installed at lpoco-v0.2.1 with -…
devlab takes the family name (lpoco-...) when device repositories install it, keeping devlab as another name
lab-tools waits on devlab first pinned or installed by a device repositorySuperseded 2026-11-17 by the one-roof decision: the rename is lpoco-rename-lab-tone, behind lpoco-dispatcher.
Never read LPASS pins through debugfs while LPASS is idle
lab-toolsFound by the bring-up session, 2026-11-17: reading /sys/kernel/debug/gpio and the LPASS LPI pinctrl debugfs on surya while the LPASS clocks were off stalled the bus; the phone hung until a person held…
The lab phone's keep-awake as lpoco-health awake: a unit in the package, gates named by device.toml, its generic check
lab-tools proven by health/tests/awake.rs under LPOCO_HEALTH_ROOT: the lock written always; with allow-autosleep, released when the UDC state is not configured and held again when the gate reports unsafe (to write); acceptance: surya-awake-from-packageLanded lab-tools PR 148 (3ac4c46): lpoco-health awake [--once], unit lpoco-awake.service and check 93-awake.sh in the package, [health] awake_gates in devlab. Proof health/tests/awake.rs (4 tests, see…
lpoco: the dispatcher - lpoco NAME runs lpoco-NAME, one version for the family, list and completions
lab-tools proven by lpoco-runs-subcommand-by-pathLanded in lab-tools PR 83 (https://github.com/linux-phone-oco/lab-tools/pull/83): lpoco NAME runs lpoco-NAME, refuses mixed versions, list/--version/completions/man from the argenv declaration, one fa…
lpoco host: the lab host prepared from the lab's and each device's declarations - udev access for gadget serials, host modules, the host's own tools at their pins; plan by default, prepare now to change
lab-tools proven by host/tests/plan.rs plan_grants_gadget_serial_and_changes_nothing (first, failing); then plan_lists_host_tools_at_pins_and_installs_nothing; acceptance: lpoco host prepare now on the lab, then the walleye keeper reads /dev/sda and /dev/ttyACM0 as the lab user waits on the tty half of the acceptance: walleye's pk5l (the mainline…Done 2026-11-18 (orchestration-renewed): both acceptance halves passed on walleye as the lab user, no root. Block: walleye lab PR 70. Tty: walleye lab PR 182 - banner2 from slot b, gadget 1d6b:0104 Se…
lpoco-host --help prints its usage (argenv), as ikb and land do
lab-tools proven by lpoco-host-help-prints-usageLanded in lab-tools #93, released as lpoco-v0.2.2: --help and -h print the usage (arguments and environment read from the argenv declaration) in lpoco, lpoco-host, lpoco-bringup, lpoco-health; lpoco-t…
lpoco host reads each device declaration from origin/main, or names the commit read and how far behind it is
lab-tools proven by lpoco-host-reads-device-from-origin-mainLanded lab-tools #108 (15c7a7c), released v0.3.4. Proof: host test reads_each_device_from_origin_main_and_names_how_far_behind (seen failing first). version of script tools documented as label only.
lpoco host finds script tools (land, agent-env, oco-work) by rev and says what it found, and the devices glob takes a list
lab-tools proven by lpoco-host-finds-script-toolsSeen writing lab.toml (lab-machine #36): plan says land 'found not found' and oco-work 'not installed' though both are in ~/.local/bin, since scripts print no --version and a script pin needs version…
lpoco-lab's command line declared once with argenv (devlab's clap moves over)
lab-toolslanded lab-tools #98 (a365eb2), read back from main; proof devlab/tests/help.rs. Left: declared env still read by std::env::var in flash/provision/watch/phone/hear/device (route through the contract);…
lpoco-lab reads its declared environment through the argenv contract, not std::env::var
lab-tools proven by lpoco-lab-env-read-onceLanded in lab-tools #103 (fd1163d): the five declared env vars are read once in cli.rs; proof lpoco-lab-env-read-once seen failing, then green. Known: a non-UTF-8 HOME counts as unset; empty DEVLAB_RO…
lpoco mcp: one MCP server for the family, every subcommand's tools under its name, old names kept
lab-tools proven by lpoco-mcp-lists-every-family-tooldone: lab-tools#87; proof lpoco-mcp-lists-every-family-tool (lpoco/tests/mcp.rs) green; read back from main
The old names (devlab, tone, devlab-health, the MCP tool names) swept to lpoco ones in small changes, the aliases kept until the sweep ends
lab-toolsLeft by lpoco-rename-lab-tone (lab-tools #86): ~450 references across AGENTS.md, READMEs, briefs, device.toml comments, launchers, devlab-watch@ units and scripts still say devlab or tone. Sweep one r…
devlab becomes lpoco-lab (lpoco lab), tone lpoco-tone; the old names stay as other names
lab-tools proven by lpoco-lab-and-devlab-are-one-programLanded in lab-tools #86: packages lpoco-lab and lpoco-tone, second [[bin]] keeps devlab and tone running the same code; one family version 0.1.7 (release-plz version_group). Proof lpoco-lab-and-devlab…
lpoco-tone's command line declared once with argenv (the last clap in the family)
lab-tools proven by lpoco-tone-help-from-argenvLanded in lab-tools #101, released in v0.3.1 (#97). Proof lpoco-tone-help-from-argenv: lab-tools tone/tests/help.rs, red first, 5 tests pass; programmer review fixed (out-of-range/zero rate and channe…
Reaches the phone
lab-toolsdevlab phone: USB or Wi-Fi, no quoting layer, boot ids.
Provisioning
lab-toolsPackages, files by {compatible}, Wi-Fi; the shared connection undone by a guard. It sets a fresh phone's clock and grows its system to fill its partition first.
A family release is one release PR that writes every member's changelog; main never red between two
lab-tools proven by release-pr-writes-every-changeloglanded lab-tools#121; proof test a_release_where_one_member_changed_writes_every_changelog. Next release PR is the real read-back.
Every release of the lpoco family bumps the version and tags what landed: no changelog-only release under an existing version
lab-tools proven by release-tags-every-changelanded lab-tools #116 and #119; proof: release-tags-every-change, release_plz_ignores_its_own_release_commits (lpoco/tests/release_family.rs). release-plz.toml release_commits lists feat|fix|perf|refa…
A change's health report stays on the phone until the watch files it
lab-toolsSeen by bring-up 2026-11-17: a suite run from its worktree brought the phone's reports into that worktree and they rode along in a landing. devlab no longer brings reports into the clone a command run…
suite put puts the lab as its main has it
lab-toolsSeen 2026-11-17 (orchestration's own slip): suite put run in a surya-lab clone 40 commits behind main put old checks and a known gap main had left (audio-mic) onto the phone, until the suite was put a…
suite put: find the runner by itself
lab-toolsDone 2026-11-17 (lab-tools PR 72): devlab suite put now --runner (no file) builds devlab-health with health/build.sh in the lab-tools devlab was built from and copies it with that tree's checks; --run…
Suite check suspend-irq-quiet: interrupts across one suspended cycle stay under a threshold
lab-tools proven by suspend-irq-quietFrom surya-lab's backlog (floor research; the surya coordinator asked orchestration's builder, 2026-11-18). A generic check in lab-tools health/suite/checks/ with its row in docs tests (ikb test): rea…
Test sounds at a level the manifest sets - quiet by default
lab-toolsAsked by the author, 2026-11-17 (~03:00 local): 'please use quieter sound for tests, asap' and 'there should be a setting in the test suite'. The bring-up session had played a full-scale speaker-test…
kernel try: a try whose release equals the test kernel's is read as stock
lab-toolsDone 2026-11-17 (lab-tools PR 71): where LoaderEntrySelected is empty, devlab kernel try reads the booted entry off the running cmdline's initrd=initramfs-NAME, and the release only where neither says…
kernel try reports what came back
lab-toolsdevlab kernel try reports what the try came to, said by the phone after a new boot answers: booted, not chosen, stopped early, or timed out with its log. Proven 2026-11-11: booted the microphone kerne…
surya-lab follows idealkb 0.14.0 (pinned at 0.9.1)
surya-lab proven by idealkb.toml pins 0.14.0 and the base's verify (tad check, make verify) passes on mainDone by idealkb's update-pins: surya-lab PR 221 (build: ideal-knowledge-base 0.14.0) merged; 220 closed as superseded.
surya's profile
sxmo-deviceprofilesBoth panel variants; Sxmo loads it; scale 3.
surya's profile upstream
sxmo-deviceprofilesIn sxmo-utils master as 1fd7822 (sxmo-profile-patch landed).