Skip to content

docs(boson-adapter): add the ARK Boson Adapter pages - #147

Merged
AlexKlimaj merged 5 commits into
mainfrom
alexklimaj/boson-adapter-docs
Nov 19, 2026
Merged

AlexKlimaj merged 5 commits into
mainfrom
alexklimaj/boson-adapter-docs

Conversation

@AlexKlimaj

Copy link
Copy Markdown
Member

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.md and accessories/README.md entries and a Boson+ row on the Just A Jetson camera overlays page. Written to the docs-writing skill.

Sources

Rev 1.0 UART swap

The board wires the Boson's uart_apb_sin (pin 33) and uart_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

  • No photos yet, so there is no cover image and no connector figures. They come with the product photos.
  • No weight. It has not been measured, so the specifications table has no weight row.
  • The PAB carriers have no Boson+ overlay, and the pages say so. The included 22-to-15-pin FFC is listed with that note.
  • The store page and ARK-Electronics/ark-hardware PR this links to are in flight.

🤖 Generated with Claude Code

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>
Copilot AI balanced review requested due to automatic review settings November 18, 2026 20:39

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 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 dakejahl left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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:5 and hardware.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 to flight-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 a warning, not info. Open it with what to do: don't set the Boson as a sync slave on CAM1. Then give FLIR's EXT_SYNC input 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:7 and hardware.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:9 and just-a-pi-setup.md:17. Give it one home and link to it.

  • The landing intro is now four sentences, and product-pages allows two.

  • The Rev 1.0 warning at README.md:15 is a caveat, and product-pages keeps caveats on the subpages. The hardware page and both setup pages already carry it.

  • The hardware.md:89 hint 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-104 holds 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:67 isn'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:49 gives the stream start failed symptom 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:15 is stackup detail, which docs-writing cuts.

  • The heading at hardware.md:31 should be Title Case: "What's Included".

  • The pinout headings at hardware.md:44 and hardware.md:75 lack the J2 and J3 designators.

  • The landing's In the box bullet lists package contents, and its Hosts bullet has links. product-pages keeps both off the landing.

Fixing these on both products keeps the two sets of pages consistent.

AlexKlimaj and others added 2 commits November 18, 2026 17:36
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>
@AlexKlimaj

Copy link
Copy Markdown
Member Author

Addressed in the latest push.

Must fix

  • PAB added: overlays table (CAM0–CAM3, bench-tested per ark_jetson_kernel@c17bbb3), cabling row with the 22-to-15-pin FFC, Hosts bullet, and a Boson+ row on the PAB camera overlays page. The pages now say only the PAB Carrier V3 has no overlay. The PAB has no Jetson UART connector for the Boson's serial port, and the cabling table says so.
  • The I2C/UART table shows Rev 1.0 as built: pin 2 is the Boson's output, pin 3 its input. The straight-cable sentence is gone. The hint opens with "cross pins 2 and 3" and says the included cable is straight. A Rev 2.0 that swaps the nets is in progress but not shipping, so the page carries the shipping pinout only.
  • The Just A Pi hint is a warning that opens with "do not set the Boson as a sync slave on CAM1" and gives FLIR's limit: the Boson External Sync application note lists the pin 72 I/O absolute limits as −0.25 to 1.92 V. The 3.3 V tolerance in that note belongs to FLIR's buffered dev board, not the Boson pin. The hardware page's Frame Sync section carries the same limit.

Optional

  • USB exclusion: two homes instead of four, the landing's Camera module bullet ("MIPI versions only") and the spec row. The landing one stays because the store asked for it.
  • "Video needs only the camera cable" lives under Connectors on the hardware page. The setup pages link to it.
  • Landing intro is two sentences. Its hint, In the box bullet and Hosts links are gone.
  • The hardware hint opens with what to do, and the pin 33/43 sentence and the pull-up claim are gone. I have no bench result for the Boson's serial port on the Just A Jetson, so the page no longer says it works there. It states the connector and device node only.
  • Frame-sync table cells are one sentence each. Bench numbers sit in a paragraph below, all in pulses per second.
  • AGC and VI are spelled out. The 16-bit sentence is gone. stream start failed says to reboot. QGroundControl's UDP h.264 Video Stream source has its menu path. CAM2's pin 18 is "left unconnected by the carrier".

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>
@AlexKlimaj
AlexKlimaj merged commit a625684 into main Nov 19, 2026
2 checks passed
@AlexKlimaj
AlexKlimaj deleted the alexklimaj/boson-adapter-docs branch November 19, 2026 00:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants