Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .gitbook/assets/ARK Boson Adapter Bottom.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .gitbook/assets/ARK Boson Adapter Top.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .gitbook/assets/ARK Boson Adapter on Boson+.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 5 additions & 0 deletions accessories/ark-boson-adapter/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
---
cover: ../../.gitbook/assets/ARK Boson Adapter on Boson+.jpg
coverY: 0
---

# ARK Boson Adapter

A breakout for the Teledyne FLIR Boson+ thermal camera module with the MIPI interface. It brings the Boson's video out on a 22-pin CSI-2 FFC, and the Boson's serial port and an onboard ICM-45686 IMU out on a 6-pin JST-GH.
Expand Down
10 changes: 7 additions & 3 deletions accessories/ark-boson-adapter/hardware.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
| Camera control | Boson I2C on the camera connector, level-translated to 3.3 V, address `0x6a` |
| Serial port | Boson UART on a 6-pin JST-GH, level-translated to 3.3 V, 921600 8N1 |
| IMU | TDK InvenSense ICM-45686 6-axis, I2C address `0x68`, on the 6-pin JST-GH |
| Frame sync | Boson `EXT_SYNC`, 1.8 V, to the camera connector's MCLK pin. The jumper to the IMU's FSYNC pin is not fitted |
| Frame sync | Boson `EXT_SYNC`, 1.8 V, to the camera connector's MCLK pin and the IMU's FSYNC pin |
| Power | 3.3 V from the camera connector, which powers the Boson and the adapter |
| ESD protection | On every MIPI, I2C and UART line |
| Mounting | 4× 1.8 mm holes |
Expand All @@ -20,6 +20,10 @@ The adapter wires no reset, power-down or clock to the Boson. The Boson runs fro

## Connectors

<figure><img src="../../.gitbook/assets/ARK Boson Adapter Top.jpg" alt="ARK Boson Adapter, top"><figcaption><p>Top: Camera FFC (J2) and I2C/UART (J3)</p></figcaption></figure>

<figure><img src="../../.gitbook/assets/ARK Boson Adapter Bottom.jpg" alt="ARK Boson Adapter, bottom"><figcaption><p>Bottom: Boson connector (J1)</p></figcaption></figure>

| Connector | Label | Part |
|-----------|-------|------|
| J1 (bottom) | Boson | Hirose DF40HC(4.0)-80DS-0.4V, 80-pin, 0.4 mm pitch, 4.0 mm stack height |
Expand Down Expand Up @@ -99,15 +103,15 @@ The adapter connects these Boson pins: 3.3 V in, the two MIPI data lanes and clo

## Frame Sync

The Boson's frame-sync line is `EXT_SYNC` on pin 72. R12 joins it to pin 18 of the camera connector, the carrier's MCLK pin, and is fitted. R13 joins it to the IMU's FSYNC pin and is not fitted on Rev 1.0. Fit a 0 Ω resistor at R13 to let the IMU timestamp the pulses.
The Boson's frame-sync line is `EXT_SYNC` on pin 72. It connects to pin 18 of the camera connector, the carrier's MCLK pin, and to the IMU's FSYNC pin.

The line is the Boson's own 1.8 V I/O, with no buffer on the adapter. FLIR's absolute limit for it is −0.25 to 1.92 V.

| Device | Role on the sync line |
| ------ | --------------------- |
| Boson | Holds the line low from power-on. As sync master, sends one pulse per 60 Hz frame while it streams |
| Host | Reads the pulses on the camera port's MCLK pin, which ARK's overlays set as an input |
| ICM-45686 | With R13 fitted, tags the first sample after each pulse with the pulse-to-sample delay at 1 µs resolution |
| ICM-45686 | Tags the first sample after each pulse with the pulse-to-sample delay at 1 µs resolution |

Set the Boson's sync mode over its serial port with FLIR function `0x00050098`: 0 off, 1 master, 2 slave. The Boson powers on with sync off and forgets the setting at power-off. Switch the IMU's pin 9 from INT2, its power-on function, to FSYNC before it can tag the pulses.

Expand Down
2 changes: 1 addition & 1 deletion accessories/ark-boson-adapter/jetson-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,4 +82,4 @@ When a stream starts, the driver switches the Boson's output to MIPI, selects th

The ICM-45686 is at `0x68` on whichever I2C bus the cable lands on. The I2C0 bus runs at 100 kHz, which carries accel and gyro at up to 400 Hz.

With the Boson as sync master, each overlay reads its pulses on the port's MCLK pad: `PP.00` for CAM0 and `PP.01` for CAM1 on both carriers, and `PQ.05` for CAM2 and `PQ.06` for CAM3 on the Jetson PAB Carrier. A port whose overlay is not applied keeps its pad as a driven output, so a Boson there sends no pulses through. The IMU timestamps the pulses only with R13 fitted, as [Frame Sync](hardware.md#frame-sync) describes.
With the Boson as sync master, each overlay reads its pulses on the port's MCLK pad: `PP.00` for CAM0 and `PP.01` for CAM1 on both carriers, and `PQ.05` for CAM2 and `PQ.06` for CAM3 on the Jetson PAB Carrier. A port whose overlay is not applied keeps its pad as a driven output, so a Boson there sends no pulses through. The IMU tags the pulses as [Frame Sync](hardware.md#frame-sync) describes.
2 changes: 1 addition & 1 deletion accessories/ark-boson-adapter/just-a-pi-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ The driver changes only the video output and saves nothing to the Boson's flash.

## IMU and Frame Sync

The ICM-45686 is at `0x68` on `/dev/i2c-7`. On CAM1 the Boson's sync line reaches the Pi on GPIO35, through pin 18, and the Pi only reads it. With the Boson as sync master, the Pi sees its 60 Hz pulses there. The carrier leaves CAM2's pin 18 unconnected, so on CAM2 only the IMU sees the pulses. The IMU timestamps them only with R13 fitted, as [Frame Sync](hardware.md#frame-sync) describes.
The ICM-45686 is at `0x68` on `/dev/i2c-7`. On CAM1 the Boson's sync line reaches the Pi on GPIO35, through pin 18, and the Pi only reads it. With the Boson as sync master, the Pi sees its 60 Hz pulses there. The carrier leaves CAM2's pin 18 unconnected, so on CAM2 only the IMU sees the pulses. The IMU tags them as [Frame Sync](hardware.md#frame-sync) describes.

{% hint style="warning" %}
Do not set the Boson as a sync slave on CAM1. The CM5 pulls GPIO35 up to 3.3 V through 15 kΩ, and no setting removes it. With nothing driving the line, the pull-up takes it above FLIR's 1.92 V absolute limit for `EXT_SYNC`. The Boson holds the line low from power-on and drives it as sync master, so in those states the pull-up only loads its output.
Expand Down