Repository navigation
docs(boson-adapter): add the ARK Boson Adapter pages - #147
Conversation
Landing page, hardware reference, Jetson setup and Just A Pi setup for the ARK Boson Adapter Rev 1.0, with the nav entries and a row on the Just A Jetson camera overlays page. The pages follow the Boson+ driver work in ark_jetson_kernel#163 and ark_pi_image#15, and record the Rev 1.0 UART swap on the I2C/UART connector. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
There was a problem hiding this comment.
🔵 Needs a closer look
Hardware-owner verification is needed because the linked Rev 1.0 design files are unavailable, leaving connector pinouts and the safety of CAM1’s 3.3 V pull-up on the Boson’s 1.8 V EXT_SYNC line unverified.
No open issues 🎉
What changed in this PR
Adds ARK Boson Adapter documentation under Accessories, covering hardware details and setup with Just A Jetson and Just A Pi.
Changes:
- Adds a product landing page, hardware reference and two host setup guides.
- Documents capture commands, IMU and frame-sync connections, and the Rev 1.0 UART wiring workaround.
- Adds navigation entries and lists Boson+ support on the Just A Jetson camera overlays page.
| File | Description |
|---|---|
SUMMARY.md |
Adds the adapter and its three child pages to navigation. |
embedded-computers/ark-just-a-jetson/camera-overlays.md |
Lists Boson+ overlays and links to setup instructions. |
accessories/README.md |
Adds the adapter to the Accessories index. |
accessories/ark-boson-adapter/README.md |
Introduces the adapter, supported hosts and UART warning. |
accessories/ark-boson-adapter/just-a-pi-setup.md |
Documents Pi configuration, capture, streaming and connections. |
accessories/ark-boson-adapter/jetson-setup.md |
Documents Jetson cabling, overlays and capture modes. |
accessories/ark-boson-adapter/hardware.md |
Provides specifications, pinouts, frame-sync details and model links. |
Review effort: Balanced
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
dakejahl
left a comment
There was a problem hiding this comment.
Claude review on behalf of @dakejahl
Merge after fixes. The pages say the PAB carriers have no Boson+ overlay, but ARK-Electronics/ark_jetson_kernel@c17bbb3 added bench-tested overlays for all four Jetson PAB Carrier ports.
Must fix
-
jetson-setup.md:5andhardware.md:37: only the Jetson PAB Carrier V3 is still missing a Boson+ overlay. Add the PAB to the overlay and cabling tables with the 22-to-15-pin FFC, to the landing's Hosts bullet and toflight-controller/jetson-pabs/ark-jetson-pab-carrier/camera-overlays.md. -
hardware.md:75-86: the I2C/UART table and "a straight cable joins it to a host's UART" describe the intended wiring. Rev 1.0 is the only revision, and it swaps those pins. Is a fixed revision planned? If not, the table should show pin 2 as the Boson's output and pin 3 as its input, and the straight-cable sentence should go. -
just-a-pi-setup.md:72: this hint is about the sync line rising above the Boson's 1.8 V, so it's awarning, notinfo. Open it with what to do: don't set the Boson as a sync slave on CAM1. Then give FLIR'sEXT_SYNCinput limit instead of telling the reader to check it.
Optional
-
52a8a0e puts "USB versions are not supported" in four places:
README.md:3,README.md:7,hardware.md:7andhardware.md:40. The spec row is enough. -
"Video needs only the camera cable" also appears in four places:
README.md:3,hardware.md:73,jetson-setup.md:9andjust-a-pi-setup.md:17. Give it one home and link to it. -
The landing intro is now four sentences, and
product-pagesallows two. -
The Rev 1.0 warning at
README.md:15is a caveat, andproduct-pageskeeps caveats on the subpages. The hardware page and both setup pages already carry it. -
The
hardware.md:89hint opens with the fact instead of what to do. The sentence about Boson pins 33 and 43 is an internal the reader can't act on. Was the Jetson's serial port bench-tested, or does "it works with the Just A Jetson" follow from its pull-up? -
Each cell of the frame-sync table at
hardware.md:102-104holds two sentences. The bench numbers could go in a paragraph under it, in one unit. The table mixes pulses per second and Hz. -
AGC is never spelled out on either setup page, and VI at
jetson-setup.md:67isn't either. -
just-a-pi-setup.md:47: "The Boson+ refuses 16-bit output over MIPI" doesn't connect to the sentences around it, so it can go. -
just-a-pi-setup.md:49gives thestream start failedsymptom but not what to do. If the answer is a reboot, as the oops in ARK-Electronics/ark_pi_image#15 suggests, say so. -
just-a-pi-setup.md:53: QGroundControl's video source is a UI name. Bold it as QGroundControl shows it and give its menu path. -
just-a-pi-setup.md:70: "CAM2 has no pin 18" reads as a missing pin. The Hadron page says the carrier leaves pin 18 unconnected.
Shared with the Hadron Adapter pages
-
The PCB row at
hardware.md:15is stackup detail, whichdocs-writingcuts. -
The heading at
hardware.md:31should be Title Case: "What's Included". -
The pinout headings at
hardware.md:44andhardware.md:75lack the J2 and J3 designators. -
The landing's
In the boxbullet lists package contents, and itsHostsbullet has links.product-pageskeeps both off the landing.
Fixing these on both products keeps the two sets of pages consistent.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- Add the Jetson PAB Carrier: overlays for CAM0-CAM3, cabling with the 22-to-15-pin FFC, the landing's Hosts bullet and the PAB camera overlays page. Only the PAB Carrier V3 has no overlay. - Show the I2C/UART pinout as built on Rev 1.0, with pin 2 the Boson's output, and open the hint with the fix. Drop the straight-cable sentence and the Boson pin 33/43 internals. - Make the Just A Pi sync hint a warning that opens with what to do, and give FLIR's -0.25 to 1.92 V absolute limit for EXT_SYNC. - Give "video needs only the camera cable" one home under Connectors, and the USB exclusion two: the landing bullet and the spec row. - Cut the landing intro to two sentences, drop its hint, In the box bullet and Hosts links, and the PCB row. - One sentence per frame-sync table cell, bench numbers in one unit below the table. - Spell out AGC and VI, drop the 16-bit sentence, say to reboot after "stream start failed", name QGroundControl's video source, and say the carrier leaves CAM2's pin 18 unconnected. - Hadron pages: same shared fixes (PCB row, Title Case headings, J designators, landing bullets). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
Addressed in the latest push. Must fix
Optional
Shared with the Hadron pages Applied to both: PCB row removed, "What's Included" and "Frame Sync" in Title Case, J designators in the pinout headings, In the box bullet and Hosts links off the landing. 🤖 Generated with Claude Code |
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Summary
Adds the ARK Boson Adapter under Accessories: a landing page, a hardware reference, a Jetson setup page and a Just A Pi setup page, plus the
SUMMARY.mdandaccessories/README.mdentries and a Boson+ row on the Just A Jetson camera overlays page. Written to thedocs-writingskill.Sources
nv_bosondriver, the JAJ CAM0/CAM1 overlays,docs/boson.mdand the Rev 1.0 bring-up findings.config.txtlines, capture and streaming commands, and the bench results.Rev 1.0 UART swap
The board wires the Boson's
uart_apb_sin(pin 33) anduart_apb_sout(pin 43) the other way round, so on the I2C/UART connector pin 2 is the Boson's output and pin 3 its input. The landing page carries a warning, the hardware page's pinout gives the design intent with a Rev 1.0 hint, and both setup pages say to cross pins 2 and 3 in the cable. Video and the IMU are not affected, since the driver controls the Boson over the camera port's I2C.Not in this PR
🤖 Generated with Claude Code