Skip to content

Commit 769947d

Browse files
author
Tang ZZ
committed
docs: add Dragon Q8B 40-pin GPIO guide
1 parent 3412910 commit 769947d

4 files changed

Lines changed: 154 additions & 2 deletions

File tree

‎docs/dragon/q8b/hardware-use/m2-e-key.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 9
2+
sidebar_position: 10
33
---
44

55
# M.2 E Key 2230 卡槽

‎docs/dragon/q8b/hardware-use/pin-gpio.md‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
---
2+
sidebar_position: 9
3+
---
4+
5+
# 40 Pin GPIO 接口
6+
7+
瑞莎 Dragon Q8B 板载 40-Pin GPIO（通用输入输出）接口，为硬件扩展提供了高度灵活的接口支持。
8+
9+
用户可以通过 40-Pin GPIO 接口连接各类传感器、执行器、通信模块、显示屏以及其他嵌入式外设，从而快速实现物联网（IoT）、机器人控制、工业自动化等领域的原型开发与功能验证。
10+
11+
<div style={{textAlign: 'center'}}>
12+
<img src="/img/dragon/q8b/q8b_gpio.webp" style={{width: '100%', maxWidth: '1200px'}} />
13+
</div>
14+
15+
:::danger
16+
使用 40-Pin GPIO 接口时，请注意引脚和外设的接线，请确保引脚连接正确，不当操作可能导致设备硬件损坏。
17+
:::
18+
19+
## GPIO 功能
20+
21+
Dragon Q8B 支持通过板载 GPIO 引脚连接外部设备，并支持 UART、SPI、I2C 等多种复用功能。
22+
23+
<TabItem value="Dragon Q8B">
24+
<div className='gpio_style' style={{ overflow :"auto"}} >
25+
| Function4 | Function3 | Function2 | Function1 | Function0 | Pin# | Pin# | Function0 | Function1 | Function2 | Function3 |
26+
|:---------------:|:-------------:|:-----------------:|:--------------:|:---------:|:--------------------------------:|:-------------------------------:|:---------:|:------------:|:-----------------:|:-------------:|
27+
| | | | | 3V3 | <div className='yellow'>1</div> | <div className='red'>2</div> | 5V | | | |
28+
| | SPI9_MISO | UART9_CTS | I2C9_SDA | GPIO_41 | <div className='green'>3</div> | <div className='red'>4</div> | 5V | | | |
29+
| | SPI9_MOSI | UART9_RFR | I2C9_SCL | GPIO_42 | <div className='green'>5</div> | <div className='black'>6</div> | GND | | | |
30+
| | | | SPI4_CS_3 | GPIO_175 | <div className='green'>7</div> | <div className='green'>8</div> | GPIO_63 | UART17_TX | | |
31+
| | | | | GND | <div className='black'>9</div> | <div className='green'>10</div> | GPIO_64 | UART17_RX | | |
32+
| | SPI4_CS_1 | | I2C5_SDA | GPIO_111 | <div className='green'>11</div> | <div className='green'>12</div> | GPIO_174 | UART4_RX | SPI4_CS_0 | |
33+
| HS-UART18_CTS | SPI18_MISO | UART18_CTS | I2C18_SDA | GPIO_66 | <div className='green'>13</div> | <div className='black'>14</div> | GND | | | |
34+
| HS-UART18_RFR | SPI18_MOSI | UART18_RFR | I2C18_SCL | GPIO_67 | <div className='green'>15</div> | <div className='green'>16</div> | GPIO_68 | UART18_TX | SPI18_SCKL | HS-UART18_TX |
35+
| | | | | 3.3V | <div className='yellow'>17</div> | <div className='green'>18</div> | GPIO_110 | | | |
36+
| | SPI20_MOSI | UART20_RFR | I2C20_SCL | GPIO_88 | <div className='green'>19</div> | <div className='black'>20</div> | GND | | | |
37+
| | SPI20_MISO | UART20_CTS | I2C20_SDA | GPIO_87 | <div className='green'>21</div> | <div className='green'>22</div> | GPIO_92 | SPI20_CS_2 | | |
38+
| | | SPI20_SCKL | UART20_TX | GPIO_89 | <div className='green'>23</div> | <div className='green'>24</div> | GPIO_90 | UART20_RX | SPI20_CS_0 | |
39+
| | | | | GND | <div className='black'>25</div> | <div className='green'>26</div> | GPIO_91 | SPI20_CS_1 | | |
40+
| | SPI9_SCKL | UART9_TX | I2C8_SDA | GPIO_43 | <div className='blue'>27</div> | <div className='blue'>28</div> | GPIO_44 | I2C8_SCL | UART9_RX | SPI9_CS_0 |
41+
| | | SPI6_CS_0 | UART6_RX | GPIO_157 | <div className='green'>29</div> | <div className='black'>30</div> | GND | | | |
42+
| | | SPI6_SCKL | UART6_TX | GPIO_156 | <div className='green'>31</div> | <div className='green'>32</div> | GPIO_114 | CCI_I2C_SCL0 | GCC_GP2_CLK_MIRA | |
43+
| | | GCC_GP3_CLK_MRIA | CCI_I2C_SDA1 | GPIO_115 | <div className='green'>33</div> | <div className='black'>34</div> | GND | | | |
44+
| | SPI4_MISO | UART4_CTS | I2C4_SDA | GPIO_171 | <div className='green'>35</div> | <div className='green'>36</div> | GPIO_112 | I2C5_SCL | SPI4_CS_2 | |
45+
| | HS-UART18_RX | SPI18_CS_0 | UART18_RX | GPIO_69 | <div className='green'>37</div> | <div className='green'>38</div> | GPIO_172 | I2C4_SCL | UART4_RFR | SPI4_MOSI |
46+
| | | | | GND | <div className='black'>39</div> | <div className='green'>40</div> | GPIO_173 | UART4_TX | SPI4_SCKL | |
47+
</div>
48+
</TabItem>
49+
50+
## GPIO 使用
51+
52+
GPIO 控制器的设备编号和引脚偏移量可能随系统镜像或内核版本变化。控制 GPIO 前，请先确认当前系统中的 GPIO 控制器及对应引脚信息。
53+
54+
### 安装工具
55+
56+
<NewCodeBlock tip="radxa@dragon-q8b$" type="device">
57+
58+
```bash
59+
sudo apt update
60+
sudo apt install -y gpiod python3-periphery
61+
```
62+
63+
</NewCodeBlock>
64+
65+
### 确认 GPIO 控制器
66+
67+
<NewCodeBlock tip="radxa@dragon-q8b$" type="device">
68+
69+
```bash
70+
gpiodetect
71+
gpioinfo
72+
```
73+
74+
</NewCodeBlock>
75+
76+
根据命令输出确认目标 GPIO 所属的 `/dev/gpiochipN` 和 line offset 后，再通过 `libgpiod` 或 `python-periphery` 控制对应引脚。请勿直接套用其他主板的 GPIO 控制器编号和引脚偏移量。

