# SIB header

The SIB header is a 3 rows and 32 pins header that connect the SIB to the MIB.

![SIB header](/_images/hardware/sib-header.jpg){align=center}

## Reference Parts

|                     | SIB Header          | MIB Connector      |
|---------------------|---------------------|--------------------|
| DigiKey Part Number | [2684-254897-E-ND](https://www.digikey.com/en/products/detail/te-connectivity-erni/254897-E/12625491) | [1195-5214-ND](https://www.digikey.com/en/products/detail/harting/09731962903/4323951) |
| Manufacturer        | TE Connectivity ERN | HARTING            |
| Product Number      | 254897-E            | 09731962903        |
| Description         | CONN DIN RCPT 96POS | CONN DIN HDR 96POS |

## Header pinout

The SIB header pinout is defined as below:

|    | A           | B             | C               |
|----|-------------|---------------|-----------------|
|  1 | GND         | GND           | GND             |
|  2 | +12V_SW     | +12V_SW       | +12V_SW         |
|  3 | GND         | GND           | GND             |
|  4 | +12V_SW     | +12V_SW       | +12V_SW         |
|  5 | GND         | GND           | GND             |
|  6 | +5V_SW      | +5V_SW        | +5V_SW          |
|  7 | GND         | GND           | GND             |
|  8 | +5V_SW      | +5V_SW        | +5V_SW          |
|  9 | GND         | GND           | GND             |
| 10 | +3V3_SW     | +3V3_SW       | +3V3_SW         |
| 11 | GND         | GND           | GND             |
| 12 | +1V8_SW     | +1V8_SW       | +1V8_SW         |
| 13 | +12V        | +3V3          | +1V8            |
| 14 | GND         | GND           | GND             |
| 15 | DUT_OPTO_4C | +5V           | I2C_SIB_3V3_SCL |
| 16 | DUT_OPTO_3C | GND           | I2C_SIB_3V3_SDA |
| 17 | DUT_OPTO_2C | MIB_VIO       | DUT_OPTO_2E     |
| 18 | DUT_OPTO_1C | GND           | DUT_OPTO_1E     |
| 19 | DUT_RST     | DDT_CS        | I2C_MIB_VIO_SCL |
| 20 | DUT_PWR     | DDT_SCK       | I2C_MIB_VIO_SDA |
| 21 | GND         | DDT_MISO      | GND             |
| 22 | DDT_GPIO_9  | DDT_MOSI      | SIB_UART1_CTS   |
| 23 | DDT_GPIO_8  | GND           | SIB_UART1_RTS   |
| 24 | DDT_GPIO_7  | SIB_USB_H2_DM | SIB_UART1_TX    |
| 25 | DDT_GPIO_6  | SIB_USB_H2_DP | SIB_UART1_RX    |
| 26 | GND         | GND           | GND             |
| 27 | DDT_GPIO_5  | SIB_USB_H1_DM | SIB_UART3_TX    |
| 28 | DDT_GPIO_4  | SIB_USB_H1_DP | SIB_UART3_RX    |
| 29 | DDT_GPIO_3  | GND           | GND             |
| 30 | DDT_GPIO_2  | DDT_CAN_L     | SIB_UART4_TX    |
| 31 | DDT_GPIO_1  | DDT_CAN_H     | SIB_UART4_RX    |
| 32 | GND         | GND           | GND             |

:::{admonition} Header orientation
:class: warning
When using hardware design tools, the model for the SIB header is labeled the
over way around!
:::

## Software usage

### CAN

The CAN bus is available as `can0` network interface. Use any CAN aware tools
like `can-utils` to interact on the bus.

### GPIOs

Two gpios are available to toggle buttons. They can be controlled with:

```shell
laam laacli button reset on
laam laacli button reset off
```

The available GPIOs are:

* `DUT_RST`: `reset` button
* `DUT_PWR`: `power` button

### I²C

The header provides 2 I²C:
* `I2C_SIB_3V3_SCL` and `I2C_SIB_3V3_SDA` at 3v3
* `I2C_MIB_VIO_SCL` and `I2C_MIB_VIO_SDA` at `MIB_VIO` reference voltage (from 0V to 5V).

### Optocouplers

Two optocouplers are available to toggle on and off virtual buttons. The
buttons can be controlled with:

```shell
laam laacli button 1 on
laam laacli button 1 off
```

The available optocouplers are:

* `DUT_OPTO_1C` and `DUT_OPTO_1E`: virtual button `1`
* `DUT_OPTO_2C` and `DUT_OPTO_2E`: virtual button `2`

:::{admonition} Unused pins
:class: note
`DUT_OPTO_3C` and `DUT_OPTO_4C` are not used.
:::

### Power rails

The power pins, flagged with `_SW`, are managed power rails that can be
controlled by [laam](/software/laam_console.md#laacli):

```shell
laam laacli power 12v on
laam laacli power 12v off
laam laacli power 12v reset
```

The header provides 4 power rails: 1v8, 3v3, 5v and 12v.

:::{admonition} Delivered power
:class: note
The power rail maximum power are listed in this table:

| Power rail | Max Amp (A) | Max Power (W) |
|------------|-------------|---------------|
|        1v8 |          1A |          1.8W |
|        3v3 |          2A |          6.6W |
|         5v |          3A |           15W |
|        12v |          3A |           36W |
:::

:::{admonition} Over Current Protecting
:class: warning
As mentioned in the table above, the LAA should not deliver more than 3A.

The LAA runs a software (soft) and hardware (hard) Over Current Protecting
(OCP) mechanism to protect the LAA and the attached DUT if the DUT draw more
power than expected.

If soft OCP is triggered, the power rails will be shutdown and a message will
be printed on every telnet and ssh sessions.

If hard OCP is triggered, the LAA will be shutdown immediately.

The soft OCP should be triggered faster than the hard OCP but under some
circumstances, the hard OCP might be triggered anyway.
:::

### Power rails power

The instant power consumption of each power rail is monitored and can be
queried by [laam](/software/laam_console.md#laacli):

```shell
laam laacli watt 12v
laam laacli watt 3v3
```

### Serials

The header provides 3 set of serials:

* `SIB_UART1` as `/dev/ttycmx0`: DUT serial with hardware flow control
* `SIB_UART3` as `/dev/ttycmx2`: LAA serial
* `SIB_UART4` as `/dev/ttycmx3`: DUT serial

`SIB_UART4` is also available via telnet:
`SIB_UART4` is also available via [laam](/software/laam_console.md#serials) or telnet:

```shell
laam serials connect ttymxc3
telnet localhost 2000
```

### SPI

The header provides one SPI: `DDT_CS`, `DDT_SCK`, `DDT_MISO` and `DDT_MISO`.

### USBs

The header provide 2 USB ports that are always on at:

* `SIB_USB_H1_DM` and `SIB_USB_H1_DP`
* `SIB_USB_H2_DM` and `SIB_USB_H2_DP`