> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 40 针低速连接器

Dragonwing IQ8-EVK 包含一个低速连接器(JLS1),可访问各种 GPIO、CAN、QUP 及其他接口。

## 引脚定义

下图显示了 IQ-8275 EVK 40 针 LS 连接器的默认功能。

<img src="https://mintcdn.com/qualcomm-staging/5j1H6H_NhFpsAqlq/Ubuntu/images/peripheral-interfaces/40-pin-LS-details.png?fit=max&auto=format&n=5j1H6H_NhFpsAqlq&q=85&s=f258b61c66017c5da976eee51ca69dab" width="1639" height="1050" data-path="Ubuntu/images/peripheral-interfaces/40-pin-LS-details.png" />

<img src="https://mintcdn.com/qualcomm-staging/5j1H6H_NhFpsAqlq/Ubuntu/images/peripheral-interfaces/LS-connector-functional_details.png?fit=max&auto=format&n=5j1H6H_NhFpsAqlq&q=85&s=7f60701e2aeff07d3046e5bbad4fffb4" width="1449" height="834" data-path="Ubuntu/images/peripheral-interfaces/LS-connector-functional_details.png" />

## GPIO

<Note>
  以下命令需要 root 权限。使用 `sudo su` 切换到 root 用户。
</Note>

### 识别 GPIO 子系统编号

运行以下命令并查找 `platform/f000000.pinctrl`(gpiochip4)来识别 GPIO 基础编号。对于 IQ-8275,基础编号为 **560**。

```bash theme={null}
cat /sys/kernel/debug/gpio
```

**示例:** 对于 LS 连接器引脚 5,GPIO 编号为 54。GPIO 子系统编号为:560 + 54 = **614**。

<img src="https://mintcdn.com/qualcomm-staging/5j1H6H_NhFpsAqlq/Ubuntu/images/peripheral-interfaces/LS-connector-subsystem_gpio.png?fit=max&auto=format&n=5j1H6H_NhFpsAqlq&q=85&s=5f09387b824d3cb276a97cc455740dad" width="921" height="893" data-path="Ubuntu/images/peripheral-interfaces/LS-connector-subsystem_gpio.png" />

### 通过 sysfs 控制 GPIO

<Steps>
  <Step title="导出 GPIO">
    ```bash theme={null}
    cd /sys/class/gpio
    echo 614 > export
    ```
  </Step>

  <Step title="配置方向和值">
    ```bash theme={null}
    cd gpio614
    echo out > direction
    echo 1 > value
    ```

    | 属性          | 值                                |
    | ----------- | -------------------------------- |
    | `direction` | `in`(输入)、`out`(输出)               |
    | `value`     | `0`(低电平)、`1`(高电平)                |
    | `edge`      | `rising`、`falling`、`both`、`none` |
  </Step>

  <Step title="完成后取消导出">
    ```bash theme={null}
    cd ..
    echo 614 > unexport
    ```
  </Step>
</Steps>

### GPIO 代码示例

<Tabs>
  <Tab title="C">
    将引脚 5 设置为输出,引脚 7 设置为输入,并循环检测引脚 7 的电平。

    <Steps>
      <Step title="编译">
        ```bash theme={null}
        gcc gpio.c -o gpio
        ```
      </Step>

      <Step title="连接引脚并运行">
        使用杜邦线将引脚 5 和引脚 7 短接。

        <Warning>
          注意引脚顺序。请勿短接电源和接地引脚——这可能会损坏开发板。
        </Warning>

        ```bash theme={null}
        ./gpio
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Python">
    安装 `python3-periphery`:

    ```bash theme={null}
    apt install python3-periphery
    ```

    <Steps>
      <Step title="连接引脚并运行">
        使用杜邦线将引脚 5 和引脚 7 短接。

        <Warning>
          注意引脚顺序。请勿短接电源和接地引脚——这可能会损坏开发板。
        </Warning>

        ```bash theme={null}
        python3 gpio.py
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## UART

引脚 5 和 7 默认配置为 UART(GPIO 线 54 和 55,映射到 `uart12 = qup1_se5 (0xa98000)`)。

按照[修改串行引擎节点](./peripheral_interface_overview#modify-serial-engine-node)步骤启用 UART 接口。启用后,设备节点显示在 `/dev/ttyHS3`。

<Tabs>
  <Tab title="Shell">
    <Steps>
      <Step title="连接引脚">
        使用杜邦线将引脚 5 和引脚 7 短接。
        <Warning>请勿短接电源和接地引脚。</Warning>
      </Step>

      <Step title="配置 UART">
        ```bash theme={null}
        sudo stty -F /dev/ttyHS3 ispeed 115200 ospeed 115200
        sudo stty -F /dev/ttyHS3 115200 -echo -icanon -isig -iexten -icrnl -ixon -opost
        ```
      </Step>

      <Step title="打开两个 SSH 终端">
        **终端 1(RX):** `sudo cat /dev/ttyHS3`

        **终端 2(TX):** `echo "hello world!" > /dev/ttyHS3`
      </Step>
    </Steps>
  </Tab>
</Tabs>

## I2C

引脚 8 和 10 默认配置为 I2C(GPIO 线 32 和 33,映射到 `i2c4 = qup0_se4 (0x990000)`)。

按照[修改串行引擎节点](./peripheral_interface_overview#modify-serial-engine-node)步骤启用 I2C 接口。

```bash theme={null}
ls /dev/i2c*
sudo apt install -y i2c-tools
i2cdetect -l
i2cdetect -a -y -r 20
```

## SPI

引脚 11 和 13 默认配置为 SPI(GPIO 线 44 和 45,映射到 `spi10 = qup1_se3 (0xa8c000)`)。

按照[修改串行引擎节点](./peripheral_interface_overview#modify-serial-engine-node)步骤启用 SPI 接口。

```bash theme={null}
sudo apt install python3-spidev
```