‎i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/hardware-use/m2-e-key.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 9
2+
sidebar_position: 10
33
---
44

55
# M.2 E Key 2230 Slot

‎i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/hardware-use/pin-gpio.md‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
---
2+
sidebar_position: 9
3+
---
4+
5+
# 40-Pin GPIO Interface
6+
7+
The Radxa Dragon Q8B features an onboard 40-pin GPIO (General-Purpose Input/Output) interface, providing highly flexible interface support for hardware expansion.
8+
9+
Users can connect various sensors, actuators, communication modules, displays, and other embedded peripherals via the 40-pin GPIO interface, enabling rapid prototyping and functional verification in fields such as the Internet of Things (IoT), robotics control, and industrial automation.
10+
11+
<div style={{textAlign: 'center'}}>
12+
<img src="/img/dragon/q8b/q8b_gpio.webp" style={{width: '100%', maxWidth: '1200px'}} />
13+
</div>
14+
15+
:::danger
16+
When using the 40-pin GPIO interface, pay attention to the wiring of the pins and peripherals, and ensure that the pins are connected correctly. Improper operation may result in damage to the device hardware.
17+
:::
18+
19+
## GPIO Functions
20+
21+
Dragon Q8B supports connecting external devices to the onboard GPIO pins and provides multiple multiplexed functions, including UART, SPI, and I2C.
22+
23+
<TabItem value="Dragon Q8B">
24+
<div className='gpio_style' style={{ overflow :"auto"}} >
25+
| Function4 | Function3 | Function2 | Function1 | Function0 | Pin# | Pin# | Function0 | Function1 | Function2 | Function3 |
26+
|:---------------:|:-------------:|:-----------------:|:--------------:|:---------:|:--------------------------------:|:-------------------------------:|:---------:|:------------:|:-----------------:|:-------------:|
27+
| | | | | 3V3 | <div className='yellow'>1</div> | <div className='red'>2</div> | 5V | | | |
28+
| | SPI9_MISO | UART9_CTS | I2C9_SDA | GPIO_41 | <div className='green'>3</div> | <div className='red'>4</div> | 5V | | | |
29+
| | SPI9_MOSI | UART9_RFR | I2C9_SCL | GPIO_42 | <div className='green'>5</div> | <div className='black'>6</div> | GND | | | |
30+
| | | | SPI4_CS_3 | GPIO_175 | <div className='green'>7</div> | <div className='green'>8</div> | GPIO_63 | UART17_TX | | |
31+
| | | | | GND | <div className='black'>9</div> | <div className='green'>10</div> | GPIO_64 | UART17_RX | | |
32+
| | SPI4_CS_1 | | I2C5_SDA | GPIO_111 | <div className='green'>11</div> | <div className='green'>12</div> | GPIO_174 | UART4_RX | SPI4_CS_0 | |
33+
| HS-UART18_CTS | SPI18_MISO | UART18_CTS | I2C18_SDA | GPIO_66 | <div className='green'>13</div> | <div className='black'>14</div> | GND | | | |
34+
| HS-UART18_RFR | SPI18_MOSI | UART18_RFR | I2C18_SCL | GPIO_67 | <div className='green'>15</div> | <div className='green'>16</div> | GPIO_68 | UART18_TX | SPI18_SCKL | HS-UART18_TX |
35+
| | | | | 3.3V | <div className='yellow'>17</div> | <div className='green'>18</div> | GPIO_110 | | | |
36+
| | SPI20_MOSI | UART20_RFR | I2C20_SCL | GPIO_88 | <div className='green'>19</div> | <div className='black'>20</div> | GND | | | |
37+
| | SPI20_MISO | UART20_CTS | I2C20_SDA | GPIO_87 | <div className='green'>21</div> | <div className='green'>22</div> | GPIO_92 | SPI20_CS_2 | | |
38+
| | | SPI20_SCKL | UART20_TX | GPIO_89 | <div className='green'>23</div> | <div className='green'>24</div> | GPIO_90 | UART20_RX | SPI20_CS_0 | |
39+
| | | | | GND | <div className='black'>25</div> | <div className='green'>26</div> | GPIO_91 | SPI20_CS_1 | | |
40+
| | SPI9_SCKL | UART9_TX | I2C8_SDA | GPIO_43 | <div className='blue'>27</div> | <div className='blue'>28</div> | GPIO_44 | I2C8_SCL | UART9_RX | SPI9_CS_0 |
41+
| | | SPI6_CS_0 | UART6_RX | GPIO_157 | <div className='green'>29</div> | <div className='black'>30</div> | GND | | | |
42+
| | | SPI6_SCKL | UART6_TX | GPIO_156 | <div className='green'>31</div> | <div className='green'>32</div> | GPIO_114 | CCI_I2C_SCL0 | GCC_GP2_CLK_MIRA | |
43+
| | | GCC_GP3_CLK_MRIA | CCI_I2C_SDA1 | GPIO_115 | <div className='green'>33</div> | <div className='black'>34</div> | GND | | | |
44+
| | SPI4_MISO | UART4_CTS | I2C4_SDA | GPIO_171 | <div className='green'>35</div> | <div className='green'>36</div> | GPIO_112 | I2C5_SCL | SPI4_CS_2 | |
45+
| | HS-UART18_RX | SPI18_CS_0 | UART18_RX | GPIO_69 | <div className='green'>37</div> | <div className='green'>38</div> | GPIO_172 | I2C4_SCL | UART4_RFR | SPI4_MOSI |
46+
| | | | | GND | <div className='black'>39</div> | <div className='green'>40</div> | GPIO_173 | UART4_TX | SPI4_SCKL | |
47+
</div>
48+
</TabItem>
49+
50+
## GPIO Usage
51+
52+
The GPIO controller device number and line offset may vary between system images or kernel versions. Before controlling a GPIO, identify the GPIO controller and line information exposed by the current system.
53+
54+
### Install Tools
55+
56+
<NewCodeBlock tip="radxa@dragon-q8b$" type="device">
57+
58+
```bash
59+
sudo apt update
60+
sudo apt install -y gpiod python3-periphery
61+
```
62+
63+
</NewCodeBlock>
64+
65+
### Identify the GPIO Controller
66+
67+
<NewCodeBlock tip="radxa@dragon-q8b$" type="device">
68+
69+
```bash
70+
gpiodetect
71+
gpioinfo
72+
```
73+
74+
</NewCodeBlock>
75+
76+
Use the command output to determine the `/dev/gpiochipN` device and line offset for the target GPIO before controlling it with `libgpiod` or `python-periphery`. Do not reuse GPIO controller numbers or line offsets from another board.

0 commit comments

Comments
 (0)