BOM-DAT/CONN-DAT/CONN-DC-barrel-jack-dat/CONN-DC-barrel-jack-dat.md
... ...
@@ -0,0 +1,9 @@
1
+
2
+# CONN-DC-barrel-jack-dat
3
+
4
+1. Barrel Jack Size (Diameter/Length)
5
+
6
+- 5.5mm x 2.1mm: The most common size used for many consumer electronics, including CCTV cameras, routers, and small gadgets.
7
+- 5.5mm x 2.5mm: Slightly larger than the 2.1mm and often used in higher-power devices like audio equipment.
8
+- 4.0mm x 1.7mm: A smaller size typically used for more compact devices like some wireless routers or small portable electronics.
9
+- 7.4mm x 5.0mm: A larger size often used for laptops and some larger equipment.
... ...
\ No newline at end of file
BOM-DAT/fuse-dat/fuse-dat.md
... ...
@@ -0,0 +1,8 @@
1
+
2
+# fuse-dat
3
+
4
+
5
+
6
+## ref
7
+
8
+- [[fuse]]
... ...
\ No newline at end of file
BOM-DAT/spacer-dat/buffer-spacer-dat/2024-11-26-11-59-48.png
... ...
Binary files /dev/null and b/BOM-DAT/spacer-dat/buffer-spacer-dat/2024-11-26-11-59-48.png differ
BOM-DAT/spacer-dat/buffer-spacer-dat/2024-11-26-12-00-05.png
... ...
Binary files /dev/null and b/BOM-DAT/spacer-dat/buffer-spacer-dat/2024-11-26-12-00-05.png differ
BOM-DAT/spacer-dat/buffer-spacer-dat/2024-11-26-12-02-15.png
... ...
Binary files /dev/null and b/BOM-DAT/spacer-dat/buffer-spacer-dat/2024-11-26-12-02-15.png differ
BOM-DAT/spacer-dat/buffer-spacer-dat/2024-11-26-12-02-28.png
... ...
Binary files /dev/null and b/BOM-DAT/spacer-dat/buffer-spacer-dat/2024-11-26-12-02-28.png differ
BOM-DAT/spacer-dat/buffer-spacer-dat/buffer-spacer-dat.md
... ...
@@ -0,0 +1,11 @@
1
+
2
+# rubber-feet-dat
3
+
4
+
5
+![](2024-11-26-11-59-48.png)
6
+
7
+![](2024-11-26-12-00-05.png)
8
+
9
+![](2024-11-26-12-02-15.png)
10
+
11
+![](2024-11-26-12-02-28.png)
... ...
\ No newline at end of file
Board-dat/AMP/AMP1006-dat/AMP1006-dat.md
... ...
@@ -11,11 +11,18 @@
11 11
![](2024-09-05-17-05-06.png)
12 12
13 13
Seperated LDO power supply for:
14
-- AVDD
15
-- DVDD
14
+- AVDD = LDO x1
15
+- DVDD = LDO x3
16 16
- 3V3 - CPVDD
17 17
18 18
19
+## Function setup
20
+
21
+- XSMT - pull high = Left justified (High)
22
+- FMT - pull ground = Soft mute (Low)
23
+- FLT - pull ground = Normal latency (Low)
24
+- DEMP - pull ground = De-emphasis control for 44.1kHz sampling rate(1): Off (Low)
25
+
19 26
## Logs
20 27
21 28
- R2 version silghly change board layout, all functions remain the same.
... ...
@@ -25,6 +32,5 @@ Seperated LDO power supply for:
25 32
26 33
- [[PCM5102-dat]]
27 34
28
-
29
-- [[bt-audio-dat]]
35
+- [[I2S-dat]]
30 36
Board-dat/DAR/DARS017-dat/2024-12-02-16-01-42.png
... ...
Binary files /dev/null and b/Board-dat/DAR/DARS017-dat/2024-12-02-16-01-42.png differ
Board-dat/DAR/DARS017-dat/DARS017-dat.md
... ...
@@ -0,0 +1,11 @@
1
+
2
+# DARS017-dat
3
+
4
+## Board map
5
+
6
+![](2024-12-02-16-01-42.png)
7
+
8
+
9
+## ref
10
+
11
+- [[DARS017]]
... ...
\ No newline at end of file
Board-dat/ILS/ILSS007-dat/ILSS007-dat.md
... ...
@@ -3,4 +3,9 @@
3 3
4 4
- 3 M version
5 5
6
-- [[led-strip-dat]]
... ...
\ No newline at end of file
0
+- [[led-strip-dat]]
1
+
2
+
3
+## ref
4
+
5
+- [[ILSS007]]
... ...
\ No newline at end of file
Board-dat/ILS/ILSS008-dat.md
... ...
@@ -1,18 +0,0 @@
1
-
2
-# ILSS008
3
-
4
-- [[led-strip-dat]]
5
-
6
-5050 RGB LED Strips, 60 LEDs/M [Meters]
7
-
8
-1M
9
-- [[ILSS006-dat]]
10
-
11
-
12
-3M
13
-- [[ILSS007-dat]]
14
-
15
-5M
16
-- [[ILSS008-dat]]
17
-- https://www.electrodragon.com/product/rgb-5050-led-strips-60-ledsm/?attribute_pa_length2=5-meters
18
-
Board-dat/ILS/ILSS008-dat/ILSS008-dat.md
... ...
@@ -0,0 +1,20 @@
1
+
2
+# ILSS008
3
+
4
+- [[led-strip-dat]]
5
+
6
+5050 RGB LED Strips, 60 LEDs/M [Meters]
7
+
8
+1M
9
+- [[ILSS006-dat]]
10
+
11
+
12
+3M
13
+- [[ILSS007-dat]]
14
+
15
+5M
16
+- [[ILSS008-dat]]
17
+
18
+- https://www.electrodragon.com/product/rgb-5050-led-strips-60-ledsm/?attribute_pa_length2=5-meters
19
+
20
+
Board-dat/ILS/ILSS013-dat.md
... ...
@@ -1,12 +0,0 @@
1
-
2
-# ILSS013-dat.md
3
-
4
-Super Light LED Strip (White), 60 LEDs/M [Meters]
5
-
6
-
7
-
8
-ILSS011 - 1M
9
-
10
-ILSS012 - 3M
11
-
12
-ILSS013 - 5M
... ...
\ No newline at end of file
Board-dat/ILS/ILSS013-dat/ILSS013-dat.md
... ...
@@ -0,0 +1,14 @@
1
+
2
+# ILSS013-dat.md
3
+
4
+Super Light LED Strip (White), 60 LEDs/M [Meters]
5
+
6
+
7
+
8
+ILSS011 - 1M
9
+
10
+ILSS012 - 3M
11
+
12
+ILSS013 - 5M
13
+
14
+- [[led-strip-dat]]
... ...
\ No newline at end of file
Board-dat/IMS/IMS1009-dat/IMS1009-dat.md
... ...
@@ -16,15 +16,15 @@
16 16
17 17
## Kit BOM
18 18
19
-| Item | usage |
20
-| -------------------------------------- | ------------------------------------------------------------- |
21
-| PCB x3 | pre-connected (chained) 3x PCB |
22
-| 8x8 Dot LED matrix super bright RED | main display parts |
23
-| 5pcs jumpers | connect to the next chain |
24
-| 1*5 bended and 1*5 straight pin header | connect to the next chain |
25
-| 3pcs 1*20 socket pin headers | please break them into 6pcs 1*8 pin header for dot led matrix |
19
+| Item | qty. | usage |
20
+| -------------------------------------- | ------ | ------------------------------------------------------------- |
21
+| PCB x3 | x1 | pre-connected (chained) 3x PCB |
22
+| 8x8 Dot LED matrix super bright RED | x3 | main display parts |
23
+| 5pcs jumpers | x5 | connect to the next chain |
24
+| 1*5 bended and 1*5 straight pin header | x1, x1 | connect to the next chain |
25
+| 3pcs 1*20 socket pin headers | x3 | please break them into 6pcs 1*8 pin header for dot led matrix |
26 26
27 27
28 28
## ref
29 29
30
-- [[IMS1009]]
... ...
\ No newline at end of file
0
+- [[IMS1009-fab]]
... ...
\ No newline at end of file
Board-dat/MPC/MPC1073-DAT/MPC1073-DAT.md
... ...
@@ -14,7 +14,7 @@ https://www.electrodragon.com/product/rgb-matrix-panel-drive-board-raspberry-pi/
14 14
Output Control Chains
15 15
- TOP - P0
16 16
- Middle - P1
17
-- Bottom - P3
17
+- Bottom - P3 (typo or P2 )
18 18
19 19
JP3 Power Supply Pins
20 20
- 3.3V
... ...
@@ -49,6 +49,8 @@ JP1 / JP2 / JP3
49 49
- code: https://github.com/hzeller/rpi-rgb-led-matrix
50 50
- board: https://github.com/hzeller/rpi-rgb-led-matrix/tree/master/adapter
51 51
52
+- [[rpi-dat]]
53
+
52 54
### C execute file
53 55
54 56
clone project, build the binary executable file, and use following commands
Board-dat/MPC/MPC1073-DAT/MPC1073-OS-error.md
... ...
@@ -8,4 +8,11 @@ We had feedback from other customers about this
8 8
9 9
please also read in reviews
10 10
11
-- https://www.electrodragon.com/product/rgb-matrix-panel-drive-board-raspberry-pi/
11
+https://www.electrodragon.com/product/rgb-matrix-panel-drive-board-raspberry-pi/
12
+
13
+
14
+ Chao (store manager) – February 27, 2020
15
+
16
+ Hi, please double check the power supply, you need a lab power at least 3-4A. We never have this problem before, not yet sure what or where is wrong. If problem still not solve please email us info@electrodragon.com.
17
+
18
+ Here is another post to use RPI4, RPI4 should be no problem: https://iot-for-maker.blogspot.com/2020/02/led-5-raspberry-pi-4-dietpi-buster.html
Board-dat/MPC/MPC1073-DAT/MPC1073-test-log-dat/MPC1073-test-log-dat.md
... ...
@@ -1,6 +1,15 @@
1 1
2 2
# MPC1073-test-log-dat.md
3 3
4
+
5
+## Make first
6
+
7
+make it
8
+
9
+ make -C examples-api-use
10
+
11
+
12
+
4 13
## P8 P10 Outdoor 32x16 == tested = OK
5 14
6 15
Run example for our selling 32x16 panel
... ...
@@ -88,3 +97,16 @@ cmd
88 97
89 98
90 99
100
+## Sounds cards
101
+
102
+=== snd_bcm2835: found that the Pi sound module is loaded. ===
103
+Don't use the built-in sound of the Pi together with this lib; it is known to be
104
+incompatible and cause trouble and hangs (you can still use external USB sound adapters).
105
+
106
+See Troubleshooting section in README how to disable the sound module.
107
+You can also run with --led-no-hardware-pulse to avoid the incompatibility,
108
+but you will have more flicker.
109
+Exiting; fix the above first or use --led-no-hardware-pulse
110
+
111
+
112
+ ./examples-api-use/demo -D 0 --led-cols=32 --led-rows=16 --led-multiplexing=8 --led-no-hardware-pulse
... ...
\ No newline at end of file
Board-dat/MPC/MPC1083-dat/MPC1083-dat.md
... ...
@@ -15,6 +15,11 @@ ADR1 = pull-up, ADR2 = pull-down
15 15
16 16
17 17
18
+
19
+
20
+
18 21
## ref
19 22
23
+- [[PCM5122-dat]] - [[TI-dat]]
24
+
20 25
- [[I2S-dat]] - [[I2C-dat]]
... ...
\ No newline at end of file
Board-dat/MPC/MPC1108-dat/MPC1108-dat.md
... ...
@@ -8,11 +8,14 @@
8 8
9 9
## Function
10 10
11
-### Fan control by
11
+### Fan control by three options
12 12
13 13
- LM ALRAM (NAND_A)
14
-- GPIO12 (NAND_B)
15
-- Switch (NAND_B)
14
+- GPIO12 (NAND_B either gate )
15
+- Manual switch (NAND_B either gate )
16
+
17
+
18
+
16 19
17 20
### Temperature sensor
18 21
... ...
@@ -23,6 +26,14 @@
23 26
24 27
Note when use this board and external 12V power supply to DC jack, you should NOT use micro USB power anymore, otherwise it can damage board.
25 28
29
+
30
+
31
+
32
+
33
+
26 34
## ref
27 35
28
-- [[MPC1108]]
... ...
\ No newline at end of file
0
+- [[dcdc-buck-dat]]
1
+
2
+- [[MPC1108]]
3
+
Board-dat/MPC/MPC1130-dat/2024-12-08-17-13-39.png
... ...
Binary files /dev/null and b/Board-dat/MPC/MPC1130-dat/2024-12-08-17-13-39.png differ
Board-dat/MPC/MPC1130-dat/2024-12-08-17-15-49.png
... ...
Binary files /dev/null and b/Board-dat/MPC/MPC1130-dat/2024-12-08-17-15-49.png differ
Board-dat/MPC/MPC1130-dat/MPC1130-dat.md
... ...
@@ -0,0 +1,29 @@
1
+
2
+# MPC1130-dat
3
+
4
+- board use guide please refer to page [[RMP-driver-dat]]
5
+
6
+https://www.electrodragon.com/product/rpi-passive-3ch-rgb-matrix-drive-board-v0/
7
+
8
+## Board map
9
+
10
+![](2024-12-08-17-15-49.png)
11
+
12
+- reserved pull resistor for P18 IO1 (not soldered)
13
+
14
+## Extra Pins
15
+
16
+![](2024-12-08-17-13-39.png)
17
+
18
+- ROW_E GND Sel_8 Sel_8 SC
19
+- ROW_E GND Sel_8 Sel_8 SC
20
+
21
+## demo video
22
+
23
+- https://www.youtube.com/shorts/7zcytJmziE4
24
+
25
+## update Logs
26
+
27
+Current version is V0 to quick start
28
+
29
+
Board-dat/MSP/MSP1064-dat/MSP1064-dat.md
... ...
@@ -0,0 +1,17 @@
1
+
2
+# MSP1064-dat
3
+
4
+Schematic please see here.
5
+https://www.electrodragon.com/w/IIC
6
+
7
+
8
+## demo code
9
+
10
+- https://github.com/Edragon/Arduino/tree/master/Sketchbook/11-Interface/PCF
11
+
12
+
13
+## ref
14
+
15
+- [[GPIO-dat]]
16
+
17
+- [[PCF8574-dat]] - [[PCF8591-dat]]
... ...
\ No newline at end of file
Board-dat/MSP/MSP1069-dat/MSP1069-dat.md
... ...
@@ -0,0 +1,12 @@
1
+
2
+# MSP1069-dat
3
+
4
+- chip-hold
5
+
6
+
7
+## ref
8
+
9
+- [[IO-expander]]
10
+
11
+- [[MCP23017-dat]]
12
+
Board-dat/MSP/MSP1072-dat/MSP1072-dat.md
... ...
@@ -11,6 +11,9 @@
11 11
12 12
## ref
13 13
14
-- [[CH423-dat]] - [[WCH-dat]]
14
+- [[CH423-dat]] - [[WCH-dat]]
15
+
16
+- [[GPIO-dat]] - [[I2C-dat]]
17
+
15 18
16 19
- [[MSP1072]]
... ...
\ No newline at end of file
Board-dat/NBL/NBL1038-dat/NBL1038-dat.md
... ...
@@ -6,6 +6,8 @@
6 6
![](2023-11-09-15-41-06.png)
7 7
8 8
9
+
10
+
9 11
## Boards
10 12
11 13
- core board - [[NBL1037-dat]]
Board-dat/NWI/NWI1126-DAT/NWI1126-e1-dat/NWI1126-e1-dat.md
... ...
@@ -0,0 +1,18 @@
1
+
2
+# NWI1126-e1-dat
3
+
4
+
5
+test demo code - https://github.com/Edragon/Arduino-ESP32/blob/master/BSP/NWI/NWI1126/basic-blink-test/basic-blink-test.ino
6
+
7
+
8
+---
9
+
10
+5 of the ESP Control boards are not working as expected. When the outputs for the WRGB channels should be off they are still providing anywhere from 17 to 24 volts when using a 24 v power supply.
11
+
12
+The 5 that work all read 0 V when the channels are disabled.
13
+
14
+I have tried changing some software components but have not solved it.
15
+
16
+Is it possible that some of the mosfets are bad? What can I do to test that there is a hardware issue? If it is a hardware issue would it be possible to get a partial refund?
17
+
18
+
Board-dat/NWI/NWI1241-dat/2024-12-17-18-32-28.png
... ...
Binary files /dev/null and b/Board-dat/NWI/NWI1241-dat/2024-12-17-18-32-28.png differ
Board-dat/NWI/NWI1241-dat/NWI1241-dat.md
... ...
@@ -10,16 +10,12 @@
10 10
11 11
### Pin Definitions of Extra Pins
12 12
13
-I2C Port
14
-* IO21 IO22 GND 3V3 +5V
15 13
16 14
17
-Extra Pin Header Pins:
18
-* GND VBAT +5V +3V3
19
-* IO4 IO16 IO17 IO26
15
+#### battery charger
20 16
17
+Jumper - SJ6 - [[battery-charger-dat]]
21 18
22
-Jumper - SJ6
23 19
- reset of IP5306 together with ESP32
24 20
25 21
... ...
@@ -27,8 +23,32 @@ Network Resistor NR2 / NR3
27 23
- default set for battery volume, indicating by on board LEDs
28 24
- NR2 + SJ2 + SJ3 for IP5306-I2C version only, customize only
29 25
26
+#### MISC
27
+
28
+Extra Pin Header Pins:
29
+
30
+* GND VBAT +5V +3V3
31
+* IO4 IO16 IO17 IO26
32
+
33
+I2C Port - [[I2C-dat]]
34
+
35
+* IO21 IO22 GND 3V3 +5V
36
+
37
+
38
+#### USB
39
+
40
+- [[Serial-dat]] - [[type-c-dat]]
41
+
42
+#### Interactive LCD and audio
43
+
44
+- [[SPI-LCD-dat]]
45
+
46
+- [[audio-dat]]
47
+
30 48
Buttons
31
-- IO33 IO36 IO 39
49
+- programmerable: IO33 IO36 IO 39
50
+
51
+
32 52
33 53
### Define in arduino
34 54
... ...
@@ -63,14 +83,19 @@ Define in [[ESP32-WROVER-dat]] module
63 83
64 84
![](2023-11-15-18-04-36.png)
65 85
86
+New version define in the file User_Setup.h
66 87
88
+![](2024-12-17-18-32-28.png)
67 89
68 90
## Arduino Demo Code
91
+
69 92
* Based on Arduino TFT_eSPI library
70 93
* Add extra pin definitions, demo code please see [here](https://github.com/Edragon/Arduino-ESP32) (Arduino-ESP32/Sketchbook/Display/).
71 94
72 95
* Working demo please search [[contact-dat]] channels
73 96
97
+- https://github.com/Bodmer/TFT_eSPI
98
+
74 99
75 100
## Demo
76 101
Board-dat/NWI/NWI1252-dat/NWI1252-dat.md
... ...
@@ -81,13 +81,14 @@ and reference demo test code - https://github.com/Edragon/Arduino-ESP32/tree/mas
81 81
82 82
## Design logs
83 83
84
-| updates | status | version |
85
-| ---------------------------------- | --------- | ------- |
86
-| changed and moved a few pins | added | V2 |
87
-| simutaniously RS-232 / RS-485 data | added | V2 |
88
-| flipped side DB-9 | added | V2 |
89
-| power reverse protection | added | V1 |
90
-| DC barrel 2.1mm barrel plug | not added | V1 |
84
+| updates | status | version |
85
+| -------------------------------------------- | --------- | ------- |
86
+| changed and moved a few pins | added | V2 |
87
+| seperated RS-232 / RS-485 data LED indicator | added | V2 |
88
+| simutaniously RS-232 / RS-485 data | added | V2 |
89
+| flipped side DB-9 | added | V2 |
90
+| power reverse protection | added | V1 |
91
+| DC barrel 2.1mm barrel plug | not added | V1 |
91 92
92 93
93 94
Board-dat/PPB/PPB0024-dat/PPB0024-dat.md
... ...
@@ -0,0 +1,12 @@
1
+
2
+# PPB0024-dat
3
+
4
+https://www.electrodragon.com/product/prototype-board-5cm-x-7cm-holes-copper-solder-pads/
5
+
6
+size
7
+- 5x7
8
+- 7x9
9
+- 9x15
10
+- 12x18
11
+
12
+
Board-dat/PPB/PPB0024-dat/PPB0025-dat.md
... ...
@@ -0,0 +1,12 @@
1
+
2
+# PPB0024-dat
3
+
4
+https://www.electrodragon.com/product/prototype-board-5cm-x-7cm-holes-copper-solder-pads/
5
+
6
+size
7
+- 5x7
8
+- 7x9
9
+- 9x15
10
+- 12x18
11
+
12
+
Board-dat/PPB/PPB0024-dat/PPB0026-dat.md
Board-dat/PPB/PPB0024-dat/PPB0027-dat.md
Board-dat/SIR/SIR1003-dat/SIR1003-dat.md
... ...
@@ -0,0 +1,17 @@
1
+
2
+# SIR1003-dat
3
+
4
+
5
+## receiver
6
+
7
+- Remote control range: 8-10 meters (the quality of the infrared receiver itself, whether there are obstacles in the middle, etc. will affect the remote control distance)
8
+- Battery: 3V button lithium manganese battery
9
+- Infrared carrier frequency: 38KHz
10
+- Surface material: 0.125mmPET
11
+- Effective life: more than 20,000 times
12
+
13
+## ref
14
+
15
+- [[Infrared-dat]]
16
+
17
+- [[SIR1003]]
... ...
\ No newline at end of file
Board-dat/SSL/SSL1027-dat/SSL1027-SCH-V1.png
... ...
Binary files /dev/null and b/Board-dat/SSL/SSL1027-dat/SSL1027-SCH-V1.png differ
Board-dat/SVC/SVC1035-dat/SVC1035-dat.md
... ...
@@ -14,13 +14,21 @@ Pins Definitions
14 14
- PF
15 15
- TX
16 16
17
+
18
+
17 19
## working principle
18 20
19 21
- current sensing by current Transformer
20 22
- votlage sensing by wire cross through the voltage transformer
21 23
24
+## Sensors
25
+
26
+- [[ZMCT103-dat]] - [[ZMPT107-dat]]
27
+
28
+
29
+
22 30
## ref
23 31
24 32
- [[HLW8032-dat]] - [[HLW-dat]]
25 33
26
-- [[SVC1035]]
... ...
\ No newline at end of file
0
+- [[svc1035]]
... ...
\ No newline at end of file
Board-new-dat/RMP-RPI-CM4-dat/RMP-RPI-CM4-dat.md
... ...
@@ -4,6 +4,9 @@ I believe the COMPUTE MODULE has enough pins to drive 6 chains.
4 4
5 5
See also: https://github.com/hzeller/rpi-rgb-led-matrix/blob/a3eea997a9254b83ab2de97ae80d83588f696387/wiring.md?plain=1#L144
6 6
7
+- https://github.com/hzeller/rpi-rgb-led-matrix/issues/1105
8
+
9
+
7 10
## Alternative Hardware Mappings
8 11
9 12
You have relative freedom to assign any pins to the output of your choosing, just add a new mapping in lib/hardware-mapping.c, recompile and it will be provided as a new option in --led-gpio-mapping.
... ...
@@ -14,7 +17,7 @@ pin definitions for CM module
14 17
15 18
- https://github.com/hzeller/rpi-rgb-led-matrix/blob/master/lib/hardware-mapping.c
16 19
17
-
20
+- [[RMP-RPI-CM4-dat]]
18 21
19 22
<summary>Table: GPIO-pins for each hardware mapping</summary>
20 23
... ...
@@ -78,6 +81,9 @@ pin definitions for CM module
78 81
79 82
- [[RPI-CM4-dat]] - [[RPI-CM4-expansion-board-dat]]
80 83
84
+- [[RMP-RPI-CM4]] - [[RMP-driver]]
85
+
86
+
81 87
82 88
- https://rpi-rgb-led-matrix.discourse.group/t/curious-has-anyone-implemented-a-cm4-solution/702/3
83 89
Chip-cn-dat/Espressif-dat/ESP32-dat/ESP32-C3-dat/ESP32-\302\255C3-\302\255WROOM\302\255-02-DAT/ESP32-\302\255C3-\302\255WROOM-\302\25502-DAT.md
... ...
@@ -23,6 +23,9 @@
23 23
## datasheet
24 24
https://www.espressif.com.cn/sites/default/files/documentation/esp32-c3-wroom-02_datasheet_cn.pdf
25 25
26
+https://docs.espressif.com/projects/esp-at/en/latest/esp32c3/Get_Started/Hardware_connection.html
27
+
28
+
26 29
## peripheral design
27 30
28 31
page 24.
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-32-50.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-32-50.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-33-30.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-33-30.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-37-50.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-37-50.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-38-09.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-38-09.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-38-22.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-38-22.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-38-54.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-38-54.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-39-38.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-39-38.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-40-36.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-40-36.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-41-04.png
... ...
Binary files /dev/null and b/Chip-cn-dat/HLW-dat/HLW8032-dat/2024-12-08-16-41-04.png differ
Chip-cn-dat/HLW-dat/HLW8032-dat/HLW8032-DAT.md
... ...
@@ -2,33 +2,16 @@
2 2
3 3
- [[SVC1031-dat]] - [[SVC1035-dat]]
4 4
5
+- [[HLW8032-faq-dat]] - [[HLW8032-reg-dat]]
6
+
5 7
## Chip Info
6 8
7 9
- The HLW8032 is a high precision energy metering IC that uses a CMOS manufacturing process and is primarily intended for single phase applications. It can measure line voltage and current, and can calculate active power, apparent power and power factor.
8 10
- The device integrates two ∑-Δ ADCs and a high-precision energy metering core. The HLW8032 can communicate data through the UART port. The HLW8032 uses a 5V supply, a built-in 3.579M crystal, and an 8PIN SOP package.
9 11
- The HLW8032 has the advantages of high precision, low power consumption, high reliability and strong adaptability to the environment. It is suitable for energy metering of single-phase two-wire power users.
10 12
11
-## Hex Read
12
-
13
- F2 5A 02 DC D0 04 C8 20 00 3E 4E 03 7C A6 4E 2B B8 B9 8A BB 61 00 01 DC
14 13
15
- seperated: F2 | 5A | 02 DC D0 | 04 C8 20 | 00 3E 4E | 03 7C A6 | 4E 2B B8 | B9 8A BB | 61 | 00 01 | DC
16 14
17
- convert to int: 85 90 2 220 208 4 134 64 0 62 78 4 25 218 78 43 184 235 216 59 97 0 0 139
18
-
19
-| | hex | dec / int |
20
-| -------------------------- | -------- | ---------- |
21
-| start | F2 | 242 |
22
-| Check register | 5A | 90 |
23
-| Voltage parameter register | 02 DC D0 | 2 220 208 |
24
-| Voltage register | 04 C8 20 | 4 134 64 |
25
-| Current parameter register | 00 3E 4E | 0 62 78 |
26
-| Current register | 03 7C A6 | 3 124 166 |
27
-| Power parameter register | 4E 2B B8 | 78 43 184 |
28
-| Power register | B9 8A BB | 235 216 59 |
29
-| Data updata register | 61 | 97 |
30
-| PF register | 00 01 | 0 1 |
31
-| CheckSum register | DC | 139 |
32 15
33 16
34 17
## Applications
... ...
@@ -49,3 +32,5 @@
49 32
- [[HLW-dat]]
50 33
51 34
- [[HLW8032.pdf]]
35
+
36
+- [[HLW-dat]]
... ...
\ No newline at end of file
Chip-cn-dat/HLW-dat/HLW8032-dat/HLW8032-faq-dat.md
... ...
@@ -0,0 +1,83 @@
1
+
2
+# FAQ: HLW8032 Module
3
+
4
+## 1. What is the HLW8032 module, and what is it used for?
5
+The HLW8032 module is designed to measure AC effective voltage, effective current, active power, and energy consumption. It can also calculate apparent power and power factor:
6
+- **Apparent Power** = Effective Voltage × Effective Current
7
+- **Power Factor** = Active Power ÷ Apparent Power
8
+
9
+Typical applications include smart plugs and charging stations. The module outputs hexadecimal data via a serial interface, which can be processed using provided formulas. Tutorials for testing and data parsing are available.
10
+
11
+
12
+---
13
+
14
+## 2. Can the HLW8032 measure DC or three-phase electricity? What are its measurement ranges, sampling frequency, and accuracy?
15
+- **DC Measurement:** Not supported.
16
+- **Three-Phase Electricity:** Not supported.
17
+- **Voltage Range:** 85V~280V AC.
18
+- **Current Range:** 50mA~10A/20A.
19
+- **Sampling Frequency:** 0.89475 MHz.
20
+- **Measurement Accuracy:** 2%.
21
+
22
+### Special Note
23
+
24
+![](2024-12-08-16-32-50.png)
25
+
26
+When measuring low-power devices (e.g., ~3W), the module updates current and power readings slowly, taking approximately 8 seconds. Similarly, it may take about 5 seconds to detect no load after a device is disconnected.
27
+
28
+
29
+
30
+---
31
+
32
+## 3. What sampling method does the module use? Can I connect the serial output directly to a computer?
33
+- **Sampling Method:** Non-isolated sampling.
34
+- **Serial Output:** Data is isolated using an optocoupler, making the serial output pin header safe. You can connect it directly to a microcontroller or to a computer via a USB-to-TTL adapter.
35
+
36
+---
37
+
38
+## 4. What is the baud rate of the serial output? Can it be modified?
39
+- **Baud Rate:** Fixed at 4800 bps.
40
+- **Configuration:** 8 data bits, 1 stop bit, even parity.
41
+- **Modification:** The baud rate cannot be changed.
42
+
43
+---
44
+
45
+## 5. How do I connect the module? Does it distinguish live and neutral wires? Can it work without a load or without 5V DC power?
46
+
47
+![](2024-12-08-16-33-30.png)
48
+
49
+- **AC Wiring:** Loosen the screws slightly, insert the metal part of the wire into the terminal, and tighten the screws. *(Tip: Place the module on a stable surface, hold it with one hand, and press the screwdriver down firmly while turning.)*
50
+- **Live and Neutral Wires:** No distinction is needed.
51
+- **Without Load:** The module can measure voltage with just a 220V input. If only 5V DC is supplied (without 220V AC input), the module will still output data.
52
+- **5V DC Power:** Required to power the chip. Without it, the chip will not function.
53
+ - Do not use 3.3V as the power supply. However, the `T` pin can be connected to a 3.3V microcontroller's RXD pin.
54
+
55
+---
56
+
57
+## 6. What is the difference between the 10A and 20A versions? What about soldered vs. unsoldered modules?
58
+- **10A vs. 20A Versions:** The difference lies in the sampling resistor:
59
+ - **10A Version:** Sampling resistor is 3 milliohms.
60
+ - **20A Version:** Sampling resistor is 1 milliohm.
61
+- **Soldered vs. Unsoldered:**
62
+ - Soldered modules have the 3P pin header and 220V terminal pre-soldered.
63
+ - Unsoldered modules allow for easier reinforcement of 220V traces with solder and the ability to reverse the pin header for use on other boards. Both versions are shipped with these components included.
64
+- **Reinforcing 220V Traces:**
65
+ To prevent trace burnout under high current (above 10A), reinforce the 220V traces with solder on both sides of the module. Be careful not to short-circuit live and neutral wires.
66
+
67
+---
68
+
69
+## 7. Can the HLW8032 module connect to microcontrollers like STM32, 51, or Arduino?
70
+Yes, the module is compatible with any TTL serial microcontroller. While example code is available for STM32 and 51 series microcontrollers, you can adapt the module to other platforms as needed.
71
+
72
+
73
+This FAQ should help you understand the HLW8032 module and its configuration for your application. For additional support, refer to tutorials and example projects.
74
+
75
+## 8. Why is the effective voltage 231V instead of 220V?
76
+This is normal and depends on the transformer and power distribution in your area. To ensure sufficient capacity, power companies often supply higher voltages. The highest observed voltage can be up to 258V. Such voltages will not damage household appliances. You can use a multimeter to verify the voltage, which should be similar to the module's readings.
77
+
78
+---
79
+
80
+## 9. Why does the effective current show a value when no device is connected instead of showing 0?
81
+This is expected behavior. The module's current detection range is 50mA–10A. Although the effective current shows a value, the energy consumption does not increase. You can verify if no device is connected by checking the first byte of raw data; if it is `0xF2`, no load is connected.
82
+
83
+For detailed information about the meaning of each byte in the raw data, refer to the HLW8032 datasheet.
Chip-cn-dat/HLW-dat/HLW8032-dat/HLW8032-reg-dat.md
... ...
@@ -0,0 +1,64 @@
1
+
2
+# HLW8032-reg-dat.md
3
+
4
+![](2024-12-08-16-37-50.png)
5
+
6
+![](2024-12-08-16-38-09.png)
7
+
8
+![](2024-12-08-16-38-22.png)
9
+
10
+![](2024-12-08-16-38-54.png)
11
+
12
+## sample data
13
+
14
+ F2 5A 02 E1 80 00 06 52 0 3E A8 3 A6 C8 4F 9A E8 5E 79 B 61 0 1 27
15
+
16
+### Voltage Parameter Register
17
+
18
+ 02 E1 80
19
+
20
+![](2024-12-08-16-39-38.png)
21
+
22
+Summing these values gives the voltage parameter register value: 131072 + 57600 + 128 = 188800
23
+
24
+### Voltage Register Calculation
25
+
26
+ 00 06 52
27
+
28
+![](2024-12-08-16-40-36.png)
29
+
30
+voltage register value: 0 + 1536 + 82 = 1618
31
+
32
+### Effective Voltage Calculation
33
+
34
+Therefore, the effective voltage is approximately 219.372V.
35
+
36
+![](2024-12-08-16-41-04.png)
37
+
38
+
39
+
40
+
41
+## obselete
42
+
43
+## Hex Read
44
+
45
+ F2 5A 02 DC D0 04 C8 20 00 3E 4E 03 7C A6 4E 2B B8 B9 8A BB 61 00 01 DC
46
+
47
+ seperated: F2 | 5A | 02 DC D0 | 04 C8 20 | 00 3E 4E | 03 7C A6 | 4E 2B B8 | B9 8A BB | 61 | 00 01 | DC
48
+
49
+ convert to int: 85 90 2 220 208 4 134 64 0 62 78 4 25 218 78 43 184 235 216 59 97 0 0 139
50
+
51
+| | hex | dec / int |
52
+| -------------------------- | -------- | ---------- |
53
+| start | F2 | 242 |
54
+| Check register | 5A | 90 |
55
+| Voltage parameter register | 02 DC D0 | 2 220 208 |
56
+| Voltage register | 04 C8 20 | 4 134 64 |
57
+| Current parameter register | 00 3E 4E | 0 62 78 |
58
+| Current register | 03 7C A6 | 3 124 166 |
59
+| Power parameter register | 4E 2B B8 | 78 43 184 |
60
+| Power register | B9 8A BB | 235 216 59 |
61
+| Data updata register | 61 | 97 |
62
+| PF register | 00 01 | 0 1 |
63
+| CheckSum register | DC | 139 |
64
+
Chip-cn-dat/HLW-dat/hlw-dat.md
... ...
@@ -1,5 +1,8 @@
1 1
# hlw-dat
2 2
3
+
4
+## chips
5
+
3 6
| ! chip | Sensing | Size | Calibration | COMM | Other |
4 7
| ------- | ----------------------- | ------- | ----------- | -------- | ---------------------------- |
5 8
| HLW8112 | 2x current / 1x voltage | SSOP16 | No need | SPI/UART | OV / LV / Zeor-crossing / OC |
... ...
@@ -11,6 +14,12 @@
11 14
* [[HLW8012-dat]] - [[HLW8032-dat]]
12 15
13 16
17
+
18
+## code house
19
+
20
+- https://github.com/Edragon/HLW
21
+
22
+
14 23
## ref
15 24
16 25
- [[HLW]]
... ...
\ No newline at end of file
Chip-cn-dat/WCH-dat/CH423-dat/2024-12-04-17-36-12.png
... ...
Binary files /dev/null and b/Chip-cn-dat/WCH-dat/CH423-dat/2024-12-04-17-36-12.png differ
Chip-cn-dat/WCH-dat/CH423-dat/CH423-dat.md
... ...
@@ -1,3 +1,26 @@
1 1
2 2
# CH423-dat
3 3
4
+https://www.wch-ic.com/products/CH423.html
5
+
6
+![](2024-12-04-17-36-12.png)
7
+
8
+- [[CH423DS1.PDF]]
9
+
10
+
11
+## code refe
12
+
13
+folked library as below:
14
+
15
+- Linux driver for WCH CH423 - https://github.com/Edragon/ch423-gpio-expander
16
+
17
+- raspberry pi demo code - https://github.com/Edragon/CH423
18
+
19
+- [[ch423-ard-demo-blink.ino]] - [[ch423-ard-demo-group.ino]] - [[ch423-ard-demo-input.ino]] - [[ch423-ard-demo-ioInterrupt.ino]] - [[ch423-ard-demo-pollInterrupt.ino]] - [[ch423-ard-demo-sleep.ino]] - [[ch423-ard-demo-waterLamp.ino]]
20
+
21
+
22
+## ref
23
+
24
+- [[I2C-dat]] - [[IO-expander-dat]]
25
+
26
+- [[MSP1072-dat]]
... ...
\ No newline at end of file
Chip-cn-dat/WCH-dat/CH423-dat/CH423DS1.PDF
... ...
Binary files /dev/null and b/Chip-cn-dat/WCH-dat/CH423-dat/CH423DS1.PDF differ
Chip-cn-dat/WCH-dat/CH423-dat/ch423-ard-demo-blink.ino
... ...
@@ -0,0 +1,112 @@
1
+
2
+/*!
3
+ * @file blink.ino
4
+ * @brief Turns an LED on for one second, then off for one second, repeatedly.
5
+ * @note This module implements the blink function in 2 ways:
6
+ * @n 1. Set GPIO group pins to output mode and connect the LED lamp to one of the GPIO pins (GPIO0~GPIO7), and control the pin to output high and low levels;
7
+ * @n 2. Set GPO group pins as push-pull output mode and connect the LED lamp to one of the GP0 pins (GPO0~GPO15), and control the pin to output high and low levels;
8
+ * @n Hardware connection: connect the LED pin to the corresponding output pin
9
+ *
10
+ * @copyright Copyright (c) 2010 DFRobot Co.Ltd (http://www.dfrobot.com)
11
+ * @license The MIT License (MIT)
12
+ * @author [Arya](xue.peng@dfrobot.com)
13
+ * @version V1.0
14
+ * @date 2022-03-09
15
+ * @url https://github.com/DFRobot/DFRobot_CH423
16
+ */
17
+#include "DFRobot_CH423.h"
18
+
19
+//Disable the macro, and the blink function will shift to the pin GPO0 of GPO pins, otherwise, it will be implemented by the pin GPIO0 of GPIO pins
20
+#define GPIO_ENABLE
21
+
22
+DFRobot_CH423 ch423;
23
+
24
+void setup() {
25
+ Serial.begin(115200);
26
+
27
+ while(!Serial){
28
+
29
+ }
30
+ ch423.begin();
31
+ /**
32
+ * @fn pinMode
33
+ * @brief Set the mode of the pin group, this module contains 2 groups of pins: GPIO(GPIO0~GPIO7) and GPO(GPO0~GPO15).
34
+ * @note This module sets the mode by group, the pins in a group can only be set as one mode at the same time, and the pins in different groups can be set as different modes
35
+ * @param group Pin group parameter, ePinGroup_t enum variable member
36
+ * @n eGPIO Bi-directional I/O pin, GPIO0-GPIO7, which can be set as input(eINPUT) or output(eOUTPUT) mode, setting to other modes is invalid
37
+ * @n eGPO/eGPO0_7/eGPO8_15 The three parameters indicate the same meaning, set the mode of GPO group pins, select the parameter and GPO pins can only be configured as open-drain(eOPEN_DRAIN) or push-pull(ePUSH_PULL) output mode, other modes are invalid
38
+ * @param mode Group pin mode parameter, as member enum variable of eMode_t
39
+ * @n eINPUT GPIO pin input mode, at high level when floating, this mode can only be used for eGPIO digital ports
40
+ * @n eOUTPUT GPIO pin output mode, can output high and low levels, this mode can only be used for eGPIO digital ports
41
+ * @n eOPEN_DRAIN GPO pin open-drain output mode, the GPO pins only output low level or don't output in this mode, it can only be used for eGPO group digital ports
42
+ * @n ePUSH_PULL GPO pin push-pull output mode, the GPO pin can output high or low level in this mode, it can only be used for eGPO digital ports
43
+ */
44
+#ifdef GPIO_ENABLE
45
+ ch423.pinMode(ch423.eGPIO, ch423.eOUTPUT);
46
+#else
47
+ ch423.pinMode(ch423.eGPO, ch423.ePUSH_PULL);
48
+#endif
49
+}
50
+
51
+void loop() {
52
+#ifdef GPIO_ENABLE
53
+ /**
54
+ * @fn
55
+ * @brief Set the pin outputting high or low level
56
+ * @param gpioPin GPIO group pins, eGPIOPin_t enum variable member
57
+ * @n eGPIO0 Bi-directional I/O pin, GPIO0, indicates setting the output value of pin GPIO0
58
+ * @n eGPIO1 Bi-directional I/O pin, GPIO1, indicates setting the output value of pin GPIO1
59
+ * @n eGPIO2 Bi-directional I/O pin, GPIO2, indicates setting the output value of pin GPIO2
60
+ * @n eGPIO3 Bi-directional I/O pin, GPIO3, indicates setting the output value of pin GPIO3
61
+ * @n eGPIO4 Bi-directional I/O pin, GPIO4, indicates setting the output value of pin GPIO4
62
+ * @n eGPIO5 Bi-directional I/O pin, GPIO5, indicates setting the output value of pin GPIO5
63
+ * @n eGPIO6 Bi-directional I/O pin, GPIO6, indicates setting the output value of pin GPIO6
64
+ * @n eGPIO7 Bi-directional I/O pin, GPIO7, indicates setting the output value of pin GPIO7
65
+ * @n eGPIOTotal sets the values of all GPIO group pins, when using this parameter, bit0~bit7 of parameter level are valid values, corresponding to the output values of pins GPIO0~GPIO7 respectively.
66
+ * @param level Output level
67
+ * @n HIGH or 1 Parameter level, bit0 in 8-bit data is valid, which indicates outputting high level
68
+ * @n LOW or 0 Parameter level, bit0 in 8-bit data is valid, which indicates outputting low level
69
+ * @n 0x00~0xFF If parameter gpioPin is GPIOTotal, bit0~bit7 of parameter level are valid data, corresponding to GPIO0~GPIO7 pins respectively.
70
+ */
71
+ ch423.digitalWrite(/* gpio= */ch423.eGPIO0, /* level= */HIGH); // turn the LED on (HIGH is the voltage level)
72
+ //ch423.digitalWrite(/* gpio= */ch423.eGPIOTotal, /* level= */0xFF); // set all pins in GPIO group(GPIO0~GPIO7) outputting high level
73
+ delay(1000); // wait for a second
74
+ ch423.digitalWrite(/* gpio= */ch423.eGPIO0, /* level= */LOW); // turn the LED off by making the voltage LOW
75
+ //ch423.digitalWrite(/* gpio= */ch423.eGPIOTotal, /* level= */0x00); // set all pins in GPIO group(GPIO0~GPIO7) outputting low level
76
+ delay(1000); // wait for a second
77
+#else
78
+ /**
79
+ * @fn digitalWrite
80
+ * @brief Set the pin outputting high and low level, or control to output or stop (interrupt) low level
81
+ * @param gpoPin eGPOPin_t enum variable member
82
+ * @n eGPO0 GPO pin, GPO0, indicates setting the output value of pin GPO0
83
+ * @n eGPO1 GPO pin, GPO1, indicates setting the output value of pin GPO1
84
+ * @n eGPO2 GPO pin, GPO2, indicates setting the output value of pin GPO2
85
+ * @n eGPO3 GPO pin, GPO3, indicates setting the output value of pin GPO3
86
+ * @n eGPO4 GPO pin, GPO4, indicates setting the output value of pin GPO4
87
+ * @n eGPO5 GPO pin, GPO5, indicates setting the output value of pin GPO5
88
+ * @n eGPO6 GPO pin, GPO6, indicates setting the output value of pin GPO6
89
+ * @n eGPO7 GPO pin, GPO7, indicates setting the output value of pin GPO7
90
+ * @n eGPO8 GPO pin, GPO8, indicates setting the output value of pin GPO8
91
+ * @n eGPO9 GPO pin, GPO9, indicates setting the output value of pin GPO9
92
+ * @n eGPO10 GPO pin, GPO10, indicates setting the output value of pin GPO10
93
+ * @n eGPO11 GPO pin, GPO11, indicates setting the output value of pin GPO11
94
+ * @n eGPO12 GPO pin, GPO12, indicates setting the output value of pin GPO12
95
+ * @n eGPO13 GPO pin, GPO13, indicates setting the output value of pin GPO13
96
+ * @n eGPO14 GPO pin, GPO14, indicates setting the output value of pin GPO14
97
+ * @n eGPO15 GPO pin, GPO15, indicates setting the output value of pin GPO15
98
+ * @n eGPOTotal sets all the GPO pins of 0~15, when using this parameter, the bit0~bit7 of the parameter 8-bit data level correspond to the output value of GPO0~GPO7 or GPO8~GPO15 pins respectively
99
+ * @param level Output level or output (stop) low level signal
100
+ * @n HIGH or 1 When GPO pin group is set to push-pull output mode, output high; for open-drain mode, output low level
101
+ * @n LOW or 0 When GPO pin group is set to push-pull output mode, output low, for open-drain mode, no signal output
102
+ * @n 0x00~0xFF When gpoPin parameter is eGPOTotal, bit0~bit7 of level are all valid data, corresponding to pin GPO0~GPO7 or GPO8~GPO15
103
+ */
104
+ ch423.digitalWrite(/* gpo= */ch423.eGPO0, /* level= */HIGH); // turn the LED on (HIGH is the voltage level)
105
+ //ch423.digitalWrite(/* gpo= */ch423.eGPOTotal, /* level= */0xFF); // set all pins in GPO group(GPO0~GPO15) outputting high level
106
+ delay(1000); // wait for a second
107
+ ch423.digitalWrite(/* gpio= */ch423.eGPO0, /* level= */LOW); // turn the LED off by making the voltage LOW
108
+ //ch423.digitalWrite(/* gpo= */ch423.eGPOTotal, /* level= */0x00); // set all pins in GPO group(GPO0~GPO15) outputting low level
109
+ delay(1000); // wait for a second
110
+#endif
111
+
112
+}
... ...
\ No newline at end of file
Chip-cn-dat/WCH-dat/CH423-dat/ch423-ard-demo-group.ino
... ...
@@ -0,0 +1,136 @@
1
+/*!
2
+ * @file group.ino
3
+ * @brief This demo is mainly used to demonstrate how to operate the digital ports of a group at a time. This module has 2 groups of digital pins, GPIO group pins and GPO pins, and GPO pins are divided into GPO0_7 group pins and GPO8_15 group pins.
4
+ * @n GPIO group pins: can be used as both input pins and output pins
5
+ * @n GPO group pins: can only be used as output pins, there are 2 output modes, push-pull and open-drain output mode
6
+ * @n Users can operate the pins by group according to the API function provided
7
+ * @copyright Copyright (c) 2010 DFRobot Co.Ltd (http://www.dfrobot.com)
8
+ * @license The MIT License (MIT)
9
+ * @author [Arya](xue.peng@dfrobot.com)
10
+ * @version V1.0
11
+ * @date 2022-03-14
12
+ * @url https://github.com/DFRobot/DFRobot_CH423
13
+ */
14
+#include "DFRobot_CH423.h"
15
+
16
+#define GROUP_GPIO_INPUT 0
17
+#define GROUP_GPIO_OUTPUT 1
18
+#define GROUP_GPO 2
19
+
20
+//Demo function switch
21
+#define DEMO_FUN_SWITCH GROUP_GPIO_INPUT
22
+//#define DEMO_FUN_SWITCH GROUP_GPIO_OUTPUT
23
+//#define DEMO_FUN_SWITCH GROUP_GPO
24
+
25
+DFRobot_CH423 ch423;
26
+
27
+void setup() {
28
+ Serial.begin(115200);
29
+
30
+ while(!Serial){
31
+
32
+ }
33
+ ch423.begin();
34
+ /**
35
+ * @fn pinMode
36
+ * @brief Set the mode of the pin groups, this module contains 2 groups of pins: GPIO(GPIO0~GPIO7) and GPO(GPO0~GPO15).
37
+ * @note This module sets the mode by group, the pins in a group can only be set as one mode at the same time, and the pins in different groups can be set as different modes
38
+ * @param group Pin group parameter, ePinGroup_t enum variable member
39
+ * @n eGPIO Bi-directional I/O pin, GPIO0~GPIO7, which can be set as input(eINPUT) or output(eOUTPUT) mode, setting to other modes is invalid
40
+ * @n eGPO/eGPO0_7/eGPO8_15 The three parameters indicate the same meaning, set the mode of GPO group pins, select the parameter and GPO pins can only be configured as open-drain(eOPEN_DRAIN) or push-pull(ePUSH_PULL) output mode, other modes are invalid
41
+ * @param mode Group pin mode parameter, enum variable member for eMode_t
42
+ * @n eINPUT GPIO pin input mode, at high level when floating, this mode can only be used for eGPIO digital ports
43
+ * @n eOUTPUT GPIO pin output mode, can output high and low levels, this mode can only be used for eGPIO digital ports
44
+ * @n eOPEN_DRAIN GPO pin open-drain output mode, the GPO pins only output low level or don't output in this mode, it can only be used for eGPO group digital ports
45
+ * @n ePUSH_PULL GPO pin push-pull output mode, the GPO pin can output high or low level in this mode, it can only be used for eGPO digital ports
46
+ */
47
+#if(DEMO_FUN_SWITCH == GROUP_GPIO_INPUT)
48
+ ch423.pinMode(ch423.eGPIO, ch423.eINPUT);
49
+#elif(DEMO_FUN_SWITCH == GROUP_GPIO_OUTPUT)
50
+ ch423.pinMode(ch423.eGPIO, ch423.eOUTPUT);
51
+
52
+ //Set GPIO group pin outputting 0xF0, bit0~bit7 of 0xF0 correspond to GPIO0~GPIO7 of GPIO group respectively
53
+ DFRobot_CH423::uGroupValue_t gpio;
54
+
55
+ gpio.GPO0 = 0; //Set pin GPIO0 outputting 0
56
+ gpio.GPO1 = 0; //Set pin GPIO1 outputting 0
57
+ gpio.GPO2 = 0; //Set pin GPIO2 outputting 0
58
+ gpio.GPO3 = 0; //Set pin GPIO3 outputting 0
59
+ gpio.GPO4 = 1; //Set pin GPIO4 outputting 1
60
+ gpio.GPO5 = 1; //Set pin GPIO5 outputting 1
61
+ gpio.GPO6 = 1; //Set pin GPIO6 outputting 1
62
+ gpio.GPO7 = 1; //Set pin GPIO7 outputting 1
63
+ //gpio.GPIO = 0xF0
64
+
65
+ ch423.digitalWrite(ch423.eGPIO, gpio); //Set GPIO0~GPIO3 outputting 0, GPIO4~GPIO7 outputting 1
66
+ //ch423.digitalWrite(ch423.eGPIO, 0xF0); //Set GPIO0~GPIO3 outputting 0, GPIO4~GPIO7 outputting 1
67
+ //ch423.digitalWrite(ch423.eGPIOTotal, 0xF0); //Set GPIO0~GPIO3 outputting 0, GPIO4~GPIO7 outputting 1
68
+
69
+ Serial.print("GPIO0 OUPUT: ");Serial.println(gpio.GPIO0);
70
+ Serial.print("GPIO1 OUPUT: ");Serial.println(gpio.GPIO1);
71
+ Serial.print("GPIO2 OUPUT: ");Serial.println(gpio.GPIO2);
72
+ Serial.print("GPIO3 OUPUT: ");Serial.println(gpio.GPIO3);
73
+ Serial.print("GPIO4 OUPUT: ");Serial.println(gpio.GPIO4);
74
+ Serial.print("GPIO5 OUPUT: ");Serial.println(gpio.GPIO5);
75
+ Serial.print("GPIO6 OUPUT: ");Serial.println(gpio.GPIO6);
76
+ Serial.print("GPIO7 OUPUT: ");Serial.println(gpio.GPIO7);
77
+#else
78
+ ch423.pinMode(ch423.eGPO, ch423.ePUSH_PULL);
79
+
80
+ //Set GPO group pins outputting 0x55F0, bit0~bit15 of 0x55F0 correspond to GPO0~GPIO15 of GPO group respectively
81
+ DFRobot_CH423::uGroupValue_t gpo;
82
+
83
+ gpo.GPO0 = 0; //Set pin GPO0 outputting 0
84
+ gpo.GPO1 = 0; //Set pin GPO1 outputting 0
85
+ gpo.GPO2 = 0; //Set pin GPO2 outputting 0
86
+ gpo.GPO3 = 0; //Set pin GPO3 outputting 0
87
+ gpo.GPO4 = 1; //Set pin GPO4 outputting 1
88
+ gpo.GPO5 = 1; //Set pin GPO5 outputting 1
89
+ gpo.GPO6 = 1; //Set pin GPO6 outputting 1
90
+ gpo.GPO7 = 1; //Set pin GPO7 outputting 1
91
+ gpo.GPO8 = 1; //Set pin GPO0 outputting 1
92
+ gpo.GPO9 = 0; //Set pin GPO1 outputting 0
93
+ gpo.GPO10 = 1; //Set pin GPO2 outputting 1
94
+ gpo.GPO11 = 0; //Set pin GPO3 outputting 0
95
+ gpo.GPO12 = 1; //Set pin GPO4 outputting 1
96
+ gpo.GPO13 = 0; //Set pin GPO5 outputting 0
97
+ gpo.GPO14 = 1; //Set pin GPO6 outputting 1
98
+ gpo.GPO15 = 0; //Set pin GPO7 outputting 0
99
+ //gpo.GPO0_7 = 0xF0;
100
+ //gpo.GPO8_15 = 0x55;
101
+ //gpo.GPO = 0x55F0;
102
+
103
+ ch423.digitalWrite(ch423.eGPO0_7, 0xF0); //only set GPO0~GPO7 outputting 0xF0
104
+ ch423.digitalWrite(ch423.eGPO8_15, (0x55 << 8)); //only set GPO8~GPO15 outputting 0x55
105
+ //ch423.digitalWrite(ch423.eGPO, gpo); //set pin GPO15~GPO0 outputting 0x55F0
106
+ //ch423.digitalWrite(ch423.eGPO, 0x55F0); //set pin GPO15~GPO0 outputting 0x55F0
107
+ Serial.print("GPO0 OUPUT: ");Serial.println(gpo.GPO0);
108
+ Serial.print("GPO1 OUPUT: ");Serial.println(gpo.GPO1);
109
+ Serial.print("GPO2 OUPUT: ");Serial.println(gpo.GPO2);
110
+ Serial.print("GPO3 OUPUT: ");Serial.println(gpo.GPO3);
111
+ Serial.print("GPO4 OUPUT: ");Serial.println(gpo.GPO4);
112
+ Serial.print("GPO5 OUPUT: ");Serial.println(gpo.GPO5);
113
+ Serial.print("GPO6 OUPUT: ");Serial.println(gpo.GPO6);
114
+ Serial.print("GPO7 OUPUT: ");Serial.println(gpo.GPO7);
115
+ Serial.print("GPO8 OUPUT: ");Serial.println(gpo.GPO8);
116
+ Serial.print("GPO9 OUPUT: ");Serial.println(gpo.GPO9);
117
+ Serial.print("GPO10 OUPUT: ");Serial.println(gpo.GPO10);
118
+ Serial.print("GPO11 OUPUT: ");Serial.println(gpo.GPO11);
119
+ Serial.print("GPO12 OUPUT: ");Serial.println(gpo.GPO12);
120
+ Serial.print("GPO13 OUPUT: ");Serial.println(gpo.GPO13);
121
+ Serial.print("GPO14 OUPUT: ");Serial.println(gpo.GPO14);
122
+ Serial.print("GPO15 OUPUT: ");Serial.println(gpo.GPO15);
123
+#endif
124
+}
125
+
126
+void loop() {
127
+#if(DEMO_FUN_SWITCH == GROUP_GPIO_INPUT)
128
+ //Query the value of each GPIO input pin (GPIO0~GPIO7) once in 1s
129
+ //0~7 bit of value correspond to the pin status of pins GPIO0~GPIO7 respectively
130
+ uint8_t value = ch423.digitalRead(ch423.eGPIOTotal);
131
+ Serial.print("The group of GPIO's pins state are 0x");
132
+ Serial.println(value, HEX);
133
+ delay(1000);
134
+#endif
135
+
136
+}
... ...
\ No newline at end of file
Chip-cn-dat/WCH-dat/CH423-dat/ch423-ard-demo-input.ino
... ...
@@ -0,0 +1,64 @@
1
+/*!
2
+ * @file input.ino
3
+ * @brief After pressing the button, the serial print button is pressed
4
+ * @note Only the pins in GPIO group can be set to input mode for this module.
5
+ *
6
+ * @copyright Copyright (c) 2010 DFRobot Co.Ltd (http://www.dfrobot.com)
7
+ * @license The MIT License (MIT)
8
+ * @author [Arya](xue.peng@dfrobot.com)
9
+ * @version V1.0
10
+ * @date 2022-03-09
11
+ * @url https://github.com/DFRobot/DFRobot_CH423
12
+ */
13
+#include "DFRobot_CH423.h"
14
+
15
+DFRobot_CH423 ch423;
16
+
17
+void setup() {
18
+ Serial.begin(115200);
19
+
20
+ while(!Serial){
21
+
22
+ }
23
+ ch423.begin();
24
+ /**
25
+ * @fn pinMode
26
+ * @brief Set the mode of the pin groups, this module contains 2 groups of pins: GPIO(GPIO0~GPIO7) and GPO(GPO0~GPO15).
27
+ * @note This module sets the mode by group, the pins in a group can only be set as one mode at the same time, and the pins in different groups can be set as different modes.
28
+ * @param group Pin group parameter, ePinGroup_t enum variable member
29
+ * @n eGPIO Bi-directional I/O pin, GPIO0-GPIO7, which can be set as input(eINPUT) or output(eOUTPUT) mode, setting to other modes is invalid
30
+ * @n eGPO/eGPO0_7/eGPO8_15 The three parameters indicate the same meaning, set the mode of GPO group pins, select the parameter and GPO pins can only be configured as open-drain(eOPEN_DRAIN) or push-pull(ePUSH_PULL) output mode, other modes are invalid
31
+ * @param mode Group pin mode parameter, as member enum variable of eMode_t
32
+ * @n eINPUT GPIO pin input mode, at high level when floating, this mode can only be used for eGPIO digital ports
33
+ * @n eOUTPUT GPIO pin output mode, can output high and low levels, this mode can only be used for eGPIO digital ports
34
+ * @n eOPEN_DRAIN GPO pin open-drain output mode, the GPO pins only output low level or don't output in this mode, it can only be used for eGPO group digital ports
35
+ * @n ePUSH_PULL GPO pin push-pull output mode, the GPO pin can output high or low level in this mode, it can only be used for eGPO digital ports
36
+ */
37
+ ch423.pinMode(ch423.eGPIO, ch423.eINPUT);
38
+}
39
+
40
+void loop() {
41
+ /**
42
+ * @fn digitalRead
43
+ * @brief Read the level status values of GPIO group pins
44
+ * @param pin GPIO group pins, eGPIOPin_t enum variable member
45
+ * @n eGPIO0 Bi-directional I/O pin, GPIO0, indicates reading level status of pin GPIO0, 0 for low level, 1 for high level
46
+ * @n eGPIO1 Bi-directional I/O pin, GPIO1, indicates reading level status of pin GPIO1, 0 for low level, 1 for high level
47
+ * @n eGPIO2 Bi-directional I/O pin, GPIO2, indicates reading level status of pin GPIO2, 0 for low level, 1 for high level
48
+ * @n eGPIO3 Bi-directional I/O pin, GPIO3, indicates reading level status of pin GPIO3, 0 for low level, 1 for high level
49
+ * @n eGPIO4 Bi-directional I/O pin, GPIO4, indicates reading level status of pin GPIO4, 0 for low level, 1 for high level
50
+ * @n eGPIO5 Bi-directional I/O pin, GPIO5, indicates reading level status of pin GPIO5, 0 for low level, 1 for high level
51
+ * @n eGPIO6 Bi-directional I/O pin, GPIO6, indicates reading level status of pin GPIO6, 0 for low level, 1 for high level
52
+ * @n eGPIO7 Bi-directional I/O pin, GPIO7, indicates reading level status of pin GPIO7, 0 for low level, 1 for high level
53
+ * @n eGPIOTotal Bi-directional I/O pin, GPIO group pins GPIO0~GPIO7 indicate reading level status of all GPIO group pins, the returned value bit0~bit8 represents the level of GPIO0~GPIO7 pins respectively
54
+ * @return Level status value
55
+ */
56
+ uint8_t value = ch423.digitalRead(/*pin = */ch423.eGPIO0);
57
+ if(value){
58
+ Serial.println("Button press!");
59
+ delay(200);
60
+ }else{
61
+ //Serial.println("Button release!");
62
+ }
63
+
64
+}
... ...
\ No newline at end of file
Chip-cn-dat/WCH-dat/CH423-dat/ch423-ard-demo-ioInterrupt.ino
... ...
@@ -0,0 +1,123 @@
1
+/*!
2
+ * @file ioInterrupt.ino
3
+ * @brief This demo is used to demonstrate the detection of rising edge, falling edge or double edge interrupt on the GPIO pin
4
+ * @note When the module is configured as rising edge, falling edge or double edge interrupt, the MCU external interrupt should use falling edge interrupt to reduce errors
5
+ * @n After burning this demo, pin GPO15 of the module needs to be connected to the corresponding external interrupt pin of MCU
6
+ * @n Hardware connection
7
+ * @n ---------------------------------------------------------
8
+ * @n module |UNO |mega2560 |M0 |ESP32 |ESP8266 |microbit |
9
+ * @n VCC |VCC |VCC |VCC |VCC |VCC |VCC |
10
+ * @n GND |GND |GND |GND |GND |GND |GND |
11
+ * @n SCL |SCL |SCL |SCL |SCL |SCL |SCL |
12
+ * @n SDA |SDA |SDA |SDA |SDA |SDA |SDA |
13
+ * @n GPO15 |2/D2 |2/D2 |2 |2 |12 |P9 |
14
+ * @n ---------------------------------------------------------
15
+ * @note If the level of any pin of GPIO0~GPIO7 changes, GPO15 will output a low level signal, and it outputs high level until the levels of GPIO0~GPIO7 pins return to the initial level.
16
+ * @n Leonardo is not supported
17
+ * @copyright Copyright (c) 2010 DFRobot Co.Ltd (http://www.dfrobot.com)
18
+ * @license The MIT License (MIT)
19
+ * @author [Arya](xue.peng@dfrobot.com)
20
+ * @version V1.0
21
+ * @date 2022-03-11
22
+ * @url https://github.com/DFRobot/DFRobot_CH423
23
+ */
24
+#include "DFRobot_CH423.h"
25
+
26
+DFRobot_CH423 ch423;
27
+
28
+#if defined(ARDUINO_BBC_MICROBIT)
29
+#define INT_PIN 9 //Connect pin GPO15 of the module to pin 9 of the MCU. For some MCUs, download the codes first and then connect hardware.
30
+#elif defined(ESP8266)
31
+#define INT_PIN 12 //Connect pin GPO15 of the module to pin 12 of the MCU. For some MCUs, download the codes first and then connect hardware.
32
+#else
33
+#define INT_PIN 2 //Connect pin GPO15 of the module to pin 2 of the MCU. For some MCUs, download the codes first and then connect hardware.
34
+#endif
35
+
36
+bool intFlag = false; //INT interrupt sign
37
+
38
+/*Interrupt service function, prototype void func(int index), index: the number of the pin that is interrupted*/
39
+void func(int index){
40
+ String description = ch423.pinDescription(/*pin = */(DFRobot_CH423::eGPIOPin_t)index);
41
+ Serial.print(description);
42
+ Serial.println(" Interruption occurs!");
43
+}
44
+
45
+void setup() {
46
+ Serial.begin(115200);
47
+
48
+ while(!Serial){
49
+
50
+ }
51
+ ch423.begin();
52
+ /**
53
+ * @fn pinMode
54
+ * @brief Set the mode of the pin groups, this module contains 2 groups of pins: GPIO(GPIO0~GPIO7) and GPO(GPO0~GPO15).
55
+ * @note This module sets the mode by group, the pins in a group can only be set as one mode at the same time, and the pins in different groups can be set as different modes
56
+ * @param group Pin group parameter, ePinGroup_t enum variable member
57
+ * @n eGPIO Bi-directional I/O pin, GPIO0~GPIO7, which can be set as input(eINPUT) or output(eOUTPUT) mode, setting to other modes is invalid
58
+ * @n eGPO/eGPO0_7/eGPO8_15 The three parameters indicate the same meaning, set the mode of GPO group pins, select the parameter and GPO pins can only be configured as open-drain(eOPEN_DRAIN) or push-pull(ePUSH_PULL) output mode, other modes are invalid
59
+ * @param mode Group pin mode parameter, as member enum variable of eMode_t
60
+ * @n eINPUT GPIO pin input mode, at high level when floating, this mode can only be used for eGPIO digital ports
61
+ * @n eOUTPUT GPIO pin output mode, can output high and low levels, this mode can only be used for eGPIO digital ports
62
+ * @n eOPEN_DRAIN GPO pin open-drain output mode, the GPO pins only output low level or don't output in this mode, it can only be used for eGPO group digital ports
63
+ * @n ePUSH_PULL GPO pin push-pull output mode, the GPO pin can output high or low level in this mode, it can only be used for eGPO digital ports
64
+ */
65
+ ch423.pinMode(ch423.eGPIO, ch423.eINPUT);
66
+ /**
67
+ * @fn attachInterrupt
68
+ * @brief Set the external interrupt mode and interrupt service function of GPIO pins
69
+ * @note Pin GPO15 of CH423 module is used to indicate whether an interrupt occurs on GPIO0~GPIO7 in interrupt mode, if an interrupt occurs on a pin, GPO15 will output a low level continuously, otherwise it will output a high level.
70
+ * @n When an interrupt occurs on a pin, trigger continuously, if there is interrupt occurring on other pins, level of pin GPO15 keeps low without changing
71
+ * @param gpioPin GPIO group pins, eGPIOPin_t enum variable member
72
+ * @n eGPIO0 Bi-directional I/O pin, GPIO0, indicates setting the external interrupt mode and interrupt service function of pin GPIO0
73
+ * @n eGPIO1 Bi-directional I/O pin, GPIO1, indicates setting the external interrupt mode and interrupt service function of pin GPIO1
74
+ * @n eGPIO2 Bi-directional I/O pin, GPIO2, indicates setting the external interrupt mode and interrupt service function of pin GPIO2
75
+ * @n eGPIO3 Bi-directional I/O pin, GPIO3, indicates setting the external interrupt mode and interrupt service function of pin GPIO3
76
+ * @n eGPIO4 Bi-directional I/O pin, GPIO4, indicates setting the external interrupt mode and interrupt service function of pin GPIO4
77
+ * @n eGPIO5 Bi-directional I/O pin, GPIO5, indicates setting the external interrupt mode and interrupt service function of pin GPIO5
78
+ * @n eGPIO6 Bi-directional I/O pin, GPIO6, indicates setting the external interrupt mode and interrupt service function of pin GPIO6
79
+ * @n eGPIO7 Bi-directional I/O pin, GPIO7, indicates setting the external interrupt mode and interrupt service function of pin GPIO7
80
+ * @n eGPIOTotal Set the values of all GPIO group pins, which indicates setting GPIO0~GPIO7 to the same interrupt mode and interrupt service function
81
+ * @param mode Interrupt mode
82
+ * @n eLOW Low level interrupt, initial level of the GPIO pin is high, if the GPIO pin detect a low level, pin GPO15 will output a low level signal
83
+ * @n eHIGH High level interrupt, initial level of the GPIO pin is low, if the GPIO pin detect a high level, pin GPO15 will output a low level signal
84
+ * @n eRISING Rising edge interrupt, initial level of the GPIO pin is low, if the GPIO pin detect a rising edge, pin GPO15 will output a high-to-low level signal (falling edge)
85
+ * @n eFALLING Falling edge interrupt, initial level of the GPIO pin is high, if the GPIO pin detect a falling edge, pin GPO15 will output a high-to-low level signal (falling edge)
86
+ * @n eCHANGE Double edge interrupt, initial level of the GPIO pin is high, and the initial level switches once for each interrupt that occurs. If the GPIO pin detect falling edge or rising edge, pin GPO15 will output a high-to-low level signal (falling edge)
87
+ * @note If the level of any pin of GPIO0-GPIO7 changes, GPO15 will output a low level signal, and it outputs high level until the levels of GPIO0~GPIO7 pins return to the initial level
88
+ * @param cb Point to interrupt service function
89
+ */
90
+ ch423.attachInterrupt(/* gpioPin= */ch423.eGPIO0, /* mode= */ch423.eFALLING, /* cb= */func);
91
+ ch423.enableInterrupt();
92
+ /**
93
+ * @brief Enable the external interrupt pin of MCU.
94
+ * @param pin: The external pin of MCU.
95
+ * @n UNO: The external pin is 2, 3,
96
+ * @n Leonardo： (Not support)The external pin is 0(RX), 1(TX), 2(SCL), 3(SDA), but 0, 1, 2, 3 can't use in this demo
97
+ * @n Mega2560: The external pin is 2, 3, 21, 20, 19, 18.
98
+ * @n microbit: The external pin is 0~20(P0-P20)
99
+ * @n ESP32, ESP8266, M0: The external pin is all digital Pin and analog pin.
100
+ * @param fun: Pointer to guide interrupt service function.
101
+ * @param mode: Interrupt trigger mode.
102
+ * @n UNO/Leonardo/Mega2560: Interrupt Modes: RISING(0x03), FALLING(0x02), CHANGE(0x01), LOW(0x00)
103
+ * @n 8266/esp32: Interrupt Modes: RISING(0x01), FALLING(0x02), CHANGE(0x03), ONLOW(0x04), ONHIGH(0x05),
104
+ * @n M0: Interrupt Modes: RISING(0x04), FALLING(0x03), CHANGE(0x02), HIGH(0x01), LOW(0x00)
105
+ * @n microbit: Interrupt Modes: RISING(0x04), FALLING(0x03), CHANGE(0x02)
106
+ */
107
+ pinMode(INT_PIN, INPUT_PULLUP);
108
+ attachInterrupt(/*pin=*/digitalPinToInterrupt(INT_PIN),/*fun=*/notify,/*mode =*/FALLING);
109
+ Serial.println("Set done!");
110
+}
111
+
112
+/*Interrupt service function*/
113
+void notify(){
114
+ intFlag = true;
115
+}
116
+
117
+void loop() {
118
+ if(intFlag){
119
+ intFlag = false;
120
+ ch423.pollInterrupts();
121
+ }
122
+ yield();
123
+}
... ...
\ No newline at end of file
Chip-cn-dat/WCH-dat/CH423-dat/ch423-ard-demo-pollInterrupt.ino
... ...
@@ -0,0 +1,123 @@
1
+/*!
2
+ * @file ioInterrupt.ino
3
+ * @brief This demo is used to demonstrate the detection of rising edge, falling edge or double edge interrupt on the GPIO pin
4
+ * @note When the module is configured as rising edge, falling edge or double edge interrupt, the MCU external interrupt should use falling edge interrupt to reduce errors
5
+ * @n After burning this demo, pin GPO15 of the module needs to be connected to the corresponding external interrupt pin of MCU
6
+ * @n Hardware connection
7
+ * @n ---------------------------------------------------------
8
+ * @n module |UNO |mega2560 |M0 |ESP32 |ESP8266 |microbit |
9
+ * @n VCC |VCC |VCC |VCC |VCC |VCC |VCC |
10
+ * @n GND |GND |GND |GND |GND |GND |GND |
11
+ * @n SCL |SCL |SCL |SCL |SCL |SCL |SCL |
12
+ * @n SDA |SDA |SDA |SDA |SDA |SDA |SDA |
13
+ * @n GPO15 |2/D2 |2/D2 |2 |2 |12 |P9 |
14
+ * @n ---------------------------------------------------------
15
+ * @note If the level of any pin of GPIO0~GPIO7 changes, GPO15 will output a low level signal, and it outputs high level until the levels of GPIO0~GPIO7 pins return to the initial level.
16
+ * @n Leonardo is not supported
17
+ * @copyright Copyright (c) 2010 DFRobot Co.Ltd (http://www.dfrobot.com)
18
+ * @license The MIT License (MIT)
19
+ * @author [Arya](xue.peng@dfrobot.com)
20
+ * @version V1.0
21
+ * @date 2022-03-11
22
+ * @url https://github.com/DFRobot/DFRobot_CH423
23
+ */
24
+#include "DFRobot_CH423.h"
25
+
26
+DFRobot_CH423 ch423;
27
+
28
+#if defined(ARDUINO_BBC_MICROBIT)
29
+#define INT_PIN 9 //Connect pin GPO15 of the module to pin 9 of the MCU. For some MCUs, download the codes first and then connect hardware.
30
+#elif defined(ESP8266)
31
+#define INT_PIN 12 //Connect pin GPO15 of the module to pin 12 of the MCU. For some MCUs, download the codes first and then connect hardware.
32
+#else
33
+#define INT_PIN 2 //Connect pin GPO15 of the module to pin 2 of the MCU. For some MCUs, download the codes first and then connect hardware.
34
+#endif
35
+
36
+bool intFlag = false; //INT interrupt sign
37
+
38
+/*Interrupt service function, prototype void func(int index), index: the number of the pin that is interrupted*/
39
+void func(int index){
40
+ String description = ch423.pinDescription(/*pin = */(DFRobot_CH423::eGPIOPin_t)index);
41
+ Serial.print(description);
42
+ Serial.println(" Interruption occurs!");
43
+}
44
+
45
+void setup() {
46
+ Serial.begin(115200);
47
+
48
+ while(!Serial){
49
+
50
+ }
51
+ ch423.begin();
52
+ /**
53
+ * @fn pinMode
54
+ * @brief Set the mode of the pin groups, this module contains 2 groups of pins: GPIO(GPIO0~GPIO7) and GPO(GPO0~GPO15).
55
+ * @note This module sets the mode by group, the pins in a group can only be set as one mode at the same time, and the pins in different groups can be set as different modes
56
+ * @param group Pin group parameter, ePinGroup_t enum variable member
57
+ * @n eGPIO Bi-directional I/O pin, GPIO0~GPIO7, which can be set as input(eINPUT) or output(eOUTPUT) mode, setting to other modes is invalid
58
+ * @n eGPO/eGPO0_7/eGPO8_15 The three parameters indicate the same meaning, set the mode of GPO group pins, select the parameter and GPO pins can only be configured as open-drain(eOPEN_DRAIN) or push-pull(ePUSH_PULL) output mode, other modes are invalid
59
+ * @param mode Group pin mode parameter, as member enum variable of eMode_t
60
+ * @n eINPUT GPIO pin input mode, at high level when floating, this mode can only be used for eGPIO digital ports
61
+ * @n eOUTPUT GPIO pin output mode, can output high and low levels, this mode can only be used for eGPIO digital ports
62
+ * @n eOPEN_DRAIN GPO pin open-drain output mode, the GPO pins only output low level or don't output in this mode, it can only be used for eGPO group digital ports
63
+ * @n ePUSH_PULL GPO pin push-pull output mode, the GPO pin can output high or low level in this mode, it can only be used for eGPO digital ports
64
+ */
65
+ ch423.pinMode(ch423.eGPIO, ch423.eINPUT);
66
+ /**
67
+ * @fn attachInterrupt
68
+ * @brief Set the external interrupt mode and interrupt service function of GPIO pins
69
+ * @note Pin GPO15 of CH423 module is used to indicate whether an interrupt occurs on GPIO0~GPIO7 in interrupt mode, if an interrupt occurs on a pin, GPO15 will output a low level continuously, otherwise it will output a high level.
70
+ * @n When an interrupt occurs on a pin, trigger continuously, if there is interrupt occurring on other pins, level of pin GPO15 keeps low without changing
71
+ * @param gpioPin GPIO group pins, eGPIOPin_t enum variable member
72
+ * @n eGPIO0 Bi-directional I/O pin, GPIO0, indicates setting the external interrupt mode and interrupt service function of pin GPIO0
73
+ * @n eGPIO1 Bi-directional I/O pin, GPIO1, indicates setting the external interrupt mode and interrupt service function of pin GPIO1
74
+ * @n eGPIO2 Bi-directional I/O pin, GPIO2, indicates setting the external interrupt mode and interrupt service function of pin GPIO2
75
+ * @n eGPIO3 Bi-directional I/O pin, GPIO3, indicates setting the external interrupt mode and interrupt service function of pin GPIO3
76
+ * @n eGPIO4 Bi-directional I/O pin, GPIO4, indicates setting the external interrupt mode and interrupt service function of pin GPIO4
77
+ * @n eGPIO5 Bi-directional I/O pin, GPIO5, indicates setting the external interrupt mode and interrupt service function of pin GPIO5
78
+ * @n eGPIO6 Bi-directional I/O pin, GPIO6, indicates setting the external interrupt mode and interrupt service function of pin GPIO6
79
+ * @n eGPIO7 Bi-directional I/O pin, GPIO7, indicates setting the external interrupt mode and interrupt service function of pin GPIO7
80
+ * @n eGPIOTotal Set the values of all GPIO group pins, which indicates setting GPIO0~GPIO7 to the same interrupt mode and interrupt service function
81
+ * @param mode Interrupt mode
82
+ * @n eLOW Low level interrupt, initial level of the GPIO pin is high, if the GPIO pin detect a low level, pin GPO15 will output a low level signal
83
+ * @n eHIGH High level interrupt, initial level of the GPIO pin is low, if the GPIO pin detect a high level, pin GPO15 will output a low level signal
84
+ * @n eRISING Rising edge interrupt, initial level of the GPIO pin is low, if the GPIO pin detect a rising edge, pin GPO15 will output a high-to-low level signal (falling edge)
85
+ * @n eFALLING Falling edge interrupt, initial level of the GPIO pin is high, if the GPIO pin detect a falling edge, pin GPO15 will output a high-to-low level signal (falling edge)
86
+ * @n eCHANGE Double edge interrupt, initial level of the GPIO pin is high, and the initial level switches once for each interrupt that occurs. If the GPIO pin detect falling edge or rising edge, pin GPO15 will output a high-to-low level signal (falling edge)
87
+ * @note If the level of any pin of GPIO0-GPIO7 changes, GPO15 will output a low level signal, and it outputs high level until the levels of GPIO0~GPIO7 pins return to the initial level
88
+ * @param cb Point to interrupt service function
89
+ */
90
+ ch423.attachInterrupt(/* gpioPin= */ch423.eGPIO0, /* mode= */ch423.eFALLING, /* cb= */func);
91
+ ch423.enableInterrupt();
92
+ /**
93
+ * @brief Enable the external interrupt pin of MCU.
94
+ * @param pin: The external pin of MCU.
95
+ * @n UNO: The external pin is 2, 3,
96
+ * @n Leonardo： (Not support)The external pin is 0(RX), 1(TX), 2(SCL), 3(SDA), but 0, 1, 2, 3 can't use in this demo
97
+ * @n Mega2560: The external pin is 2, 3, 21, 20, 19, 18.
98
+ * @n microbit: The external pin is 0~20(P0-P20)
99
+ * @n ESP32, ESP8266, M0: The external pin is all digital Pin and analog pin.
100
+ * @param fun: Pointer to guide interrupt service function.
101
+ * @param mode: Interrupt trigger mode.
102
+ * @n UNO/Leonardo/Mega2560: Interrupt Modes: RISING(0x03), FALLING(0x02), CHANGE(0x01), LOW(0x00)
103
+ * @n 8266/esp32: Interrupt Modes: RISING(0x01), FALLING(0x02), CHANGE(0x03), ONLOW(0x04), ONHIGH(0x05),
104
+ * @n M0: Interrupt Modes: RISING(0x04), FALLING(0x03), CHANGE(0x02), HIGH(0x01), LOW(0x00)
105
+ * @n microbit: Interrupt Modes: RISING(0x04), FALLING(0x03), CHANGE(0x02)
106
+ */
107
+ pinMode(INT_PIN, INPUT_PULLUP);
108
+ attachInterrupt(/*pin=*/digitalPinToInterrupt(INT_PIN),/*fun=*/notify,/*mode =*/FALLING);
109
+ Serial.println("Set done!");
110
+}
111
+
112
+/*Interrupt service function*/
113
+void notify(){
114
+ intFlag = true;
115
+}
116
+
117
+void loop() {
118
+ if(intFlag){
119
+ intFlag = false;
120
+ ch423.pollInterrupts();
121
+ }
122
+ yield();
123
+}
... ...
\ No newline at end of file
Chip-cn-dat/WCH-dat/CH423-dat/ch423-ard-demo-sleep.ino
... ...
@@ -0,0 +1,123 @@
1
+/*!
2
+ * @file ioInterrupt.ino
3
+ * @brief This demo is used to demonstrate the detection of rising edge, falling edge or double edge interrupt on the GPIO pin
4
+ * @note When the module is configured as rising edge, falling edge or double edge interrupt, the MCU external interrupt should use falling edge interrupt to reduce errors
5
+ * @n After burning this demo, pin GPO15 of the module needs to be connected to the corresponding external interrupt pin of MCU
6
+ * @n Hardware connection
7
+ * @n ---------------------------------------------------------
8
+ * @n module |UNO |mega2560 |M0 |ESP32 |ESP8266 |microbit |
9
+ * @n VCC |VCC |VCC |VCC |VCC |VCC |VCC |
10
+ * @n GND |GND |GND |GND |GND |GND |GND |
11
+ * @n SCL |SCL |SCL |SCL |SCL |SCL |SCL |
12
+ * @n SDA |SDA |SDA |SDA |SDA |SDA |SDA |
13
+ * @n GPO15 |2/D2 |2/D2 |2 |2 |12 |P9 |
14
+ * @n ---------------------------------------------------------
15
+ * @note If the level of any pin of GPIO0~GPIO7 changes, GPO15 will output a low level signal, and it outputs high level until the levels of GPIO0~GPIO7 pins return to the initial level.
16
+ * @n Leonardo is not supported
17
+ * @copyright Copyright (c) 2010 DFRobot Co.Ltd (http://www.dfrobot.com)
18
+ * @license The MIT License (MIT)
19
+ * @author [Arya](xue.peng@dfrobot.com)
20
+ * @version V1.0
21
+ * @date 2022-03-11
22
+ * @url https://github.com/DFRobot/DFRobot_CH423
23
+ */
24
+#include "DFRobot_CH423.h"
25
+
26
+DFRobot_CH423 ch423;
27
+
28
+#if defined(ARDUINO_BBC_MICROBIT)
29
+#define INT_PIN 9 //Connect pin GPO15 of the module to pin 9 of the MCU. For some MCUs, download the codes first and then connect hardware.
30
+#elif defined(ESP8266)
31
+#define INT_PIN 12 //Connect pin GPO15 of the module to pin 12 of the MCU. For some MCUs, download the codes first and then connect hardware.
32
+#else
33
+#define INT_PIN 2 //Connect pin GPO15 of the module to pin 2 of the MCU. For some MCUs, download the codes first and then connect hardware.
34
+#endif
35
+
36
+bool intFlag = false; //INT interrupt sign
37
+
38
+/*Interrupt service function, prototype void func(int index), index: the number of the pin that is interrupted*/
39
+void func(int index){
40
+ String description = ch423.pinDescription(/*pin = */(DFRobot_CH423::eGPIOPin_t)index);
41
+ Serial.print(description);
42
+ Serial.println(" Interruption occurs!");
43
+}
44
+
45
+void setup() {
46
+ Serial.begin(115200);
47
+
48
+ while(!Serial){
49
+
50
+ }
51
+ ch423.begin();
52
+ /**
53
+ * @fn pinMode
54
+ * @brief Set the mode of the pin groups, this module contains 2 groups of pins: GPIO(GPIO0~GPIO7) and GPO(GPO0~GPO15).
55
+ * @note This module sets the mode by group, the pins in a group can only be set as one mode at the same time, and the pins in different groups can be set as different modes
56
+ * @param group Pin group parameter, ePinGroup_t enum variable member
57
+ * @n eGPIO Bi-directional I/O pin, GPIO0~GPIO7, which can be set as input(eINPUT) or output(eOUTPUT) mode, setting to other modes is invalid
58
+ * @n eGPO/eGPO0_7/eGPO8_15 The three parameters indicate the same meaning, set the mode of GPO group pins, select the parameter and GPO pins can only be configured as open-drain(eOPEN_DRAIN) or push-pull(ePUSH_PULL) output mode, other modes are invalid
59
+ * @param mode Group pin mode parameter, as member enum variable of eMode_t
60
+ * @n eINPUT GPIO pin input mode, at high level when floating, this mode can only be used for eGPIO digital ports
61
+ * @n eOUTPUT GPIO pin output mode, can output high and low levels, this mode can only be used for eGPIO digital ports
62
+ * @n eOPEN_DRAIN GPO pin open-drain output mode, the GPO pins only output low level or don't output in this mode, it can only be used for eGPO group digital ports
63
+ * @n ePUSH_PULL GPO pin push-pull output mode, the GPO pin can output high or low level in this mode, it can only be used for eGPO digital ports
64
+ */
65
+ ch423.pinMode(ch423.eGPIO, ch423.eINPUT);
66
+ /**
67
+ * @fn attachInterrupt
68
+ * @brief Set the external interrupt mode and interrupt service function of GPIO pins
69
+ * @note Pin GPO15 of CH423 module is used to indicate whether an interrupt occurs on GPIO0~GPIO7 in interrupt mode, if an interrupt occurs on a pin, GPO15 will output a low level continuously, otherwise it will output a high level.
70
+ * @n When an interrupt occurs on a pin, trigger continuously, if there is interrupt occurring on other pins, level of pin GPO15 keeps low without changing
71
+ * @param gpioPin GPIO group pins, eGPIOPin_t enum variable member
72
+ * @n eGPIO0 Bi-directional I/O pin, GPIO0, indicates setting the external interrupt mode and interrupt service function of pin GPIO0
73
+ * @n eGPIO1 Bi-directional I/O pin, GPIO1, indicates setting the external interrupt mode and interrupt service function of pin GPIO1
74
+ * @n eGPIO2 Bi-directional I/O pin, GPIO2, indicates setting the external interrupt mode and interrupt service function of pin GPIO2
75
+ * @n eGPIO3 Bi-directional I/O pin, GPIO3, indicates setting the external interrupt mode and interrupt service function of pin GPIO3
76
+ * @n eGPIO4 Bi-directional I/O pin, GPIO4, indicates setting the external interrupt mode and interrupt service function of pin GPIO4
77
+ * @n eGPIO5 Bi-directional I/O pin, GPIO5, indicates setting the external interrupt mode and interrupt service function of pin GPIO5
78
+ * @n eGPIO6 Bi-directional I/O pin, GPIO6, indicates setting the external interrupt mode and interrupt service function of pin GPIO6
79
+ * @n eGPIO7 Bi-directional I/O pin, GPIO7, indicates setting the external interrupt mode and interrupt service function of pin GPIO7
80
+ * @n eGPIOTotal Set the values of all GPIO group pins, which indicates setting GPIO0~GPIO7 to the same interrupt mode and interrupt service function
81
+ * @param mode Interrupt mode
82
+ * @n eLOW Low level interrupt, initial level of the GPIO pin is high, if the GPIO pin detect a low level, pin GPO15 will output a low level signal
83
+ * @n eHIGH High level interrupt, initial level of the GPIO pin is low, if the GPIO pin detect a high level, pin GPO15 will output a low level signal
84
+ * @n eRISING Rising edge interrupt, initial level of the GPIO pin is low, if the GPIO pin detect a rising edge, pin GPO15 will output a high-to-low level signal (falling edge)
85
+ * @n eFALLING Falling edge interrupt, initial level of the GPIO pin is high, if the GPIO pin detect a falling edge, pin GPO15 will output a high-to-low level signal (falling edge)
86
+ * @n eCHANGE Double edge interrupt, initial level of the GPIO pin is high, and the initial level switches once for each interrupt that occurs. If the GPIO pin detect falling edge or rising edge, pin GPO15 will output a high-to-low level signal (falling edge)
87
+ * @note If the level of any pin of GPIO0-GPIO7 changes, GPO15 will output a low level signal, and it outputs high level until the levels of GPIO0~GPIO7 pins return to the initial level
88
+ * @param cb Point to interrupt service function
89
+ */
90
+ ch423.attachInterrupt(/* gpioPin= */ch423.eGPIO0, /* mode= */ch423.eFALLING, /* cb= */func);
91
+ ch423.enableInterrupt();
92
+ /**
93
+ * @brief Enable the external interrupt pin of MCU.
94
+ * @param pin: The external pin of MCU.
95
+ * @n UNO: The external pin is 2, 3,
96
+ * @n Leonardo： (Not support)The external pin is 0(RX), 1(TX), 2(SCL), 3(SDA), but 0, 1, 2, 3 can't use in this demo
97
+ * @n Mega2560: The external pin is 2, 3, 21, 20, 19, 18.
98
+ * @n microbit: The external pin is 0~20(P0-P20)
99
+ * @n ESP32, ESP8266, M0: The external pin is all digital Pin and analog pin.
100
+ * @param fun: Pointer to guide interrupt service function.
101
+ * @param mode: Interrupt trigger mode.
102
+ * @n UNO/Leonardo/Mega2560: Interrupt Modes: RISING(0x03), FALLING(0x02), CHANGE(0x01), LOW(0x00)
103
+ * @n 8266/esp32: Interrupt Modes: RISING(0x01), FALLING(0x02), CHANGE(0x03), ONLOW(0x04), ONHIGH(0x05),
104
+ * @n M0: Interrupt Modes: RISING(0x04), FALLING(0x03), CHANGE(0x02), HIGH(0x01), LOW(0x00)
105
+ * @n microbit: Interrupt Modes: RISING(0x04), FALLING(0x03), CHANGE(0x02)
106
+ */
107
+ pinMode(INT_PIN, INPUT_PULLUP);
108
+ attachInterrupt(/*pin=*/digitalPinToInterrupt(INT_PIN),/*fun=*/notify,/*mode =*/FALLING);
109
+ Serial.println("Set done!");
110
+}
111
+
112
+/*Interrupt service function*/
113
+void notify(){
114
+ intFlag = true;
115
+}
116
+
117
+void loop() {
118
+ if(intFlag){
119
+ intFlag = false;
120
+ ch423.pollInterrupts();
121
+ }
122
+ yield();
123
+}
... ...
\ No newline at end of file
Chip-cn-dat/WCH-dat/CH423-dat/ch423-ard-demo-waterLamp.ino
... ...
@@ -0,0 +1,90 @@
1
+/*!
2
+ * @file waterLamp.ino
3
+ * @brief This demo is used to make RGB LED realize the effect of the water flowing effect
4
+ * @note 8 LEDs need to be connected to GPIO group pins, GPO0~7 group pins, or GPO8~15 group pins, you can switch GROUP_FLAG to achieve the effect of connecting to the IO port of different groups
5
+ *
6
+ * @copyright Copyright (c) 2010 DFRobot Co.Ltd (http://www.dfrobot.com)
7
+ * @license The MIT License (MIT)
8
+ * @author [Arya](xue.peng@dfrobot.com)
9
+ * @version V1.0
10
+ * @date 2022-03-11
11
+ * @url https://github.com/DFRobot/DFRobot_CH423
12
+ */
13
+#include "DFRobot_CH423.h"
14
+
15
+#define GROUP_GPIO 0
16
+#define GROUP_GPO0_7 1
17
+#define GROUP_GPO8_15 2
18
+
19
+//Control macro GROUP_FLAG to realize the connecting of the LED to the pin group of the module
20
+#define GROUP_FLAG GROUP_GPIO
21
+//#define GROUP_FLAG GROUP_GPO0_7
22
+//#define GROUP_FLAG GROUP_GPO8_15
23
+
24
+DFRobot_CH423 ch423;
25
+
26
+void setup() {
27
+ Serial.begin(115200);
28
+
29
+ while(!Serial){
30
+
31
+ }
32
+ ch423.begin();
33
+ /**
34
+ * @fn pinMode
35
+ * @brief Set the mode of the pin groups, this module contains 2 groups of pins: GPIO(GPIO0~GPIO7) and GPO(GPO0~GPO15).
36
+ * @note This module sets the mode by group, the pins in a group can only be set as one mode at the same time, and the pins in different groups can be set as different modes
37
+ * @param group Pin group parameter, ePinGroup_t enum variable member
38
+ * @n eGPIO Bi-directional I/O pins, GPIO0~GPIO7, which can be set as input(eINPUT) or output(eOUTPUT) mode, invalid when set to other modes
39
+ * @n eGPO/eGPO0_7/eGPO8_15 The three parameters indicate the same meaning, set the mode of GPO group pins, select the parameter and GPO pins can only be configured as open-drain(eOPEN_DRAIN) or push-pull(ePUSH_PULL) output mode, other modes are invalid
40
+ * @param mode Group pin mode parameter, as member enum variable of eMode_t
41
+ * @n eINPUT GPIO pin input mode, at high level when floating, this mode can only be used for eGPIO digital ports
42
+ * @n eOUTPUT GPIO pin output mode, can output high and low levels, this mode can only be used for eGPIO digital ports
43
+ * @n eOPEN_DRAIN GPO pin open-drain output mode, the GPO pins only output low level or don't output in this mode, it can only be used for eGPO group digital ports
44
+ * @n ePUSH_PULL GPO pin push-pull output mode, the GPO pin can output high or low level in this mode, it can only be used for eGPO digital ports
45
+ */
46
+#if (GROUP_FLAG == GROUP_GPIO)
47
+ ch423.pinMode(ch423.eGPIO, ch423.eOUTPUT);
48
+#else
49
+ ch423.pinMode(ch423.eGPO, ch423.ePUSH_PULL);
50
+#endif
51
+}
52
+
53
+void loop() {
54
+#if (GROUP_FLAG == GROUP_GPIO)
55
+
56
+ DFRobot_CH423::eGPIOPin_t gpioBuf[]= {ch423.eGPIO0, ch423.eGPIO1, ch423.eGPIO2, ch423.eGPIO3, ch423.eGPIO4, ch423.eGPIO5, ch423.eGPIO6, ch423.eGPIO7};
57
+ int on = 0, off;
58
+ ch423.digitalWrite(gpioBuf[on], HIGH);
59
+ for(on = 1, off = 0; on < sizeof(gpioBuf)/sizeof(DFRobot_CH423::eGPIOPin_t); on++, off++){
60
+ ch423.digitalWrite(gpioBuf[on], HIGH);
61
+ ch423.digitalWrite(gpioBuf[off], LOW);
62
+ delay(200);
63
+ }
64
+ ch423.digitalWrite(gpioBuf[off], LOW);
65
+
66
+#elif (GROUP_FLAG == GROUP_GPO0_7)
67
+ DFRobot_CH423::eGPOPin_t gpoBuf[]= {ch423.eGPO0, ch423.eGPO1, ch423.eGPO2, ch423.eGPO3, ch423.eGPO4, ch423.eGPO5, ch423.eGPO6, ch423.eGPO7};
68
+ int on = 0, off;
69
+ ch423.digitalWrite(gpoBuf[on], HIGH);
70
+ for(on = 1, off = 0; on < sizeof(gpoBuf)/sizeof(DFRobot_CH423::eGPOPin_t); on++, off++){
71
+ ch423.digitalWrite(gpoBuf[on], HIGH);
72
+ ch423.digitalWrite(gpoBuf[off], LOW);
73
+ delay(200);
74
+ }
75
+ ch423.digitalWrite(gpoBuf[off], LOW);
76
+#else
77
+ DFRobot_CH423::eGPOPin_t gpoBuf[]= {ch423.eGPO8, ch423.eGPO9, ch423.eGPO10, ch423.eGPO11, ch423.eGPO12, ch423.eGPO13, ch423.eGPO14, ch423.eGPO15};
78
+ int on = 0, off;
79
+ ch423.digitalWrite(gpoBuf[on], HIGH);
80
+ for(on = 1, off = 0; on < sizeof(gpoBuf)/sizeof(DFRobot_CH423::eGPOPin_t); on++, off++){
81
+ ch423.digitalWrite(gpoBuf[on], HIGH);
82
+ ch423.digitalWrite(gpoBuf[off], LOW);
83
+ delay(200);
84
+ }
85
+ ch423.digitalWrite(gpoBuf[off], LOW);
86
+#endif
87
+ delay(200);
88
+}
89
+
90
+
Chip-cn-dat/WCH-dat/CH432-dat/CH432DS1.PDF
... ...
Binary files /dev/null and b/Chip-cn-dat/WCH-dat/CH432-dat/CH432DS1.PDF differ
Chip-dat/TI-dat/PCM5102-dat/PCM5102-dat.md
... ...
@@ -0,0 +1,25 @@
1
+
2
+# PCM5102-dat
3
+
4
+https://www.ti.com/product/PCM5102
5
+
6
+https://www.ti.com/lit/ds/symlink/pcm5102.pdf?ts=1733652266351&ref_url=https%253A%252F%252Fwww.ti.com%252Fproduct%252FPCM5102
7
+
8
+- [[AMP1006-dat]]
9
+
10
+- A_VDD
11
+- D_VDD
12
+
13
+## 1.8V logic tolerant consideration
14
+
15
+The I2S signals on the PCM5122 are typically not guaranteed to reliably tolerate 1.8V logic levels.
16
+
17
+You should use level shifters to safely interface a 1.8V system with the PCM5122, especially for high-speed communication like I2S.
18
+
19
+
20
+
21
+
22
+
23
+## ref
24
+
25
+- [[PCM5122-dat]]
... ...
\ No newline at end of file
Chip-dat/TI-dat/PCM5122-dat/2024-12-03-17-25-44.png
... ...
Binary files /dev/null and b/Chip-dat/TI-dat/PCM5122-dat/2024-12-03-17-25-44.png differ
Chip-dat/TI-dat/PCM5122-dat/2024-12-03-17-27-57.png
... ...
Binary files /dev/null and b/Chip-dat/TI-dat/PCM5122-dat/2024-12-03-17-27-57.png differ
Chip-dat/TI-dat/PCM5122-dat/PCM5122-dat.md
... ...
@@ -0,0 +1,27 @@
1
+
2
+# PCM5122-dat
3
+
4
+https://www.ti.com/lit/ds/symlink/pcm5122.pdf?ts=1733217884746&ref_url=https%253A%252F%252Fwww.google.com%252F
5
+
6
+PCM512x 2-VRMS DirectPath™, 112-dB and 106-dB Audio Stereo DACsWith 32-Bit, 384-kHz PCM Interface
7
+
8
+## Function Diagram
9
+
10
+- [[PCM1863-dat]] - [[TPA3130-dat]] - [[TPA6120-dat]] - [[MSP430-dat]]
11
+
12
+- [[I2S-dat]]
13
+
14
+![](2024-12-03-17-25-44.png)
15
+
16
+![](2024-12-03-17-27-57.png)
17
+
18
+- normally use the [[SPI-dat]] output
19
+
20
+## Board
21
+
22
+- [[MPC1083-dat]]
23
+
24
+
25
+## ref
26
+
27
+
Chip-dat/broadcom-dat/BCM2711-dat/BCM2711-dat.md
... ...
@@ -0,0 +1,20 @@
1
+
2
+# BCM2711-dat
3
+
4
+
5
+https://elinux.org/RPi_BCM2711_GPIOs
6
+
7
+There are 58 General-Purpose Input/Output (GPIO) lines split into three banks.
8
+
9
+- Bank 0 contains GPIOs 0 to 27,
10
+- bank 1 contains GPIOs 28 to 45,
11
+- and bank 2 contains GPIOs 46 to 57.
12
+
13
+All GPIO pins have at least two alternative functions within BCM2711.
14
+
15
+- https://github.com/raspberrypi/linux/blob/rpi-5.4.y/arch/arm/boot/dts/bcm2711.dtsi
16
+
17
+
18
+
19
+- [[bcm2711-peripherals.pdf]]
20
+
Chip-dat/broadcom-dat/BCM2711-dat/bcm2711-peripherals.pdf
... ...
Binary files /dev/null and b/Chip-dat/broadcom-dat/BCM2711-dat/bcm2711-peripherals.pdf differ
Chip-dat/broadcom-dat/BCM2835-dat/BCM2835-dat.md
... ...
@@ -0,0 +1,4 @@
1
+
2
+# BCM2835-dat
3
+
4
+https://elinux.org/RPi_BCM2835_GPIOs
... ...
\ No newline at end of file
Chip-dat/broadcom-dat/broadcom-dat.md
... ...
@@ -0,0 +1,4 @@
1
+
2
+# broadcom-dat
3
+
4
+- [[BCM2711-dat]]
... ...
\ No newline at end of file
FAQ-dat/discount-dat/discount-dat.md
... ...
@@ -7,7 +7,7 @@ Our profit margin is normally at 30% for all products.
7 7
8 8
For bulk order we can provide up to 15% discount. Please enquiry by emails to info@electrodragon.com for detailed discount setup.
9 9
10
-## Order Procedure
10
+## How to Order with Discount
11 11
12 12
Please add the matching quantity into your cart, and the price will be automatically updated.
13 13
... ...
@@ -34,5 +34,6 @@ Thank you.
34 34
35 35
| SKU | MOQ | discount |
36 36
| --------------- | ------ | -------- |
37
-| [[ILC1031-dat]] | 30pcs | 10% |
38
-| [[DPR1157-dat]] | 30pcs | 15% |
... ...
\ No newline at end of file
0
+| [[ILC1031-dat]] | 30pcs | 10% |
1
+| [[DPR1157-dat]] | 30pcs | 15% |
2
+| [[MPC1073-dat]] | 100pcs | 15% |
... ...
\ No newline at end of file
FAQ-dat/invoice-dat/invoice-dat.md
... ...
@@ -0,0 +1,15 @@
1
+
2
+# invoice-dat
3
+
4
+
5
+Dear customer,
6
+
7
+We are a small company running an automated online store, we only support online store payment. 
8
+
9
+You can find shipping costs and options while online checkout.
10
+
11
+If you need a proforma invoice, you can hold the payment (hold on the last step while checkout and keep it as a pending order). I will email you it later as a PDF.
12
+
13
+If you just need an invoice afterward, you can place the order directly, and download the invoice later from your account page.
14
+
15
+Thank you. Best Regards
... ...
\ No newline at end of file
SDK-dat/RPI-OS-dat/RPI-OS-dat.md
... ...
@@ -19,7 +19,7 @@ https://www.raspberrypi.com/software/
19 19
20 20
Raspberry Pi OS (64-bit): 3B 3B+ 3A+ 4B 400 5 CM3 CM3+ CM4 CM4S Zero 2 W
21 21
22
-
22
+- login user "admin", should set password for it, prbably another "admin"
23 23
24 24
25 25
Shipment-dat/Internal-tracking-dat/2024-12-12-15-39-57.png
... ...
Binary files /dev/null and b/Shipment-dat/Internal-tracking-dat/2024-12-12-15-39-57.png differ
Shipment-dat/Internal-tracking-dat/Internal-tracking-dat.md
... ...
@@ -0,0 +1,11 @@
1
+
2
+# Internal-tracking-dat
3
+
4
+- Use the internal tracking number, format as R9656924........ for example R965692411290001
5
+
6
+- in which R96569 for our shipping code, 241129 for date, 0001 for package number
7
+
8
+- Track the package at [pfctrack](http://pfctrack.com/)
9
+
10
+![](2024-12-12-15-39-57.png)
11
+
Shipment-dat/Shipment-DAT.md
... ...
@@ -1,6 +1,8 @@
1 1
2 2
# Shipment-dat
3 3
4
+- how to use [[internal-tracking-dat]] internal tracking number
5
+
4 6
## Important Note
5 7
6 8
- **Brazil, Chile, Argentina, South Africa**, customers please MUST provide tax id / or personal ID number for shipment - [[shipment-requirement-dat]]
... ...
@@ -52,6 +54,9 @@ Normal Post, worldwide delivery
52 54
53 55
- [[remote-address-dat]] sometimes will be extrally applied
54 56
57
+
58
+
59
+
55 60
## ref
56 61
57 62
- [[shipment-by-country]] - [[shipment-by-continent]]
Shipment-dat/remote-address-dat.md
... ...
@@ -1,7 +0,0 @@
1
-
2
-# remote address
3
-
4
-- [DHL remote address list](https://www.dhl.de/content/dam/images/Express/downloads/dhl-express-remote-areas-service.pdf)
5
- - no remote address for US for DHL
6
-- [Fedex remote address list](https://www.fedex.com/content/dam/fedex/us-united-states/services/Zipcodes_OPA_ODA.pdf)
7
-
Shipment-dat/remote-address-dat/remote-address-dat.md
... ...
@@ -0,0 +1,27 @@
1
+
2
+# remote address
3
+
4
+## zipcode checklist
5
+
6
+[DHL remote address list](https://www.dhl.de/content/dam/images/Express/downloads/dhl-express-remote-areas-service.pdf)
7
+
8
+- no remote address for US for DHL
9
+- alternative address - https://mydhl.express.dhl/content/dam/downloads/global/en/remote-areas/dhl_express_remote_areas_en.pdf.coredownload.pdf
10
+
11
+
12
+
13
+
14
+[Fedex remote address list](https://www.fedex.com/content/dam/fedex/us-united-states/services/Zipcodes_OPA_ODA.pdf)
15
+
16
+## Solutions and Options
17
+
18
+- Minimum charge cost 35 usd. if you insist to use the expres shipping option, please consider directly send the extra cost to info@electrodragon.com, and reply the email back
19
+
20
+- use alternative shipping methods: [[EUEX-dat]] for European countries, [[USPS-dat]] for US. Shipping cost is around 10 usd, and extra shipping cost will be refunded back via the original payment way.
21
+
22
+- Order cancel, please simply let us know by email back.
23
+
24
+
25
+## ref
26
+
27
+- [[偏远]]
... ...
\ No newline at end of file
Shipment-dat/shipment-express-dat/DHL-dat/DHL-dat.md
... ...
@@ -9,3 +9,6 @@ Please note Fedex / DHL normally need 2-4 days to process the shipment, we have
9 9
10 10
- [[HKDHL-BA]] - [[DHL-dct-dat]]
11 11
12
+- DHL lowest declare value for European Countries: 121 USD
13
+
14
+
Tech-dat/GPIO-dat/GPIO-dat.md
... ...
@@ -10,7 +10,12 @@ GPIOS (Giant Pixel Interleaved Octal Shifts) is a method used in data storage an
10 10
4. POI (Pull-Up Resistor In): In this mode, the cable noise can be filtered out by the internal pull-up resistors while the device is running.
11 11
5. POPI (Pull-Up Resistor/Pull-Down Input): It's a versatile option that provides isolation for both inputs and outputs
12 12
13
-d
13
+## IO expander
14
+
15
+- [[MSP1072-dat]] - [[MSP1064-dat]] - [[MSP1069-dat]]
16
+
17
+
18
+
14 19
15 20
## ref
16 21
Tech-dat/Interface-dat/I2C-dat/I2C-dat.md
... ...
@@ -45,6 +45,29 @@ the most easy to use library for ESP
45 45
- common pullup resistors 1K/4.7K/10K
46 46
![](2024-07-10-01-21-40.png)
47 47
48
+
49
+## setup for RPI I2C
50
+
51
+Driver Installing
52
+
53
+1.Enable Raspberry Pi I2C. Skip this step if it is already enabled. Open terminal and input the following commands and press "Enter":
54
+
55
+ pi@raspberrypi:~ $ sudo raspi-config
56
+
57
+Then use the UP/Down keys to select "5 Interfacing Options", press Enter, select "P5 I2C" and press Enter to comfirm "Yes". Restart the Raspeberry Pi board.
58
+
59
+2.To install Python dependency library and git, the Raspberry Pi needs to be networked. Skip this step if already installed. In the terminal, input the following commands and press Enter:
60
+
61
+ pi@raspberrypi:~ $ sudo apt-get update pi@raspberrypi:~ $ sudo apt-get install build-essential python-dev python-smbus git
62
+
63
+3.Download the DFRobot_CH423 driver library. In the terminal, type the following commands and press Enter:
64
+
65
+ pi@raspberrypi:~ $ cd Desktop/ `pi@raspberrypi:~/Desktop $ git clone https://github.com/DFRobot/DFRobot_CH423
66
+
67
+
68
+
69
+
70
+
48 71
## ref
49 72
50 73
- https://randomnerdtutorials.com/esp32-i2c-communication-arduino-ide/#1
Tech-dat/Interface-dat/I2S-dat/I2S-dat.md
... ...
@@ -20,12 +20,24 @@ This makes I2S a popular choice for high-speed data transfer applications.
20 20
| SD | SDIN / SDOUT | At least one multiplexed data line | G21 | PIN 40 |
21 21
22 22
23
+
24
+
25
+
23 26
## Solution
24 27
25 28
- [[WM8960-dat]]
26 29
30
+- [[PCM5102-dat]] - [[AMP1006-dat]]
31
+
32
+- [[UDA1334-dat]] - [[AMP1013-dat]]
33
+
34
+- [[PCM5122-dat]] - [[MPC1083-dat]] - [[I2S-dat]]
35
+
36
+- [[bt-audio-dat]] - [[DAC-dat]] - [[ADC-dat]]
27 37
38
+- [[ES9023-dat]] - [[MPC1111-dat]]
28 39
40
+- [[PCM1808-dat]]
29 41
30 42
## ref
31 43
Tech-dat/Interface-dat/SPI-dat/SPI-dat.md
... ...
@@ -0,0 +1,13 @@
1
+
2
+# SPI-dat
3
+
4
+
5
+| pin | function | note |
6
+| ---- | -------- | ---------- |
7
+| CLK | | 3-wire SPI |
8
+| MISO | | 3-wire SPI |
9
+| MOSI | | 3-wire SPI |
10
+| CS | | 4-wire SPI |
11
+
12
+
13
+- [[interface-dat]]
... ...
\ No newline at end of file
Tech-dat/Network-dat/Infrared-dat/Infrared-dat.md
... ...
@@ -1,6 +1,11 @@
1 1
2 2
# Infrared
3 3
4
+
5
+
6
+
7
+
8
+
4 9
## Boards
5 10
6 11
- [[SIR1008-dat]]
... ...
@@ -21,6 +26,7 @@ arduino shield - [[DAS1013-dat]]
21 26
22 27
## Demo code
23 28
29
+- https://github.com/Edragon/Infrared
24 30
25 31
## ref
26 32
Tech-dat/Network-dat/Infrared-dat/infrared-receiver/2024-12-03-18-12-48.png
... ...
Binary files /dev/null and b/Tech-dat/Network-dat/Infrared-dat/infrared-receiver/2024-12-03-18-12-48.png differ
Tech-dat/Network-dat/Infrared-dat/infrared-receiver/infrared-receiver-dat.md
... ...
@@ -1,18 +1,24 @@
1 1
2 2
# infrared-receiver
3 3
4
-0038
4
+## 0038
5 5
6 6
![](2024-01-04-16-55-47.png)
7 7
8
-0038-2
8
+## 0038-2
9 9
10 10
![](2024-01-04-16-58-41.png)
11 11
12
-## SCH
12
+## HX1838
13
+
14
+- HX1838 SCH
13 15
14 16
![](2024-01-04-16-59-58.png)
15 17
18
+Internal diagram of HX1838
19
+
20
+![](2024-12-03-18-12-48.png)
21
+
16 22
17 23
## Params
18 24
Tech-dat/Network-dat/Infrared-dat/infrared-sender/infrared-sender-dat.md
... ...
@@ -1,6 +1,10 @@
1 1
2 2
# infrared-sender-dat
3 3
4
+
5
+
6
+## 5mm 940nm common IR sender
7
+
4 8
Wavelength: 940nm
5 9
6 10
Transmission range: This component is an infrared emission tube.
Tech-dat/Network-dat/ethernet-dat/PHY-dat/PHY-dat.md
... ...
@@ -0,0 +1,52 @@
1
+
2
+# PHY-dat
3
+
4
+
5
+
6
+
7
+## PHY (Physical Layer Transceiver)
8
+
9
+In networking, a PHY is a hardware component responsible for the Physical Layer (Layer 1) of the OSI model, which deals with the electrical or optical signal transmission and reception. It's typically used in Ethernet systems to interface between the digital data from a MAC (Media Access Controller) and the physical medium, such as twisted-pair cables or fiber optics.
10
+
11
+Key roles of a PHY:
12
+
13
+- Signal encoding/decoding: Converts digital data (from the MAC) into signals suitable for transmission over physical media (and vice versa).
14
+- Clock recovery: Extracts clock signals from incoming data streams.
15
+- Auto-negotiation: Determines connection parameters like speed (10/100/1000 Mbps) and duplex mode (full/half).
16
+- Media-dependent interfaces: Provides the electrical interface for the transmission medium, such as copper wires or fiber.
17
+
18
+The PHY communicates with the MAC through standardized interfaces like RGMII, MII, or GMII.
19
+
20
+
21
+
22
+## RGMII (Reduced Gigabit Media Independent Interface)
23
+
24
+RGMII is a standard interface used between a MAC and a PHY to support Gigabit Ethernet (1 Gbps) connectivity. It is a more compact and efficient version of GMII, reducing the number of data pins.
25
+
26
+Features of RGMII:
27
+
28
+1. Reduced pin count: Uses only 12 data pins (compared to GMII's 24 pins) by transmitting data on both the rising and falling edges of the clock (DDR - Double Data Rate).
29
+2. Speed support: Capable of operating at 10 Mbps, 100 Mbps, and 1 Gbps.
30
+3. Signals in RGMII:
31
+- TX (Transmit) and RX (Receive) data signals
32
+- Clock signals for TX and RX
33
+- Control signals (TX_EN, RX_DV)
34
+
35
+RGMII enables the MAC and PHY to communicate effectively while optimizing space and complexity.
36
+
37
+
38
+
39
+
40
+## MDIO (Management Data Input/Output)
41
+
42
+The MDIO (Management Data Input/Output) interface is a two-wire protocol used for managing and configuring Ethernet PHYs. It allows the MAC (or a host controller) to:
43
+
44
+- Read status registers in the PHY.
45
+- Configure operating modes (e.g., speed, duplex, auto-negotiation settings).
46
+
47
+MDIO Interface Components:
48
+- MDIO Signal: A bidirectional data line that transfers register addresses and data between the controller and the PHY.
49
+- MDC (Management Data Clock): A clock signal provided by the MAC or host to synchronize MDIO operations.
50
+
51
+
52
+Using the MDIO interface, a host can control multiple PHY devices on the same bus by assigning unique addresses to each PHY.
... ...
\ No newline at end of file
Tech-dat/Network-dat/software-define-radio-dat/software-define-radio-dat.md
... ...
@@ -0,0 +1,5 @@
1
+
2
+# software-define-radio-dat
3
+
4
+https://github.com/cariboulabs/cariboulite/tree/main
5
+
Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/2024-11-22-19-30-56.png
... ...
Binary files a/Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/2024-11-22-19-30-56.png and /dev/null differ
Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/2024-11-22-19-31-24.png
... ...
Binary files a/Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/2024-11-22-19-31-24.png and /dev/null differ
Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/README-CM-dat.md
... ...
@@ -0,0 +1,4981 @@
1
+Introduction
2
+============
3
+
4
+This directory contains Device Tree overlays. Device Tree makes it possible
5
+to support many hardware configurations with a single kernel and without the
6
+need to explicitly load or blacklist kernel modules. Note that this isn't a
7
+"pure" Device Tree configuration (c.f. MACH_BCM2835) - some on-board devices
8
+are still configured by the board support code, but the intention is to
9
+eventually reach that goal.
10
+
11
+On Raspberry Pi, Device Tree usage is controlled from /boot/config.txt. By
12
+default, the Raspberry Pi kernel boots with device tree enabled. You can
13
+completely disable DT usage (for now) by adding:
14
+
15
+ device_tree=
16
+
17
+to your config.txt, which should cause your Pi to revert to the old way of
18
+doing things after a reboot.
19
+
20
+In /boot you will find a .dtb for each base platform. This describes the
21
+hardware that is part of the Raspberry Pi board. The loader (start.elf and its
22
+siblings) selects the .dtb file appropriate for the platform by name, and reads
23
+it into memory. At this point, all of the optional interfaces (i2c, i2s, spi)
24
+are disabled, but they can be enabled using Device Tree parameters:
25
+
26
+ dtparam=i2c=on,i2s=on,spi=on
27
+
28
+However, this shouldn't be necessary in many use cases because loading an
29
+overlay that requires one of those interfaces will cause it to be enabled
30
+automatically, and it is advisable to only enable interfaces if they are
31
+needed.
32
+
33
+Configuring additional, optional hardware is done using Device Tree overlays
34
+(see below).
35
+
36
+GPIO numbering uses the hardware pin numbering scheme (aka BCM scheme) and
37
+not the physical pin numbers.
38
+
39
+raspi-config
40
+============
41
+
42
+The Advanced Options section of the raspi-config utility can enable and disable
43
+Device Tree use, as well as toggling the I2C and SPI interfaces. Note that it
44
+is possible to both enable an interface and blacklist the driver, if for some
45
+reason you should want to defer the loading.
46
+
47
+Modules
48
+=======
49
+
50
+As well as describing the hardware, Device Tree also gives enough information
51
+to allow suitable driver modules to be located and loaded, with the corollary
52
+that unneeded modules are not loaded. As a result it should be possible to
53
+remove lines from /etc/modules, and /etc/modprobe.d/raspi-blacklist.conf can
54
+have its contents deleted (or commented out).
55
+
56
+Using Overlays
57
+==============
58
+
59
+Overlays are loaded using the "dtoverlay" config.txt setting. As an example,
60
+consider I2C Real Time Clock drivers. In the pre-DT world these would be loaded
61
+by writing a magic string comprising a device identifier and an I2C address to
62
+a special file in /sys/class/i2c-adapter, having first loaded the driver for
63
+the I2C interface and the RTC device - something like this:
64
+
65
+ modprobe i2c-bcm2835
66
+ modprobe rtc-ds1307
67
+ echo ds1307 0x68 > /sys/class/i2c-adapter/i2c-1/new_device
68
+
69
+With DT enabled, this becomes a line in config.txt:
70
+
71
+ dtoverlay=i2c-rtc,ds1307
72
+
73
+This causes the file /boot/overlays/i2c-rtc.dtbo to be loaded and a "node"
74
+describing the DS1307 I2C device to be added to the Device Tree for the Pi. By
75
+default it usees address 0x68, but this can be modified with an additional DT
76
+parameter:
77
+
78
+ dtoverlay=i2c-rtc,ds1307,addr=0x68
79
+
80
+Parameters usually have default values, although certain parameters are
81
+mandatory. See the list of overlays below for a description of the parameters
82
+and their defaults.
83
+
84
+Making new Overlays based on existing Overlays
85
+==============================================
86
+
87
+Recent overlays have been designed in a more general way, so that they can be
88
+adapted to hardware by changing their parameters. When you have additional
89
+hardware with more than one device of a kind, you end up using the same overlay
90
+multiple times with other parameters, e.g.
91
+
92
+ # 2 CAN FD interfaces on spi but with different pins
93
+ dtoverlay=mcp251xfd,spi0-0,interrupt=25
94
+ dtoverlay=mcp251xfd,spi0-1,interrupt=24
95
+
96
+ # a realtime clock on i2c
97
+ dtoverlay=i2c-rtc,pcf85063
98
+
99
+While this approach does work, it requires knowledge about the hardware design.
100
+It is more feasible to simplify things for the end user by providing a single
101
+overlay as it is done the traditional way.
102
+
103
+A new overlay can be generated by using ovmerge utility.
104
+https://github.com/raspberrypi/utils/blob/master/ovmerge/ovmerge
105
+
106
+To generate an overlay for the above configuration we pass the configuration
107
+to ovmerge and add the -c flag.
108
+
109
+ ovmerge -c mcp251xfd-overlay.dts,spi0-0,interrupt=25 \
110
+ mcp251xfd-overlay.dts,spi0-1,interrupt=24 \
111
+ i2c-rtc-overlay.dts,pcf85063 \
112
+ >> merged-overlay.dts
113
+
114
+The -c option writes the command above as a comment into the overlay as
115
+a marker that this overlay is generated and how it was generated.
116
+After compiling the overlay it can be loaded in a single line.
117
+
118
+ dtoverlay=merged
119
+
120
+It does the same as the original configuration but without parameters.
121
+
122
+The Overlay and Parameter Reference
123
+===================================
124
+
125
+N.B. When editing this file, please preserve the indentation levels to make it
126
+simple to parse programmatically. NO HARD TABS.
127
+
128
+
129
+Name: <The base DTB>
130
+Info: Configures the base Raspberry Pi hardware
131
+Load: <loaded automatically>
132
+Params:
133
+ ant1 Select antenna 1 (default). CM4 only.
134
+
135
+ ant2 Select antenna 2. CM4 only.
136
+
137
+ noant Disable both antennas. CM4 only.
138
+
139
+ audio Set to "on" to enable the onboard ALSA audio
140
+ interface (default "off")
141
+
142
+ axiperf Set to "on" to enable the AXI bus performance
143
+ monitors.
144
+ See /sys/kernel/debug/raspberrypi_axi_monitor
145
+ for the results.
146
+
147
+ bdaddr Set an alternative Bluetooth address (BDADDR).
148
+ The value should be a 6-byte hexadecimal value,
149
+ with or without colon separators, written least-
150
+ significant-byte first. For example,
151
+ bdaddr=06:05:04:03:02:01
152
+ will set the BDADDR to 01:02:03:04:05:06.
153
+
154
+ button_debounce Set the debounce delay (in ms) on the power/
155
+ shutdown button (default 50ms)
156
+
157
+ cam0_reg Enables CAM 0 regulator.
158
+ Only required on CM1 & 3.
159
+
160
+ cam0_reg_gpio Set GPIO for CAM 0 regulator.
161
+ Default 31 on CM1, 3, and 4S.
162
+ Default of GPIO expander 5 on CM4, but override
163
+ switches to normal GPIO.
164
+
165
+ cam1_reg Enables CAM 1 regulator.
166
+ Only required on CM1 & 3.
167
+
168
+ cam1_reg_gpio Set GPIO for CAM 1 regulator.
169
+ Default 3 on CM1, 3, and 4S.
170
+ Default of GPIO expander 5 on CM4, but override
171
+ switches to normal GPIO.
172
+
173
+ cooling_fan Enables the Pi 5 cooling fan (enabled
174
+ automatically by the firmware)
175
+
176
+ eee Enable Energy Efficient Ethernet support for
177
+ compatible devices (default "on"). See also
178
+ "tx_lpi_timer". Pi3B+ only.
179
+
180
+ eth_downshift_after Set the number of auto-negotiation failures
181
+ after which the 1000Mbps modes are disabled.
182
+ Legal values are 2, 3, 4, 5 and 0, where
183
+ 0 means never downshift (default 2). Pi3B+ only.
184
+
185
+ eth_led0 Set mode of LED0 - amber on Pi3B+ (default "1"),
186
+ green on Pi4 (default "0").
187
+ The legal values are:
188
+
189
+ Pi3B+
190
+
191
+ 0=link/activity 1=link1000/activity
192
+ 2=link100/activity 3=link10/activity
193
+ 4=link100/1000/activity 5=link10/1000/activity
194
+ 6=link10/100/activity 14=off 15=on
195
+
196
+ Pi4
197
+
198
+ 0=Speed/Activity 1=Speed
199
+ 2=Flash activity 3=FDX
200
+ 4=Off 5=On
201
+ 6=Alt 7=Speed/Flash
202
+ 8=Link 9=Activity
203
+
204
+ eth_led1 Set mode of LED1 - green on Pi3B+ (default "6"),
205
+ amber on Pi4 (default "8"). See eth_led0 for
206
+ legal values.
207
+
208
+ eth_max_speed Set the maximum speed a link is allowed
209
+ to negotiate. Legal values are 10, 100 and
210
+ 1000 (default 1000). Pi3B+ only.
211
+
212
+ hdmi Set to "off" to disable the HDMI interface
213
+ (default "on")
214
+
215
+ i2c An alias for i2c_arm
216
+
217
+ i2c_arm Set to "on" to enable the ARM's i2c interface
218
+ (default "off")
219
+
220
+ i2c_arm_baudrate Set the baudrate of the ARM's i2c interface
221
+ (default "100000")
222
+
223
+ i2c_baudrate An alias for i2c_arm_baudrate
224
+
225
+ i2c_csi_dsi Set to "on" to enable the i2c_csi_dsi interface
226
+
227
+ i2c_csi_dsi0 Set to "on" to enable the i2c_csi_dsi0 interface
228
+
229
+ i2c_csi_dsi1 Set to "on" to enable the i2c_csi_dsi1 interface
230
+
231
+ i2c_vc Set to "on" to enable the i2c interface
232
+ usually reserved for the VideoCore processor
233
+ (default "off")
234
+
235
+ i2c_vc_baudrate Set the baudrate of the VideoCore i2c interface
236
+ (default "100000")
237
+
238
+ i2s Set to "on" to enable the i2s interface
239
+ (default "off")
240
+
241
+ i2s_dma4 Use to enable 40-bit DMA on the i2s interface
242
+ (the assigned value doesn't matter)
243
+ (2711 only)
244
+
245
+ krnbt Set to "off" to disable autoprobing of Bluetooth
246
+ driver without need of hciattach/btattach
247
+ (default "on")
248
+
249
+ krnbt_baudrate Set the baudrate of the PL011 UART when used
250
+ with krnbt=on
251
+
252
+ nvme Alias for "pciex1" (2712 only)
253
+
254
+ pcie Set to "off" to disable the PCIe interface
255
+ (default "on")
256
+ (2711 only, but not applicable on CM4S)
257
+ N.B. USB-A ports on 4B are subsequently disabled
258
+
259
+ pciex1 Set to "on" to enable the external PCIe link
260
+ (2712 only, default "off")
261
+
262
+ pciex1_gen Sets the PCIe "GEN"/speed for the external PCIe
263
+ link (2712 only, default "2")
264
+
265
+ pciex1_no_l0s Set to "on" to disable ASPM L0s on the external
266
+ PCIe link for devices that have broken
267
+ implementations (2712 only, default "off")
268
+
269
+ spi Set to "on" to enable the spi interfaces
270
+ (default "off")
271
+
272
+ spi_dma4 Use to enable 40-bit DMA on spi interfaces
273
+ (the assigned value doesn't matter)
274
+ (2711 only)
275
+
276
+ random Set to "on" to enable the hardware random
277
+ number generator (default "on")
278
+
279
+ rtc_bbat_vchg Set the RTC backup battery charging voltage in
280
+ microvolts. If set to 0 or not specified, the
281
+ trickle charger is disabled.
282
+ (2712 only, default "0")
283
+
284
+ sd Set to "off" to disable the SD card (or eMMC on
285
+ non-lite SKU of CM4).
286
+ (default "on")
287
+
288
+ sd_overclock Clock (in MHz) to use when the MMC framework
289
+ requests 50MHz
290
+
291
+ sd_poll_once Looks for a card once after booting. Useful
292
+ for network booting scenarios to avoid the
293
+ overhead of continuous polling. N.B. Using
294
+ this option restricts the system to using a
295
+ single card per boot (or none at all).
296
+ (default off)
297
+
298
+ sd_force_pio Disable DMA support for SD driver (default off)
299
+
300
+ sd_pio_limit Number of blocks above which to use DMA for
301
+ SD card (default 1)
302
+
303
+ sd_debug Enable debug output from SD driver (default off)
304
+
305
+ sdio_overclock Clock (in MHz) to use when the MMC framework
306
+ requests 50MHz for the SDIO/WLAN interface.
307
+
308
+ suspend Make the power button trigger a suspend rather
309
+ than a power-off (2712 only, default "off")
310
+
311
+ tx_lpi_timer Set the delay in microseconds between going idle
312
+ and entering the low power state (default 600).
313
+ Requires EEE to be enabled - see "eee".
314
+
315
+ uart0 Set to "off" to disable uart0 (default "on")
316
+
317
+ uart0_console Move the kernel boot console to UART0 on pins
318
+ 6, 8 and 10 of the 40-way header (2712 only,
319
+ default "off")
320
+
321
+ uart1 Set to "on" or "off" to enable or disable uart1
322
+ (default varies)
323
+
324
+ watchdog Set to "on" to enable the hardware watchdog
325
+ (default "off")
326
+
327
+ wifiaddr Set an alternative WiFi MAC address.
328
+ The value should be a 6-byte hexadecimal value,
329
+ with or without colon separators, written in the
330
+ natural (big-endian) order.
331
+
332
+ act_led_trigger Choose which activity the LED tracks.
333
+ Use "heartbeat" for a nice load indicator.
334
+ (default "mmc")
335
+
336
+ act_led_activelow Set to "on" to invert the sense of the LED
337
+ (default "off")
338
+ N.B. For Pi 3B, 3B+, 3A+ and 4B, use the act-led
339
+ overlay.
340
+
341
+ act_led_gpio Set which GPIO to use for the activity LED
342
+ (in case you want to connect it to an external
343
+ device)
344
+ (default "16" on a non-Plus board, "47" on a
345
+ Plus or Pi 2)
346
+ N.B. For Pi 3B, 3B+, 3A+ and 4B, use the act-led
347
+ overlay.
348
+
349
+ pwr_led_trigger
350
+ pwr_led_activelow
351
+ pwr_led_gpio
352
+ As for act_led_*, but using the PWR LED.
353
+ Not available on Model A/B boards.
354
+
355
+ N.B. It is recommended to only enable those interfaces that are needed.
356
+ Leaving all interfaces enabled can lead to unwanted behaviour (i2c_vc
357
+ interfering with Pi Camera, I2S and SPI hogging GPIO pins, etc.)
358
+ Note also that i2c, i2c_arm and i2c_vc are aliases for the physical
359
+ interfaces i2c0 and i2c1. Use of the numeric variants is still possible
360
+ but deprecated because the ARM/VC assignments differ between board
361
+ revisions. The same board-specific mapping applies to i2c_baudrate,
362
+ and the other i2c baudrate parameters.
363
+
364
+
365
+Name: act-led
366
+Info: Pi 3B, 3B+, 3A+ and 4B use a GPIO expander to drive the LEDs which can
367
+ only be accessed from the VPU. There is a special driver for this with a
368
+ separate DT node, which has the unfortunate consequence of breaking the
369
+ act_led_gpio and act_led_activelow dtparams.
370
+ This overlay changes the GPIO controller back to the standard one and
371
+ restores the dtparams.
372
+Load: dtoverlay=act-led,<param>=<val>
373
+Params: activelow Set to "on" to invert the sense of the LED
374
+ (default "off")
375
+
376
+ gpio Set which GPIO to use for the activity LED
377
+ (in case you want to connect it to an external
378
+ device)
379
+ REQUIRED
380
+
381
+
382
+Name: adafruit-st7735r
383
+Info: Overlay for the SPI-connected Adafruit 1.8" 160x128 or 128x128 displays,
384
+ based on the ST7735R chip.
385
+ This overlay uses the newer DRM/KMS "Tiny" driver.
386
+Load: dtoverlay=adafruit-st7735r,<param>=<val>
387
+Params: 128x128 Select the 128x128 driver (default 160x128)
388
+ rotate Display rotation {0,90,180,270} (default 90)
389
+ speed SPI bus speed in Hz (default 4000000)
390
+ dc_pin GPIO pin for D/C (default 24)
391
+ reset_pin GPIO pin for RESET (default 25)
392
+ led_pin GPIO used to control backlight (default 18)
393
+
394
+
395
+Name: adafruit18
396
+Info: Overlay for the SPI-connected Adafruit 1.8" display (based on the
397
+ ST7735R chip). It includes support for the "green tab" version.
398
+ This overlay uses the older fbtft driver.
399
+Load: dtoverlay=adafruit18,<param>=<val>
400
+Params: green Use the adafruit18_green variant.
401
+ rotate Display rotation {0,90,180,270}
402
+ speed SPI bus speed in Hz (default 4000000)
403
+ fps Display frame rate in Hz
404
+ bgr Enable BGR mode (default off)
405
+ debug Debug output level {0-7}
406
+ dc_pin GPIO pin for D/C (default 24)
407
+ reset_pin GPIO pin for RESET (default 25)
408
+ led_pin GPIO used to control backlight (default 18)
409
+
410
+
411
+Name: adau1977-adc
412
+Info: Overlay for activation of ADAU1977 ADC codec over I2C for control
413
+ and I2S for data.
414
+Load: dtoverlay=adau1977-adc
415
+Params: <None>
416
+
417
+
418
+Name: adau7002-simple
419
+Info: Overlay for the activation of ADAU7002 stereo PDM to I2S converter.
420
+Load: dtoverlay=adau7002-simple,<param>=<val>
421
+Params: card-name Override the default, "adau7002", card name.
422
+
423
+
424
+Name: ads1015
425
+Info: Overlay for activation of Texas Instruments ADS1015 ADC over I2C
426
+Load: dtoverlay=ads1015,<param>=<val>
427
+Params: addr I2C bus address of device. Set based on how the
428
+ addr pin is wired. (default=0x48 assumes addr
429
+ is pulled to GND)
430
+ cha_enable Enable virtual channel a. (default=true)
431
+ cha_cfg Set the configuration for virtual channel a.
432
+ (default=4 configures this channel for the
433
+ voltage at A0 with respect to GND)
434
+ cha_datarate Set the datarate (samples/sec) for this channel.
435
+ (default=4 sets 1600 sps)
436
+ cha_gain Set the gain of the Programmable Gain
437
+ Amplifier for this channel. (default=2 sets the
438
+ full scale of the channel to 2.048 Volts)
439
+
440
+ Channel (ch) parameters can be set for each enabled channel.
441
+ A maximum of 4 channels can be enabled (letters a thru d).
442
+ For more information refer to the device datasheet at:
443
+ http://www.ti.com/lit/ds/symlink/ads1015.pdf
444
+
445
+
446
+Name: ads1115
447
+Info: Texas Instruments ADS1115 ADC
448
+Load: dtoverlay=ads1115,<param>[=<val>]
449
+Params: addr I2C bus address of device. Set based on how the
450
+ addr pin is wired. (default=0x48 assumes addr
451
+ is pulled to GND)
452
+ cha_enable Enable virtual channel a.
453
+ cha_cfg Set the configuration for virtual channel a.
454
+ (default=4 configures this channel for the
455
+ voltage at A0 with respect to GND)
456
+ cha_datarate Set the datarate (samples/sec) for this channel.
457
+ (default=7 sets 860 sps)
458
+ cha_gain Set the gain of the Programmable Gain
459
+ Amplifier for this channel. (Default 1 sets the
460
+ full scale of the channel to 4.096 Volts)
461
+
462
+ Channel parameters can be set for each enabled channel.
463
+ A maximum of 4 channels can be enabled (letters a thru d).
464
+ For more information refer to the device datasheet at:
465
+ http://www.ti.com/lit/ds/symlink/ads1115.pdf
466
+
467
+
468
+Name: ads7846
469
+Info: ADS7846 Touch controller
470
+Load: dtoverlay=ads7846,<param>=<val>
471
+Params: cs SPI bus Chip Select (default 1)
472
+ speed SPI bus speed (default 2MHz, max 3.25MHz)
473
+ penirq GPIO used for PENIRQ. REQUIRED
474
+ penirq_pull Set GPIO pull (default 0=none, 2=pullup)
475
+ swapxy Swap x and y axis
476
+ xmin Minimum value on the X axis (default 0)
477
+ ymin Minimum value on the Y axis (default 0)
478
+ xmax Maximum value on the X axis (default 4095)
479
+ ymax Maximum value on the Y axis (default 4095)
480
+ pmin Minimum reported pressure value (default 0)
481
+ pmax Maximum reported pressure value (default 65535)
482
+ xohms Touchpanel sensitivity (X-plate resistance)
483
+ (default 400)
484
+
485
+ penirq is required and usually xohms (60-100) has to be set as well.
486
+ Apart from that, pmax (255) and swapxy are also common.
487
+ The rest of the calibration can be done with xinput-calibrator.
488
+ See: github.com/notro/fbtft/wiki/FBTFT-on-Raspian
489
+ Device Tree binding document:
490
+ www.kernel.org/doc/Documentation/devicetree/bindings/input/ads7846.txt
491
+
492
+
493
+Name: adv7282m
494
+Info: Analog Devices ADV7282M analogue video to CSI2 bridge.
495
+ Uses Unicam1, which is the standard camera connector on most Pi
496
+ variants.
497
+Load: dtoverlay=adv7282m,<param>=<val>
498
+Params: addr Overrides the I2C address (default 0x21)
499
+ media-controller Configure use of Media Controller API for
500
+ configuring the sensor (default off)
501
+
502
+
503
+Name: adv728x-m
504
+Info: Analog Devices ADV728[0|1|2]-M analogue video to CSI2 bridges.
505
+ This is a wrapper for adv7282m, and defaults to ADV7282M.
506
+Load: dtoverlay=adv728x-m,<param>=<val>
507
+Params: addr Overrides the I2C address (default 0x21)
508
+ adv7280m Select ADV7280-M.
509
+ adv7281m Select ADV7281-M.
510
+ adv7281ma Select ADV7281-MA.
511
+ media-controller Configure use of Media Controller API for
512
+ configuring the sensor (default off)
513
+
514
+
515
+Name: akkordion-iqdacplus
516
+Info: Configures the Digital Dreamtime Akkordion Music Player (based on the
517
+ OEM IQAudIO DAC+ or DAC Zero module).
518
+Load: dtoverlay=akkordion-iqdacplus,<param>=<val>
519
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
520
+ Digital volume control. Enable with
521
+ dtoverlay=akkordion-iqdacplus,24db_digital_gain
522
+ (The default behaviour is that the Digital
523
+ volume control is limited to a maximum of
524
+ 0dB. ie. it can attenuate but not provide
525
+ gain. For most users, this will be desired
526
+ as it will prevent clipping. By appending
527
+ the 24db_digital_gain parameter, the Digital
528
+ volume control will allow up to 24dB of
529
+ gain. If this parameter is enabled, it is the
530
+ responsibility of the user to ensure that
531
+ the Digital volume control is set to a value
532
+ that does not result in clipping/distortion!)
533
+
534
+
535
+Name: allo-boss-dac-pcm512x-audio
536
+Info: Configures the Allo Boss DAC audio cards.
537
+Load: dtoverlay=allo-boss-dac-pcm512x-audio,<param>
538
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
539
+ Digital volume control. Enable with
540
+ "dtoverlay=allo-boss-dac-pcm512x-audio,
541
+ 24db_digital_gain"
542
+ (The default behaviour is that the Digital
543
+ volume control is limited to a maximum of
544
+ 0dB. ie. it can attenuate but not provide
545
+ gain. For most users, this will be desired
546
+ as it will prevent clipping. By appending
547
+ the 24db_digital_gain parameter, the Digital
548
+ volume control will allow up to 24dB of
549
+ gain. If this parameter is enabled, it is the
550
+ responsibility of the user to ensure that
551
+ the Digital volume control is set to a value
552
+ that does not result in clipping/distortion!)
553
+ slave Force Boss DAC into slave mode, using Pi a
554
+ master for bit clock and frame clock. Enable
555
+ with "dtoverlay=allo-boss-dac-pcm512x-audio,
556
+ slave"
557
+
558
+
559
+Name: allo-boss2-dac-audio
560
+Info: Configures the Allo Boss2 DAC audio card
561
+Load: dtoverlay=allo-boss2-dac-audio
562
+Params: <None>
563
+
564
+
565
+Name: allo-digione
566
+Info: Configures the Allo Digione audio card
567
+Load: dtoverlay=allo-digione
568
+Params: <None>
569
+
570
+
571
+Name: allo-katana-dac-audio
572
+Info: Configures the Allo Katana DAC audio card
573
+Load: dtoverlay=allo-katana-dac-audio
574
+Params: <None>
575
+
576
+
577
+Name: allo-piano-dac-pcm512x-audio
578
+Info: Configures the Allo Piano DAC (2.0/2.1) audio cards.
579
+ (NB. This initial support is for 2.0 channel audio ONLY! ie. stereo.
580
+ The subwoofer outputs on the Piano 2.1 are not currently supported!)
581
+Load: dtoverlay=allo-piano-dac-pcm512x-audio,<param>
582
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
583
+ Digital volume control.
584
+ (The default behaviour is that the Digital
585
+ volume control is limited to a maximum of
586
+ 0dB. ie. it can attenuate but not provide
587
+ gain. For most users, this will be desired
588
+ as it will prevent clipping. By appending
589
+ the 24db_digital_gain parameter, the Digital
590
+ volume control will allow up to 24dB of
591
+ gain. If this parameter is enabled, it is the
592
+ responsibility of the user to ensure that
593
+ the Digital volume control is set to a value
594
+ that does not result in clipping/distortion!)
595
+
596
+
597
+Name: allo-piano-dac-plus-pcm512x-audio
598
+Info: Configures the Allo Piano DAC (2.1) audio cards.
599
+Load: dtoverlay=allo-piano-dac-plus-pcm512x-audio,<param>
600
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
601
+ Digital volume control.
602
+ (The default behaviour is that the Digital
603
+ volume control is limited to a maximum of
604
+ 0dB. ie. it can attenuate but not provide
605
+ gain. For most users, this will be desired
606
+ as it will prevent clipping. By appending
607
+ the 24db_digital_gain parameter, the Digital
608
+ volume control will allow up to 24dB of
609
+ gain. If this parameter is enabled, it is the
610
+ responsibility of the user to ensure that
611
+ the Digital volume control is set to a value
612
+ that does not result in clipping/distortion!)
613
+ glb_mclk This option is only with Kali board. If enabled,
614
+ MCLK for Kali is used and PLL is disabled for
615
+ better voice quality. (default Off)
616
+
617
+
618
+Name: anyspi
619
+Info: Universal device tree overlay for SPI devices
620
+
621
+ Just specify the SPI address and device name ("compatible" property).
622
+ This overlay lacks any device-specific parameter support!
623
+
624
+ For devices on spi1 or spi2, the interfaces should be enabled
625
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
626
+
627
+ Examples:
628
+ 1. SPI NOR flash on spi0.1, maximum SPI clock frequency 45MHz:
629
+ dtoverlay=anyspi:spi0-1,dev="jedec,spi-nor",speed=45000000
630
+ 2. MCP3204 ADC on spi1.2, maximum SPI clock frequency 500kHz:
631
+ dtoverlay=anyspi:spi1-2,dev="microchip,mcp3204"
632
+Load: dtoverlay=anyspi,<param>=<val>
633
+Params: spi<n>-<m> Configure device at spi<n>, cs<m>
634
+ (boolean, required)
635
+ dev Set device name to search compatible module
636
+ (string, required)
637
+ speed Set SPI clock frequency in Hz
638
+ (integer, optional, default 500000)
639
+
640
+
641
+Name: apds9960
642
+Info: Configures the AVAGO APDS9960 digital proximity, ambient light, RGB and
643
+ gesture sensor
644
+Load: dtoverlay=apds9960,<param>=<val>
645
+Params: gpiopin GPIO used for INT (default 4)
646
+ noints Disable the interrupt GPIO line.
647
+
648
+
649
+Name: applepi-dac
650
+Info: Configures the Orchard Audio ApplePi-DAC audio card
651
+Load: dtoverlay=applepi-dac
652
+Params: <None>
653
+
654
+
655
+Name: arducam-64mp
656
+Info: Arducam 64MP camera module.
657
+ Uses Unicam 1, which is the standard camera connector on most Pi
658
+ variants.
659
+Load: dtoverlay=arducam-64mp,<param>=<val>
660
+Params: rotation Mounting rotation of the camera sensor (0 or
661
+ 180, default 0)
662
+ orientation Sensor orientation (0 = front, 1 = rear,
663
+ 2 = external, default external)
664
+ media-controller Configure use of Media Controller API for
665
+ configuring the sensor (default on)
666
+ cam0 Adopt the default configuration for CAM0 on a
667
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
668
+ vcm Select lens driver state. Default is enabled,
669
+ but vcm=off will disable.
670
+
671
+
672
+Name: arducam-pivariety
673
+Info: Arducam Pivariety camera module.
674
+ Uses Unicam 1, which is the standard camera connector on most Pi
675
+ variants.
676
+Load: dtoverlay=arducam-pivariety,<param>=<val>
677
+Params: rotation Mounting rotation of the camera sensor (0 or
678
+ 180, default 0)
679
+ orientation Sensor orientation (0 = front, 1 = rear,
680
+ 2 = external, default external)
681
+ media-controller Configure use of Media Controller API for
682
+ configuring the sensor (default on)
683
+ cam0 Adopt the default configuration for CAM0 on a
684
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
685
+
686
+
687
+Name: at86rf233
688
+Info: Configures the Atmel AT86RF233 802.15.4 low-power WPAN transceiver,
689
+ connected to spi0.0
690
+Load: dtoverlay=at86rf233,<param>=<val>
691
+Params: interrupt GPIO used for INT (default 23)
692
+ reset GPIO used for Reset (default 24)
693
+ sleep GPIO used for Sleep (default 25)
694
+ speed SPI bus speed in Hz (default 3000000)
695
+ trim Fine tuning of the internal capacitance
696
+ arrays (0=+0pF, 15=+4.5pF, default 15)
697
+
698
+
699
+Name: audioinjector-addons
700
+Info: Configures the audioinjector.net audio add on soundcards
701
+Load: dtoverlay=audioinjector-addons,<param>=<val>
702
+Params: non-stop-clocks Keeps the clocks running even when the stream
703
+ is paused or stopped (default off)
704
+
705
+
706
+Name: audioinjector-bare-i2s
707
+Info: Configures the audioinjector.net audio bare i2s soundcard
708
+Load: dtoverlay=audioinjector-bare-i2s
709
+Params: <None>
710
+
711
+
712
+Name: audioinjector-isolated-soundcard
713
+Info: Configures the audioinjector.net isolated soundcard
714
+Load: dtoverlay=audioinjector-isolated-soundcard
715
+Params: <None>
716
+
717
+
718
+Name: audioinjector-ultra
719
+Info: Configures the audioinjector.net ultra soundcard
720
+Load: dtoverlay=audioinjector-ultra
721
+Params: <None>
722
+
723
+
724
+Name: audioinjector-wm8731-audio
725
+Info: Configures the audioinjector.net audio add on soundcard
726
+Load: dtoverlay=audioinjector-wm8731-audio
727
+Params: <None>
728
+
729
+
730
+Name: audiosense-pi
731
+Info: Configures the audiosense-pi add on soundcard
732
+ For more information refer to
733
+ https://gitlab.com/kakar0t/audiosense-pi
734
+Load: dtoverlay=audiosense-pi
735
+Params: <None>
736
+
737
+
738
+Name: audremap
739
+Info: Switches PWM sound output to GPIOs on the 40-pin header
740
+Load: dtoverlay=audremap,<param>=<val>
741
+Params: swap_lr Reverse the channel allocation, which will also
742
+ swap the audio jack outputs (default off)
743
+ enable_jack Don't switch off the audio jack output. Does
744
+ nothing on BCM2711 (default off)
745
+ pins_12_13 Select GPIOs 12 & 13 (default)
746
+ pins_18_19 Select GPIOs 18 & 19
747
+ pins_40_41 Select GPIOs 40 & 41 (not available on CM4, used
748
+ for other purposes)
749
+ pins_40_45 Select GPIOs 40 & 45 (don't use on BCM2711 - the
750
+ pins are on different controllers)
751
+
752
+
753
+Name: balena-fin
754
+Info: Overlay that enables WLAN, Bluetooth and the GPIO expander on the
755
+ balenaFin carrier board for the Raspberry Pi Compute Module 3/3+ Lite.
756
+Load: dtoverlay=balena-fin
757
+Params: <None>
758
+
759
+
760
+Name: bmp085_i2c-sensor
761
+Info: This overlay is now deprecated - see i2c-sensor
762
+Load: <Deprecated>
763
+
764
+
765
+Name: camera-mux-2port
766
+Info: Configures a 2 port camera multiplexer
767
+ Note that currently ALL IMX290 modules share a common clock, therefore
768
+ all modules will need to have the same clock frequency.
769
+Load: dtoverlay=camera-mux-2port,<param>=<val>
770
+Params: cam0-arducam-64mp Select Arducam64MP for camera on port 0
771
+ cam0-imx219 Select IMX219 for camera on port 0
772
+ cam0-imx258 Select IMX258 for camera on port 0
773
+ cam0-imx290 Select IMX290 for camera on port 0
774
+ cam0-imx477 Select IMX477 for camera on port 0
775
+ cam0-imx519 Select IMX519 for camera on port 0
776
+ cam0-imx708 Select IMX708 for camera on port 0
777
+ cam0-ov2311 Select OV2311 for camera on port 0
778
+ cam0-ov5647 Select OV5647 for camera on port 0
779
+ cam0-ov7251 Select OV7251 for camera on port 0
780
+ cam0-ov9281 Select OV9281 for camera on port 0
781
+ cam0-imx290-clk-freq Set clock frequency for an IMX290 on port 0
782
+ cam1-arducam-64mp Select Arducam64MP for camera on port 1
783
+ cam1-imx219 Select IMX219 for camera on port 1
784
+ cam1-imx258 Select IMX258 for camera on port 1
785
+ cam1-imx290 Select IMX290 for camera on port 1
786
+ cam1-imx477 Select IMX477 for camera on port 1
787
+ cam1-imx519 Select IMX519 for camera on port 1
788
+ cam1-imx708 Select IMX708 for camera on port 1
789
+ cam1-ov2311 Select OV2311 for camera on port 1
790
+ cam1-ov5647 Select OV5647 for camera on port 1
791
+ cam1-ov7251 Select OV7251 for camera on port 1
792
+ cam1-ov9281 Select OV9281 for camera on port 1
793
+ cam1-imx290-clk-freq Set clock frequency for an IMX290 on port 1
794
+
795
+
796
+Name: camera-mux-4port
797
+Info: Configures a 4 port camera multiplexer
798
+ Note that currently ALL IMX290 modules share a common clock, therefore
799
+ all modules will need to have the same clock frequency.
800
+Load: dtoverlay=camera-mux-4port,<param>=<val>
801
+Params: cam0-arducam-64mp Select Arducam64MP for camera on port 0
802
+ cam0-imx219 Select IMX219 for camera on port 0
803
+ cam0-imx258 Select IMX258 for camera on port 0
804
+ cam0-imx290 Select IMX290 for camera on port 0
805
+ cam0-imx477 Select IMX477 for camera on port 0
806
+ cam0-imx519 Select IMX519 for camera on port 0
807
+ cam0-imx708 Select IMX708 for camera on port 0
808
+ cam0-ov2311 Select OV2311 for camera on port 0
809
+ cam0-ov5647 Select OV5647 for camera on port 0
810
+ cam0-ov7251 Select OV7251 for camera on port 0
811
+ cam0-ov9281 Select OV9281 for camera on port 0
812
+ cam0-imx290-clk-freq Set clock frequency for an IMX290 on port 0
813
+ cam1-arducam-64mp Select Arducam64MP for camera on port 1
814
+ cam1-imx219 Select IMX219 for camera on port 1
815
+ cam1-imx258 Select IMX258 for camera on port 1
816
+ cam1-imx290 Select IMX290 for camera on port 1
817
+ cam1-imx477 Select IMX477 for camera on port 1
818
+ cam1-imx519 Select IMX519 for camera on port 1
819
+ cam1-imx708 Select IMX708 for camera on port 1
820
+ cam1-ov2311 Select OV2311 for camera on port 1
821
+ cam1-ov5647 Select OV5647 for camera on port 1
822
+ cam1-ov7251 Select OV7251 for camera on port 1
823
+ cam1-ov9281 Select OV9281 for camera on port 1
824
+ cam1-imx290-clk-freq Set clock frequency for an IMX290 on port 1
825
+ cam2-arducam-64mp Select Arducam64MP for camera on port 2
826
+ cam2-imx219 Select IMX219 for camera on port 2
827
+ cam2-imx258 Select IMX258 for camera on port 2
828
+ cam2-imx290 Select IMX290 for camera on port 2
829
+ cam2-imx477 Select IMX477 for camera on port 2
830
+ cam2-imx519 Select IMX519 for camera on port 2
831
+ cam2-imx708 Select IMX708 for camera on port 2
832
+ cam2-ov2311 Select OV2311 for camera on port 2
833
+ cam2-ov5647 Select OV5647 for camera on port 2
834
+ cam2-ov7251 Select OV7251 for camera on port 2
835
+ cam2-ov9281 Select OV9281 for camera on port 2
836
+ cam2-imx290-clk-freq Set clock frequency for an IMX290 on port 2
837
+ cam3-arducam-64mp Select Arducam64MP for camera on port 3
838
+ cam3-imx219 Select IMX219 for camera on port 3
839
+ cam3-imx258 Select IMX258 for camera on port 3
840
+ cam3-imx290 Select IMX290 for camera on port 3
841
+ cam3-imx477 Select IMX477 for camera on port 3
842
+ cam3-imx519 Select IMX519 for camera on port 3
843
+ cam3-imx708 Select IMX708 for camera on port 3
844
+ cam3-ov2311 Select OV2311 for camera on port 3
845
+ cam3-ov5647 Select OV5647 for camera on port 3
846
+ cam3-ov7251 Select OV7251 for camera on port 3
847
+ cam3-ov9281 Select OV9281 for camera on port 3
848
+ cam3-imx290-clk-freq Set clock frequency for an IMX290 on port 3
849
+
850
+
851
+Name: cap1106
852
+Info: Enables the ability to use the cap1106 touch sensor as a keyboard
853
+Load: dtoverlay=cap1106,<param>=<val>
854
+Params: int_pin GPIO pin for interrupt signal (default 23)
855
+
856
+
857
+Name: chipdip-dac
858
+Info: Configures Chip Dip audio cards.
859
+Load: dtoverlay=chipdip-dac
860
+Params: <None>
861
+
862
+
863
+Name: cirrus-wm5102
864
+Info: Configures the Cirrus Logic Audio Card
865
+Load: dtoverlay=cirrus-wm5102
866
+Params: <None>
867
+
868
+
869
+Name: cm-swap-i2c0
870
+Info: Largely for Compute Modules 1&3 where the original instructions for
871
+ adding a camera used GPIOs 0&1 for CAM1 and 28&29 for CAM0, whilst all
872
+ other platforms use 28&29 (or 44&45) for CAM1.
873
+ The default assignment through using this overlay is for
874
+ i2c0 to use 28&29, and i2c10 (aka i2c_csi_dsi) to use 28&29, but the
875
+ overrides allow this to be changed.
876
+Load: dtoverlay=cm-swap-i2c0,<param>=<val>
877
+Params: i2c0-gpio0 Use GPIOs 0&1 for i2c0
878
+ i2c0-gpio28 Use GPIOs 28&29 for i2c0 (default)
879
+ i2c0-gpio44 Use GPIOs 44&45 for i2c0
880
+ i2c10-gpio0 Use GPIOs 0&1 for i2c0 (default)
881
+ i2c10-gpio28 Use GPIOs 28&29 for i2c0
882
+ i2c10-gpio44 Use GPIOs 44&45 for i2c0
883
+
884
+
885
+Name: cma
886
+Info: Set custom CMA sizes, only use if you know what you are doing, might
887
+ clash with other overlays like vc4-fkms-v3d and vc4-kms-v3d.
888
+Load: dtoverlay=cma,<param>=<val>
889
+Params: cma-512 CMA is 512MB (needs 1GB)
890
+ cma-448 CMA is 448MB (needs 1GB)
891
+ cma-384 CMA is 384MB (needs 1GB)
892
+ cma-320 CMA is 320MB (needs 1GB)
893
+ cma-256 CMA is 256MB (needs 1GB)
894
+ cma-192 CMA is 192MB (needs 1GB)
895
+ cma-128 CMA is 128MB
896
+ cma-96 CMA is 96MB
897
+ cma-64 CMA is 64MB
898
+ cma-size CMA size in bytes, 4MB aligned
899
+ cma-default Use upstream's default value
900
+
901
+
902
+Name: crystalfontz-cfa050_pi_m
903
+Info: Configures the Crystalfontz CFA050-PI-M series of Raspberry Pi CM4
904
+ based modules using the CFA7201280A0_050Tx 7" TFT LCD displays,
905
+ with or without capacitive touch screen.
906
+ Requires use of vc4-kms-v3d.
907
+Load: dtoverlay=crystalfontz-cfa050_pi_m,<param>=<val>
908
+Params: captouch Enable capacitive touch display
909
+
910
+
911
+Name: cutiepi-panel
912
+Info: 8" TFT LCD display and touch panel used by cutiepi.io
913
+Load: dtoverlay=cutiepi-panel
914
+Params: <None>
915
+
916
+
917
+Name: dacberry400
918
+Info: Configures the dacberry400 add on soundcard
919
+Load: dtoverlay=dacberry400
920
+Params: <None>
921
+
922
+
923
+Name: dht11
924
+Info: Overlay for the DHT11/DHT21/DHT22 humidity/temperature sensors
925
+ Also sometimes found with the part number(s) AM230x.
926
+Load: dtoverlay=dht11,<param>=<val>
927
+Params: gpiopin GPIO connected to the sensor's DATA output.
928
+ (default 4)
929
+
930
+
931
+Name: dionaudio-kiwi
932
+Info: Configures the Dion Audio KIWI STREAMER
933
+Load: dtoverlay=dionaudio-kiwi
934
+Params: <None>
935
+
936
+
937
+Name: dionaudio-loco
938
+Info: Configures the Dion Audio LOCO DAC-AMP
939
+Load: dtoverlay=dionaudio-loco
940
+Params: <None>
941
+
942
+
943
+Name: dionaudio-loco-v2
944
+Info: Configures the Dion Audio LOCO-V2 DAC-AMP
945
+Load: dtoverlay=dionaudio-loco-v2,<param>=<val>
946
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
947
+ Digital volume control. Enable with
948
+ "dtoverlay=hifiberry-dacplus,24db_digital_gain"
949
+ (The default behaviour is that the Digital
950
+ volume control is limited to a maximum of
951
+ 0dB. ie. it can attenuate but not provide
952
+ gain. For most users, this will be desired
953
+ as it will prevent clipping. By appending
954
+ the 24dB_digital_gain parameter, the Digital
955
+ volume control will allow up to 24dB of
956
+ gain. If this parameter is enabled, it is the
957
+ responsibility of the user to ensure that
958
+ the Digital volume control is set to a value
959
+ that does not result in clipping/distortion!)
960
+
961
+
962
+Name: disable-bt
963
+Info: Disable onboard Bluetooth on Bluetooth-capable Raspberry Pis. On Pis
964
+ prior to Pi 5 this restores UART0/ttyAMA0 over GPIOs 14 & 15.
965
+Load: dtoverlay=disable-bt
966
+Params: <None>
967
+
968
+
969
+Name: disable-bt-pi5
970
+Info: See disable-bt
971
+
972
+
973
+Name: disable-emmc2
974
+Info: Disable EMMC2 controller on BCM2711.
975
+ The allows the onboard EMMC storage on Compute Module 4 to be disabled
976
+ e.g. if a fault has occurred.
977
+Load: dtoverlay=disable-emmc2
978
+Params: <None>
979
+
980
+
981
+Name: disable-wifi
982
+Info: Disable onboard WLAN on WiFi-capable Raspberry Pis.
983
+Load: dtoverlay=disable-wifi
984
+Params: <None>
985
+
986
+
987
+Name: disable-wifi-pi5
988
+Info: See disable-wifi
989
+
990
+
991
+Name: dpi18
992
+Info: Overlay for a generic 18-bit DPI display
993
+ This uses GPIOs 0-21 (so no I2C, uart etc.), and activates the output
994
+ 2-3 seconds after the kernel has started.
995
+Load: dtoverlay=dpi18
996
+Params: <None>
997
+
998
+
999
+Name: dpi18cpadhi
1000
+Info: Overlay for a generic 18-bit DPI display (in 'mode 6' connection scheme)
1001
+ This uses GPIOs 0-9,12-17,20-25 (so no I2C, uart etc.), and activates
1002
+ the output 3-3 seconds after the kernel has started.
1003
+Load: dtoverlay=dpi18cpadhi
1004
+Params: <None>
1005
+
1006
+
1007
+Name: dpi24
1008
+Info: Overlay for a generic 24-bit DPI display
1009
+ This uses GPIOs 0-27 (so no I2C, uart etc.), and activates the output
1010
+ 2-3 seconds after the kernel has started.
1011
+Load: dtoverlay=dpi24
1012
+Params: <None>
1013
+
1014
+
1015
+Name: draws
1016
+Info: Configures the NW Digital Radio DRAWS Hat
1017
+
1018
+ The board includes an ADC to measure various board values and also
1019
+ provides two analog user inputs on the expansion header. The ADC
1020
+ can be configured for various sample rates and gain values to adjust
1021
+ the input range. Tables describing the two parameters follow.
1022
+
1023
+ ADC Gain Values:
1024
+ 0 = +/- 6.144V
1025
+ 1 = +/- 4.096V
1026
+ 2 = +/- 2.048V
1027
+ 3 = +/- 1.024V
1028
+ 4 = +/- 0.512V
1029
+ 5 = +/- 0.256V
1030
+ 6 = +/- 0.256V
1031
+ 7 = +/- 0.256V
1032
+
1033
+ ADC Datarate Values:
1034
+ 0 = 128sps
1035
+ 1 = 250sps
1036
+ 2 = 490sps
1037
+ 3 = 920sps
1038
+ 4 = 1600sps (default)
1039
+ 5 = 2400sps
1040
+ 6 = 3300sps
1041
+ 7 = 3300sps
1042
+Load: dtoverlay=draws,<param>=<val>
1043
+Params: draws_adc_ch4_gain Sets the full scale resolution of the ADCs
1044
+ input voltage sensor (default 1)
1045
+
1046
+ draws_adc_ch4_datarate Sets the datarate of the ADCs input voltage
1047
+ sensor
1048
+
1049
+ draws_adc_ch5_gain Sets the full scale resolution of the ADCs
1050
+ 5V rail voltage sensor (default 1)
1051
+
1052
+ draws_adc_ch5_datarate Sets the datarate of the ADCs 4V rail voltage
1053
+ sensor
1054
+
1055
+ draws_adc_ch6_gain Sets the full scale resolution of the ADCs
1056
+ AIN2 input (default 2)
1057
+
1058
+ draws_adc_ch6_datarate Sets the datarate of the ADCs AIN2 input
1059
+
1060
+ draws_adc_ch7_gain Sets the full scale resolution of the ADCs
1061
+ AIN3 input (default 2)
1062
+
1063
+ draws_adc_ch7_datarate Sets the datarate of the ADCs AIN3 input
1064
+
1065
+ alsaname Name of the ALSA audio device (default "draws")
1066
+
1067
+
1068
+Name: dwc-otg
1069
+Info: Selects the dwc_otg USB controller driver which has fiq support. This
1070
+ is the default on all except the Pi Zero which defaults to dwc2.
1071
+Load: dtoverlay=dwc-otg
1072
+Params: <None>
1073
+
1074
+
1075
+Name: dwc2
1076
+Info: Selects the dwc2 USB controller driver
1077
+Load: dtoverlay=dwc2,<param>=<val>
1078
+Params: dr_mode Dual role mode: "host", "peripheral" or "otg"
1079
+
1080
+ g-rx-fifo-size Size of rx fifo size in gadget mode
1081
+
1082
+ g-np-tx-fifo-size Size of non-periodic tx fifo size in gadget
1083
+ mode
1084
+
1085
+
1086
+[ The ds1307-rtc overlay has been deleted. See i2c-rtc. ]
1087
+
1088
+
1089
+Name: edt-ft5406
1090
+Info: Overlay for the EDT FT5406 touchscreen.
1091
+ This works with the Raspberry Pi 7" touchscreen when not being polled
1092
+ by the firmware.
1093
+ By default the overlay uses the i2c_csi_dsi I2C interface, but this
1094
+ can be overridden
1095
+ You MUST use either "disable_touchscreen=1" or "ignore_lcd=1" in
1096
+ config.txt to stop the firmware polling the touchscreen.
1097
+Load: dtoverlay=edt-ft5406,<param>=<val>
1098
+Params: sizex Touchscreen size x (default 800)
1099
+ sizey Touchscreen size y (default 480)
1100
+ invx Touchscreen inverted x axis
1101
+ invy Touchscreen inverted y axis
1102
+ swapxy Touchscreen swapped x y axis
1103
+ i2c0 Choose the I2C0 bus on GPIOs 0&1
1104
+ i2c1 Choose the I2C1 bus on GPIOs 2&3
1105
+ i2c3 Choose the I2C3 bus (configure with the i2c3
1106
+ overlay - BCM2711 only)
1107
+ i2c4 Choose the I2C4 bus (configure with the i2c4
1108
+ overlay - BCM2711 only)
1109
+ i2c5 Choose the I2C5 bus (configure with the i2c5
1110
+ overlay - BCM2711 only)
1111
+ i2c6 Choose the I2C6 bus (configure with the i2c6
1112
+ overlay - BCM2711 only)
1113
+ addr Sets the address for the touch controller. Note
1114
+ that the device must be configured to use the
1115
+ specified address.
1116
+
1117
+
1118
+Name: enc28j60
1119
+Info: Overlay for the Microchip ENC28J60 Ethernet Controller on SPI0
1120
+Load: dtoverlay=enc28j60,<param>=<val>
1121
+Params: int_pin GPIO used for INT (default 25)
1122
+
1123
+ speed SPI bus speed (default 12000000)
1124
+
1125
+
1126
+Name: enc28j60-spi2
1127
+Info: Overlay for the Microchip ENC28J60 Ethernet Controller on SPI2
1128
+Load: dtoverlay=enc28j60-spi2,<param>=<val>
1129
+Params: int_pin GPIO used for INT (default 39)
1130
+
1131
+ speed SPI bus speed (default 12000000)
1132
+
1133
+
1134
+Name: exc3000
1135
+Info: Enables I2C connected EETI EXC3000 multiple touch controller using
1136
+ GPIO 4 (pin 7 on GPIO header) for interrupt.
1137
+Load: dtoverlay=exc3000,<param>=<val>
1138
+Params: interrupt GPIO used for interrupt (default 4)
1139
+ sizex Touchscreen size x (default 4096)
1140
+ sizey Touchscreen size y (default 4096)
1141
+ invx Touchscreen inverted x axis
1142
+ invy Touchscreen inverted y axis
1143
+ swapxy Touchscreen swapped x y axis
1144
+
1145
+
1146
+Name: fbtft
1147
+Info: Overlay for SPI-connected displays using the fbtft drivers.
1148
+
1149
+ This overlay seeks to replace the functionality provided by fbtft_device
1150
+ which is now gone from the kernel.
1151
+
1152
+ Most displays from fbtft_device have been ported over.
1153
+ Example:
1154
+ dtoverlay=fbtft,spi0-0,rpi-display,reset_pin=23,dc_pin=24,led_pin=18,rotate=270
1155
+
1156
+ It is also possible to specify the controller (this will use the default
1157
+ init sequence in the driver).
1158
+ Example:
1159
+ dtoverlay=fbtft,spi0-0,ili9341,bgr,reset_pin=23,dc_pin=24,led_pin=18,rotate=270
1160
+
1161
+ For devices on spi1 or spi2, the interfaces should be enabled
1162
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
1163
+
1164
+ The following features of fbtft_device have not been ported over:
1165
+ - parallel bus is not supported
1166
+ - the init property which overrides the controller initialization
1167
+ sequence is not supported as a parameter due to memory limitations in
1168
+ the bootloader responsible for applying the overlay.
1169
+
1170
+ See https://github.com/notro/fbtft/wiki/FBTFT-RPI-overlays for how to
1171
+ create an overlay.
1172
+
1173
+Load: dtoverlay=fbtft,<param>=<val>
1174
+Params:
1175
+ spi<n>-<m> Configure device at spi<n>, cs<m>
1176
+ (boolean, required)
1177
+ speed SPI bus speed in Hz (default 32000000)
1178
+ cpha Shifted clock phase (CPHA) mode
1179
+ cpol Inverse clock polarity (CPOL) mode
1180
+
1181
+ adafruit18 Adafruit 1.8
1182
+ adafruit22 Adafruit 2.2 (old)
1183
+ adafruit22a Adafruit 2.2
1184
+ adafruit28 Adafruit 2.8
1185
+ adafruit13m Adafruit 1.3 OLED
1186
+ admatec_c-berry28 C-Berry28
1187
+ dogs102 EA DOGS102
1188
+ er_tftm050_2 ER-TFTM070-2
1189
+ er_tftm070_5 ER-TFTM070-5
1190
+ ew24ha0 EW24HA0
1191
+ ew24ha0_9bit EW24HA0 in 9-bit mode
1192
+ freetronicsoled128 Freetronics OLED128
1193
+ hy28a HY28A
1194
+ hy28b HY28B
1195
+ itdb28_spi ITDB02-2.8 with SPI interface circuit
1196
+ mi0283qt-2 Watterott MI0283QT-2
1197
+ mi0283qt-9a Watterott MI0283QT-9A
1198
+ nokia3310 Nokia 3310
1199
+ nokia3310a Nokia 3310a
1200
+ nokia5110 Nokia 5110
1201
+ piscreen PiScreen
1202
+ pitft Adafruit PiTFT 2.8
1203
+ pioled ILSoft OLED
1204
+ rpi-display Watterott rpi-display
1205
+ sainsmart18 Sainsmart 1.8
1206
+ sainsmart32_spi Sainsmart 3.2 with SPI interfce circuit
1207
+ tinylcd35 TinyLCD 3.5
1208
+ tm022hdh26 Tianma TM022HDH26
1209
+ tontec35_9481 Tontect 3.5 with ILI9481 controller
1210
+ tontec35_9486 Tontect 3.5 with ILI9486 controller
1211
+ waveshare32b Waveshare 3.2
1212
+ waveshare22 Waveshare 2.2
1213
+
1214
+ bd663474 BD663474 display controller
1215
+ hx8340bn HX8340BN display controller
1216
+ hx8347d HX8347D display controller
1217
+ hx8353d HX8353D display controller
1218
+ hx8357d HX8357D display controller
1219
+ ili9163 ILI9163 display controller
1220
+ ili9320 ILI9320 display controller
1221
+ ili9325 ILI9325 display controller
1222
+ ili9340 ILI9340 display controller
1223
+ ili9341 ILI9341 display controller
1224
+ ili9481 ILI9481 display controller
1225
+ ili9486 ILI9486 display controller
1226
+ pcd8544 PCD8544 display controller
1227
+ ra8875 RA8875 display controller
1228
+ s6d02a1 S6D02A1 display controller
1229
+ s6d1121 S6D1121 display controller
1230
+ seps525 SEPS525 display controller
1231
+ sh1106 SH1106 display controller
1232
+ ssd1289 SSD1289 display controller
1233
+ ssd1305 SSD1305 display controller
1234
+ ssd1306 SSD1306 display controller
1235
+ ssd1325 SSD1325 display controller
1236
+ ssd1331 SSD1331 display controller
1237
+ ssd1351 SSD1351 display controller
1238
+ st7735r ST7735R display controller
1239
+ st7789v ST7789V display controller
1240
+ tls8204 TLS8204 display controller
1241
+ uc1611 UC1611 display controller
1242
+ uc1701 UC1701 display controller
1243
+ upd161704 UPD161704 display controller
1244
+
1245
+ width Display width in pixels
1246
+ height Display height in pixels
1247
+ regwidth Display controller register width (default is
1248
+ driver specific)
1249
+ buswidth Display bus interface width (default 8)
1250
+ debug Debug output level {0-7}
1251
+ rotate Display rotation {0, 90, 180, 270} (counter
1252
+ clockwise). Not supported by all drivers.
1253
+ bgr Enable BGR mode (default off). Use if Red and
1254
+ Blue are swapped. Not supported by all drivers.
1255
+ fps Frames per second (default 30). In effect this
1256
+ states how long the driver will wait after video
1257
+ memory has been changed until display update
1258
+ transfer is started.
1259
+ txbuflen Length of the FBTFT transmit buffer
1260
+ (default 4096)
1261
+ startbyte Sets the Start byte used by fb_ili9320,
1262
+ fb_ili9325 and fb_hx8347d. Common value is 0x70.
1263
+ gamma String representation of Gamma Curve(s). Driver
1264
+ specific. Not supported by all drivers.
1265
+ reset_pin GPIO pin for RESET
1266
+ dc_pin GPIO pin for D/C
1267
+ led_pin GPIO pin for LED backlight
1268
+
1269
+
1270
+Name: fe-pi-audio
1271
+Info: Configures the Fe-Pi Audio Sound Card
1272
+Load: dtoverlay=fe-pi-audio
1273
+Params: <None>
1274
+
1275
+
1276
+Name: fsm-demo
1277
+Info: A demonstration of the gpio-fsm driver. The GPIOs are chosen to work
1278
+ nicely with a "traffic-light" display of red, amber and green LEDs on
1279
+ GPIOs 7, 8 and 25 respectively.
1280
+Load: dtoverlay=fsm-demo,<param>=<val>
1281
+Params: fsm_debug Enable debug logging (default off)
1282
+
1283
+
1284
+Name: gc9a01
1285
+Info: Enables GalaxyCore's GC9A01 single chip driver based displays on
1286
+ SPI0 as fb1, using GPIOs DC=25, RST=27 and BL=18 (physical
1287
+ GPIO header pins 22, 13 and 12 respectively) in addition to the
1288
+ SPI0 pins DIN=10, CLK=11 and CS=8 (physical GPIO header pins 19,
1289
+ 23 and 24 respectively).
1290
+Load: dtoverlay=gc9a01,<param>=<val>
1291
+Params: speed Display SPI bus speed
1292
+
1293
+ rotate Display rotation {0,90,180,270}
1294
+
1295
+ width Width of the display
1296
+
1297
+ height Height of the display
1298
+
1299
+ fps Delay between frame updates
1300
+
1301
+ debug Debug output level {0-7}
1302
+
1303
+
1304
+Name: ghost-amp
1305
+Info: An overlay for the Ghost amplifier.
1306
+Load: dtoverlay=ghost-amp,<param>=<val>
1307
+Params: fsm_debug Enable debug logging of the GPIO FSM (default
1308
+ off)
1309
+
1310
+
1311
+Name: goodix
1312
+Info: Enables I2C connected Goodix gt9271 multiple touch controller using
1313
+ GPIOs 4 and 17 (pins 7 and 11 on GPIO header) for interrupt and reset.
1314
+Load: dtoverlay=goodix,<param>=<val>
1315
+Params: interrupt GPIO used for interrupt (default 4)
1316
+ reset GPIO used for reset (default 17)
1317
+
1318
+
1319
+Name: googlevoicehat-soundcard
1320
+Info: Configures the Google voiceHAT soundcard
1321
+Load: dtoverlay=googlevoicehat-soundcard
1322
+Params: <None>
1323
+
1324
+
1325
+Name: gpio-charger
1326
+Info: This is a generic overlay for detecting charger with GPIO.
1327
+Load: dtoverlay=gpio-charger,<param>=<val>
1328
+Params: gpio GPIO pin to trigger on (default 4)
1329
+ active_low When this is 1 (active low), a falling
1330
+ edge generates a charging event and a
1331
+ rising edge generates a discharging event.
1332
+ When this is 0 (active high), this is
1333
+ reversed. The default is 0 (active high)
1334
+ gpio_pull Desired pull-up/down state (off, down, up)
1335
+ Default is "down".
1336
+ type Set a charger type for the pin. (Default: mains)
1337
+
1338
+
1339
+Name: gpio-fan
1340
+Info: Configure a GPIO pin to control a cooling fan.
1341
+Load: dtoverlay=gpio-fan,<param>=<val>
1342
+Params: gpiopin GPIO used to control the fan (default 12)
1343
+ temp Temperature at which the fan switches on, in
1344
+ millicelcius (default 55000)
1345
+ hyst Temperature delta (in millicelcius) below
1346
+ temp at which the fan will drop to minrpm
1347
+ (default 10000)
1348
+
1349
+
1350
+Name: gpio-hog
1351
+Info: Activate a "hog" for a GPIO - request that the kernel configures it as
1352
+ an output, driven low or high as indicated by the presence or absence
1353
+ of the active_low parameter. Note that a hogged GPIO is not available
1354
+ to other drivers or for gpioset/gpioget.
1355
+Load: dtoverlay=gpio-hog,<param>=<val>
1356
+Params: gpio GPIO pin to hog (default 26)
1357
+ active_low If set, the hog drives the GPIO low (defaults
1358
+ to off - the GPIO is driven high)
1359
+
1360
+
1361
+Name: gpio-ir
1362
+Info: Use GPIO pin as rc-core style infrared receiver input. The rc-core-
1363
+ based gpio_ir_recv driver maps received keys directly to a
1364
+ /dev/input/event* device, all decoding is done by the kernel - LIRC is
1365
+ not required! The key mapping and other decoding parameters can be
1366
+ configured by "ir-keytable" tool.
1367
+Load: dtoverlay=gpio-ir,<param>=<val>
1368
+Params: gpio_pin Input pin number. Default is 18.
1369
+
1370
+ gpio_pull Desired pull-up/down state (off, down, up)
1371
+ Default is "up".
1372
+
1373
+ invert "1" = invert the input (active-low signalling).
1374
+ "0" = non-inverted input (active-high
1375
+ signalling). Default is "1".
1376
+
1377
+ rc-map-name Default rc keymap (can also be changed by
1378
+ ir-keytable), defaults to "rc-rc6-mce"
1379
+
1380
+
1381
+Name: gpio-ir-tx
1382
+Info: Use GPIO pin as bit-banged infrared transmitter output.
1383
+ This is an alternative to "pwm-ir-tx". gpio-ir-tx doesn't require
1384
+ a PWM so it can be used together with onboard analog audio.
1385
+Load: dtoverlay=gpio-ir-tx,<param>=<val>
1386
+Params: gpio_pin Output GPIO (default 18)
1387
+
1388
+ invert "1" = invert the output (make it active-low).
1389
+ Default is "0" (active-high).
1390
+
1391
+
1392
+Name: gpio-key
1393
+Info: This is a generic overlay for activating GPIO keypresses using
1394
+ the gpio-keys library and this dtoverlay. Multiple keys can be
1395
+ set up using multiple calls to the overlay for configuring
1396
+ additional buttons or joysticks. You can see available keycodes
1397
+ at https://github.com/torvalds/linux/blob/v4.12/include/uapi/
1398
+ linux/input-event-codes.h#L64
1399
+Load: dtoverlay=gpio-key,<param>=<val>
1400
+Params: gpio GPIO pin to trigger on (default 3)
1401
+ active_low When this is 1 (active low), a falling
1402
+ edge generates a key down event and a
1403
+ rising edge generates a key up event.
1404
+ When this is 0 (active high), this is
1405
+ reversed. The default is 1 (active low)
1406
+ gpio_pull Desired pull-up/down state (off, down, up)
1407
+ Default is "up". Note that the default pin
1408
+ (GPIO3) has an external pullup
1409
+ label Set a label for the key
1410
+ keycode Set the key code for the button
1411
+
1412
+
1413
+
1414
+Name: gpio-led
1415
+Info: This is a generic overlay for activating LEDs (or any other component)
1416
+ by a GPIO pin. Multiple LEDs can be set up using multiple calls to the
1417
+ overlay. While there are many existing methods to activate LEDs on the
1418
+ RPi, this method offers some advantages:
1419
+ 1) Does not require any userspace programs.
1420
+ 2) LEDs can be connected to the kernel's led-trigger framework,
1421
+ and drive the LED based on triggers such as cpu load, heartbeat,
1422
+ kernel panic, key input, timers and others.
1423
+ 3) LED can be tied to the input state of another GPIO pin.
1424
+ 4) The LED is setup early during the kernel boot process (useful
1425
+ for cpu/heartbeat/panic triggers).
1426
+
1427
+ Typical electrical connection is:
1428
+ RPI-GPIO.19 -> LED -> 300ohm resister -> RPI-GND
1429
+ The GPIO pin number can be changed with the 'gpio=' parameter.
1430
+
1431
+ To control an LED from userspace, write a 0 or 1 value:
1432
+ echo 1 > /sys/class/leds/myled1/brightness
1433
+ The 'myled1' name can be changed with the 'label=' parameter.
1434
+
1435
+ To connect the LED to a kernel trigger from userspace:
1436
+ echo cpu > /sys/class/leds/myled1/trigger
1437
+ echo heartbeat > /sys/class/leds/myled1/trigger
1438
+ echo none > /sys/class/leds/myled1/trigger
1439
+ To connect the LED to GPIO.26 pin (physical pin 37):
1440
+ echo gpio > /sys/class/leds/myled1/trigger
1441
+ echo 26 > /sys/class/leds/myled1/gpio
1442
+ Available triggers:
1443
+ cat /sys/class/leds/myled1/trigger
1444
+
1445
+ More information about the Linux kernel LED/Trigger system:
1446
+ https://www.kernel.org/doc/Documentation/leds/leds-class.rst
1447
+ https://www.kernel.org/doc/Documentation/leds/ledtrig-oneshot.rst
1448
+Load: dtoverlay=gpio-led,<param>=<val>
1449
+Params: gpio GPIO pin connected to the LED (default 19)
1450
+ label The label for this LED. It will appear under
1451
+ /sys/class/leds/<label> . Default 'myled1'.
1452
+ trigger Set the led-trigger to connect to this LED.
1453
+ default 'none' (LED is user-controlled).
1454
+ Some possible triggers:
1455
+ cpu - CPU load (all CPUs)
1456
+ cpu0 - CPU load of first CPU.
1457
+ mmc - disk activity (all disks)
1458
+ panic - turn on on kernel panic
1459
+ heartbeat - indicate system health
1460
+ gpio - connect to a GPIO input pin (note:
1461
+ currently the GPIO PIN can not be set
1462
+ using overlay parameters, must be
1463
+ done in userspace, see examples above.
1464
+ active_low Set to 1 to turn invert the LED control
1465
+ (writing 0 to /sys/class/leds/XXX/brightness
1466
+ will turn on the GPIO/LED). Default '0'.
1467
+
1468
+
1469
+Name: gpio-no-bank0-irq
1470
+Info: Use this overlay to disable GPIO interrupts for GPIOs in bank 0 (0-27),
1471
+ which can be useful for UIO drivers.
1472
+ N.B. Using this overlay will trigger a kernel WARN during booting, but
1473
+ this can safely be ignored - the system should work as expected.
1474
+Load: dtoverlay=gpio-no-bank0-irq
1475
+Params: <None>
1476
+
1477
+
1478
+Name: gpio-no-irq
1479
+Info: Use this overlay to disable all GPIO interrupts, which can be useful
1480
+ for user-space GPIO edge detection systems.
1481
+Load: dtoverlay=gpio-no-irq
1482
+Params: <None>
1483
+
1484
+
1485
+Name: gpio-poweroff
1486
+Info: Drives a GPIO high or low on poweroff (including halt). Using this
1487
+ overlay interferes with the normal power-down sequence, preventing the
1488
+ kernel from resetting the SoC (a necessary step in a normal power-off
1489
+ or reboot). This also disables the ability to trigger a boot by driving
1490
+ GPIO3 low.
1491
+
1492
+ The GPIO starts in an inactive state. At poweroff time it is driven
1493
+ active for 100ms, then inactive for 100ms, then active again. It is
1494
+ safe to remove the power at any point after the initial activation of
1495
+ the GPIO.
1496
+
1497
+ Users of this overlay are required to provide an external mechanism to
1498
+ switch off the power supply when signalled - failure to do so results
1499
+ in a kernel BUG, increased power consumption and undefined behaviour.
1500
+Load: dtoverlay=gpio-poweroff,<param>=<val>
1501
+Params: gpiopin GPIO for signalling (default 26)
1502
+
1503
+ active_low Set if the power control device requires a
1504
+ high->low transition to trigger a power-down.
1505
+ Note that this will require the support of a
1506
+ custom dt-blob.bin to prevent a power-down
1507
+ during the boot process, and that a reboot
1508
+ will also cause the pin to go low.
1509
+ input Set if the gpio pin should be configured as
1510
+ an input.
1511
+ export Set to export the configured pin to sysfs
1512
+ active_delay_ms Initial GPIO active period (default 100)
1513
+ inactive_delay_ms Subsequent GPIO inactive period (default 100)
1514
+ timeout_ms Specify (in ms) how long the kernel waits for
1515
+ power-down before issuing a WARN (default 3000).
1516
+
1517
+
1518
+Name: gpio-shutdown
1519
+Info: Initiates a shutdown when GPIO pin changes. The given GPIO pin
1520
+ is configured as an input key that generates KEY_POWER events.
1521
+
1522
+ This event is handled by systemd-logind by initiating a
1523
+ shutdown. Systemd versions older than 225 need an udev rule
1524
+ enable listening to the input device:
1525
+
1526
+ ACTION!="REMOVE", SUBSYSTEM=="input", KERNEL=="event*", \
1527
+ SUBSYSTEMS=="platform", DRIVERS=="gpio-keys", \
1528
+ ATTRS{keys}=="116", TAG+="power-switch"
1529
+
1530
+ Alternatively this event can be handled also on systems without
1531
+ systemd, just by traditional SysV init daemon. KEY_POWER event
1532
+ (keycode 116) needs to be mapped to KeyboardSignal on console
1533
+ and then kb::kbrequest inittab action which is triggered by
1534
+ KeyboardSignal from console can be configured to issue system
1535
+ shutdown. Steps for this configuration are:
1536
+
1537
+ Add following lines to the /etc/console-setup/remap.inc file:
1538
+
1539
+ # Key Power as special keypress
1540
+ keycode 116 = KeyboardSignal
1541
+
1542
+ Then add following lines to /etc/inittab file:
1543
+
1544
+ # Action on special keypress (Key Power)
1545
+ kb::kbrequest:/sbin/shutdown -t1 -a -h -P now
1546
+
1547
+ And finally reload configuration by calling following commands:
1548
+
1549
+ # dpkg-reconfigure console-setup
1550
+ # service console-setup reload
1551
+ # init q
1552
+
1553
+ This overlay only handles shutdown. After shutdown, the system
1554
+ can be powered up again by driving GPIO3 low. The default
1555
+ configuration uses GPIO3 with a pullup, so if you connect a
1556
+ button between GPIO3 and GND (pin 5 and 6 on the 40-pin header),
1557
+ you get a shutdown and power-up button. Please note that
1558
+ Raspberry Pi 1 Model B rev 1 uses GPIO1 instead of GPIO3.
1559
+Load: dtoverlay=gpio-shutdown,<param>=<val>
1560
+Params: gpio_pin GPIO pin to trigger on (default 3)
1561
+ For Raspberry Pi 1 Model B rev 1 set this
1562
+ explicitly to value 1, e.g.:
1563
+
1564
+ dtoverlay=gpio-shutdown,gpio_pin=1
1565
+
1566
+ active_low When this is 1 (active low), a falling
1567
+ edge generates a key down event and a
1568
+ rising edge generates a key up event.
1569
+ When this is 0 (active high), this is
1570
+ reversed. The default is 1 (active low).
1571
+
1572
+ gpio_pull Desired pull-up/down state (off, down, up)
1573
+ Default is "up".
1574
+
1575
+ Note that the default pin (GPIO3) has an
1576
+ external pullup. Same applies for GPIO1
1577
+ on Raspberry Pi 1 Model B rev 1.
1578
+
1579
+ debounce Specify the debounce interval in milliseconds
1580
+ (default 100)
1581
+
1582
+
1583
+Name: hd44780-lcd
1584
+Info: Configures an HD44780 compatible LCD display. Uses 4 gpio pins for
1585
+ data, 2 gpio pins for enable and register select and 1 optional pin
1586
+ for enabling/disabling the backlight display.
1587
+Load: dtoverlay=hd44780-lcd,<param>=<val>
1588
+Params: pin_d4 GPIO pin for data pin D4 (default 6)
1589
+
1590
+ pin_d5 GPIO pin for data pin D5 (default 13)
1591
+
1592
+ pin_d6 GPIO pin for data pin D6 (default 19)
1593
+
1594
+ pin_d7 GPIO pin for data pin D7 (default 26)
1595
+
1596
+ pin_en GPIO pin for "Enable" (default 21)
1597
+
1598
+ pin_rs GPIO pin for "Register Select" (default 20)
1599
+
1600
+ pin_bl Optional pin for enabling/disabling the
1601
+ display backlight. (default disabled)
1602
+
1603
+ display_height Height of the display in characters
1604
+
1605
+ display_width Width of the display in characters
1606
+
1607
+
1608
+Name: hdmi-backlight-hwhack-gpio
1609
+Info: Devicetree overlay for GPIO based backlight on/off capability.
1610
+ Use this if you have one of those HDMI displays whose backlight cannot
1611
+ be controlled via DPMS over HDMI and plan to do a little soldering to
1612
+ use an RPi gpio pin for on/off switching. See:
1613
+ https://www.waveshare.com/wiki/7inch_HDMI_LCD_(C)#Backlight_Control
1614
+Load: dtoverlay=hdmi-backlight-hwhack-gpio,<param>=<val>
1615
+Params: gpio_pin GPIO pin used (default 17)
1616
+ active_low Set this to 1 if the display backlight is
1617
+ switched on when the wire goes low.
1618
+ Leave the default (value 0) if the backlight
1619
+ expects a high to switch it on.
1620
+
1621
+
1622
+Name: hifiberry-amp
1623
+Info: Configures the HifiBerry Amp and Amp+ audio cards
1624
+Load: dtoverlay=hifiberry-amp
1625
+Params: <None>
1626
+
1627
+
1628
+Name: hifiberry-amp100
1629
+Info: Configures the HifiBerry AMP100 audio card
1630
+Load: dtoverlay=hifiberry-amp100,<param>=<val>
1631
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
1632
+ Digital volume control. Enable with
1633
+ "dtoverlay=hifiberry-amp100,24db_digital_gain"
1634
+ (The default behaviour is that the Digital
1635
+ volume control is limited to a maximum of
1636
+ 0dB. ie. it can attenuate but not provide
1637
+ gain. For most users, this will be desired
1638
+ as it will prevent clipping. By appending
1639
+ the 24dB_digital_gain parameter, the Digital
1640
+ volume control will allow up to 24dB of
1641
+ gain. If this parameter is enabled, it is the
1642
+ responsibility of the user to ensure that
1643
+ the Digital volume control is set to a value
1644
+ that does not result in clipping/distortion!)
1645
+ slave Force DAC+ Pro into slave mode, using Pi as
1646
+ master for bit clock and frame clock.
1647
+ leds_off If set to 'true' the onboard indicator LEDs
1648
+ are switched off at all times.
1649
+ auto_mute If set to 'true' the amplifier is automatically
1650
+ muted when the DAC is not playing.
1651
+ mute_ext_ctl The amplifier's HW mute control is enabled
1652
+ in ALSA mixer and set to <val>.
1653
+ Will be overwritten by ALSA user settings.
1654
+
1655
+
1656
+Name: hifiberry-amp3
1657
+Info: Configures the HifiBerry Amp3 audio card
1658
+Load: dtoverlay=hifiberry-amp3
1659
+Params: <None>
1660
+
1661
+
1662
+Name: hifiberry-dac
1663
+Info: Configures the HifiBerry DAC audio cards
1664
+Load: dtoverlay=hifiberry-dac
1665
+Params: <None>
1666
+
1667
+
1668
+Name: hifiberry-dacplus
1669
+Info: Configures the HifiBerry DAC+ audio card
1670
+Load: dtoverlay=hifiberry-dacplus,<param>=<val>
1671
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
1672
+ Digital volume control. Enable with
1673
+ "dtoverlay=hifiberry-dacplus,24db_digital_gain"
1674
+ (The default behaviour is that the Digital
1675
+ volume control is limited to a maximum of
1676
+ 0dB. ie. it can attenuate but not provide
1677
+ gain. For most users, this will be desired
1678
+ as it will prevent clipping. By appending
1679
+ the 24dB_digital_gain parameter, the Digital
1680
+ volume control will allow up to 24dB of
1681
+ gain. If this parameter is enabled, it is the
1682
+ responsibility of the user to ensure that
1683
+ the Digital volume control is set to a value
1684
+ that does not result in clipping/distortion!)
1685
+ slave Force DAC+ Pro into slave mode, using Pi as
1686
+ master for bit clock and frame clock.
1687
+ leds_off If set to 'true' the onboard indicator LEDs
1688
+ are switched off at all times.
1689
+
1690
+
1691
+Name: hifiberry-dacplusadc
1692
+Info: Configures the HifiBerry DAC+ADC audio card
1693
+Load: dtoverlay=hifiberry-dacplusadc,<param>=<val>
1694
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
1695
+ Digital volume control. Enable with
1696
+ "dtoverlay=hifiberry-dacplus,24db_digital_gain"
1697
+ (The default behaviour is that the Digital
1698
+ volume control is limited to a maximum of
1699
+ 0dB. ie. it can attenuate but not provide
1700
+ gain. For most users, this will be desired
1701
+ as it will prevent clipping. By appending
1702
+ the 24dB_digital_gain parameter, the Digital
1703
+ volume control will allow up to 24dB of
1704
+ gain. If this parameter is enabled, it is the
1705
+ responsibility of the user to ensure that
1706
+ the Digital volume control is set to a value
1707
+ that does not result in clipping/distortion!)
1708
+ slave Force DAC+ Pro into slave mode, using Pi as
1709
+ master for bit clock and frame clock.
1710
+ leds_off If set to 'true' the onboard indicator LEDs
1711
+ are switched off at all times.
1712
+
1713
+
1714
+Name: hifiberry-dacplusadcpro
1715
+Info: Configures the HifiBerry DAC+ADC PRO audio card
1716
+Load: dtoverlay=hifiberry-dacplusadcpro,<param>=<val>
1717
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
1718
+ Digital volume control. Enable with
1719
+ "dtoverlay=hifiberry-dacplusadcpro,24db_digital_gain"
1720
+ (The default behaviour is that the Digital
1721
+ volume control is limited to a maximum of
1722
+ 0dB. ie. it can attenuate but not provide
1723
+ gain. For most users, this will be desired
1724
+ as it will prevent clipping. By appending
1725
+ the 24dB_digital_gain parameter, the Digital
1726
+ volume control will allow up to 24dB of
1727
+ gain. If this parameter is enabled, it is the
1728
+ responsibility of the user to ensure that
1729
+ the Digital volume control is set to a value
1730
+ that does not result in clipping/distortion!)
1731
+ slave Force DAC+ADC Pro into slave mode, using Pi as
1732
+ master for bit clock and frame clock.
1733
+ leds_off If set to 'true' the onboard indicator LEDs
1734
+ are switched off at all times.
1735
+
1736
+
1737
+Name: hifiberry-dacplusdsp
1738
+Info: Configures the HifiBerry DAC+DSP audio card
1739
+Load: dtoverlay=hifiberry-dacplusdsp
1740
+Params: <None>
1741
+
1742
+
1743
+Name: hifiberry-dacplushd
1744
+Info: Configures the HifiBerry DAC+ HD audio card
1745
+Load: dtoverlay=hifiberry-dacplushd
1746
+Params: <None>
1747
+
1748
+
1749
+Name: hifiberry-digi
1750
+Info: Configures the HifiBerry Digi and Digi+ audio card
1751
+Load: dtoverlay=hifiberry-digi
1752
+Params: <None>
1753
+
1754
+
1755
+Name: hifiberry-digi-pro
1756
+Info: Configures the HifiBerry Digi+ Pro and Digi2 Pro audio card
1757
+Load: dtoverlay=hifiberry-digi-pro
1758
+Params: <None>
1759
+
1760
+
1761
+Name: highperi
1762
+Info: Enables "High Peripheral" mode
1763
+Load: dtoverlay=highperi
1764
+Params: <None>
1765
+
1766
+
1767
+Name: hy28a
1768
+Info: HY28A - 2.8" TFT LCD Display Module by HAOYU Electronics
1769
+ Default values match Texy's display shield
1770
+Load: dtoverlay=hy28a,<param>=<val>
1771
+Params: speed Display SPI bus speed
1772
+
1773
+ rotate Display rotation {0,90,180,270}
1774
+
1775
+ fps Delay between frame updates
1776
+
1777
+ debug Debug output level {0-7}
1778
+
1779
+ xohms Touchpanel sensitivity (X-plate resistance)
1780
+
1781
+ resetgpio GPIO used to reset controller
1782
+
1783
+ ledgpio GPIO used to control backlight
1784
+
1785
+
1786
+Name: hy28b
1787
+Info: HY28B - 2.8" TFT LCD Display Module by HAOYU Electronics
1788
+ Default values match Texy's display shield
1789
+Load: dtoverlay=hy28b,<param>=<val>
1790
+Params: speed Display SPI bus speed
1791
+
1792
+ rotate Display rotation {0,90,180,270}
1793
+
1794
+ fps Delay between frame updates
1795
+
1796
+ debug Debug output level {0-7}
1797
+
1798
+ xohms Touchpanel sensitivity (X-plate resistance)
1799
+
1800
+ resetgpio GPIO used to reset controller
1801
+
1802
+ ledgpio GPIO used to control backlight
1803
+
1804
+
1805
+Name: hy28b-2017
1806
+Info: HY28B 2017 version - 2.8" TFT LCD Display Module by HAOYU Electronics
1807
+ Default values match Texy's display shield
1808
+Load: dtoverlay=hy28b-2017,<param>=<val>
1809
+Params: speed Display SPI bus speed
1810
+
1811
+ rotate Display rotation {0,90,180,270}
1812
+
1813
+ fps Delay between frame updates
1814
+
1815
+ debug Debug output level {0-7}
1816
+
1817
+ xohms Touchpanel sensitivity (X-plate resistance)
1818
+
1819
+ resetgpio GPIO used to reset controller
1820
+
1821
+ ledgpio GPIO used to control backlight
1822
+
1823
+
1824
+Name: i-sabre-q2m
1825
+Info: Configures the Audiophonics I-SABRE Q2M DAC
1826
+Load: dtoverlay=i-sabre-q2m
1827
+Params: <None>
1828
+
1829
+
1830
+Name: i2c-bcm2708
1831
+Info: Fall back to the i2c_bcm2708 driver for the i2c_arm bus.
1832
+Load: dtoverlay=i2c-bcm2708
1833
+Params: <None>
1834
+
1835
+
1836
+Name: i2c-fan
1837
+Info: Adds support for a number of I2C fan controllers
1838
+Load: dtoverlay=i2c-fan,<param>=<val>
1839
+Params: addr Sets the address for the fan controller. Note
1840
+ that the device must be configured to use the
1841
+ specified address.
1842
+
1843
+ i2c0 Choose the I2C0 bus on GPIOs 0&1
1844
+
1845
+ i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
1846
+
1847
+ i2c3 Choose the I2C3 bus (configure with the i2c3
1848
+ overlay - BCM2711 only)
1849
+
1850
+ i2c4 Choose the I2C4 bus (configure with the i2c4
1851
+ overlay - BCM2711 only)
1852
+
1853
+ i2c5 Choose the I2C5 bus (configure with the i2c5
1854
+ overlay - BCM2711 only)
1855
+
1856
+ i2c6 Choose the I2C6 bus (configure with the i2c6
1857
+ overlay - BCM2711 only)
1858
+
1859
+ minpwm PWM setting for the fan when the SoC is below
1860
+ mintemp (range 0-255. default 0)
1861
+ maxpwm PWM setting for the fan when the SoC is above
1862
+ maxtemp (range 0-255. default 255)
1863
+ midtemp Temperature (in millicelcius) at which the fan
1864
+ begins to speed up (default 50000)
1865
+
1866
+ midtemp_hyst Temperature delta (in millicelcius) below
1867
+ mintemp at which the fan will drop to minrpm
1868
+ (default 2000)
1869
+
1870
+ maxtemp Temperature (in millicelcius) at which the fan
1871
+ will be held at maxrpm (default 70000)
1872
+
1873
+ maxtemp_hyst Temperature delta (in millicelcius) below
1874
+ maxtemp at which the fan begins to slow down
1875
+ (default 2000)
1876
+
1877
+ emc2301 Select the Microchip EMC230x controller family
1878
+ - EMC2301, EMC2302, EMC2303, EMC2305.
1879
+
1880
+
1881
+Name: i2c-gpio
1882
+Info: Adds support for software i2c controller on gpio pins
1883
+Load: dtoverlay=i2c-gpio,<param>=<val>
1884
+Params: i2c_gpio_sda GPIO used for I2C data (default "23")
1885
+
1886
+ i2c_gpio_scl GPIO used for I2C clock (default "24")
1887
+
1888
+ i2c_gpio_delay_us Clock delay in microseconds
1889
+ (default "2" = ~100kHz)
1890
+
1891
+ bus Set to a unique, non-zero value if wanting
1892
+ multiple i2c-gpio busses. If set, will be used
1893
+ as the preferred bus number (/dev/i2c-<n>). If
1894
+ not set, the default value is 0, but the bus
1895
+ number will be dynamically assigned - probably
1896
+ 3.
1897
+
1898
+
1899
+Name: i2c-mux
1900
+Info: Adds support for a number of I2C bus multiplexers on i2c_arm
1901
+Load: dtoverlay=i2c-mux,<param>=<val>
1902
+Params: pca9542 Select the NXP PCA9542 device
1903
+
1904
+ pca9545 Select the NXP PCA9545 device
1905
+
1906
+ pca9548 Select the NXP PCA9548 device
1907
+
1908
+ addr Change I2C address of the device (default 0x70)
1909
+
1910
+ i2c0 Choose the I2C0 bus on GPIOs 0&1
1911
+
1912
+ i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
1913
+
1914
+ i2c3 Choose the I2C3 bus (configure with the i2c3
1915
+ overlay - BCM2711 only)
1916
+
1917
+ i2c4 Choose the I2C3 bus (configure with the i2c3
1918
+ overlay - BCM2711 only)
1919
+
1920
+ i2c5 Choose the I2C5 bus (configure with the i2c4
1921
+ overlay - BCM2711 only)
1922
+
1923
+ i2c6 Choose the I2C6 bus (configure with the i2c6
1924
+ overlay - BCM2711 only)
1925
+
1926
+
1927
+[ The i2c-mux-pca9548a overlay has been deleted. See i2c-mux. ]
1928
+
1929
+
1930
+Name: i2c-pwm-pca9685a
1931
+Info: Adds support for an NXP PCA9685A I2C PWM controller on i2c_arm
1932
+Load: dtoverlay=i2c-pwm-pca9685a,<param>=<val>
1933
+Params: addr I2C address of PCA9685A (default 0x40)
1934
+ i2c0 Choose the I2C0 bus on GPIOs 0&1
1935
+ i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
1936
+ i2c3 Choose the I2C3 bus (configure with the i2c3
1937
+ overlay - BCM2711 only)
1938
+ i2c4 Choose the I2C3 bus (configure with the i2c3
1939
+ overlay - BCM2711 only)
1940
+ i2c5 Choose the I2C5 bus (configure with the i2c4
1941
+ overlay - BCM2711 only)
1942
+ i2c6 Choose the I2C6 bus (configure with the i2c6
1943
+ overlay - BCM2711 only)
1944
+
1945
+
1946
+Name: i2c-rtc
1947
+Info: Adds support for a number of I2C Real Time Clock devices
1948
+Load: dtoverlay=i2c-rtc,<param>=<val>
1949
+Params: abx80x Select one of the ABx80x family:
1950
+ AB0801, AB0803, AB0804, AB0805,
1951
+ AB1801, AB1803, AB1804, AB1805
1952
+
1953
+ bq32000 Select the TI BQ32000 device
1954
+
1955
+ ds1307 Select the DS1307 device
1956
+
1957
+ ds1339 Select the DS1339 device
1958
+
1959
+ ds1340 Select the DS1340 device
1960
+
1961
+ ds3231 Select the DS3231 device
1962
+
1963
+ m41t62 Select the M41T62 device
1964
+
1965
+ mcp7940x Select the MCP7940x device
1966
+
1967
+ mcp7941x Select the MCP7941x device
1968
+
1969
+ pcf2127 Select the PCF2127 device
1970
+
1971
+ pcf2129 Select the PCF2129 device
1972
+
1973
+ pcf85063 Select the PCF85063 device
1974
+
1975
+ pcf85063a Select the PCF85063A device
1976
+
1977
+ pcf8523 Select the PCF8523 device
1978
+
1979
+ pcf85363 Select the PCF85363 device
1980
+
1981
+ pcf8563 Select the PCF8563 device
1982
+
1983
+ rv1805 Select the Micro Crystal RV1805 device
1984
+
1985
+ rv3028 Select the Micro Crystal RV3028 device
1986
+
1987
+ rv3032 Select the Micro Crystal RV3032 device
1988
+
1989
+ rv8803 Select the Micro Crystal RV8803 device
1990
+
1991
+ sd3078 Select the ZXW Shenzhen whwave SD3078 device
1992
+
1993
+ s35390a Select the ABLIC S35390A device
1994
+
1995
+ i2c0 Choose the I2C0 bus on GPIOs 0&1
1996
+
1997
+ i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
1998
+
1999
+ i2c3 Choose the I2C3 bus (configure with the i2c3
2000
+ overlay - BCM2711 only)
2001
+
2002
+ i2c4 Choose the I2C3 bus (configure with the i2c3
2003
+ overlay - BCM2711 only)
2004
+
2005
+ i2c5 Choose the I2C5 bus (configure with the i2c4
2006
+ overlay - BCM2711 only)
2007
+
2008
+ i2c6 Choose the I2C6 bus (configure with the i2c6
2009
+ overlay - BCM2711 only)
2010
+
2011
+ addr Sets the address for the RTC. Note that the
2012
+ device must be configured to use the specified
2013
+ address.
2014
+
2015
+ trickle-diode-disable Do not use the internal trickle charger diode
2016
+ (BQ32000 only)
2017
+
2018
+ trickle-diode-type Diode type for trickle charge - "standard" or
2019
+ "schottky" (ABx80x and RV1805 only)
2020
+
2021
+ trickle-resistor-ohms Resistor value for trickle charge (DS1339,
2022
+ ABx80x, BQ32000, RV1805, RV3028, RV3032)
2023
+
2024
+ trickle-voltage-mv Charge pump voltage for trickle charge (RV3032)
2025
+
2026
+ wakeup-source Specify that the RTC can be used as a wakeup
2027
+ source
2028
+
2029
+ backup-switchover-mode Backup power supply switch mode. Must be 0 for
2030
+ off or 1 for Vdd < VBackup (RV3028, RV3032)
2031
+
2032
+
2033
+Name: i2c-rtc-gpio
2034
+Info: Adds support for a number of I2C Real Time Clock devices
2035
+ using the software i2c controller
2036
+Load: dtoverlay=i2c-rtc-gpio,<param>=<val>
2037
+Params: abx80x Select one of the ABx80x family:
2038
+ AB0801, AB0803, AB0804, AB0805,
2039
+ AB1801, AB1803, AB1804, AB1805
2040
+
2041
+ bq32000 Select the TI BQ32000 device
2042
+
2043
+ ds1307 Select the DS1307 device
2044
+
2045
+ ds1339 Select the DS1339 device
2046
+
2047
+ ds1340 Select the DS1340 device
2048
+
2049
+ ds3231 Select the DS3231 device
2050
+
2051
+ m41t62 Select the M41T62 device
2052
+
2053
+ mcp7940x Select the MCP7940x device
2054
+
2055
+ mcp7941x Select the MCP7941x device
2056
+
2057
+ pcf2127 Select the PCF2127 device
2058
+
2059
+ pcf2129 Select the PCF2129 device
2060
+
2061
+ pcf85063 Select the PCF85063 device
2062
+
2063
+ pcf85063a Select the PCF85063A device
2064
+
2065
+ pcf8523 Select the PCF8523 device
2066
+
2067
+ pcf85363 Select the PCF85363 device
2068
+
2069
+ pcf8563 Select the PCF8563 device
2070
+
2071
+ rv1805 Select the Micro Crystal RV1805 device
2072
+
2073
+ rv3028 Select the Micro Crystal RV3028 device
2074
+
2075
+ rv3032 Select the Micro Crystal RV3032 device
2076
+
2077
+ rv8803 Select the Micro Crystal RV8803 device
2078
+
2079
+ sd3078 Select the ZXW Shenzhen whwave SD3078 device
2080
+
2081
+ s35390a Select the ABLIC S35390A device
2082
+
2083
+ addr Sets the address for the RTC. Note that the
2084
+ device must be configured to use the specified
2085
+ address.
2086
+
2087
+ trickle-diode-disable Do not use the internal trickle charger diode
2088
+ (BQ32000 only)
2089
+
2090
+ trickle-diode-type Diode type for trickle charge - "standard" or
2091
+ "schottky" (ABx80x and RV1805 only)
2092
+
2093
+ trickle-resistor-ohms Resistor value for trickle charge (DS1339,
2094
+ ABx80x, BQ32000, RV1805, RV3028, RV3032)
2095
+
2096
+ trickle-voltage-mv Charge pump voltage for trickle charge (RV3032)
2097
+
2098
+ wakeup-source Specify that the RTC can be used as a wakeup
2099
+ source
2100
+
2101
+ backup-switchover-mode Backup power supply switch mode. Must be 0 for
2102
+ off or 1 for Vdd < VBackup (RV3028, RV3032)
2103
+
2104
+ i2c_gpio_sda GPIO used for I2C data (default "23")
2105
+
2106
+ i2c_gpio_scl GPIO used for I2C clock (default "24")
2107
+
2108
+ i2c_gpio_delay_us Clock delay in microseconds
2109
+ (default "2" = ~100kHz)
2110
+
2111
+
2112
+Name: i2c-sensor
2113
+Info: Adds support for a number of I2C barometric pressure, temperature,
2114
+ light level and chemical sensors on i2c_arm
2115
+Load: dtoverlay=i2c-sensor,<param>=<val>
2116
+Params: addr Set the address for the BH1750, BME280, BME680,
2117
+ BMP280, BMP380, CCS811, DS1621, HDC100X, JC42,
2118
+ LM75, MCP980x, MPU6050, MPU9250, MS5637, MS5803,
2119
+ MS5805, MS5837, MS8607, SHT3x or TMP102
2120
+
2121
+ aht10 Select the Aosong AHT10 temperature and humidity
2122
+ sensor
2123
+
2124
+ bh1750 Select the Rohm BH1750 ambient light sensor
2125
+ Valid addresses 0x23 or 0x5c, default 0x23
2126
+
2127
+ bme280 Select the Bosch Sensortronic BME280
2128
+ Valid addresses 0x76-0x77, default 0x76
2129
+
2130
+ bme680 Select the Bosch Sensortronic BME680
2131
+ Valid addresses 0x76-0x77, default 0x76
2132
+
2133
+ bmp085 Select the Bosch Sensortronic BMP085
2134
+
2135
+ bmp180 Select the Bosch Sensortronic BMP180
2136
+
2137
+ bmp280 Select the Bosch Sensortronic BMP280
2138
+ Valid addresses 0x76-0x77, default 0x76
2139
+
2140
+ bmp380 Select the Bosch Sensortronic BMP380
2141
+ Valid addresses 0x76-0x77, default 0x76
2142
+
2143
+ bno055 Select the Bosch Sensortronic BNO055 IMU
2144
+ Valid address 0x28-0x29, default 0x29
2145
+
2146
+ ccs811 Select the AMS CCS811 digital gas sensor
2147
+ Valid addresses 0x5a-0x5b, default 0x5b
2148
+
2149
+ ds1621 Select the Dallas Semiconductors DS1621 temp
2150
+ sensor. Valid addresses 0x48-0x4f, default 0x48
2151
+
2152
+ hdc100x Select the Texas Instruments HDC100x temp sensor
2153
+ Valid addresses 0x40-0x43, default 0x40
2154
+
2155
+ htu21 Select the HTU21 temperature and humidity sensor
2156
+
2157
+ int_pin Set the GPIO to use for interrupts (max30102,
2158
+ mpu6050 and mpu9250 only)
2159
+
2160
+ jc42 Select any of the many JEDEC JC42.4-compliant
2161
+ temperature sensors, including:
2162
+ ADT7408, AT30TS00, CAT34TS02, CAT6095,
2163
+ MAX6604, MCP9804, MCP9805, MCP9808,
2164
+ MCP98242, MCP98243, MCP98244, MCP9843,
2165
+ SE97, SE98, STTS424(E), STTS2002, STTS3000,
2166
+ TSE2002, TSE2004, TS3000, and TS3001.
2167
+ The default address is 0x18.
2168
+
2169
+ lm75 Select the Maxim LM75 temperature sensor
2170
+ Valid addresses 0x48-0x4f, default 0x4f
2171
+
2172
+ lm75addr Deprecated - use addr parameter instead
2173
+
2174
+ max17040 Select the Maxim Integrated MAX17040 battery
2175
+ monitor
2176
+
2177
+ max30102 Select the Maxim Integrated MAX30102 heart-rate
2178
+ and blood-oxygen sensor
2179
+
2180
+ mcp980x Select the Maxim MCP980x range of temperature
2181
+ sensors (i.e. MCP9800, MCP9801, MCP9802 and
2182
+ MCP9803). N.B. For MCP9804, MCP9805 and MCP9808,
2183
+ use the "jc42" option.
2184
+ Valid addresses are 0x18-0x1f (default 0x18)
2185
+
2186
+ mpu6050 Select the InvenSense MPU6050 IMU. Valid
2187
+ valid addresses are 0x68 and 0x69 (default 0x68)
2188
+
2189
+ mpu9250 Select the InvenSense MPU9250 IMU. Valid
2190
+ valid addresses are 0x68 and 0x69 (default 0x68)
2191
+
2192
+ ms5637 Select the Measurement Specialities MS5637
2193
+ pressure and temperature sensor.
2194
+
2195
+ ms5803 Select the Measurement Specialities MS5803
2196
+ pressure and temperature sensor.
2197
+
2198
+ ms5805 Select the Measurement Specialities MS5805
2199
+ pressure and temperature sensor.
2200
+
2201
+ ms5837 Select the Measurement Specialities MS5837
2202
+ pressure and temperature sensor.
2203
+
2204
+ ms8607 Select the Measurement Specialities MS8607
2205
+ pressure and temperature sensor.
2206
+
2207
+ no_timeout Disable the SMBUS timeout. N.B. Only supported
2208
+ by some jc42 devices - using with an
2209
+ incompatible device can stop it from being
2210
+ activated.
2211
+
2212
+ reset_pin GPIO to be used to reset the device (bno055
2213
+ only, disabled by default)
2214
+
2215
+ sht3x Select the Sensirion SHT3x temperature and
2216
+ humidity sensors. Valid addresses 0x44-0x45,
2217
+ default 0x44
2218
+
2219
+ sht4x Select the Sensirion SHT4x temperature and
2220
+ humidity sensors. Valid addresses 0x44-0x45,
2221
+ default 0x44
2222
+
2223
+ si7020 Select the Silicon Labs Si7013/20/21 humidity/
2224
+ temperature sensor
2225
+
2226
+ sps30 Select the Sensirion SPS30 particulate matter
2227
+ sensor. Fixed address 0x69.
2228
+
2229
+ sgp30 Select the Sensirion SGP30 VOC sensor.
2230
+ Fixed address 0x58.
2231
+
2232
+ tmp102 Select the Texas Instruments TMP102 temp sensor
2233
+ Valid addresses 0x48-0x4b, default 0x48
2234
+
2235
+ tsl4531 Select the AMS TSL4531 digital ambient light
2236
+ sensor
2237
+
2238
+ veml6070 Select the Vishay VEML6070 ultraviolet light
2239
+ sensor
2240
+
2241
+ i2c0 Choose the I2C0 bus on GPIOs 0&1
2242
+
2243
+ i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
2244
+
2245
+ i2c3 Choose the I2C3 bus (configure with the i2c3
2246
+ overlay - BCM2711 only)
2247
+
2248
+ i2c4 Choose the I2C3 bus (configure with the i2c3
2249
+ overlay - BCM2711 only)
2250
+
2251
+ i2c5 Choose the I2C5 bus (configure with the i2c4
2252
+ overlay - BCM2711 only)
2253
+
2254
+ i2c6 Choose the I2C6 bus (configure with the i2c6
2255
+ overlay - BCM2711 only)
2256
+
2257
+
2258
+Name: i2c0
2259
+Info: Change i2c0 pin usage. Not all pin combinations are usable on all
2260
+ platforms - platforms other then Compute Modules can only use this
2261
+ to disable transaction combining.
2262
+ Do NOT use in conjunction with dtparam=i2c_vc=on. From the 5.4 kernel
2263
+ onwards the base DT includes the use of i2c_mux_pinctrl to expose two
2264
+ muxings of BSC0 - GPIOs 0&1, and whichever combination is used for the
2265
+ camera and display connectors. This overlay disables that mux and
2266
+ configures /dev/i2c0 to point at whichever set of pins is requested.
2267
+ dtparam=i2c_vc=on will try and enable the mux, so combining the two
2268
+ will cause conflicts.
2269
+Load: dtoverlay=i2c0,<param>=<val>
2270
+Params: pins_0_1 Use pins 0 and 1 (default)
2271
+ pins_28_29 Use pins 28 and 29
2272
+ pins_44_45 Use pins 44 and 45
2273
+ pins_46_47 Use pins 46 and 47
2274
+ combine Allow transactions to be combined (default
2275
+ "yes")
2276
+
2277
+
2278
+Name: i2c0-bcm2708
2279
+Info: Deprecated, legacy version of i2c0.
2280
+Load: <Deprecated>
2281
+
2282
+
2283
+Name: i2c0-pi5
2284
+Info: Enable i2c0 (Pi 5 only)
2285
+Load: dtoverlay=i2c0-pi5,<param>=<val>
2286
+Params: pins_0_1 Use GPIOs 0 and 1 (default)
2287
+ pins_8_9 Use GPIOs 8 and 9
2288
+ baudrate Set the baudrate for the interface (default
2289
+ "100000")
2290
+
2291
+
2292
+Name: i2c1
2293
+Info: Change i2c1 pin usage. Not all pin combinations are usable on all
2294
+ platforms - platforms other then Compute Modules can only use this
2295
+ to disable transaction combining.
2296
+Load: dtoverlay=i2c1,<param>=<val>
2297
+Params: pins_2_3 Use pins 2 and 3 (default)
2298
+ pins_44_45 Use pins 44 and 45
2299
+ combine Allow transactions to be combined (default
2300
+ "yes")
2301
+
2302
+
2303
+Name: i2c1-bcm2708
2304
+Info: Deprecated, legacy version of i2c1.
2305
+Load: <Deprecated>
2306
+
2307
+
2308
+Name: i2c1-pi5
2309
+Info: Enable i2c1 (Pi 5 only)
2310
+Load: dtoverlay=i2c1-pi5,<param>=<val>
2311
+Params: pins_2_3 Use GPIOs 2 and 3 (default)
2312
+ pins_10_11 Use GPIOs 10 and 11
2313
+ baudrate Set the baudrate for the interface (default
2314
+ "100000")
2315
+
2316
+
2317
+Name: i2c2-pi5
2318
+Info: Enable i2c2 (Pi 5 only)
2319
+Load: dtoverlay=i2c2-pi5,<param>=<val>
2320
+Params: pins_4_5 Use GPIOs 4 and 5 (default)
2321
+ pins_12_13 Use GPIOs 12 and 13
2322
+ baudrate Set the baudrate for the interface (default
2323
+ "100000")
2324
+
2325
+
2326
+Name: i2c3
2327
+Info: Enable the i2c3 bus. BCM2711 only.
2328
+Load: dtoverlay=i2c3,<param>
2329
+Params: pins_2_3 Use GPIOs 2 and 3
2330
+ pins_4_5 Use GPIOs 4 and 5 (default)
2331
+ baudrate Set the baudrate for the interface (default
2332
+ "100000")
2333
+
2334
+
2335
+Name: i2c3-pi5
2336
+Info: Enable i2c3 (Pi 5 only)
2337
+Load: dtoverlay=i2c3-pi5,<param>=<val>
2338
+Params: pins_6_7 Use GPIOs 6 and 7 (default)
2339
+ pins_14_15 Use GPIOs 14 and 15
2340
+ pins_22_23 Use GPIOs 22 and 23
2341
+ baudrate Set the baudrate for the interface (default
2342
+ "100000")
2343
+
2344
+
2345
+Name: i2c4
2346
+Info: Enable the i2c4 bus. BCM2711 only.
2347
+Load: dtoverlay=i2c4,<param>
2348
+Params: pins_6_7 Use GPIOs 6 and 7
2349
+ pins_8_9 Use GPIOs 8 and 9 (default)
2350
+ baudrate Set the baudrate for the interface (default
2351
+ "100000")
2352
+
2353
+
2354
+Name: i2c5
2355
+Info: Enable the i2c5 bus. BCM2711 only.
2356
+Load: dtoverlay=i2c5,<param>
2357
+Params: pins_10_11 Use GPIOs 10 and 11
2358
+ pins_12_13 Use GPIOs 12 and 13 (default)
2359
+ baudrate Set the baudrate for the interface (default
2360
+ "100000")
2361
+
2362
+
2363
+Name: i2c6
2364
+Info: Enable the i2c6 bus. BCM2711 only.
2365
+Load: dtoverlay=i2c6,<param>
2366
+Params: pins_0_1 Use GPIOs 0 and 1
2367
+ pins_22_23 Use GPIOs 22 and 23 (default)
2368
+ baudrate Set the baudrate for the interface (default
2369
+ "100000")
2370
+
2371
+
2372
+Name: i2s-dac
2373
+Info: Configures any passive I2S DAC soundcard.
2374
+Load: dtoverlay=i2s-dac
2375
+Params: <None>
2376
+
2377
+
2378
+Name: i2s-gpio28-31
2379
+Info: move I2S function block to GPIO 28 to 31
2380
+Load: dtoverlay=i2s-gpio28-31
2381
+Params: <None>
2382
+
2383
+
2384
+Name: ilitek251x
2385
+Info: Enables I2C connected Ilitek 251x multiple touch controller using
2386
+ GPIO 4 (pin 7 on GPIO header) for interrupt.
2387
+Load: dtoverlay=ilitek251x,<param>=<val>
2388
+Params: interrupt GPIO used for interrupt (default 4)
2389
+ sizex Touchscreen size x, horizontal resolution of
2390
+ touchscreen (in pixels)
2391
+ sizey Touchscreen size y, vertical resolution of
2392
+ touchscreen (in pixels)
2393
+
2394
+
2395
+Name: imx219
2396
+Info: Sony IMX219 camera module.
2397
+ Uses Unicam 1, which is the standard camera connector on most Pi
2398
+ variants.
2399
+Load: dtoverlay=imx219,<param>=<val>
2400
+Params: rotation Mounting rotation of the camera sensor (0 or
2401
+ 180, default 180)
2402
+ orientation Sensor orientation (0 = front, 1 = rear,
2403
+ 2 = external, default external)
2404
+ media-controller Configure use of Media Controller API for
2405
+ configuring the sensor (default on)
2406
+ cam0 Adopt the default configuration for CAM0 on a
2407
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2408
+ vcm Configure a VCM focus drive on the sensor.
2409
+
2410
+
2411
+Name: imx258
2412
+Info: Sony IMX258 camera module.
2413
+ Uses Unicam 1, which is the standard camera connector on most Pi
2414
+ variants.
2415
+Load: dtoverlay=imx258,<param>=<val>
2416
+Params: rotation Mounting rotation of the camera sensor (0 or
2417
+ 180, default 180)
2418
+ orientation Sensor orientation (0 = front, 1 = rear,
2419
+ 2 = external, default external)
2420
+ media-controller Configure use of Media Controller API for
2421
+ configuring the sensor (default on)
2422
+ cam0 Adopt the default configuration for CAM0 on a
2423
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2424
+ vcm Configure a VCM focus drive on the sensor.
2425
+ 4lane Enable 4 CSI2 lanes. This requires a Compute
2426
+ Module (1, 3, or 4).
2427
+
2428
+
2429
+Name: imx290
2430
+Info: Sony IMX290 camera module.
2431
+ Uses Unicam 1, which is the standard camera connector on most Pi
2432
+ variants.
2433
+Load: dtoverlay=imx290,<param>
2434
+Params: 4lane Enable 4 CSI2 lanes. This requires a Compute
2435
+ Module (1, 3, or 4).
2436
+ clock-frequency Sets the clock frequency to match that used on
2437
+ the board.
2438
+ Modules from Vision Components use 37.125MHz
2439
+ (the default), whilst those from Innomaker use
2440
+ 74.25MHz.
2441
+ mono Denote that the module is a mono sensor.
2442
+ orientation Sensor orientation (0 = front, 1 = rear,
2443
+ 2 = external, default external)
2444
+ rotation Mounting rotation of the camera sensor (0 or
2445
+ 180, default 0)
2446
+ media-controller Configure use of Media Controller API for
2447
+ configuring the sensor (default on)
2448
+ cam0 Adopt the default configuration for CAM0 on a
2449
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2450
+
2451
+
2452
+Name: imx296
2453
+Info: Sony IMX296 camera module.
2454
+ Uses Unicam 1, which is the standard camera connector on most Pi
2455
+ variants.
2456
+Load: dtoverlay=imx296,<param>=<val>
2457
+Params: rotation Mounting rotation of the camera sensor (0 or
2458
+ 180, default 180)
2459
+ orientation Sensor orientation (0 = front, 1 = rear,
2460
+ 2 = external, default external)
2461
+ media-controller Configure use of Media Controller API for
2462
+ configuring the sensor (default on)
2463
+ cam0 Adopt the default configuration for CAM0 on a
2464
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2465
+ clock-frequency Sets the clock frequency to match that used on
2466
+ the board, which should be one of 54000000
2467
+ (the default), 37125000 or 74250000.
2468
+
2469
+
2470
+Name: imx327
2471
+Info: Sony IMX327 camera module.
2472
+ Uses Unicam 1, which is the standard camera connector on most Pi
2473
+ variants.
2474
+Load: dtoverlay=imx327,<param>
2475
+Params: 4lane Enable 4 CSI2 lanes. This requires a Compute
2476
+ Module (1, 3, or 4).
2477
+ clock-frequency Sets the clock frequency to match that used on
2478
+ the board.
2479
+ Modules from Vision Components use 37.125MHz
2480
+ (the default), whilst those from Innomaker use
2481
+ 74.25MHz.
2482
+ mono Denote that the module is a mono sensor.
2483
+ orientation Sensor orientation (0 = front, 1 = rear,
2484
+ 2 = external, default external)
2485
+ rotation Mounting rotation of the camera sensor (0 or
2486
+ 180, default 0)
2487
+ media-controller Configure use of Media Controller API for
2488
+ configuring the sensor (default on)
2489
+ cam0 Adopt the default configuration for CAM0 on a
2490
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2491
+
2492
+
2493
+Name: imx378
2494
+Info: Sony IMX378 camera module.
2495
+ Uses Unicam 1, which is the standard camera connector on most Pi
2496
+ variants.
2497
+Load: dtoverlay=imx378,<param>=<val>
2498
+Params: rotation Mounting rotation of the camera sensor (0 or
2499
+ 180, default 180)
2500
+ orientation Sensor orientation (0 = front, 1 = rear,
2501
+ 2 = external, default external)
2502
+ media-controller Configure use of Media Controller API for
2503
+ configuring the sensor (default on)
2504
+ cam0 Adopt the default configuration for CAM0 on a
2505
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2506
+
2507
+
2508
+Name: imx462
2509
+Info: Sony IMX462 camera module.
2510
+ Uses Unicam 1, which is the standard camera connector on most Pi
2511
+ variants.
2512
+Load: dtoverlay=imx462,<param>
2513
+Params: 4lane Enable 4 CSI2 lanes. This requires a Compute
2514
+ Module (1, 3, or 4).
2515
+ clock-frequency Sets the clock frequency to match that used on
2516
+ the board.
2517
+ Modules from Vision Components use 37.125MHz
2518
+ (the default), whilst those from Innomaker use
2519
+ 74.25MHz.
2520
+ mono Denote that the module is a mono sensor.
2521
+ orientation Sensor orientation (0 = front, 1 = rear,
2522
+ 2 = external, default external)
2523
+ rotation Mounting rotation of the camera sensor (0 or
2524
+ 180, default 0)
2525
+ media-controller Configure use of Media Controller API for
2526
+ configuring the sensor (default on)
2527
+ cam0 Adopt the default configuration for CAM0 on a
2528
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2529
+
2530
+
2531
+Name: imx477
2532
+Info: Sony IMX477 camera module.
2533
+ Uses Unicam 1, which is the standard camera connector on most Pi
2534
+ variants.
2535
+Load: dtoverlay=imx477,<param>=<val>
2536
+Params: rotation Mounting rotation of the camera sensor (0 or
2537
+ 180, default 180)
2538
+ orientation Sensor orientation (0 = front, 1 = rear,
2539
+ 2 = external, default external)
2540
+ media-controller Configure use of Media Controller API for
2541
+ configuring the sensor (default on)
2542
+ cam0 Adopt the default configuration for CAM0 on a
2543
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2544
+
2545
+
2546
+Name: imx519
2547
+Info: Sony IMX519 camera module.
2548
+ Uses Unicam 1, which is the standard camera connector on most Pi
2549
+ variants.
2550
+Load: dtoverlay=imx519,<param>=<val>
2551
+Params: rotation Mounting rotation of the camera sensor (0 or
2552
+ 180, default 0)
2553
+ orientation Sensor orientation (0 = front, 1 = rear,
2554
+ 2 = external, default external)
2555
+ media-controller Configure use of Media Controller API for
2556
+ configuring the sensor (default on)
2557
+ cam0 Adopt the default configuration for CAM0 on a
2558
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2559
+ vcm Select lens driver state. Default is enabled,
2560
+ but vcm=off will disable.
2561
+
2562
+
2563
+Name: imx708
2564
+Info: Sony IMX708 camera module.
2565
+ Uses Unicam 1, which is the standard camera connector on most Pi
2566
+ variants.
2567
+Load: dtoverlay=imx708,<param>=<val>
2568
+Params: rotation Mounting rotation of the camera sensor (0 or
2569
+ 180, default 180)
2570
+ orientation Sensor orientation (0 = front, 1 = rear,
2571
+ 2 = external, default external)
2572
+ vcm Select lens driver state. Default is enabled,
2573
+ but vcm=off will disable.
2574
+ media-controller Configure use of Media Controller API for
2575
+ configuring the sensor (default on)
2576
+ cam0 Adopt the default configuration for CAM0 on a
2577
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2578
+ link-frequency Allowable link frequency values to use in Hz:
2579
+ 450000000 (default), 447000000, 453000000.
2580
+
2581
+
2582
+Name: iqaudio-codec
2583
+Info: Configures the IQaudio Codec audio card
2584
+Load: dtoverlay=iqaudio-codec
2585
+Params: <None>
2586
+
2587
+
2588
+Name: iqaudio-dac
2589
+Info: Configures the IQaudio DAC audio card
2590
+Load: dtoverlay=iqaudio-dac,<param>
2591
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
2592
+ Digital volume control. Enable with
2593
+ "dtoverlay=iqaudio-dac,24db_digital_gain"
2594
+ (The default behaviour is that the Digital
2595
+ volume control is limited to a maximum of
2596
+ 0dB. ie. it can attenuate but not provide
2597
+ gain. For most users, this will be desired
2598
+ as it will prevent clipping. By appending
2599
+ the 24db_digital_gain parameter, the Digital
2600
+ volume control will allow up to 24dB of
2601
+ gain. If this parameter is enabled, it is the
2602
+ responsibility of the user to ensure that
2603
+ the Digital volume control is set to a value
2604
+ that does not result in clipping/distortion!)
2605
+
2606
+
2607
+Name: iqaudio-dacplus
2608
+Info: Configures the IQaudio DAC+ audio card
2609
+Load: dtoverlay=iqaudio-dacplus,<param>=<val>
2610
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
2611
+ Digital volume control. Enable with
2612
+ "dtoverlay=iqaudio-dacplus,24db_digital_gain"
2613
+ (The default behaviour is that the Digital
2614
+ volume control is limited to a maximum of
2615
+ 0dB. ie. it can attenuate but not provide
2616
+ gain. For most users, this will be desired
2617
+ as it will prevent clipping. By appending
2618
+ the 24db_digital_gain parameter, the Digital
2619
+ volume control will allow up to 24dB of
2620
+ gain. If this parameter is enabled, it is the
2621
+ responsibility of the user to ensure that
2622
+ the Digital volume control is set to a value
2623
+ that does not result in clipping/distortion!)
2624
+ auto_mute_amp If specified, unmute/mute the IQaudIO amp when
2625
+ starting/stopping audio playback.
2626
+ unmute_amp If specified, unmute the IQaudIO amp once when
2627
+ the DAC driver module loads.
2628
+
2629
+
2630
+Name: iqaudio-digi-wm8804-audio
2631
+Info: Configures the IQAudIO Digi WM8804 audio card
2632
+Load: dtoverlay=iqaudio-digi-wm8804-audio,<param>=<val>
2633
+Params: card_name Override the default, "IQAudIODigi", card name.
2634
+ dai_name Override the default, "IQAudIO Digi", dai name.
2635
+ dai_stream_name Override the default, "IQAudIO Digi HiFi",
2636
+ dai stream name.
2637
+
2638
+
2639
+Name: iqs550
2640
+Info: Enables I2C connected Azoteq IQS550 trackpad/touchscreen controller
2641
+ using GPIO 4 (pin 7 on GPIO header) for interrupt.
2642
+Load: dtoverlay=iqs550,<param>=<val>
2643
+Params: interrupt GPIO used for interrupt (default 4)
2644
+ reset GPIO used for reset (optional)
2645
+ sizex Touchscreen size x (default 800)
2646
+ sizey Touchscreen size y (default 480)
2647
+ invx Touchscreen inverted x axis
2648
+ invy Touchscreen inverted y axis
2649
+ swapxy Touchscreen swapped x y axis
2650
+
2651
+
2652
+Name: irs1125
2653
+Info: Infineon irs1125 TOF camera module.
2654
+ Uses Unicam 1, which is the standard camera connector on most Pi
2655
+ variants.
2656
+Load: dtoverlay=irs1125,<param>=<val>
2657
+Params: media-controller Configure use of Media Controller API for
2658
+ configuring the sensor (default off)
2659
+ cam0 Adopt the default configuration for CAM0 on a
2660
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
2661
+
2662
+
2663
+Name: jedec-spi-nor
2664
+Info: Adds support for JEDEC-compliant SPI NOR flash devices. (Note: The
2665
+ "jedec,spi-nor" kernel driver was formerly known as "m25p80".)
2666
+Load: dtoverlay=jedec-spi-nor,<param>=<val>
2667
+Params: spi<n>-<m> Enable flash device on SPI<n>, CS#<m>
2668
+ fastr Add fast read capability to the flash device
2669
+ speed Maximum SPI frequency (Hz)
2670
+ flash-spi<n>-<m> Same as spi<n>-<m> (deprecated)
2671
+ flash-fastr-spi<n>-<m> Same as spi<n>->m>,fastr (deprecated)
2672
+
2673
+
2674
+Name: justboom-both
2675
+Info: Simultaneous usage of an justboom-dac and justboom-digi based
2676
+ card
2677
+Load: dtoverlay=justboom-both,<param>=<val>
2678
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
2679
+ Digital volume control. Enable with
2680
+ "dtoverlay=justboom-dac,24db_digital_gain"
2681
+ (The default behaviour is that the Digital
2682
+ volume control is limited to a maximum of
2683
+ 0dB. ie. it can attenuate but not provide
2684
+ gain. For most users, this will be desired
2685
+ as it will prevent clipping. By appending
2686
+ the 24dB_digital_gain parameter, the Digital
2687
+ volume control will allow up to 24dB of
2688
+ gain. If this parameter is enabled, it is the
2689
+ responsibility of the user to ensure that
2690
+ the Digital volume control is set to a value
2691
+ that does not result in clipping/distortion!)
2692
+
2693
+
2694
+Name: justboom-dac
2695
+Info: Configures the JustBoom DAC HAT, Amp HAT, DAC Zero and Amp Zero audio
2696
+ cards
2697
+Load: dtoverlay=justboom-dac,<param>=<val>
2698
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
2699
+ Digital volume control. Enable with
2700
+ "dtoverlay=justboom-dac,24db_digital_gain"
2701
+ (The default behaviour is that the Digital
2702
+ volume control is limited to a maximum of
2703
+ 0dB. ie. it can attenuate but not provide
2704
+ gain. For most users, this will be desired
2705
+ as it will prevent clipping. By appending
2706
+ the 24dB_digital_gain parameter, the Digital
2707
+ volume control will allow up to 24dB of
2708
+ gain. If this parameter is enabled, it is the
2709
+ responsibility of the user to ensure that
2710
+ the Digital volume control is set to a value
2711
+ that does not result in clipping/distortion!)
2712
+
2713
+
2714
+Name: justboom-digi
2715
+Info: Configures the JustBoom Digi HAT and Digi Zero audio cards
2716
+Load: dtoverlay=justboom-digi
2717
+Params: <None>
2718
+
2719
+
2720
+Name: lirc-rpi
2721
+Info: This overlay has been deprecated and removed - see gpio-ir
2722
+Load: <Deprecated>
2723
+
2724
+
2725
+Name: ltc294x
2726
+Info: Adds support for the ltc294x family of battery gauges
2727
+Load: dtoverlay=ltc294x,<param>=<val>
2728
+Params: ltc2941 Select the ltc2941 device
2729
+
2730
+ ltc2942 Select the ltc2942 device
2731
+
2732
+ ltc2943 Select the ltc2943 device
2733
+
2734
+ ltc2944 Select the ltc2944 device
2735
+
2736
+ resistor-sense The sense resistor value in milli-ohms.
2737
+ Can be a 32-bit negative value when the battery
2738
+ has been connected to the wrong end of the
2739
+ resistor.
2740
+
2741
+ prescaler-exponent Range and accuracy of the gauge. The value is
2742
+ programmed into the chip only if it differs
2743
+ from the current setting.
2744
+ For LTC2941 only:
2745
+ - Default value is 128
2746
+ - the exponent is in the range 0-7 (default 7)
2747
+ See the datasheet for more information.
2748
+
2749
+
2750
+Name: max98357a
2751
+Info: Configures the Maxim MAX98357A I2S DAC
2752
+Load: dtoverlay=max98357a,<param>=<val>
2753
+Params: no-sdmode Driver does not manage the state of the DAC's
2754
+ SD_MODE pin (i.e. chip is always on).
2755
+ sdmode-pin integer, GPIO pin connected to the SD_MODE input
2756
+ of the DAC (default GPIO4 if parameter omitted).
2757
+
2758
+
2759
+Name: maxtherm
2760
+Info: Configure a MAX6675, MAX31855 or MAX31856 thermocouple as an IIO device.
2761
+
2762
+ For devices on spi1 or spi2, the interfaces should be enabled
2763
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2764
+ The overlay expects to disable the relevant spidev node, so also using
2765
+ e.g. cs0_spidev=off is unnecessary.
2766
+
2767
+ Example:
2768
+ MAX31855 on /dev/spidev0.0
2769
+ dtoverlay=maxtherm,spi0-0,max31855
2770
+ MAX31856 using a type J thermocouple on /dev/spidev2.1
2771
+ dtoverlay=spi2-2cs
2772
+ dtoverlay=maxtherm,spi2-1,max31856,type_j
2773
+
2774
+Load: dtoverlay=maxtherm,<param>=<val>
2775
+Params: spi<n>-<m> Configure device at spi<n>, cs<m>
2776
+ (boolean, required)
2777
+ max6675 Enable support for the MAX6675 (default)
2778
+ max31855 Enable support for the MAX31855
2779
+ max31855e Enable support for the MAX31855E
2780
+ max31855j Enable support for the MAX31855J
2781
+ max31855k Enable support for the MAX31855K
2782
+ max31855n Enable support for the MAX31855N
2783
+ max31855r Enable support for the MAX31855R
2784
+ max31855s Enable support for the MAX31855S
2785
+ max31855t Enable support for the MAX31855T
2786
+ max31856 Enable support for the MAX31856 (with type K)
2787
+ type_b Select a type B sensor for max31856
2788
+ type_e Select a type E sensor for max31856
2789
+ type_j Select a type J sensor for max31856
2790
+ type_k Select a type K sensor for max31856
2791
+ type_n Select a type N sensor for max31856
2792
+ type_r Select a type R sensor for max31856
2793
+ type_s Select a type S sensor for max31856
2794
+ type_t Select a type T sensor for max31856
2795
+
2796
+
2797
+Name: mbed-dac
2798
+Info: Configures the mbed AudioCODEC (TLV320AIC23B)
2799
+Load: dtoverlay=mbed-dac
2800
+Params: <None>
2801
+
2802
+
2803
+Name: mcp23017
2804
+Info: Configures the MCP23017 I2C GPIO expander
2805
+Load: dtoverlay=mcp23017,<param>=<val>
2806
+Params: gpiopin Gpio pin connected to the INTA output of the
2807
+ MCP23017 (default: 4)
2808
+
2809
+ addr I2C address of the MCP23017 (default: 0x20)
2810
+
2811
+ mcp23008 Configure an MCP23008 instead.
2812
+ noints Disable the interrupt GPIO line.
2813
+
2814
+
2815
+Name: mcp23s17
2816
+Info: Configures the MCP23S08/17 SPI GPIO expanders.
2817
+ If devices are present on SPI1 or SPI2, those interfaces must be enabled
2818
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2819
+ If interrupts are enabled for a device on a given CS# on a SPI bus, that
2820
+ device must be the only one present on that SPI bus/CS#.
2821
+Load: dtoverlay=mcp23s17,<param>=<val>
2822
+Params: s08-spi<n>-<m>-present 4-bit integer, bitmap indicating MCP23S08
2823
+ devices present on SPI<n>, CS#<m>
2824
+
2825
+ s17-spi<n>-<m>-present 8-bit integer, bitmap indicating MCP23S17
2826
+ devices present on SPI<n>, CS#<m>
2827
+
2828
+ s08-spi<n>-<m>-int-gpio integer, enables interrupts on a single
2829
+ MCP23S08 device on SPI<n>, CS#<m>, specifies
2830
+ the GPIO pin to which INT output of MCP23S08
2831
+ is connected.
2832
+
2833
+ s17-spi<n>-<m>-int-gpio integer, enables mirrored interrupts on a
2834
+ single MCP23S17 device on SPI<n>, CS#<m>,
2835
+ specifies the GPIO pin to which either INTA
2836
+ or INTB output of MCP23S17 is connected.
2837
+
2838
+
2839
+Name: mcp2515
2840
+Info: Configures the MCP2515 CAN controller on spi0/1/2
2841
+ For devices on spi1 or spi2, the interfaces should be enabled
2842
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2843
+Load: dtoverlay=mcp2515,<param>=<val>
2844
+Params: spi<n>-<m> Configure device at spi<n>, cs<m>
2845
+ (boolean, required)
2846
+
2847
+ oscillator Clock frequency for the CAN controller (Hz)
2848
+
2849
+ speed Maximum SPI frequence (Hz)
2850
+
2851
+ interrupt GPIO for interrupt signal
2852
+
2853
+
2854
+Name: mcp2515-can0
2855
+Info: Configures the MCP2515 CAN controller on spi0.0
2856
+Load: dtoverlay=mcp2515-can0,<param>=<val>
2857
+Params: oscillator Clock frequency for the CAN controller (Hz)
2858
+
2859
+ spimaxfrequency Maximum SPI frequence (Hz)
2860
+
2861
+ interrupt GPIO for interrupt signal
2862
+
2863
+
2864
+Name: mcp2515-can1
2865
+Info: Configures the MCP2515 CAN controller on spi0.1
2866
+Load: dtoverlay=mcp2515-can1,<param>=<val>
2867
+Params: oscillator Clock frequency for the CAN controller (Hz)
2868
+
2869
+ spimaxfrequency Maximum SPI frequence (Hz)
2870
+
2871
+ interrupt GPIO for interrupt signal
2872
+
2873
+
2874
+Name: mcp251xfd
2875
+Info: Configures the MCP251XFD CAN controller family
2876
+ For devices on spi1 or spi2, the interfaces should be enabled
2877
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2878
+Load: dtoverlay=mcp251xfd,<param>=<val>
2879
+Params: spi<n>-<m> Configure device at spi<n>, cs<m>
2880
+ (boolean, required)
2881
+
2882
+ oscillator Clock frequency for the CAN controller (Hz)
2883
+
2884
+ speed Maximum SPI frequence (Hz)
2885
+
2886
+ interrupt GPIO for interrupt signal
2887
+
2888
+ rx_interrupt GPIO for RX interrupt signal (nINT1) (optional)
2889
+
2890
+ xceiver_enable GPIO for CAN transceiver enable (optional)
2891
+
2892
+ xceiver_active_high specifiy if CAN transceiver enable pin is
2893
+ active high (optional, default: active low)
2894
+
2895
+
2896
+Name: mcp3008
2897
+Info: Configures MCP3008 A/D converters
2898
+ For devices on spi1 or spi2, the interfaces should be enabled
2899
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2900
+Load: dtoverlay=mcp3008,<param>[=<val>]
2901
+Params: spi<n>-<m>-present boolean, configure device at spi<n>, cs<m>
2902
+ spi<n>-<m>-speed integer, set the spi bus speed for this device
2903
+
2904
+
2905
+Name: mcp3202
2906
+Info: Configures MCP3202 A/D converters
2907
+ For devices on spi1 or spi2, the interfaces should be enabled
2908
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2909
+Load: dtoverlay=mcp3202,<param>[=<val>]
2910
+Params: spi<n>-<m>-present boolean, configure device at spi<n>, cs<m>
2911
+ spi<n>-<m>-speed integer, set the spi bus speed for this device
2912
+
2913
+
2914
+Name: mcp342x
2915
+Info: Overlay for activation of Microchip MCP3421-3428 ADCs over I2C
2916
+Load: dtoverlay=mcp342x,<param>=<val>
2917
+Params: addr I2C bus address of device, for devices with
2918
+ addresses that are configurable, e.g. by
2919
+ hardware links (default=0x68)
2920
+ mcp3421 The device is an MCP3421
2921
+ mcp3422 The device is an MCP3422
2922
+ mcp3423 The device is an MCP3423
2923
+ mcp3424 The device is an MCP3424
2924
+ mcp3425 The device is an MCP3425
2925
+ mcp3426 The device is an MCP3426
2926
+ mcp3427 The device is an MCP3427
2927
+ mcp3428 The device is an MCP3428
2928
+
2929
+
2930
+Name: media-center
2931
+Info: Media Center HAT - 2.83" Touch Display + extras by Pi Supply
2932
+Load: dtoverlay=media-center,<param>=<val>
2933
+Params: speed Display SPI bus speed
2934
+ rotate Display rotation {0,90,180,270}
2935
+ fps Delay between frame updates
2936
+ xohms Touchpanel sensitivity (X-plate resistance)
2937
+ swapxy Swap x and y axis
2938
+ backlight Change backlight GPIO pin {e.g. 12, 18}
2939
+ debug "on" = enable additional debug messages
2940
+ (default "off")
2941
+
2942
+
2943
+Name: merus-amp
2944
+Info: Configures the merus-amp audio card
2945
+Load: dtoverlay=merus-amp
2946
+Params: <None>
2947
+
2948
+
2949
+Name: midi-uart0
2950
+Info: Configures UART0 (ttyAMA0) so that a requested 38.4kbaud actually gets
2951
+ 31.25kbaud, the frequency required for MIDI
2952
+Load: dtoverlay=midi-uart0
2953
+Params: <None>
2954
+
2955
+
2956
+Name: midi-uart0-pi5
2957
+Info: See midi-uart0 (this is the Pi 5 version)
2958
+
2959
+
2960
+Name: midi-uart1
2961
+Info: Configures UART1 (ttyS0) so that a requested 38.4kbaud actually gets
2962
+ 31.25kbaud, the frequency required for MIDI
2963
+Load: dtoverlay=midi-uart1
2964
+Params: <None>
2965
+
2966
+
2967
+Name: midi-uart1-pi5
2968
+Info: See midi-uart1 (this is the Pi 5 version)
2969
+
2970
+
2971
+Name: midi-uart2
2972
+Info: Configures UART2 (ttyAMA2) so that a requested 38.4kbaud actually gets
2973
+ 31.25kbaud, the frequency required for MIDI
2974
+Load: dtoverlay=midi-uart2
2975
+Params: <None>
2976
+
2977
+
2978
+Name: midi-uart2-pi5
2979
+Info: See midi-uart2 (this is the Pi 5 version)
2980
+
2981
+
2982
+Name: midi-uart3
2983
+Info: Configures UART3 (ttyAMA3) so that a requested 38.4kbaud actually gets
2984
+ 31.25kbaud, the frequency required for MIDI
2985
+Load: dtoverlay=midi-uart3
2986
+Params: <None>
2987
+
2988
+
2989
+Name: midi-uart3-pi5
2990
+Info: See midi-uart3 (this is the Pi 5 version)
2991
+
2992
+
2993
+Name: midi-uart4
2994
+Info: Configures UART4 (ttyAMA4) so that a requested 38.4kbaud actually gets
2995
+ 31.25kbaud, the frequency required for MIDI
2996
+Load: dtoverlay=midi-uart4
2997
+Params: <None>
2998
+
2999
+
3000
+Name: midi-uart4-pi5
3001
+Info: See midi-uart4 (this is the Pi 5 version)
3002
+
3003
+
3004
+Name: midi-uart5
3005
+Info: Configures UART5 (ttyAMA5) so that a requested 38.4kbaud actually gets
3006
+ 31.25kbaud, the frequency required for MIDI
3007
+Load: dtoverlay=midi-uart5
3008
+Params: <None>
3009
+
3010
+
3011
+Name: minipitft13
3012
+Info: Overlay for AdaFruit Mini Pi 1.3" TFT via SPI using fbtft driver.
3013
+Load: dtoverlay=minipitft13,<param>=<val>
3014
+Params: speed SPI bus speed (default 32000000)
3015
+ rotate Display rotation (0, 90, 180 or 270; default 0)
3016
+ width Display width (default 240)
3017
+ height Display height (default 240)
3018
+ fps Delay between frame updates (default 25)
3019
+ debug Debug output level (0-7; default 0)
3020
+
3021
+
3022
+Name: miniuart-bt
3023
+Info: Switch the onboard Bluetooth function of a BT-equipped Raspberry Pi
3024
+ to use the mini-UART (ttyS0) and restore UART0/ttyAMA0 over GPIOs 14 &
3025
+ 15. Note that this option uses a lower baudrate, and should only be used
3026
+ with low-bandwidth peripherals.
3027
+Load: dtoverlay=miniuart-bt,<param>=<val>
3028
+Params: krnbt Set to "off" to disable autoprobing of Bluetooth
3029
+ driver without need of hciattach/btattach
3030
+
3031
+
3032
+Name: mipi-dbi-spi
3033
+Info: Overlay for SPI-connected MIPI DBI displays using the panel-mipi-dbi
3034
+ driver. The driver will load a file /lib/firmware/panel.bin containing
3035
+ the initialisation commands.
3036
+
3037
+ Example:
3038
+ dtoverlay=mipi-dbi-spi,spi0-0,speed=70000000
3039
+ dtparam=width=320,height=240
3040
+ dtparam=reset-gpio=23,dc-gpio=24
3041
+ dtparam=backlight-gpio=18
3042
+
3043
+ Compared to fbtft panel-mipi-dbi runs pixel data at spi-max-frequency
3044
+ and init commands at 10MHz. This makes it possible to push the envelope
3045
+ without messing up the controller configuration due to command
3046
+ transmission errors.
3047
+
3048
+ For devices on spi1 or spi2, the interfaces should be enabled
3049
+ with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
3050
+
3051
+ See https://github.com/notro/panel-mipi-dbi/wiki for more info.
3052
+
3053
+Load: dtoverlay=mipi-dbi-spi,<param>=<val>
3054
+Params:
3055
+ compatible Set the compatible string to load a different
3056
+ firmware file. Both the panel compatible value
3057
+ used to load the firmware file and the value
3058
+ used to load the driver has to be set having a
3059
+ NUL (\0) separator between them.
3060
+ Example:
3061
+ dtparam=compatible=mypanel\0panel-mipi-dbi-spi
3062
+ spi<n>-<m> Configure device at spi<n>, cs<m>
3063
+ (boolean, required)
3064
+ speed SPI bus speed in Hz (default 32000000)
3065
+ cpha Shifted SPI clock phase (CPHA) mode
3066
+ cpol Inverse SPI clock polarity (CPOL) mode
3067
+ write-only Controller is not readable
3068
+ (ie. MISO is not wired up).
3069
+
3070
+ width Panel width in pixels (required)
3071
+ height Panel height in pixels (required)
3072
+ width-mm Panel width in mm
3073
+ height-mm Panel height in mm
3074
+ x-offset Panel x-offset in controller RAM
3075
+ y-offset Panel y-offset in controller RAM
3076
+
3077
+ clock-frequency Panel clock frequency in Hz
3078
+ (optional, just informational).
3079
+
3080
+ reset-gpio GPIO pin to be used for RESET
3081
+ dc-gpio GPIO pin to be used for D/C
3082
+
3083
+ backlight-gpio GPIO pin to be used for backlight control
3084
+ (default of none).
3085
+ backlight-pwm PWM channel to be used for backlight control
3086
+ (default of none). NB Disables audio headphone
3087
+ output as that also uses PWM.
3088
+ backlight-pwm-chan Choose channel on &pwm node for backlight
3089
+ control (default 0).
3090
+ backlight-pwm-gpio GPIO pin to be used for the PWM backlight. See
3091
+ pwm-2chan for valid options (default 18).
3092
+ backlight-pwm-func Pin function of GPIO used for the PWM backlight.
3093
+ See pwm-2chan for valid options (default 2).
3094
+ backlight-def-brightness
3095
+ Set the default brightness. Normal range 1-16.
3096
+ (default 16).
3097
+
3098
+
3099
+Name: mlx90640
3100
+Info: Overlay for i2c connected mlx90640 thermal camera
3101
+Load: dtoverlay=mlx90640
3102
+Params: <None>
3103
+
3104
+
3105
+Name: mmc
3106
+Info: Selects the bcm2835-mmc SD/MMC driver, optionally with overclock
3107
+Load: dtoverlay=mmc,<param>=<val>
3108
+Params: overclock_50 Clock (in MHz) to use when the MMC framework
3109
+ requests 50MHz
3110
+
3111
+
3112
+Name: mpu6050
3113
+Info: This overlay has been deprecated - use "dtoverlay=i2c-sensor,mpu6050"
3114
+ instead. Note that "int_pin" is the new name for the "interrupt"
3115
+ parameter.
3116
+Load: <Deprecated>
3117
+
3118
+
3119
+Name: mz61581
3120
+Info: MZ61581 display by Tontec
3121
+Load: dtoverlay=mz61581,<param>=<val>
3122
+Params: speed Display SPI bus speed
3123
+
3124
+ rotate Display rotation {0,90,180,270}
3125
+
3126
+ fps Delay between frame updates
3127
+
3128
+ txbuflen Transmit buffer length (default 32768)
3129
+
3130
+ debug Debug output level {0-7}
3131
+
3132
+ xohms Touchpanel sensitivity (X-plate resistance)
3133
+
3134
+
3135
+Name: ov2311
3136
+Info: Omnivision OV2311 camera module.
3137
+ Uses Unicam 1, which is the standard camera connector on most Pi
3138
+ variants.
3139
+Load: dtoverlay=ov2311,<param>=<val>
3140
+Params: rotation Mounting rotation of the camera sensor (0 or
3141
+ 180, default 0)
3142
+ orientation Sensor orientation (0 = front, 1 = rear,
3143
+ 2 = external, default external)
3144
+ media-controller Configure use of Media Controller API for
3145
+ configuring the sensor (default on)
3146
+ cam0 Adopt the default configuration for CAM0 on a
3147
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
3148
+
3149
+
3150
+Name: ov5647
3151
+Info: Omnivision OV5647 camera module.
3152
+ Uses Unicam 1, which is the standard camera connector on most Pi
3153
+ variants.
3154
+Load: dtoverlay=ov5647,<param>=<val>
3155
+Params: rotation Mounting rotation of the camera sensor (0 or
3156
+ 180, default 0)
3157
+ orientation Sensor orientation (0 = front, 1 = rear,
3158
+ 2 = external, default external)
3159
+ media-controller Configure use of Media Controller API for
3160
+ configuring the sensor (default on)
3161
+ cam0 Adopt the default configuration for CAM0 on a
3162
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
3163
+ vcm Configure a VCM focus drive on the sensor.
3164
+
3165
+
3166
+Name: ov7251
3167
+Info: Omnivision OV7251 camera module.
3168
+ Uses Unicam 1, which is the standard camera connector on most Pi
3169
+ variants.
3170
+Load: dtoverlay=ov7251,<param>=<val>
3171
+Params: rotation Mounting rotation of the camera sensor (0 or
3172
+ 180, default 0)
3173
+ orientation Sensor orientation (0 = front, 1 = rear,
3174
+ 2 = external, default external)
3175
+ media-controller Configure use of Media Controller API for
3176
+ configuring the sensor (default off)
3177
+ cam0 Adopt the default configuration for CAM0 on a
3178
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
3179
+
3180
+
3181
+Name: ov9281
3182
+Info: Omnivision OV9281 camera module.
3183
+ Uses Unicam 1, which is the standard camera connector on most Pi
3184
+ variants.
3185
+Load: dtoverlay=ov9281,<param>=<val>
3186
+Params: rotation Mounting rotation of the camera sensor (0 or
3187
+ 180, default 0)
3188
+ orientation Sensor orientation (0 = front, 1 = rear,
3189
+ 2 = external, default external)
3190
+ media-controller Configure use of Media Controller API for
3191
+ configuring the sensor (default on)
3192
+ cam0 Adopt the default configuration for CAM0 on a
3193
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
3194
+
3195
+
3196
+Name: papirus
3197
+Info: PaPiRus ePaper Screen by Pi Supply (both HAT and pHAT)
3198
+Load: dtoverlay=papirus,<param>=<val>
3199
+Params: panel Display panel (required):
3200
+ 1.44": e1144cs021
3201
+ 2.0": e2200cs021
3202
+ 2.7": e2271cs021
3203
+
3204
+ speed Display SPI bus speed
3205
+
3206
+
3207
+Name: pca953x
3208
+Info: TI PCA953x family of I2C GPIO expanders. Default is for NXP PCA9534.
3209
+Load: dtoverlay=pca953x,<param>=<val>
3210
+Params: addr I2C address of expander. Default 0x20.
3211
+ pca6416 Select the NXP PCA6416 (16 bit)
3212
+ pca9505 Select the NXP PCA9505 (40 bit)
3213
+ pca9535 Select the NXP PCA9535 (16 bit)
3214
+ pca9536 Select the NXP PCA9536 or TI PCA9536 (4 bit)
3215
+ pca9537 Select the NXP PCA9537 (4 bit)
3216
+ pca9538 Select the NXP PCA9538 (8 bit)
3217
+ pca9539 Select the NXP PCA9539 (16 bit)
3218
+ pca9554 Select the NXP PCA9554 (8 bit)
3219
+ pca9555 Select the NXP PCA9555 (16 bit)
3220
+ pca9556 Select the NXP PCA9556 (8 bit)
3221
+ pca9557 Select the NXP PCA9557 (8 bit)
3222
+ pca9574 Select the NXP PCA9574 (8 bit)
3223
+ pca9575 Select the NXP PCA9575 (16 bit)
3224
+ pca9698 Select the NXP PCA9698 (40 bit)
3225
+ pcal6416 Select the NXP PCAL6416 (16 bit)
3226
+ pcal6524 Select the NXP PCAL6524 (24 bit)
3227
+ pcal9555a Select the NXP PCAL9555A (16 bit)
3228
+ max7310 Select the Maxim MAX7310 (8 bit)
3229
+ max7312 Select the Maxim MAX7312 (16 bit)
3230
+ max7313 Select the Maxim MAX7313 (16 bit)
3231
+ max7315 Select the Maxim MAX7315 (8 bit)
3232
+ pca6107 Select the TI PCA6107 (8 bit)
3233
+ tca6408 Select the TI TCA6408 (8 bit)
3234
+ tca6416 Select the TI TCA6416 (16 bit)
3235
+ tca6424 Select the TI TCA6424 (24 bit)
3236
+ tca9539 Select the TI TCA9539 (16 bit)
3237
+ tca9554 Select the TI TCA9554 (8 bit)
3238
+ cat9554 Select the Onnn CAT9554 (8 bit)
3239
+ pca9654 Select the Onnn PCA9654 (8 bit)
3240
+ xra1202 Select the Exar XRA1202 (8 bit)
3241
+
3242
+
3243
+Name: pcf857x
3244
+Info: NXP PCF857x family of I2C GPIO expanders.
3245
+Load: dtoverlay=pcf857x,<param>=<val>
3246
+Params: addr I2C address of expander. Default
3247
+ depends on model selected.
3248
+ pcf8574 Select the NXP PCF8574 (8 bit)
3249
+ pcf8574a Select the NXP PCF8574A (8 bit)
3250
+ pcf8575 Select the NXP PCF8575 (16 bit)
3251
+ pca8574 Select the NXP PCA8574 (8 bit)
3252
+
3253
+
3254
+Name: pcie-32bit-dma
3255
+Info: Force PCIe config to support 32bit DMA addresses at the expense of
3256
+ having to bounce buffers.
3257
+Load: dtoverlay=pcie-32bit-dma
3258
+Params: <None>
3259
+
3260
+
3261
+[ The pcf2127-rtc overlay has been deleted. See i2c-rtc. ]
3262
+
3263
+
3264
+[ The pcf8523-rtc overlay has been deleted. See i2c-rtc. ]
3265
+
3266
+
3267
+[ The pcf8563-rtc overlay has been deleted. See i2c-rtc. ]
3268
+
3269
+
3270
+Name: pi3-act-led
3271
+Info: This overlay has been renamed act-led, keeping pi3-act-led as an alias
3272
+ for backwards compatibility.
3273
+Load: <Deprecated>
3274
+
3275
+
3276
+Name: pi3-disable-bt
3277
+Info: This overlay has been renamed disable-bt, keeping pi3-disable-bt as an
3278
+ alias for backwards compatibility.
3279
+Load: <Deprecated>
3280
+
3281
+
3282
+Name: pi3-disable-wifi
3283
+Info: This overlay has been renamed disable-wifi, keeping pi3-disable-wifi as
3284
+ an alias for backwards compatibility.
3285
+Load: <Deprecated>
3286
+
3287
+
3288
+Name: pi3-miniuart-bt
3289
+Info: This overlay has been renamed miniuart-bt, keeping pi3-miniuart-bt as
3290
+ an alias for backwards compatibility.
3291
+Load: <Deprecated>
3292
+
3293
+
3294
+Name: pibell
3295
+Info: Configures the pibell audio card.
3296
+Load: dtoverlay=pibell,<param>=<val>
3297
+Params: alsaname Set the name as it appears in ALSA (default
3298
+ "PiBell")
3299
+
3300
+
3301
+Name: pifacedigital
3302
+Info: Configures the PiFace Digital mcp23s17 GPIO port expander.
3303
+Load: dtoverlay=pifacedigital,<param>=<val>
3304
+Params: spi-present-mask 8-bit integer, bitmap indicating MCP23S17 SPI0
3305
+ CS0 address. PiFace Digital supports addresses
3306
+ 0-3, which can be configured with JP1 and JP2.
3307
+
3308
+
3309
+Name: pifi-40
3310
+Info: Configures the PiFi 40W stereo amplifier
3311
+Load: dtoverlay=pifi-40
3312
+Params: <None>
3313
+
3314
+
3315
+Name: pifi-dac-hd
3316
+Info: Configures the PiFi DAC HD
3317
+Load: dtoverlay=pifi-dac-hd
3318
+Params: <None>
3319
+
3320
+
3321
+Name: pifi-dac-zero
3322
+Info: Configures the PiFi DAC Zero
3323
+Load: dtoverlay=pifi-dac-zero
3324
+Params: <None>
3325
+
3326
+
3327
+Name: pifi-mini-210
3328
+Info: Configures the PiFi Mini stereo amplifier
3329
+Load: dtoverlay=pifi-mini-210
3330
+Params: <None>
3331
+
3332
+
3333
+Name: piglow
3334
+Info: Configures the PiGlow by pimoroni.com
3335
+Load: dtoverlay=piglow
3336
+Params: <None>
3337
+
3338
+
3339
+Name: piscreen
3340
+Info: PiScreen display by OzzMaker.com
3341
+Load: dtoverlay=piscreen,<param>=<val>
3342
+Params: speed Display SPI bus speed
3343
+
3344
+ rotate Display rotation {0,90,180,270}
3345
+
3346
+ fps Delay between frame updates
3347
+
3348
+ debug Debug output level {0-7}
3349
+
3350
+ xohms Touchpanel sensitivity (X-plate resistance)
3351
+
3352
+ drm Select the DRM/KMS driver instead of the FBTFT
3353
+ one
3354
+
3355
+
3356
+Name: piscreen2r
3357
+Info: PiScreen 2 with resistive TP display by OzzMaker.com
3358
+Load: dtoverlay=piscreen2r,<param>=<val>
3359
+Params: speed Display SPI bus speed
3360
+
3361
+ rotate Display rotation {0,90,180,270}
3362
+
3363
+ fps Delay between frame updates
3364
+
3365
+ debug Debug output level {0-7}
3366
+
3367
+ xohms Touchpanel sensitivity (X-plate resistance)
3368
+
3369
+
3370
+Name: pisound
3371
+Info: Configures the Blokas Labs pisound card
3372
+Load: dtoverlay=pisound
3373
+Params: <None>
3374
+
3375
+
3376
+Name: pitft22
3377
+Info: Adafruit PiTFT 2.2" screen
3378
+Load: dtoverlay=pitft22,<param>=<val>
3379
+Params: speed Display SPI bus speed
3380
+
3381
+ rotate Display rotation {0,90,180,270}
3382
+
3383
+ fps Delay between frame updates
3384
+
3385
+ debug Debug output level {0-7}
3386
+
3387
+
3388
+Name: pitft28-capacitive
3389
+Info: Adafruit PiTFT 2.8" capacitive touch screen
3390
+Load: dtoverlay=pitft28-capacitive,<param>=<val>
3391
+Params: speed Display SPI bus speed
3392
+
3393
+ rotate Display rotation {0,90,180,270}
3394
+
3395
+ fps Delay between frame updates
3396
+
3397
+ debug Debug output level {0-7}
3398
+
3399
+ touch-sizex Touchscreen size x (default 240)
3400
+
3401
+ touch-sizey Touchscreen size y (default 320)
3402
+
3403
+ touch-invx Touchscreen inverted x axis
3404
+
3405
+ touch-invy Touchscreen inverted y axis
3406
+
3407
+ touch-swapxy Touchscreen swapped x y axis
3408
+
3409
+
3410
+Name: pitft28-resistive
3411
+Info: Adafruit PiTFT 2.8" resistive touch screen
3412
+Load: dtoverlay=pitft28-resistive,<param>=<val>
3413
+Params: speed Display SPI bus speed
3414
+
3415
+ rotate Display rotation {0,90,180,270}
3416
+
3417
+ fps Delay between frame updates
3418
+
3419
+ debug Debug output level {0-7}
3420
+
3421
+ drm Force the use of the mi0283qt DRM driver (by
3422
+ default the ili9340 framebuffer driver will
3423
+ be used in preference if available)
3424
+
3425
+
3426
+Name: pitft35-resistive
3427
+Info: Adafruit PiTFT 3.5" resistive touch screen
3428
+Load: dtoverlay=pitft35-resistive,<param>=<val>
3429
+Params: speed Display SPI bus speed
3430
+
3431
+ rotate Display rotation {0,90,180,270}
3432
+
3433
+ fps Delay between frame updates
3434
+
3435
+ debug Debug output level {0-7}
3436
+
3437
+ drm Force the use of the hx8357d DRM driver (by
3438
+ default the fb_hx8357d framebuffer driver will
3439
+ be used in preference if available)
3440
+
3441
+
3442
+Name: pps-gpio
3443
+Info: Configures the pps-gpio (pulse-per-second time signal via GPIO).
3444
+Load: dtoverlay=pps-gpio,<param>=<val>
3445
+Params: gpiopin Input GPIO (default "18")
3446
+ assert_falling_edge When present, assert is indicated by a falling
3447
+ edge, rather than by a rising edge (default
3448
+ off)
3449
+ capture_clear Generate clear events on the trailing edge
3450
+ (default off)
3451
+ pull Desired pull-up/down state (off, down, up)
3452
+ Default is "off".
3453
+
3454
+
3455
+Name: proto-codec
3456
+Info: Configures the PROTO Audio Codec card
3457
+Load: dtoverlay=proto-codec
3458
+Params: <None>
3459
+
3460
+
3461
+Name: pwm
3462
+Info: Configures a single PWM channel
3463
+ Legal pin,function combinations for each channel:
3464
+ PWM0: 12,4(Alt0) 18,2(Alt5) 40,4(Alt0) 52,5(Alt1)
3465
+ PWM1: 13,4(Alt0) 19,2(Alt5) 41,4(Alt0) 45,4(Alt0) 53,5(Alt1)
3466
+ N.B.:
3467
+ 1) Pin 18 is the only one available on all platforms, and
3468
+ it is the one used by the I2S audio interface.
3469
+ Pins 12 and 13 might be better choices on an A+, B+ or Pi2.
3470
+ 2) The onboard analogue audio output uses both PWM channels.
3471
+ 3) So be careful mixing audio and PWM.
3472
+ 4) Currently the clock must have been enabled and configured
3473
+ by other means.
3474
+Load: dtoverlay=pwm,<param>=<val>
3475
+Params: pin Output pin (default 18) - see table
3476
+ func Pin function (default 2 = Alt5) - see above
3477
+ clock PWM clock frequency (informational)
3478
+
3479
+
3480
+Name: pwm-2chan
3481
+Info: Configures both PWM channels
3482
+ Legal pin,function combinations for each channel:
3483
+ PWM0: 12,4(Alt0) 18,2(Alt5) 40,4(Alt0) 52,5(Alt1)
3484
+ PWM1: 13,4(Alt0) 19,2(Alt5) 41,4(Alt0) 45,4(Alt0) 53,5(Alt1)
3485
+ N.B.:
3486
+ 1) Pin 18 is the only one available on all platforms, and
3487
+ it is the one used by the I2S audio interface.
3488
+ Pins 12 and 13 might be better choices on an A+, B+ or Pi2.
3489
+ 2) The onboard analogue audio output uses both PWM channels.
3490
+ 3) So be careful mixing audio and PWM.
3491
+ 4) Currently the clock must have been enabled and configured
3492
+ by other means.
3493
+Load: dtoverlay=pwm-2chan,<param>=<val>
3494
+Params: pin Output pin (default 18) - see table
3495
+ pin2 Output pin for other channel (default 19)
3496
+ func Pin function (default 2 = Alt5) - see above
3497
+ func2 Function for pin2 (default 2 = Alt5)
3498
+ clock PWM clock frequency (informational)
3499
+
3500
+
3501
+Name: pwm-ir-tx
3502
+Info: Use GPIO pin as pwm-assisted infrared transmitter output.
3503
+ This is an alternative to "gpio-ir-tx". pwm-ir-tx makes use
3504
+ of PWM0 to reduce the CPU load during transmission compared to
3505
+ gpio-ir-tx which uses bit-banging.
3506
+ Legal pin,function combinations are:
3507
+ 12,4(Alt0) 18,2(Alt5) 40,4(Alt0) 52,5(Alt1)
3508
+Load: dtoverlay=pwm-ir-tx,<param>=<val>
3509
+Params: gpio_pin Output GPIO (default 18)
3510
+
3511
+ func Pin function (default 2 = Alt5)
3512
+
3513
+
3514
+Name: pwm1
3515
+Info: Configures one or two PWM channel on PWM1 (BCM2711 only)
3516
+ N.B.:
3517
+ 1) The onboard analogue audio output uses both PWM channels.
3518
+ 2) So be careful mixing audio and PWM.
3519
+ Note that even when only one pin is enabled, both channels are available
3520
+ from the PWM driver, so be careful to use the correct one.
3521
+Load: dtoverlay=pwm1,<param>=<val>
3522
+Params: clock PWM clock frequency (informational)
3523
+ pins_40 Enable channel 0 (PWM1_0) on GPIO 40
3524
+ pins_41 Enable channel 1 (PWM1_1) on GPIO 41
3525
+ pins_40_41 Enable channels 0 (PWM1_0) and 1 (PW1_1) on
3526
+ GPIOs 40 and 41 (default)
3527
+ pull_up Enable pull-ups on the PWM pins (default)
3528
+ pull_down Enable pull-downs on the PWM pins
3529
+ pull_off Disable pulls on the PWM pins
3530
+
3531
+
3532
+Name: qca7000
3533
+Info: in-tech's Evaluation Board for PLC Stamp micro
3534
+ This uses spi0 and a separate GPIO interrupt to connect the QCA7000.
3535
+Load: dtoverlay=qca7000,<param>=<val>
3536
+Params: int_pin GPIO pin for interrupt signal (default 23)
3537
+
3538
+ speed SPI bus speed (default 12 MHz)
3539
+
3540
+
3541
+Name: qca7000-uart0
3542
+Info: in-tech's Evaluation Board for PLC Stamp micro (UART)
3543
+ This uses uart0/ttyAMA0 over GPIOs 14 & 15 to connect the QCA7000.
3544
+ But it requires disabling of onboard Bluetooth on
3545
+ Pi 3B, 3B+, 3A+, 4B and Zero W.
3546
+Load: dtoverlay=qca7000-uart0,<param>=<val>
3547
+Params: baudrate Set the baudrate for the UART (default
3548
+ "115200")
3549
+
3550
+
3551
+Name: ramoops
3552
+Info: Enable the preservation of crash logs across a reboot. With
3553
+ systemd-pstore enabled (as it is on Raspberry Pi OS) the crash logs
3554
+ are moved to /var/lib/systemd/pstore/ on reboot.
3555
+Load: dtoverlay=ramoops,<param>=<val>
3556
+Params: base-addr Where to place the capture buffer (default
3557
+ 0x0b000000)
3558
+ total-size How much memory to allocate altogether (in
3559
+ bytes - default 64kB)
3560
+ record-size How much space to use for each capture, i.e.
3561
+ total-size / record-size = number of captures
3562
+ (default 16kB)
3563
+ console-size Size of non-panic dmesg captures (default 0)
3564
+
3565
+
3566
+Name: ramoops-pi4
3567
+Info: The version of the ramoops overlay for the Pi 4 family. It should be
3568
+ loaded automatically if dtoverlay=ramoops is specified on a Pi 4.
3569
+Load: dtoverlay=ramoops-pi4,<param>=<val>
3570
+Params: base-addr Where to place the capture buffer (default
3571
+ 0x0b000000)
3572
+ total-size How much memory to allocate altogether (in
3573
+ bytes - default 64kB)
3574
+ record-size How much space to use for each capture, i.e.
3575
+ total-size / record-size = number of captures
3576
+ (default 16kB)
3577
+ console-size Size of non-panic dmesg captures (default 0)
3578
+
3579
+
3580
+Name: rotary-encoder
3581
+Info: Overlay for GPIO connected rotary encoder.
3582
+Load: dtoverlay=rotary-encoder,<param>=<val>
3583
+Params: pin_a GPIO connected to rotary encoder channel A
3584
+ (default 4).
3585
+ pin_b GPIO connected to rotary encoder channel B
3586
+ (default 17).
3587
+ relative_axis register a relative axis rather than an
3588
+ absolute one. Relative axis will only
3589
+ generate +1/-1 events on the input device,
3590
+ hence no steps need to be passed.
3591
+ linux_axis the input subsystem axis to map to this
3592
+ rotary encoder. Defaults to 0 (ABS_X / REL_X)
3593
+ rollover Automatic rollover when the rotary value
3594
+ becomes greater than the specified steps or
3595
+ smaller than 0. For absolute axis only.
3596
+ steps-per-period Number of steps (stable states) per period.
3597
+ The values have the following meaning:
3598
+ 1: Full-period mode (default)
3599
+ 2: Half-period mode
3600
+ 4: Quarter-period mode
3601
+ steps Number of steps in a full turnaround of the
3602
+ encoder. Only relevant for absolute axis.
3603
+ Defaults to 24 which is a typical value for
3604
+ such devices.
3605
+ wakeup Boolean, rotary encoder can wake up the
3606
+ system.
3607
+ encoding String, the method used to encode steps.
3608
+ Supported are "gray" (the default and more
3609
+ common) and "binary".
3610
+
3611
+
3612
+Name: rpi-backlight
3613
+Info: Raspberry Pi official display backlight driver
3614
+Load: dtoverlay=rpi-backlight
3615
+Params: <None>
3616
+
3617
+
3618
+Name: rpi-cirrus-wm5102
3619
+Info: This overlay has been renamed to cirrus-wm5102
3620
+Load: <Deprecated>
3621
+
3622
+
3623
+Name: rpi-codeczero
3624
+Info: Configures the Raspberry Pi Codec Zero sound card
3625
+Load: dtoverlay=rpi-codeczero
3626
+Params: <None>
3627
+
3628
+
3629
+Name: rpi-dac
3630
+Info: This overlay has been renamed to i2s-dac.
3631
+Load: <Deprecated>
3632
+
3633
+
3634
+Name: rpi-dacplus
3635
+Info: Configures the Raspberry Pi DAC+ card
3636
+Load: dtoverlay=rpi-dacplus,<param>=<val>
3637
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
3638
+ digital volume control. Enable by adding
3639
+ "dtparam=24db_digital_gain" to config.txt
3640
+ before any "dtoverlay" lines.
3641
+ The default behaviour is that the digital
3642
+ volume control is limited to a maximum of
3643
+ 0dB. ie. it can attenuate but not provide
3644
+ gain. For most users, this will be desired
3645
+ as it will prevent clipping. By appending
3646
+ the 24db_digital_gain parameter, the digital
3647
+ volume control will allow up to 24dB of
3648
+ gain. If this parameter is enabled, it is the
3649
+ responsibility of the user to ensure that
3650
+ the digital volume control is set to a value
3651
+ that does not result in clipping/distortion!
3652
+
3653
+
3654
+Name: rpi-dacpro
3655
+Info: Configures the Raspberry Pi DAC Pro sound card
3656
+Load: dtoverlay=rpi-dacpro,<param>=<val>
3657
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
3658
+ digital volume control. Enable by adding
3659
+ "dtparam=24db_digital_gain" to config.txt
3660
+ before any "dtoverlay" lines.
3661
+ The default behaviour is that the digital
3662
+ volume control is limited to a maximum of
3663
+ 0dB. ie. it can attenuate but not provide
3664
+ gain. For most users, this will be desired
3665
+ as it will prevent clipping. By appending
3666
+ the 24db_digital_gain parameter, the digital
3667
+ volume control will allow up to 24dB of
3668
+ gain. If this parameter is enabled, it is the
3669
+ responsibility of the user to ensure that
3670
+ the digital volume control is set to a value
3671
+ that does not result in clipping/distortion!
3672
+
3673
+
3674
+Name: rpi-digiampplus
3675
+Info: Configures the Raspberry Pi DigiAMP+ sound card
3676
+Load: dtoverlay=rpi-digiampplus,<param>=<val>
3677
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
3678
+ digital volume control. Enable by adding
3679
+ "dtparam=24db_digital_gain" to config.txt
3680
+ before any "dtoverlay" lines.
3681
+ The default behaviour is that the digital
3682
+ volume control is limited to a maximum of
3683
+ 0dB. ie. it can attenuate but not provide
3684
+ gain. For most users, this will be desired
3685
+ as it will prevent clipping. By appending
3686
+ the 24db_digital_gain parameter, the digital
3687
+ volume control will allow up to 24dB of
3688
+ gain. If this parameter is enabled, it is the
3689
+ responsibility of the user to ensure that
3690
+ the digital volume control is set to a value
3691
+ that does not result in clipping/distortion!
3692
+ auto_mute_amp If specified, unmute/mute the DigiAMP+ when
3693
+ starting/stopping audio playback (default "on").
3694
+ unmute_amp If specified, unmute the DigiAMP+ amp once when
3695
+ the DAC driver module loads (default "off").
3696
+
3697
+
3698
+Name: rpi-display
3699
+Info: This overlay has been renamed to watterott-display
3700
+Load: <Deprecated>
3701
+
3702
+
3703
+Name: rpi-ft5406
3704
+Info: Official Raspberry Pi display touchscreen
3705
+Load: dtoverlay=rpi-ft5406,<param>=<val>
3706
+Params: touchscreen-size-x Touchscreen X resolution (default 800)
3707
+ touchscreen-size-y Touchscreen Y resolution (default 600);
3708
+ touchscreen-inverted-x Invert touchscreen X coordinates (default 0);
3709
+ touchscreen-inverted-y Invert touchscreen Y coordinates (default 0);
3710
+ touchscreen-swapped-x-y Swap X and Y cordinates (default 0);
3711
+
3712
+
3713
+Name: rpi-poe
3714
+Info: Raspberry Pi PoE HAT fan
3715
+Load: dtoverlay=rpi-poe,<param>[=<val>]
3716
+Params: poe_fan_temp0 Temperature (in millicelcius) at which the fan
3717
+ turns on (default 40000)
3718
+ poe_fan_temp0_hyst Temperature delta (in millicelcius) at which
3719
+ the fan turns off (default 2000)
3720
+ poe_fan_temp1 Temperature (in millicelcius) at which the fan
3721
+ speeds up (default 45000)
3722
+ poe_fan_temp1_hyst Temperature delta (in millicelcius) at which
3723
+ the fan slows down (default 2000)
3724
+ poe_fan_temp2 Temperature (in millicelcius) at which the fan
3725
+ speeds up (default 50000)
3726
+ poe_fan_temp2_hyst Temperature delta (in millicelcius) at which
3727
+ the fan slows down (default 2000)
3728
+ poe_fan_temp3 Temperature (in millicelcius) at which the fan
3729
+ speeds up (default 55000)
3730
+ poe_fan_temp3_hyst Temperature delta (in millicelcius) at which
3731
+ the fan slows down (default 5000)
3732
+ i2c Control the fan via Linux I2C drivers instead of
3733
+ the firmware.
3734
+
3735
+
3736
+Name: rpi-poe-plus
3737
+Info: Raspberry Pi PoE+ HAT fan
3738
+Load: dtoverlay=rpi-poe-plus,<param>[=<val>]
3739
+Params: poe_fan_temp0 Temperature (in millicelcius) at which the fan
3740
+ turns on (default 40000)
3741
+ poe_fan_temp0_hyst Temperature delta (in millicelcius) at which
3742
+ the fan turns off (default 2000)
3743
+ poe_fan_temp1 Temperature (in millicelcius) at which the fan
3744
+ speeds up (default 45000)
3745
+ poe_fan_temp1_hyst Temperature delta (in millicelcius) at which
3746
+ the fan slows down (default 2000)
3747
+ poe_fan_temp2 Temperature (in millicelcius) at which the fan
3748
+ speeds up (default 50000)
3749
+ poe_fan_temp2_hyst Temperature delta (in millicelcius) at which
3750
+ the fan slows down (default 2000)
3751
+ poe_fan_temp3 Temperature (in millicelcius) at which the fan
3752
+ speeds up (default 55000)
3753
+ poe_fan_temp3_hyst Temperature delta (in millicelcius) at which
3754
+ the fan slows down (default 5000)
3755
+ i2c Control the fan via Linux I2C drivers instead of
3756
+ the firmware.
3757
+
3758
+
3759
+Name: rpi-proto
3760
+Info: This overlay has been renamed to proto-codec.
3761
+Load: <Deprecated>
3762
+
3763
+
3764
+Name: rpi-sense
3765
+Info: Raspberry Pi Sense HAT
3766
+Load: dtoverlay=rpi-sense
3767
+Params: <None>
3768
+
3769
+
3770
+Name: rpi-sense-v2
3771
+Info: Raspberry Pi Sense HAT v2
3772
+Load: dtoverlay=rpi-sense-v2
3773
+Params: <None>
3774
+
3775
+
3776
+Name: rpi-tv
3777
+Info: Raspberry Pi TV HAT
3778
+Load: dtoverlay=rpi-tv
3779
+Params: <None>
3780
+
3781
+
3782
+Name: rpivid-v4l2
3783
+Info: This overlay has been deprecated and deleted as the V4L2 stateless
3784
+ video decoder driver is enabled by default.
3785
+Load: <Deprecated>
3786
+
3787
+
3788
+Name: rra-digidac1-wm8741-audio
3789
+Info: Configures the Red Rocks Audio DigiDAC1 soundcard
3790
+Load: dtoverlay=rra-digidac1-wm8741-audio
3791
+Params: <None>
3792
+
3793
+
3794
+Name: sainsmart18
3795
+Info: Overlay for the SPI-connected Sainsmart 1.8" display (based on the
3796
+ ST7735R chip).
3797
+Load: dtoverlay=sainsmart18,<param>=<val>
3798
+Params: rotate Display rotation {0,90,180,270}
3799
+ speed SPI bus speed in Hz (default 4000000)
3800
+ fps Display frame rate in Hz
3801
+ bgr Enable BGR mode (default off)
3802
+ debug Debug output level {0-7}
3803
+ dc_pin GPIO pin for D/C (default 24)
3804
+ reset_pin GPIO pin for RESET (default 25)
3805
+
3806
+
3807
+Name: sc16is750-i2c
3808
+Info: Overlay for the NXP SC16IS750 UART with I2C Interface
3809
+ Enables the chip on I2C1 at 0x48 (or the "addr" parameter value). To
3810
+ select another address, please refer to table 10 in reference manual.
3811
+Load: dtoverlay=sc16is750-i2c,<param>=<val>
3812
+Params: int_pin GPIO used for IRQ (default 24)
3813
+ addr Address (default 0x48)
3814
+ xtal On-board crystal frequency (default 14745600)
3815
+
3816
+
3817
+Name: sc16is752-i2c
3818
+Info: Overlay for the NXP SC16IS752 dual UART with I2C Interface
3819
+ Enables the chip on I2C1 at 0x48 (or the "addr" parameter value). To
3820
+ select another address, please refer to table 10 in reference manual.
3821
+Load: dtoverlay=sc16is752-i2c,<param>=<val>
3822
+Params: int_pin GPIO used for IRQ (default 24)
3823
+ addr Address (default 0x48)
3824
+ xtal On-board crystal frequency (default 14745600)
3825
+
3826
+
3827
+Name: sc16is752-spi0
3828
+Info: Overlay for the NXP SC16IS752 Dual UART with SPI Interface
3829
+ Enables the chip on SPI0.
3830
+Load: dtoverlay=sc16is752-spi0,<param>=<val>
3831
+Params: int_pin GPIO used for IRQ (default 24)
3832
+ xtal On-board crystal frequency (default 14745600)
3833
+
3834
+
3835
+Name: sc16is752-spi1
3836
+Info: Overlay for the NXP SC16IS752 Dual UART with SPI Interface
3837
+ Enables the chip on SPI1.
3838
+ N.B.: spi1 is only accessible on devices with a 40pin header, eg:
3839
+ A+, B+, Zero and PI2 B; as well as the Compute Module.
3840
+
3841
+Load: dtoverlay=sc16is752-spi1,<param>=<val>
3842
+Params: int_pin GPIO used for IRQ (default 24)
3843
+ xtal On-board crystal frequency (default 14745600)
3844
+
3845
+
3846
+Name: sdhost
3847
+Info: Selects the bcm2835-sdhost SD/MMC driver, optionally with overclock.
3848
+ N.B. This overlay is designed for situations where the mmc driver is
3849
+ the default, so it disables the other (mmc) interface - this will kill
3850
+ WLAN on a Pi3. If this isn't what you want, either use the sdtweak
3851
+ overlay or the new sd_* dtparams of the base DTBs.
3852
+Load: dtoverlay=sdhost,<param>=<val>
3853
+Params: overclock_50 Clock (in MHz) to use when the MMC framework
3854
+ requests 50MHz
3855
+
3856
+ force_pio Disable DMA support (default off)
3857
+
3858
+ pio_limit Number of blocks above which to use DMA
3859
+ (default 1)
3860
+
3861
+ debug Enable debug output (default off)
3862
+
3863
+
3864
+Name: sdio
3865
+Info: Selects the bcm2835-sdhost SD/MMC driver, optionally with overclock,
3866
+ and enables SDIO via GPIOs 22-27. An example of use in 1-bit mode is
3867
+ "dtoverlay=sdio,bus_width=1,gpios_22_25"
3868
+Load: dtoverlay=sdio,<param>=<val>
3869
+Params: sdio_overclock SDIO Clock (in MHz) to use when the MMC
3870
+ framework requests 50MHz
3871
+
3872
+ poll_once Disable SDIO-device polling every second
3873
+ (default on: polling once at boot-time)
3874
+
3875
+ bus_width Set the SDIO host bus width (default 4 bits)
3876
+
3877
+ gpios_22_25 Select GPIOs 22-25 for 1-bit mode. Must be used
3878
+ with bus_width=1. This replaces the sdio-1bit
3879
+ overlay, which is now deprecated.
3880
+
3881
+ gpios_34_37 Select GPIOs 34-37 for 1-bit mode. Must be used
3882
+ with bus_width=1.
3883
+
3884
+ gpios_34_39 Select GPIOs 34-39 for 4-bit mode. Must be used
3885
+ with bus_width=4 (the default).
3886
+
3887
+
3888
+Name: sdio-1bit
3889
+Info: This overlay is now deprecated. Use
3890
+ "dtoverlay=sdio,bus_width=1,gpios_22_25" instead.
3891
+Load: <Deprecated>
3892
+
3893
+
3894
+Name: sdtweak
3895
+Info: This overlay is now deprecated. Use the sd_* dtparams in the
3896
+ base DTB, e.g. "dtoverlay=sdtweak,poll_once" becomes
3897
+ "dtparam=sd_poll_once".
3898
+Load: <Deprecated>
3899
+
3900
+
3901
+Name: seeed-can-fd-hat-v1
3902
+Info: Overlay for Seeed Studio CAN BUS FD HAT with two CAN FD
3903
+ channels without RTC. Use this overlay if your HAT has no
3904
+ battery holder.
3905
+ https://www.seeedstudio.com/2-Channel-CAN-BUS-FD-Shield-for-Raspberry-Pi-p-4072.html
3906
+Load: dtoverlay=seeed-can-fd-hat-v1
3907
+Params: <None>
3908
+
3909
+
3910
+Name: seeed-can-fd-hat-v2
3911
+Info: Overlay for Seeed Studio CAN BUS FD HAT with two CAN FD
3912
+ channels and an RTC. Use this overlay if your HAT has a
3913
+ battery holder.
3914
+ https://www.seeedstudio.com/CAN-BUS-FD-HAT-for-Raspberry-Pi-p-4742.html
3915
+Load: dtoverlay=seeed-can-fd-hat-v2
3916
+Params: <None>
3917
+
3918
+
3919
+Name: sh1106-spi
3920
+Info: Overlay for SH1106 OLED via SPI using fbtft staging driver.
3921
+Load: dtoverlay=sh1106-spi,<param>=<val>
3922
+Params: speed SPI bus speed (default 4000000)
3923
+ rotate Display rotation (0, 90, 180 or 270; default 0)
3924
+ fps Delay between frame updates (default 25)
3925
+ debug Debug output level (0-7; default 0)
3926
+ dc_pin GPIO pin for D/C (default 24)
3927
+ reset_pin GPIO pin for RESET (default 25)
3928
+ height Display height (32 or 64; default 64)
3929
+
3930
+
3931
+Name: si446x-spi0
3932
+Info: Overlay for Si446x UHF Transceiver via SPI using si446x driver.
3933
+ The driver is currently out-of-tree at
3934
+ https://github.com/sunipkmukherjee/silabs.git
3935
+Load: dtoverlay=si446x-spi0,<param>=<val>
3936
+Params: speed SPI bus speed (default 4000000)
3937
+ int_pin GPIO pin for interrupts (default 17)
3938
+ reset_pin GPIO pin for RESET (default 27)
3939
+
3940
+
3941
+Name: smi
3942
+Info: Enables the Secondary Memory Interface peripheral. Uses GPIOs 2-25!
3943
+Load: dtoverlay=smi
3944
+Params: <None>
3945
+
3946
+
3947
+Name: smi-dev
3948
+Info: Enables the userspace interface for the SMI driver
3949
+Load: dtoverlay=smi-dev
3950
+Params: <None>
3951
+
3952
+
3953
+Name: smi-nand
3954
+Info: Enables access to NAND flash via the SMI interface
3955
+Load: dtoverlay=smi-nand
3956
+Params: <None>
3957
+
3958
+
3959
+Name: spi-gpio35-39
3960
+Info: Move SPI function block to GPIO 35 to 39
3961
+Load: dtoverlay=spi-gpio35-39
3962
+Params: <None>
3963
+
3964
+
3965
+Name: spi-gpio40-45
3966
+Info: Move SPI function block to GPIOs 40 to 45
3967
+Load: dtoverlay=spi-gpio40-45
3968
+Params: <None>
3969
+
3970
+
3971
+Name: spi-rtc
3972
+Info: Adds support for a number of SPI Real Time Clock devices
3973
+Load: dtoverlay=spi-rtc,<param>=<val>
3974
+Params: ds3232 Select the DS3232 device
3975
+ ds3234 Select the DS3234 device
3976
+ pcf2123 Select the PCF2123 device
3977
+
3978
+ spi0_0 Use spi0.0 (default)
3979
+ spi0_1 Use spi0.1
3980
+ spi1_0 Use spi1.0
3981
+ spi1_1 Use spi1.1
3982
+ spi2_0 Use spi2.0
3983
+ spi2_1 Use spi2.1
3984
+ cs_high This device requires an active-high CS
3985
+
3986
+
3987
+Name: spi0-0cs
3988
+Info: Don't claim any CS pins for SPI0. Requires a device with its chip
3989
+ select permanently enabled, but frees a GPIO for e.g. a DPI display.
3990
+Load: dtoverlay=spi0-0cs,<param>=<val>
3991
+Params: no_miso Don't claim and use the MISO pin (9), freeing
3992
+ it for other uses.
3993
+
3994
+
3995
+Name: spi0-1cs
3996
+Info: Only use one CS pin for SPI0
3997
+Load: dtoverlay=spi0-1cs,<param>=<val>
3998
+Params: cs0_pin GPIO pin for CS0 (default 8)
3999
+ no_miso Don't claim and use the MISO pin (9), freeing
4000
+ it for other uses.
4001
+
4002
+
4003
+Name: spi0-2cs
4004
+Info: Change the CS pins for SPI0
4005
+Load: dtoverlay=spi0-2cs,<param>=<val>
4006
+Params: cs0_pin GPIO pin for CS0 (default 8)
4007
+ cs1_pin GPIO pin for CS1 (default 7)
4008
+ no_miso Don't claim and use the MISO pin (9), freeing
4009
+ it for other uses.
4010
+
4011
+
4012
+Name: spi0-cs
4013
+Info: This overlay has been renamed spi0-2cs, keeping spi0-cs as an
4014
+ alias for backwards compatibility.
4015
+Load: <Deprecated>
4016
+
4017
+
4018
+Name: spi0-hw-cs
4019
+Info: This overlay has been deprecated and removed because it is no longer
4020
+ necessary and has been seen to prevent spi0 from working.
4021
+Load: <Deprecated>
4022
+
4023
+
4024
+Name: spi1-1cs
4025
+Info: Enables spi1 with a single chip select (CS) line and associated spidev
4026
+ dev node. The gpio pin number for the CS line and spidev device node
4027
+ creation are configurable.
4028
+ N.B.: spi1 is not accessible on old Pis without a 40-pin header.
4029
+Load: dtoverlay=spi1-1cs,<param>=<val>
4030
+Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI1_CE0).
4031
+ cs0_spidev Set to 'off' to stop the creation of a
4032
+ userspace device node /dev/spidev1.0 (default
4033
+ is 'on' or enabled).
4034
+
4035
+
4036
+Name: spi1-2cs
4037
+Info: Enables spi1 with two chip select (CS) lines and associated spidev
4038
+ dev nodes. The gpio pin numbers for the CS lines and spidev device node
4039
+ creation are configurable.
4040
+ N.B.: spi1 is not accessible on old Pis without a 40-pin header.
4041
+Load: dtoverlay=spi1-2cs,<param>=<val>
4042
+Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI1_CE0).
4043
+ cs1_pin GPIO pin for CS1 (default 17 - BCM SPI1_CE1).
4044
+ cs0_spidev Set to 'off' to stop the creation of a
4045
+ userspace device node /dev/spidev1.0 (default
4046
+ is 'on' or enabled).
4047
+ cs1_spidev Set to 'off' to stop the creation of a
4048
+ userspace device node /dev/spidev1.1 (default
4049
+ is 'on' or enabled).
4050
+
4051
+
4052
+Name: spi1-3cs
4053
+Info: Enables spi1 with three chip select (CS) lines and associated spidev
4054
+ dev nodes. The gpio pin numbers for the CS lines and spidev device node
4055
+ creation are configurable.
4056
+ N.B.: spi1 is not accessible on old Pis without a 40-pin header.
4057
+Load: dtoverlay=spi1-3cs,<param>=<val>
4058
+Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI1_CE0).
4059
+ cs1_pin GPIO pin for CS1 (default 17 - BCM SPI1_CE1).
4060
+ cs2_pin GPIO pin for CS2 (default 16 - BCM SPI1_CE2).
4061
+ cs0_spidev Set to 'off' to stop the creation of a
4062
+ userspace device node /dev/spidev1.0 (default
4063
+ is 'on' or enabled).
4064
+ cs1_spidev Set to 'off' to stop the creation of a
4065
+ userspace device node /dev/spidev1.1 (default
4066
+ is 'on' or enabled).
4067
+ cs2_spidev Set to 'off' to stop the creation of a
4068
+ userspace device node /dev/spidev1.2 (default
4069
+ is 'on' or enabled).
4070
+
4071
+
4072
+Name: spi2-1cs
4073
+Info: Enables spi2 on GPIOs 40-42 with a single chip select (CS) line and
4074
+ associated spidev dev node. The gpio pin number for the CS line and
4075
+ spidev device node creation are configurable. spi2-2cs-pi5 is
4076
+ substituted on a Pi 5.
4077
+ N.B.: spi2 is only accessible with the Compute Module or Pi 5.
4078
+Load: dtoverlay=spi2-1cs,<param>=<val>
4079
+Params: cs0_pin GPIO pin for CS0 (default 43 - BCM SPI2_CE0).
4080
+ cs0_spidev Set to 'off' to stop the creation of a
4081
+ userspace device node /dev/spidev2.0 (default
4082
+ is 'on' or enabled).
4083
+
4084
+
4085
+Name: spi2-1cs-pi5
4086
+Info: Enables spi2 on GPIOs 1-3 with a single chip select (CS) line and
4087
+ associated spidev dev node. The gpio pin number for the CS line and
4088
+ spidev device node creation are configurable. Pi 5 only.
4089
+Load: dtoverlay=spi2-1cs-pi5,<param>=<val>
4090
+Params: cs0_pin GPIO pin for CS0 (default 0).
4091
+ cs0_spidev Set to 'off' to stop the creation of a
4092
+ userspace device node /dev/spidev2.0 (default
4093
+ is 'on' or enabled).
4094
+
4095
+
4096
+Name: spi2-2cs
4097
+Info: Enables spi2 on GPIOs 40-42 with two chip select (CS) lines and
4098
+ associated spidev dev nodes. The gpio pin numbers for the CS lines and
4099
+ spidev device node creation are configurable. spi2-2cs-pi5 is
4100
+ substituted on a Pi 5.
4101
+ N.B.: spi2 is only accessible with the Compute Module or Pi 5.
4102
+Load: dtoverlay=spi2-2cs,<param>=<val>
4103
+Params: cs0_pin GPIO pin for CS0 (default 43 - BCM SPI2_CE0).
4104
+ cs1_pin GPIO pin for CS1 (default 44 - BCM SPI2_CE1).
4105
+ cs0_spidev Set to 'off' to stop the creation of a
4106
+ userspace device node /dev/spidev2.0 (default
4107
+ is 'on' or enabled).
4108
+ cs1_spidev Set to 'off' to stop the creation of a
4109
+ userspace device node /dev/spidev2.1 (default
4110
+ is 'on' or enabled).
4111
+
4112
+
4113
+Name: spi2-2cs-pi5
4114
+Info: Enables spi2 on GPIOs 1-3 with two chip select (CS) lines and
4115
+ associated spidev dev nodes. The gpio pin numbers for the CS lines and
4116
+ spidev device node creation are configurable. Pi 5 only.
4117
+Load: dtoverlay=spi2-2cs-pi5,<param>=<val>
4118
+Params: cs0_pin GPIO pin for CS0 (default 0).
4119
+ cs1_pin GPIO pin for CS1 (default 24).
4120
+ cs0_spidev Set to 'off' to stop the creation of a
4121
+ userspace device node /dev/spidev2.0 (default
4122
+ is 'on' or enabled).
4123
+ cs1_spidev Set to 'off' to stop the creation of a
4124
+ userspace device node /dev/spidev2.1 (default
4125
+ is 'on' or enabled).
4126
+
4127
+
4128
+Name: spi2-3cs
4129
+Info: Enables spi2 on GPIOs 40-42 with three chip select (CS) lines and
4130
+ associated spidev dev nodes. The gpio pin numbers for the CS lines and
4131
+ spidev device node creation are configurable.
4132
+ N.B.: spi2 is only accessible with the Compute Module or Pi 5.
4133
+Load: dtoverlay=spi2-3cs,<param>=<val>
4134
+Params: cs0_pin GPIO pin for CS0 (default 43 - BCM SPI2_CE0).
4135
+ cs1_pin GPIO pin for CS1 (default 44 - BCM SPI2_CE1).
4136
+ cs2_pin GPIO pin for CS2 (default 45 - BCM SPI2_CE2).
4137
+ cs0_spidev Set to 'off' to stop the creation of a
4138
+ userspace device node /dev/spidev2.0 (default
4139
+ is 'on' or enabled).
4140
+ cs1_spidev Set to 'off' to stop the creation of a
4141
+ userspace device node /dev/spidev2.1 (default
4142
+ is 'on' or enabled).
4143
+ cs2_spidev Set to 'off' to stop the creation of a
4144
+ userspace device node /dev/spidev2.2 (default
4145
+ is 'on' or enabled).
4146
+
4147
+
4148
+Name: spi3-1cs
4149
+Info: Enables spi3 on GPIOs 1-3 with a single chip select (CS) line and
4150
+ associated spidev dev node. The gpio pin number for the CS line and
4151
+ spidev device node creation are configurable. BCM2711 only,
4152
+ spi3-1cs-pi5 is substituted on Pi 5.
4153
+Load: dtoverlay=spi3-1cs,<param>=<val>
4154
+Params: cs0_pin GPIO pin for CS0 (default 0 - BCM SPI3_CE0).
4155
+ cs0_spidev Set to 'off' to prevent the creation of a
4156
+ userspace device node /dev/spidev3.0 (default
4157
+ is 'on' or enabled).
4158
+
4159
+
4160
+Name: spi3-1cs-pi5
4161
+Info: Enables spi3 on GPIOs 5-7 with a single chip select (CS) line and
4162
+ associated spidev dev node. The gpio pin number for the CS line and
4163
+ spidev device node creation are configurable. Pi 5 only.
4164
+Load: dtoverlay=spi3-1cs-pi5,<param>=<val>
4165
+Params: cs0_pin GPIO pin for CS0 (default 4).
4166
+ cs0_spidev Set to 'off' to prevent the creation of a
4167
+ userspace device node /dev/spidev3.0 (default
4168
+ is 'on' or enabled).
4169
+
4170
+
4171
+Name: spi3-2cs
4172
+Info: Enables spi3 on GPIO2 1-3 with two chip select (CS) lines and
4173
+ associated spidev dev nodes. The gpio pin numbers for the CS lines and
4174
+ spidev device node creation are configurable. BCM2711 only,
4175
+ spi3-2cs-pi5 is substituted on Pi 5.
4176
+Load: dtoverlay=spi3-2cs,<param>=<val>
4177
+Params: cs0_pin GPIO pin for CS0 (default 0 - BCM SPI3_CE0).
4178
+ cs1_pin GPIO pin for CS1 (default 24 - BCM SPI3_CE1).
4179
+ cs0_spidev Set to 'off' to prevent the creation of a
4180
+ userspace device node /dev/spidev3.0 (default
4181
+ is 'on' or enabled).
4182
+ cs1_spidev Set to 'off' to prevent the creation of a
4183
+ userspace device node /dev/spidev3.1 (default
4184
+ is 'on' or enabled).
4185
+
4186
+
4187
+Name: spi3-2cs-pi5
4188
+Info: Enables spi3 on GPIOs 5-7 with two chip select (CS) lines and
4189
+ associated spidev dev nodes. The gpio pin numbers for the CS lines and
4190
+ spidev device node creation are configurable. Pi 5 only.
4191
+Load: dtoverlay=spi3-2cs-pi5,<param>=<val>
4192
+Params: cs0_pin GPIO pin for CS0 (default 4).
4193
+ cs1_pin GPIO pin for CS1 (default 25).
4194
+ cs0_spidev Set to 'off' to prevent the creation of a
4195
+ userspace device node /dev/spidev3.0 (default
4196
+ is 'on' or enabled).
4197
+ cs1_spidev Set to 'off' to prevent the creation of a
4198
+ userspace device node /dev/spidev3.1 (default
4199
+ is 'on' or enabled).
4200
+
4201
+
4202
+Name: spi4-1cs
4203
+Info: Enables spi4 on GPIOs 5-7 with a single chip select (CS) line and
4204
+ associated spidev dev node. The gpio pin number for the CS line and
4205
+ spidev device node creation are configurable. BCM2711 only.
4206
+Load: dtoverlay=spi4-1cs,<param>=<val>
4207
+Params: cs0_pin GPIO pin for CS0 (default 4 - BCM SPI4_CE0).
4208
+ cs0_spidev Set to 'off' to prevent the creation of a
4209
+ userspace device node /dev/spidev4.0 (default
4210
+ is 'on' or enabled).
4211
+
4212
+
4213
+Name: spi4-2cs
4214
+Info: Enables spi4 on GPIOs 5-6 with two chip select (CS) lines and
4215
+ associated spidev dev nodes. The gpio pin numbers for the CS lines and
4216
+ spidev device node creation are configurable. BCM2711 only.
4217
+Load: dtoverlay=spi4-2cs,<param>=<val>
4218
+Params: cs0_pin GPIO pin for CS0 (default 4 - BCM SPI4_CE0).
4219
+ cs1_pin GPIO pin for CS1 (default 25 - BCM SPI4_CE1).
4220
+ cs0_spidev Set to 'off' to prevent the creation of a
4221
+ userspace device node /dev/spidev4.0 (default
4222
+ is 'on' or enabled).
4223
+ cs1_spidev Set to 'off' to prevent the creation of a
4224
+ userspace device node /dev/spidev4.1 (default
4225
+ is 'on' or enabled).
4226
+
4227
+
4228
+Name: spi5-1cs
4229
+Info: Enables spi5 on GPIOs 13-15 with a single chip select (CS) line and
4230
+ associated spidev dev node. The gpio pin numbers for the CS lines and
4231
+ spidev device node creation are configurable. BCM2711 and Pi 5.
4232
+Load: dtoverlay=spi5-1cs,<param>=<val>
4233
+Params: cs0_pin GPIO pin for CS0 (default 12).
4234
+ cs0_spidev Set to 'off' to prevent the creation of a
4235
+ userspace device node /dev/spidev5.0 (default
4236
+ is 'on' or enabled).
4237
+
4238
+
4239
+Name: spi5-1cs-pi5
4240
+Info: See spi5-1cs
4241
+
4242
+
4243
+Name: spi5-2cs
4244
+Info: Enables spi5 on GPIOs 13-15 with two chip select (CS) lines and
4245
+ associated spidev dev nodes. The gpio pin numbers for the CS lines and
4246
+ spidev device node creation are configurable. BCM2711 and Pi 5.
4247
+Load: dtoverlay=spi5-2cs,<param>=<val>
4248
+Params: cs0_pin GPIO pin for CS0 (default 12).
4249
+ cs1_pin GPIO pin for CS1 (default 26).
4250
+ cs0_spidev Set to 'off' to prevent the creation of a
4251
+ userspace device node /dev/spidev5.0 (default
4252
+ is 'on' or enabled).
4253
+ cs1_spidev Set to 'off' to prevent the creation of a
4254
+ userspace device node /dev/spidev5.1 (default
4255
+ is 'on' or enabled).
4256
+
4257
+
4258
+Name: spi5-2cs-pi5
4259
+Info: See spi5-2cs
4260
+
4261
+
4262
+Name: spi6-1cs
4263
+Info: Enables spi6 with a single chip select (CS) line and associated spidev
4264
+ dev node. The gpio pin number for the CS line and spidev device node
4265
+ creation are configurable. BCM2711 only.
4266
+Load: dtoverlay=spi6-1cs,<param>=<val>
4267
+Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI6_CE0).
4268
+ cs0_spidev Set to 'off' to prevent the creation of a
4269
+ userspace device node /dev/spidev6.0 (default
4270
+ is 'on' or enabled).
4271
+
4272
+
4273
+Name: spi6-2cs
4274
+Info: Enables spi6 with two chip select (CS) lines and associated spidev
4275
+ dev nodes. The gpio pin numbers for the CS lines and spidev device node
4276
+ creation are configurable. BCM2711 only.
4277
+Load: dtoverlay=spi6-2cs,<param>=<val>
4278
+Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI6_CE0).
4279
+ cs1_pin GPIO pin for CS1 (default 27 - BCM SPI6_CE1).
4280
+ cs0_spidev Set to 'off' to prevent the creation of a
4281
+ userspace device node /dev/spidev6.0 (default
4282
+ is 'on' or enabled).
4283
+ cs1_spidev Set to 'off' to prevent the creation of a
4284
+ userspace device node /dev/spidev6.1 (default
4285
+ is 'on' or enabled).
4286
+
4287
+
4288
+Name: ssd1306
4289
+Info: Overlay for activation of SSD1306 over I2C OLED display framebuffer.
4290
+Load: dtoverlay=ssd1306,<param>=<val>
4291
+Params: address Location in display memory of first character.
4292
+ (default=0)
4293
+ width Width of display. (default=128)
4294
+ height Height of display. (default=64)
4295
+ offset virtual channel a. (default=0)
4296
+ normal Has no effect on displays tested. (default=not
4297
+ set)
4298
+ sequential Set this if every other scan line is missing.
4299
+ (default=not set)
4300
+ remapped Set this if display is garbled. (default=not
4301
+ set)
4302
+ inverted Set this if display is inverted and mirrored.
4303
+ (default=not set)
4304
+
4305
+ Examples:
4306
+ Typical usage for 128x64 display: dtoverlay=ssd1306,inverted
4307
+
4308
+ Typical usage for 128x32 display: dtoverlay=ssd1306,inverted,sequential
4309
+
4310
+ i2c_baudrate=400000 will speed up the display.
4311
+
4312
+ i2c_baudrate=1000000 seems to work even though it's not officially
4313
+ supported by the hardware, and is faster still.
4314
+
4315
+ For more information refer to the device datasheet at:
4316
+ https://cdn-shop.adafruit.com/datasheets/SSD1306.pdf
4317
+
4318
+
4319
+Name: ssd1306-spi
4320
+Info: Overlay for SSD1306 OLED via SPI using fbtft staging driver.
4321
+Load: dtoverlay=ssd1306-spi,<param>=<val>
4322
+Params: speed SPI bus speed (default 10000000)
4323
+ rotate Display rotation (0, 90, 180 or 270; default 0)
4324
+ fps Delay between frame updates (default 25)
4325
+ debug Debug output level (0-7; default 0)
4326
+ dc_pin GPIO pin for D/C (default 24)
4327
+ reset_pin GPIO pin for RESET (default 25)
4328
+ height Display height (32 or 64; default 64)
4329
+ inverted Set this if display is inverted and mirrored.
4330
+ (default=not set)
4331
+
4332
+
4333
+Name: ssd1331-spi
4334
+Info: Overlay for SSD1331 OLED via SPI using fbtft staging driver.
4335
+Load: dtoverlay=ssd1331-spi,<param>=<val>
4336
+Params: speed SPI bus speed (default 4500000)
4337
+ rotate Display rotation (0, 90, 180 or 270; default 0)
4338
+ fps Delay between frame updates (default 25)
4339
+ debug Debug output level (0-7; default 0)
4340
+ dc_pin GPIO pin for D/C (default 24)
4341
+ reset_pin GPIO pin for RESET (default 25)
4342
+
4343
+
4344
+Name: ssd1351-spi
4345
+Info: Overlay for SSD1351 OLED via SPI using fbtft staging driver.
4346
+Load: dtoverlay=ssd1351-spi,<param>=<val>
4347
+Params: speed SPI bus speed (default 4500000)
4348
+ rotate Display rotation (0, 90, 180 or 270; default 0)
4349
+ fps Delay between frame updates (default 25)
4350
+ debug Debug output level (0-7; default 0)
4351
+ dc_pin GPIO pin for D/C (default 24)
4352
+ reset_pin GPIO pin for RESET (default 25)
4353
+
4354
+
4355
+Name: superaudioboard
4356
+Info: Configures the SuperAudioBoard sound card
4357
+Load: dtoverlay=superaudioboard,<param>=<val>
4358
+Params: gpiopin GPIO pin for codec reset
4359
+
4360
+
4361
+Name: sx150x
4362
+Info: Configures the Semtech SX150X I2C GPIO expanders.
4363
+Load: dtoverlay=sx150x,<param>=<val>
4364
+Params: sx150<x>-<n>-<m> Enables SX150X device on I2C#<n> with slave
4365
+ address <m>. <x> may be 1-9. <n> may be 0 or 1.
4366
+ Permissible values of <m> (which is denoted in
4367
+ hex) depend on the device variant. For SX1501,
4368
+ SX1502, SX1504 and SX1505, <m> may be 20 or 21.
4369
+ For SX1503 and SX1506, <m> may be 20. For
4370
+ SX1507 and SX1509, <m> may be 3E, 3F, 70 or 71.
4371
+ For SX1508, <m> may be 20, 21, 22 or 23.
4372
+
4373
+ sx150<x>-<n>-<m>-int-gpio
4374
+ Integer, enables interrupts on SX150X device on
4375
+ I2C#<n> with slave address <m>, specifies
4376
+ the GPIO pin to which NINT output of SX150X is
4377
+ connected.
4378
+
4379
+
4380
+Name: tc358743
4381
+Info: Toshiba TC358743 HDMI to CSI-2 bridge chip.
4382
+ Uses Unicam 1, which is the standard camera connector on most Pi
4383
+ variants.
4384
+Load: dtoverlay=tc358743,<param>=<val>
4385
+Params: 4lane Use 4 lanes (only applicable to Compute Modules
4386
+ CAM1 connector).
4387
+
4388
+ link-frequency Set the link frequency. Only values of 297000000
4389
+ (574Mbit/s) and 486000000 (972Mbit/s - default)
4390
+ are supported by the driver.
4391
+ media-controller Configure use of Media Controller API for
4392
+ configuring the sensor (default off)
4393
+ cam0 Adopt the default configuration for CAM0 on a
4394
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
4395
+
4396
+
4397
+Name: tc358743-audio
4398
+Info: Used in combination with the tc358743-fast overlay to route the audio
4399
+ from the TC358743 over I2S to the Pi.
4400
+ Wiring is LRCK/WFS to GPIO 19, BCK/SCK to GPIO 18, and DATA/SD to GPIO
4401
+ 20.
4402
+Load: dtoverlay=tc358743-audio,<param>=<val>
4403
+Params: card-name Override the default, "tc358743", card name.
4404
+
4405
+
4406
+Name: tinylcd35
4407
+Info: 3.5" Color TFT Display by www.tinylcd.com
4408
+ Options: Touch, RTC, keypad
4409
+Load: dtoverlay=tinylcd35,<param>=<val>
4410
+Params: speed Display SPI bus speed
4411
+
4412
+ rotate Display rotation {0,90,180,270}
4413
+
4414
+ fps Delay between frame updates
4415
+
4416
+ debug Debug output level {0-7}
4417
+
4418
+ touch Enable touch panel
4419
+
4420
+ touchgpio Touch controller IRQ GPIO
4421
+
4422
+ xohms Touchpanel: Resistance of X-plate in ohms
4423
+
4424
+ rtc-pcf PCF8563 Real Time Clock
4425
+
4426
+ rtc-ds DS1307 Real Time Clock
4427
+
4428
+ keypad Enable keypad
4429
+
4430
+ Examples:
4431
+ Display with touchpanel, PCF8563 RTC and keypad:
4432
+ dtoverlay=tinylcd35,touch,rtc-pcf,keypad
4433
+ Old touch display:
4434
+ dtoverlay=tinylcd35,touch,touchgpio=3
4435
+
4436
+
4437
+Name: tpm-slb9670
4438
+Info: Enables support for Infineon SLB9670 Trusted Platform Module add-on
4439
+ boards, which can be used as a secure key storage and hwrng,
4440
+ available as "Iridium SLB9670" by Infineon and "LetsTrust TPM" by pi3g.
4441
+Load: dtoverlay=tpm-slb9670
4442
+Params: <None>
4443
+
4444
+
4445
+Name: tpm-slb9673
4446
+Info: Enables support for Infineon SLB9673 Trusted Platform Module add-on
4447
+ boards, which can be used as a secure key storage and hwrng
4448
+ via the I2C protocol.
4449
+Load: dtoverlay=tpm-slb9673
4450
+Params: <None>
4451
+
4452
+
4453
+Name: uart0
4454
+Info: Change the pin usage of uart0
4455
+Load: dtoverlay=uart0,<param>=<val>
4456
+Params: txd0_pin GPIO pin for TXD0 (14, 32 or 36 - default 14)
4457
+
4458
+ rxd0_pin GPIO pin for RXD0 (15, 33 or 37 - default 15)
4459
+
4460
+ pin_func Alternative pin function - 4(Alt0) for 14&15,
4461
+ 7(Alt3) for 32&33, 6(Alt2) for 36&37
4462
+
4463
+
4464
+Name: uart0-pi5
4465
+Info: Enable uart 0 on GPIOs 14-15. Pi 5 only.
4466
+Load: dtoverlay=uart0-pi5,<param>
4467
+Params: ctsrts Enable CTS/RTS on GPIOs 16-17 (default off)
4468
+
4469
+
4470
+Name: uart1
4471
+Info: Change the pin usage of uart1
4472
+Load: dtoverlay=uart1,<param>=<val>
4473
+Params: txd1_pin GPIO pin for TXD1 (14, 32 or 40 - default 14)
4474
+
4475
+ rxd1_pin GPIO pin for RXD1 (15, 33 or 41 - default 15)
4476
+
4477
+
4478
+Name: uart1-pi5
4479
+Info: Enable uart 1 on GPIOs 0-1. Pi 5 only.
4480
+Load: dtoverlay=uart1-pi5,<param>
4481
+Params: ctsrts Enable CTS/RTS on GPIOs 2-3 (default off)
4482
+
4483
+
4484
+Name: uart2
4485
+Info: Enable uart 2 on GPIOs 0-3. BCM2711 only.
4486
+Load: dtoverlay=uart2,<param>
4487
+Params: ctsrts Enable CTS/RTS on GPIOs 2-3 (default off)
4488
+
4489
+
4490
+Name: uart2-pi5
4491
+Info: Enable uart 2 on GPIOs 4-5. Pi 5 only.
4492
+Load: dtoverlay=uart2-pi5,<param>
4493
+Params: ctsrts Enable CTS/RTS on GPIOs 6-7 (default off)
4494
+
4495
+
4496
+Name: uart3
4497
+Info: Enable uart 3 on GPIOs 4-7. BCM2711 only.
4498
+Load: dtoverlay=uart3,<param>
4499
+Params: ctsrts Enable CTS/RTS on GPIOs 6-7 (default off)
4500
+
4501
+
4502
+Name: uart3-pi5
4503
+Info: Enable uart 3 on GPIOs 8-9. Pi 5 only.
4504
+Load: dtoverlay=uart3-pi5,<param>
4505
+Params: ctsrts Enable CTS/RTS on GPIOs 10-11 (default off)
4506
+
4507
+
4508
+Name: uart4
4509
+Info: Enable uart 4 on GPIOs 8-11. BCM2711 only.
4510
+Load: dtoverlay=uart4,<param>
4511
+Params: ctsrts Enable CTS/RTS on GPIOs 10-11 (default off)
4512
+
4513
+
4514
+Name: uart4-pi5
4515
+Info: Enable uart 4 on GPIOs 12-13. Pi 5 only.
4516
+Load: dtoverlay=uart4-pi5,<param>
4517
+Params: ctsrts Enable CTS/RTS on GPIOs 14-15 (default off)
4518
+
4519
+
4520
+Name: uart5
4521
+Info: Enable uart 5 on GPIOs 12-15. BCM2711 only.
4522
+Load: dtoverlay=uart5,<param>
4523
+Params: ctsrts Enable CTS/RTS on GPIOs 14-15 (default off)
4524
+
4525
+
4526
+Name: udrc
4527
+Info: Configures the NW Digital Radio UDRC Hat
4528
+Load: dtoverlay=udrc,<param>=<val>
4529
+Params: alsaname Name of the ALSA audio device (default "udrc")
4530
+
4531
+
4532
+Name: ugreen-dabboard
4533
+Info: Configures the ugreen-dabboard I2S overlay
4534
+ This is a simple overlay based on the simple-audio-card and the dmic
4535
+ codec. It has the speciality that it is configured to use the codec
4536
+ as a master I2S device. It works for example with the Si468x DAB
4537
+ receiver on the uGreen DABBoard.
4538
+Load: dtoverlay=ugreen-dabboard,<param>=<val>
4539
+Params: card-name Override the default, "dabboard", card name.
4540
+
4541
+
4542
+Name: upstream
4543
+Info: Allow usage of downstream .dtb with upstream kernel. Comprises the
4544
+ vc4-kms-v3d and dwc2 overlays.
4545
+Load: dtoverlay=upstream
4546
+Params: <None>
4547
+
4548
+
4549
+Name: upstream-aux-interrupt
4550
+Info: This overlay has been deprecated and removed because it is no longer
4551
+ necessary.
4552
+Load: <Deprecated>
4553
+
4554
+
4555
+Name: upstream-pi4
4556
+Info: Allow usage of downstream .dtb with upstream kernel on Pi 4. Comprises
4557
+ the vc4-kms-v3d-pi4 and dwc2 overlays.
4558
+Load: dtoverlay=upstream-pi4
4559
+Params: <None>
4560
+
4561
+
4562
+Name: vc4-fkms-v3d
4563
+Info: Enable Eric Anholt's DRM VC4 V3D driver on top of the dispmanx
4564
+ display stack.
4565
+Load: dtoverlay=vc4-fkms-v3d,<param>
4566
+Params: cma-512 CMA is 512MB (needs 1GB)
4567
+ cma-448 CMA is 448MB (needs 1GB)
4568
+ cma-384 CMA is 384MB (needs 1GB)
4569
+ cma-320 CMA is 320MB (needs 1GB)
4570
+ cma-256 CMA is 256MB (needs 1GB)
4571
+ cma-192 CMA is 192MB (needs 1GB)
4572
+ cma-128 CMA is 128MB
4573
+ cma-96 CMA is 96MB
4574
+ cma-64 CMA is 64MB
4575
+ cma-size CMA size in bytes, 4MB aligned
4576
+ cma-default Use upstream's default value
4577
+
4578
+
4579
+Name: vc4-fkms-v3d-pi4
4580
+Info: Enable Eric Anholt's DRM VC4 V3D driver on top of the dispmanx
4581
+ display stack.
4582
+Load: dtoverlay=vc4-fkms-v3d-pi4,<param>
4583
+Params: cma-512 CMA is 512MB (needs 1GB)
4584
+ cma-448 CMA is 448MB (needs 1GB)
4585
+ cma-384 CMA is 384MB (needs 1GB)
4586
+ cma-320 CMA is 320MB (needs 1GB)
4587
+ cma-256 CMA is 256MB (needs 1GB)
4588
+ cma-192 CMA is 192MB (needs 1GB)
4589
+ cma-128 CMA is 128MB
4590
+ cma-96 CMA is 96MB
4591
+ cma-64 CMA is 64MB
4592
+ cma-size CMA size in bytes, 4MB aligned
4593
+ cma-default Use upstream's default value
4594
+
4595
+
4596
+Name: vc4-kms-dpi-at056tn53v1
4597
+Info: This overlay is now deprecated - see vc4-kms-dpi-panel,at056tn53v1
4598
+Load: <Deprecated>
4599
+
4600
+
4601
+Name: vc4-kms-dpi-generic
4602
+Info: Enable a generic DPI display under KMS. Default timings are for the
4603
+ Adafruit Kippah with 800x480 panel and RGB666 (GPIOs 0-21)
4604
+ Requires vc4-kms-v3d to be loaded.
4605
+Load: dtoverlay=vc4-kms-dpi-generic,<param>=<val>
4606
+Params: clock-frequency Display clock frequency (Hz)
4607
+ hactive Horizontal active pixels
4608
+ hfp Horizontal front porch
4609
+ hsync Horizontal sync pulse width
4610
+ hbp Horizontal back porch
4611
+ vactive Vertical active lines
4612
+ vfp Vertical front porch
4613
+ vsync Vertical sync pulse width
4614
+ vbp Vertical back porch
4615
+ hsync-invert Horizontal sync active low
4616
+ vsync-invert Vertical sync active low
4617
+ de-invert Data Enable active low
4618
+ pixclk-invert Negative edge pixel clock
4619
+ width-mm Define the screen width in mm
4620
+ height-mm Define the screen height in mm
4621
+ rgb565 Change to RGB565 output on GPIOs 0-19
4622
+ rgb565-padhi Change to RGB565 output on GPIOs 0-8, 12-17, and
4623
+ 20-24
4624
+ bgr666 Change to BGR666 output on GPIOs 0-21.
4625
+ bgr666-padhi Change to BGR666 output on GPIOs 0-9, 12-17, and
4626
+ 20-25
4627
+ rgb666-padhi Change to RGB666 output on GPIOs 0-9, 12-17, and
4628
+ 20-25
4629
+ bgr888 Change to BGR888 output on GPIOs 0-27
4630
+ rgb888 Change to RGB888 output on GPIOs 0-27
4631
+ bus-format Override the bus format for a MEDIA_BUS_FMT_*
4632
+ value. NB also overridden by rgbXXX overrides.
4633
+ backlight-gpio Defines a GPIO to be used for backlight control
4634
+ (default of none).
4635
+ backlight-pwm Defines a PWM channel to be used for backlight
4636
+ control (default of none). NB Disables audio
4637
+ headphone output as that also uses PWM.
4638
+ backlight-pwm-chan Choose channel on &pwm node for backlight
4639
+ control.
4640
+ (default 0).
4641
+ backlight-pwm-gpio GPIO pin to be used for the PWM backlight. See
4642
+ pwm-2chan for valid options.
4643
+ (default 18 - note this can only work with
4644
+ rgb666-padhi).
4645
+ backlight-pwm-func Pin function of GPIO used for the PWM
4646
+ backlight.
4647
+ See pwm-2chan for valid options.
4648
+ (default 2).
4649
+ backlight-def-brightness
4650
+ Set the default brightness. Normal range 1-16.
4651
+ (default 16).
4652
+ rotate Display rotation {0,90,180,270} (default 0)
4653
+
4654
+
4655
+Name: vc4-kms-dpi-hyperpixel2r
4656
+Info: Enable the KMS drivers for the Pimoroni HyperPixel2 Round DPI display.
4657
+ Requires vc4-kms-v3d to be loaded.
4658
+Load: dtoverlay=vc4-kms-dpi-hyperpixel2r,<param>=<val>
4659
+Params: disable-touch Disables the touch controller
4660
+ touchscreen-inverted-x Inverts X direction of touch controller
4661
+ touchscreen-inverted-y Inverts Y direction of touch controller
4662
+ touchscreen-swapped-x-y Swaps X & Y axes of touch controller
4663
+ rotate Display rotation {0,90,180,270} (default 0)
4664
+
4665
+
4666
+Name: vc4-kms-dpi-hyperpixel4
4667
+Info: Enable the KMS drivers for the Pimoroni HyperPixel4 DPI display.
4668
+ Requires vc4-kms-v3d to be loaded.
4669
+Load: dtoverlay=vc4-kms-dpi-hyperpixel4,<param>=<val>
4670
+Params: disable-touch Disables the touch controller
4671
+ touchscreen-inverted-x Inverts X direction of touch controller
4672
+ touchscreen-inverted-y Inverts Y direction of touch controller
4673
+ touchscreen-swapped-x-y Swaps X & Y axes of touch controller
4674
+ rotate Display rotation {0,90,180,270} (default 0)
4675
+
4676
+
4677
+Name: vc4-kms-dpi-hyperpixel4sq
4678
+Info: Enable the KMS drivers for the Pimoroni HyperPixel4 Square DPI display.
4679
+ Requires vc4-kms-v3d to be loaded.
4680
+Load: dtoverlay=vc4-kms-dpi-hyperpixel4sq,<param>=<val>
4681
+Params: disable-touch Disables the touch controller
4682
+ touchscreen-inverted-x Inverts X direction of touch controller
4683
+ touchscreen-inverted-y Inverts Y direction of touch controller
4684
+ touchscreen-swapped-x-y Swaps X & Y axes of touch controller
4685
+ rotate Display rotation {0,90,180,270} (default 0)
4686
+
4687
+
4688
+Name: vc4-kms-dpi-panel
4689
+Info: Enable a preconfigured KMS DPI panel.
4690
+ Requires vc4-kms-v3d to be loaded.
4691
+Load: dtoverlay=vc4-kms-dpi-panel,<param>=<val>
4692
+Params: at056tn53v1 Enable an Innolux 5.6in VGA TFT
4693
+ kippah-7inch Enable an Adafruit Kippah with 7inch panel.
4694
+ mzp280 Enable a Geekworm MZP280 panel.
4695
+ backlight-gpio Defines a GPIO to be used for backlight control
4696
+ (default of none).
4697
+ backlight-pwm Defines a PWM channel to be used for backlight
4698
+ control (default of none). NB Disables audio
4699
+ headphone output as that also uses PWM.
4700
+ backlight-pwm-chan Choose channel on &pwm node for backlight
4701
+ control.
4702
+ (default 0).
4703
+ backlight-pwm-gpio GPIO pin to be used for the PWM backlight. See
4704
+ pwm-2chan for valid options.
4705
+ (default 18 - note this can only work with
4706
+ rgb666-padhi).
4707
+ backlight-pwm-func Pin function of GPIO used for the PWM
4708
+ backlight.
4709
+ See pwm-2chan for valid options.
4710
+ (default 2).
4711
+ backlight-def-brightness
4712
+ Set the default brightness. Normal range 1-16.
4713
+ (default 16).
4714
+ rotate Display rotation {0,90,180,270} (default 0)
4715
+
4716
+
4717
+Name: vc4-kms-dsi-7inch
4718
+Info: Enable the Raspberry Pi DSI 7" screen.
4719
+ Includes the edt-ft5406 for the touchscreen element.
4720
+ Requires vc4-kms-v3d to be loaded.
4721
+Load: dtoverlay=vc4-kms-dsi-7inch,<param>=<val>
4722
+Params: sizex Touchscreen size x (default 800)
4723
+ sizey Touchscreen size y (default 480)
4724
+ invx Touchscreen inverted x axis
4725
+ invy Touchscreen inverted y axis
4726
+ swapxy Touchscreen swapped x y axis
4727
+ disable_touch Disables the touch screen overlay driver
4728
+ dsi0 Use DSI0 and i2c_csi_dsi0 (rather than
4729
+ the default DSI1 and i2c_csi_dsi).
4730
+
4731
+
4732
+Name: vc4-kms-dsi-lt070me05000
4733
+Info: Enable a JDI LT070ME05000 DSI display on DSI1.
4734
+ Note that this is a 4 lane DSI device, so it will only work on a Compute
4735
+ Module.
4736
+ Requires vc4-kms-v3d to be loaded.
4737
+Load: dtoverlay=vc4-kms-dsi-lt070me05000,<param>
4738
+Params: reset GPIO for the reset signal (default 17)
4739
+ enable GPIO for the enable signal (default 4)
4740
+ dcdc-en GPIO for the DC-DC converter enable (default 5)
4741
+
4742
+
4743
+Name: vc4-kms-dsi-lt070me05000-v2
4744
+Info: Enable a JDI LT070ME05000 DSI display on DSI1 using Harlab's V2
4745
+ interface board.
4746
+ Note that this is a 4 lane DSI device, so it will only work on a Compute
4747
+ Module.
4748
+ Requires vc4-kms-v3d to be loaded.
4749
+Load: dtoverlay=vc4-kms-dsi-lt070me05000-v2
4750
+Params: <None>
4751
+
4752
+
4753
+Name: vc4-kms-dsi-waveshare-panel
4754
+Info: Enable a Waveshare DSI touchscreen
4755
+ Includes the Goodix driver for the touchscreen element.
4756
+ The default is for the display to be using the I2C0 option for control.
4757
+ Use the i2c1 override if using the I2C1 wiring with jumper wires from
4758
+ GPIOs 2&3 (pins 3&5).
4759
+ invx/invy/swapxy should be used with caution as the panel specifier will
4760
+ set the default inversions for that panel. Always use them after the
4761
+ panel specifier, and be aware that you may need to set them as =0, not
4762
+ just adding it.
4763
+ Requires vc4-kms-v3d to be loaded.
4764
+Load: dtoverlay=vc4-kms-dsi-waveshare-panel,<param>=<val>
4765
+Params: 2_8_inch 2.8" 480x640
4766
+ 3_4_inch 3.4" 800x800 round
4767
+ 4_0_inch 4.0" 480x800
4768
+ 7_0_inchC 7.0" C 1024x600
4769
+ 7_9_inch 7.9" 400x1280
4770
+ 8_0_inch 8.0" 1280x800
4771
+ 10_1_inch 10.1" 1280x800
4772
+ 11_9_inch 11.9" 320x1480
4773
+ i2c1 Use i2c-1 with jumper wires from GPIOs 2&3
4774
+ disable_touch Disable the touch controller
4775
+ rotation Set the panel orientation property
4776
+ invx Touchscreen inverted x axis
4777
+ invy Touchscreen inverted y axis
4778
+ swapxy Touchscreen swapped x y axis
4779
+ dsi0 Use DSI0 and i2c_csi_dsi0 (rather than
4780
+ the default DSI1 and i2c_csi_dsi).
4781
+
4782
+
4783
+Name: vc4-kms-kippah-7inch
4784
+Info: This overlay is now deprecated - see vc4-kms-dpi-panel,kippah-7inch
4785
+Load: <Deprecated>
4786
+
4787
+
4788
+Name: vc4-kms-v3d
4789
+Info: Enable Eric Anholt's DRM VC4 HDMI/HVS/V3D driver.
4790
+Load: dtoverlay=vc4-kms-v3d,<param>
4791
+Params: cma-512 CMA is 512MB (needs 1GB)
4792
+ cma-448 CMA is 448MB (needs 1GB)
4793
+ cma-384 CMA is 384MB (needs 1GB)
4794
+ cma-320 CMA is 320MB (needs 1GB)
4795
+ cma-256 CMA is 256MB (needs 1GB)
4796
+ cma-192 CMA is 192MB (needs 1GB)
4797
+ cma-128 CMA is 128MB
4798
+ cma-96 CMA is 96MB
4799
+ cma-64 CMA is 64MB
4800
+ cma-size CMA size in bytes, 4MB aligned
4801
+ cma-default Use upstream's default value
4802
+ audio Enable or disable audio over HDMI (default "on")
4803
+ noaudio Disable all HDMI audio (default "off")
4804
+ composite Enable the composite output (default "off")
4805
+ N.B. Disables all other outputs on a Pi 4.
4806
+ nohdmi Disable HDMI output
4807
+
4808
+
4809
+Name: vc4-kms-v3d-pi4
4810
+Info: Enable Eric Anholt's DRM VC4 HDMI/HVS/V3D driver for Pi4.
4811
+Load: dtoverlay=vc4-kms-v3d-pi4,<param>
4812
+Params: cma-512 CMA is 512MB
4813
+ cma-448 CMA is 448MB
4814
+ cma-384 CMA is 384MB
4815
+ cma-320 CMA is 320MB
4816
+ cma-256 CMA is 256MB
4817
+ cma-192 CMA is 192MB
4818
+ cma-128 CMA is 128MB
4819
+ cma-96 CMA is 96MB
4820
+ cma-64 CMA is 64MB
4821
+ cma-size CMA size in bytes, 4MB aligned
4822
+ cma-default Use upstream's default value
4823
+ audio Enable or disable audio over HDMI0 (default
4824
+ "on")
4825
+ audio1 Enable or disable audio over HDMI1 (default
4826
+ "on")
4827
+ noaudio Disable all HDMI audio (default "off")
4828
+ composite Enable the composite output (disables all other
4829
+ outputs)
4830
+ nohdmi Disable both HDMI 0 & 1 outputs
4831
+ nohdmi0 Disable HDMI 0 output
4832
+ nohdmi1 Disable HDMI 1 output
4833
+
4834
+
4835
+Name: vc4-kms-v3d-pi5
4836
+Info: See vc4-kms-v3d-pi4 (this is the Pi 5 version)
4837
+
4838
+
4839
+Name: vc4-kms-vga666
4840
+Info: Enable the VGA666 (resistor ladder ADC) for the vc4-kms-v3d driver.
4841
+ Requires vc4-kms-v3d to be loaded.
4842
+Load: dtoverlay=vc4-kms-vga666,<param>
4843
+Params: ddc Enables GPIOs 0&1 as the I2C to read the EDID
4844
+ from the display. NB These are NOT 5V tolerant
4845
+ GPIOs, therefore level shifters are required.
4846
+
4847
+
4848
+Name: vga666
4849
+Info: Overlay for the Fen Logic VGA666 board
4850
+ This uses GPIOs 2-21 (so no I2C), and activates the output 2-3 seconds
4851
+ after the kernel has started.
4852
+ NOT for use with vc4-kms-v3d.
4853
+Load: dtoverlay=vga666
4854
+Params: <None>
4855
+
4856
+
4857
+Name: vl805
4858
+Info: Overlay to enable a VIA VL805 USB3 controller on CM4 carriers
4859
+ Will be loaded automatically by up-to-date firmware if "VL805=1" is
4860
+ set in the EEPROM config.
4861
+Load: dtoverlay=vl805
4862
+Params: <None>
4863
+
4864
+
4865
+Name: w1-gpio
4866
+Info: Configures the w1-gpio Onewire interface module.
4867
+ Use this overlay if you *don't* need a GPIO to drive an external pullup.
4868
+Load: dtoverlay=w1-gpio,<param>=<val>
4869
+Params: gpiopin GPIO for I/O (default "4")
4870
+ pullup Now enabled by default (ignored)
4871
+
4872
+
4873
+Name: w1-gpio-pullup
4874
+Info: Configures the w1-gpio Onewire interface module.
4875
+ Use this overlay if you *do* need a GPIO to drive an external pullup.
4876
+Load: dtoverlay=w1-gpio-pullup,<param>=<val>
4877
+Params: gpiopin GPIO for I/O (default "4")
4878
+ extpullup GPIO for external pullup (default "5")
4879
+ pullup Now enabled by default (ignored)
4880
+
4881
+
4882
+Name: w5500
4883
+Info: Overlay for the Wiznet W5500 Ethernet Controller on SPI0
4884
+Load: dtoverlay=w5500,<param>=<val>
4885
+Params: int_pin GPIO used for INT (default 25)
4886
+
4887
+ speed SPI bus speed (default 30000000)
4888
+
4889
+ cs SPI bus Chip Select (default 0)
4890
+
4891
+
4892
+Name: watterott-display
4893
+Info: Watterott RPi-Display - 2.8" Touch Display
4894
+ Linux has 2 drivers that support this display and this overlay supports
4895
+ both.
4896
+
4897
+ Examples:
4898
+ fbtft/fb_ili9341: dtoverlay=watterott-display
4899
+ drm/mi0283qt: dtoverlay=watterott-display,drm,backlight-pwm,rotate=180
4900
+
4901
+ Some notable differences with the DRM driver compared to fbtft:
4902
+ - The display is turned on when it's first used and not on driver load
4903
+ as with fbtft. So if nothing uses the display it stays off.
4904
+ - Can run with a higher SPI clock increasing framerate. This is possible
4905
+ since the driver avoids messing up the controller configuration due to
4906
+ transmission errors by running config commands at 10MHz and only pixel
4907
+ data at full speed (occasional pixel glitch might occur).
4908
+ - PWM backlight is supported.
4909
+
4910
+Load: dtoverlay=watterott-display,<param>=<val>
4911
+Params: speed Display SPI bus speed
4912
+ rotate Display rotation {0,90,180,270}
4913
+ fps Delay between frame updates (fbtft only)
4914
+ debug Debug output level {0-7} (fbtft only)
4915
+ xohms Touchpanel sensitivity (X-plate resistance)
4916
+ swapxy Swap x and y axis
4917
+ backlight Change backlight GPIO pin {e.g. 12, 18}
4918
+ (fbtft only)
4919
+ drm Use DRM/KMS driver mi0283qt instead of fbtft.
4920
+ Set the SPI clock to 70MHz.
4921
+ This has to be the first parameter.
4922
+ backlight-pwm Use pwm for backlight (drm only). NB: Disables
4923
+ audio headphone output as that also uses PWM.
4924
+
4925
+
4926
+Name: waveshare-can-fd-hat-mode-a
4927
+Info: Overlay for the Waveshare 2-Channel Isolated CAN FD Expansion HAT
4928
+ for Raspberry Pi, Multi Protections. Use this overlay when the
4929
+ HAT is configured in Mode A (Default), with can0 on spi0.0
4930
+ and can1 on spi1.0.
4931
+ https://www.waveshare.com/2-ch-can-fd-hat.htm
4932
+Load: dtoverlay=waveshare-can-fd-hat-mode-a
4933
+Params: <None>
4934
+
4935
+
4936
+Name: waveshare-can-fd-hat-mode-b
4937
+Info: Overlay for the Waveshare 2-Channel Isolated CAN FD Expansion HAT
4938
+ for Raspberry Pi, Multi Protections. Use this overlay when the
4939
+ HAT is configured in Mode B (requires hardware modification), with
4940
+ can0 on spi0.0 and can1 on spi0.1.
4941
+ https://www.waveshare.com/2-ch-can-fd-hat.htm
4942
+Load: dtoverlay=waveshare-can-fd-hat-mode-b
4943
+Params: <None>
4944
+
4945
+
4946
+Name: wittypi
4947
+Info: Configures the wittypi RTC module.
4948
+Load: dtoverlay=wittypi,<param>=<val>
4949
+Params: led_gpio GPIO for LED (default "17")
4950
+ led_trigger Choose which activity the LED tracks (default
4951
+ "default-on")
4952
+
4953
+
4954
+Name: wm8960-soundcard
4955
+Info: Overlay for the Waveshare wm8960 soundcard
4956
+Load: dtoverlay=wm8960-soundcard,<param>=<val>
4957
+Params: alsaname Changes the card name in ALSA
4958
+ compatible Changes the codec compatibility
4959
+
4960
+
4961
+Troubleshooting
4962
+===============
4963
+
4964
+If you are experiencing problems that you think are DT-related, enable DT
4965
+diagnostic output by adding this to /boot/config.txt:
4966
+
4967
+ dtdebug=on
4968
+
4969
+and rebooting. Then run:
4970
+
4971
+ sudo vcdbg log msg
4972
+
4973
+and look for relevant messages.
4974
+
4975
+Further reading
4976
+===============
4977
+
4978
+This is only meant to be a quick introduction to the subject of Device Tree on
4979
+Raspberry Pi. There is a more complete explanation here:
4980
+
4981
+http://www.raspberrypi.org/documentation/configuration/device-tree.md
Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/RPI-CM4-dat.md
... ...
@@ -2,6 +2,12 @@
2 2
3 3
# RPI-CM-dat
4 4
5
+- [[RPI-dat]]
6
+
7
+[COMPUTE MODULE OPERATING INSTRUCTIONS](https://www.farnell.com/datasheets/1830506.pdf)
8
+
9
+- [[README-CM-dat]]
10
+
5 11
## CM3
6 12
7 13
The Raspberry Pi Compute Module is a small, powerful, and customizable single-board computer designed for embedded applications. It is based on the same architecture as the Raspberry Pi boards but in a more compact form factor. The Compute Module provides a more flexible and modular approach compared to the standard Raspberry Pi boards.
... ...
@@ -53,17 +59,22 @@ default UARTs: https://forums.raspberrypi.com/viewtopic.php?t=345086
53 59
54 60
![](2023-10-27-16-46-54.png)
55 61
62
+
63
+
56 64
## hardware
57 65
58
-- [[EMMC]] - [[WIFI]]
66
+- [[BCM2711-dat]]
67
+
68
+- [[EMMC-dat]] - [[WIFI-dat]] - [[PHY-dat]] - [[ethernet-dat]]
59 69
60 70
- Connector - 【 DF40HC (3.0)-100DS-0.4V(51)】
61 71
72
+- [[RMP-RPI-CM4-dat]]
73
+
62 74
### Pins
63 75
64
-![](2024-11-22-19-30-56.png)
76
+- [[RPI-CM4-gpio-dat]]
65 77
66
-![](2024-11-22-19-31-24.png)
67 78
68 79
## Features
69 80
Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/RPI-CM4-gpio-dat/2024-11-22-19-30-56.png
... ...
Binary files /dev/null and b/Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/RPI-CM4-gpio-dat/2024-11-22-19-30-56.png differ
Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/RPI-CM4-gpio-dat/2024-11-22-19-31-24.png
... ...
Binary files /dev/null and b/Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/RPI-CM4-gpio-dat/2024-11-22-19-31-24.png differ
Tech-dat/SBC-dat/RPI-dat/RPI-CM4-dat/RPI-CM4-gpio-dat/RPI-CM4-gpio-dat.md
... ...
@@ -0,0 +1,265 @@
1
+
2
+# RPI-CM4-gpio-dat
3
+
4
+
5
+reference extra pins - https://docs.google.com/spreadsheets/d/1m27caMlk2gofswU9ZlBD_y3y81Y_0ARSmmQgm0i1AdQ/edit?gid=0#gid=0
6
+
7
+pin definitions - [[cm4-datasheet.pdf]] - Chapter 4. Pinout
8
+
9
+## Understanding the Discrepancy
10
+
11
+The Compute Module 4 Datasheet uses absolute pin numbering, which is sequential across both connectors (J6 and J7). Here's how it works:
12
+
13
+- Pins 1 to 100: Belong to J6 (Connector 1).
14
+- Pins 101 to 200: Belong to J7 (Connector 2).
15
+
16
+Thus, Pin 164 corresponds to J7-77 (Connector 2, Top Row, Pin 77) when using the relative pin numbering scheme for the J7 connector.
17
+
18
+Summary
19
+- HDMI1_CK_P is on J7 (Connector 2).
20
+- Its absolute pin number in the datasheet: 164.
21
+- Its relative pin number on J7: 77.
22
+
23
+
24
+
25
+
26
+
27
+
28
+
29
+
30
+## pin in pictures
31
+
32
+
33
+![](2024-11-22-19-30-56.png)
34
+
35
+![](2024-11-22-19-31-24.png)
36
+
37
+
38
+- [[RPI-CM4]]
39
+
40
+
41
+## pin note
42
+
43
+- 28&29 are ethernet
44
+- 30-33 are Bluetooth
45
+- 34-39 are Wifi (SDIO)
46
+- 40, 41, and 43 are boot rom related.
47
+- 42 is the activity LED
48
+- 44&45 are I2C to the camera and display
49
+- 46&47 are internal control
50
+- 48-53 would appear to configured as SD card, but I believe you're right that they on dedicated pins.
51
+
52
+## ref
53
+
54
+- https://forums.raspberrypi.com/viewtopic.php?t=354412
55
+
56
+- https://forums.raspberrypi.com/viewtopic.php?t=320541
57
+
58
+- https://forums.raspberrypi.com/viewtopic.php?t=299667
59
+
60
+- https://docs.google.com/spreadsheets/d/1m27caMlk2gofswU9ZlBD_y3y81Y_0ARSmmQgm0i1AdQ/edit?gid=0#gid=0
61
+
62
+
63
+## pin table
64
+
65
+| Pin | | Signal | Description |
66
+| --- | ------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
67
+| 1 | | GND | Ground (0V) |
68
+| 2 | | GND | Ground (0V) |
69
+| 3 | | Ethernet_Pair3_P | Ethernet pair 3 positive (connect to transformer or MagJack) |
70
+| 4 | | Ethernet_Pair1_P | Ethernet pair 1 positive (connect to transformer or MagJack) |
71
+| 5 | | Ethernet_Pair3_N | Ethernet pair 3 negative (connect to transformer or MagJack) |
72
+| 6 | | Ethernet_Pair1_N | Ethernet pair 1 negative (connect to transformer or MagJack) |
73
+| 7 | | GND | Ground (0V) |
74
+| 8 | | GND | Ground (0V) |
75
+| 9 | | Ethernet_Pair2_N | Ethernet pair 2 negative (connect to transformer or MagJack) |
76
+| 10 | | Ethernet_Pair0_N | Ethernet pair 0 negative (connect to transformer or MagJack) |
77
+| 11 | | Ethernet_Pair2_P | Ethernet pair 2 positive (connect to transformer or MagJack) |
78
+| 12 | | Ethernet_Pair0_P | Ethernet pair 0 positive (connect to transformer or MagJack) |
79
+| 13 | | GND | Ground (0V) |
80
+| 14 | | GND | Ground (0V) |
81
+| 15 | | Ethernet_nLED3 | Active-low Ethernet activity indicator (CM4_3.3V signal): typically a green LED is connected to this pin. IOL = 8mA @ VOL < 0.4V |
82
+| 16 | | Ethernet_SYNC_IN | IEEE1588 SYNC Input pin (CM4_3.3V signal: IOL = 8mA @ VOL < 0.4V) |
83
+| 17 | | Ethernet_nLED2 | Active-low Ethernet speed indicator (`CM4_3.3V`signal): typically a yellow LED is connected to this pin. A low state indicates the 1Gbit or 100Mbit link: IOL = 8mA @ VOL < 0.4V |
84
+| 18 | | Ethernet_SYNC_OUT | IEEE1588 SYNC Output pin (CM4_3.3V signal: IOL = 8mA @ VOL < 0.4V) |
85
+| 19 | | Ethernet_nLED1 | Active-low Ethernet speed indicator (CM4_3.3V signal): typically a yellow LED is connected to this pin. A low state indicates the 1Gbit or 10Mbit link: IOL = 8mA @ VOL < 0.4V |
86
+| 20 | | EEPROM_nWP | Leave floating NB internally pulled up to CM4_3.3V via 100kΩ (VIL < 0.8V), but can be grounded to prevent writing to the on-board EEPROM which stores the bootcode |
87
+| 21 | | Pi_nLED_Activity | Active-low Pi activity LED. 20mA Max, 5V tolerant (VOL < 0.4V). (this is the signal that drives the green LED on the Raspberry Pi 4 Model B) |
88
+| 22 | | GND | Ground (0V) |
89
+| 23 | | GND | Ground (0V) |
90
+| 24 | | GPIO26 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
91
+| 25 | | GPIO21 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
92
+| 26 | | GPIO19 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
93
+| 27 | | GPIO20 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
94
+| 28 | | GPIO13 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
95
+| 29 | | GPIO16 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
96
+| 30 | | GPIO6 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
97
+| 31 | | GPIO12 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
98
+| 32 | | GND | Ground (0V) |
99
+| 33 | | GND | Ground (0V) |
100
+| 34 | | GPIO5 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
101
+| 35 | GPIO1 | ID_SC | (BCM2711 GPIO 1) GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
102
+| 36 | GPIO0 | ID_SD | (BCM2711 GPIO 0) GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
103
+| 37 | | GPIO7 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
104
+| 38 | | GPIO11 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
105
+| 39 | | GPIO8 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
106
+| 40 | | GPIO9 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
107
+| 41 | | GPIO25 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
108
+| 42 | | GND | Ground (0V) |
109
+| 43 | | GND | Ground (0V) |
110
+| 44 | | GPIO10 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
111
+| 45 | | GPIO24 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
112
+| 46 | | GPIO22 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
113
+| 47 | | GPIO23 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
114
+| 48 | | GPIO27 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
115
+| 49 | | GPIO18 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
116
+| 50 | | GPIO17 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
117
+| 51 | | GPIO15 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
118
+| 52 | | GND | Ground (0V) |
119
+| 53 | | GND | Ground (0V) |
120
+| 54 | | GPIO4 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
121
+| 55 | | GPIO14 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V |
122
+| 56 | | GPIO3 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V. Internal 1.8kΩ pull up to GPIO_VREF |
123
+| 57 | | SD_CLK | SD card clock signal (only available on CM4Lite) |
124
+| 58 | | GPIO2 | GPIO: typically a 3.3V signal, but can be a 1.8V signal by connecting GPIO_VREF to CM4_1.8V. Internal 1.8kΩ pull up to GPIO_VREF |
125
+| 59 | | GND | Ground (0V) |
126
+| 60 | | GND | Ground (0V) |
127
+| 61 | | SD_DAT3 | SD card/eMMC Data3 signal (only available on CM4Lite) |
128
+| 62 | | SD_CMD | SD card/eMMC Command signal (only available on CM4Lite) |
129
+| 63 | | SD_DAT0 | SD card/eMMC Data0 signal (only available on CM4Lite) |
130
+| 64 | | SD_DAT5 | SD card/eMMC Data5 signal (only available on CM4Lite) |
131
+| 65 | | GND | Ground (0V) |
132
+| 66 | | GND | Ground (0V) |
133
+| 67 | | SD_DAT1 | SD card/eMMC Data1 signal (only available on CM4Lite) |
134
+| 68 | | SD_DAT4 | SD card/eMMC Data4 signal (only available on CM4Lite) |
135
+| 69 | | SD_DAT2 | SD card/eMMC Data2 signal (only available on CM4Lite) |
136
+| 70 | | SD_DAT7 | SD card/eMMC Data7 signal (only available on CM4Lite) |
137
+| 71 | | GND | Ground (0V) |
138
+| 72 | | SD_DAT6 | SD card/eMMC Data6 signal (only available on CM4Lite) |
139
+| 73 | | SD_VDD_OVERRIDE | Connect to CM4_3.3V to force SD card/eMMC interface to 1.8V signalling instead of 3.3V, otherwise leave unconnected. Typically only used if external eMMC is connected. |
140
+| 74 | | GND | Ground (0V) |
141
+| 75 | | SD_PWR_ON | Output to power-switch for the SD card. The CM4 sets this pin high (3.3V) to signal that power to the SD card should be turned on. If booting from the SD card is required then a pullup should also be fitted so the power-switch defaults to on. (only available on CM4Lite) |
142
+| 76 | | Reserved | Do not connect anything to this pin. |
143
+| 77 | | +5V | (Input) 4.75V-5.25V. Main power input |
144
+| 78 | | GPIO_VREF | Must be connected to CM4_3.3V (pins 84 and 86) for 3.3V GPIO or CM4_1.8V (pins 88 and 90) for 1.8V GPIO. This pin cannot be floating or connected to ground. |
145
+| 79 | | +5V | (Input) 4.75V-5.25V. Main power input |
146
+| 80 | GPIO45 | SCL0 | I2C clock pin (BCM2711 GPIO45): typically used for Camera and Display. Internal 1.8kΩ pull up to CM4_3.3V |
147
+| 81 | | +5V | (Input) 4.75V-5.25V. Main power input |
148
+| 82 | GPIO44 | SDA0 | I2C Data pin (BCM2711 GPIO44): typically used for Camera and Display. Internal 1.8kΩ pull up to CM4_3.3V |
149
+| 83 | | +5V (Input) | 4.75V-5.25V. Main power input |
150
+| 84 | | CM4_3.3V (Output) | 3.3V ± 2.5%. Power Output max 300mA per pin for a total of 600mA. This will be powered down during power-off or GLOBAL_EN being set low |
151
+| 85 | | +5V (Input) | 4.75V-5.25V. Main power input |
152
+| 86 | | CM4_3.3V (Output) | 3.3V ± 2.5%. Power Output max 300mA per pin for a total of 600mA. This will be powered down during power-off or GLOBAL_EN being set low |
153
+| 87 | | +5V (Input) | 4.75V-5.25V. Main power input |
154
+| 88 | | CM4_1.8V (Output) | 1.8V ± 2.5%. Power Output max 300mA per pin for a total of 600mA. This will be powered down during power-off or GLOBAL_EN being set low |
155
+| 89 | | WL_nDisable | Can be left floating; if driven low the wireless interface will be disabled. Internally pulled up via 1.8kΩ to CM4_3.3V |
156
+| 90 | | CM4_1.8V (Output) | 1.8V ± 2.5%. Power Output max 300mA per pin for a total of 600mA. This will be powered down during power-off or GLOBAL_EN being set low |
157
+| 91 | | BT_nDisable | Can be left floating; if driven low the Bluetooth interface will be disabled. Internally pulled up via 1.8kΩ to CM4_3.3V |
158
+| 92 | | RUN_PG | Bidirectional pin. Can be driven low (via a 220Ω resistor) to reset the CM4 CPU. As an output, a high signals that power is good and CPU is running. Internally pulled up to +3.3V via 10kΩ |
159
+| 93 | | nRPIBOOT | A low on this pin forces booting from an RPI server (e.g. PC or a Raspberry Pi); if not used leave floating. Internally pulled up via 10kΩ to +3.3V |
160
+| 94 | | AnalogIP1 | Analogue input of the MXL7704: typically connected to CC pin of Type C power connector |
161
+| 95 | | PI_LED_nPWR | Active-low output to drive Power On LED. This signal needs to be buffered. |
162
+| 96 | | AnalogIP0 | Analogue input of the MXL7704: typically connected to CC pin of Type C power connector |
163
+| 97 | | Camera_GPIO | Typically used to shut down the camera to reduce power. Reassigning this pin to another function isn’t recommended. CM4_3.3V signalling |
164
+| 98 | | GND Ground (0V) |
165
+| 99 | | GLOBAL_EN | Input. Drive low to power off CM4. Internally pulled up with a 100kΩ to +5V |
166
+| 100 | | nEXTRST | Output. Driven low during reset; Driven high (CM4_3.3V) once CM4 CPU has started to boot |
167
+| 101 | | USB_OTG_ID | Input (3.3V signal) USB OTG Pin. Internally pulled up. When grounded the CM4 becomes a USB host but the correct OS driver also needs to be used |
168
+| 102 | | PCIe_CLK_nREQ | Input (3.3V signal) PCIe clock request pin (low to request PCI clock). Internally pulled up |
169
+| 103 | | USB_N | USB D104 Reserved Do not connect anything to this pin. |
170
+| 105 | | USB_P | USB D+ |
171
+| 106 | | Reserved | Do not connect anything to this pin. |
172
+| 107 | | GND | Ground (0V) |
173
+| 108 | | GND | Ground (0V) |
174
+| 109 | | PCIe_nRST | Output (+3.3V signal) PCIe reset active-low |
175
+| 110 | | PCIe_CLK_P | PCIe clock Out positive (100MHz) NB AC coupling capacitor included on CM4 |
176
+| 111 | | VDAC_COMP | Video DAC output (TV OUT) |
177
+| 112 | | PCIe_CLK_N | PCIe clock Out negative (100MHz) NB AC coupling capacitor included on CM4 |
178
+| 113 | | GND | Ground (0V) |
179
+| 114 | | GND | Ground (0V) |
180
+| 115 | | CAM1_D0_N | Input Camera1 D0 negative |
181
+| 116 | | PCIe_RX_P | Input PCIe GEN 2 RX positive NB external AC coupling capacitor required |
182
+| 117 | | CAM1_D0_P | Input Camera1 D0 positive |
183
+| 118 | | PCIe_RX_N | Input PCIe GEN 2 RX negative NB external AC coupling capacitor required |
184
+| 119 | | GND | Ground (0V) |
185
+| 120 | | GND | Ground (0V) |
186
+| 121 | | CAM1_D1_N | Input Camera1 D1 negative |
187
+| 122 | | PCIe_TX_P | Output PCIe GEN 2 TX positive NB AC coupling capacitor included on CM4 |
188
+| 123 | | CAM1_D1_P | Input Camera1 D1 positive |
189
+| 124 | | PCIe_TX_N | Output PCIe GEN 2 TX positive NB AC coupling capacitor included on CM4 |
190
+| 125 | | GND | Ground (0V) |
191
+| 126 | | GND | Ground (0V) |
192
+| 127 | | CAM1_C_N | Input Camera1 clock negative |
193
+| 128 | | CAM0_D0_N | Input Camera0 D0 negative |
194
+| 129 | | CAM1_C_P | Input Camera1 clock positive |
195
+| 130 | | CAM0_D0_P | Input Camera0 D0 positive |
196
+| 131 | | GND | Ground (0V) |
197
+| 132 | | GND | Ground (0V) |
198
+| 133 | | CAM1_D2_N | Input Camera1 D2 negative |
199
+| 134 | | CAM0_D1_N | Input Camera0 D1 negative |
200
+| 135 | | CAM1_D2_P | Input Camera1 D2 positive |
201
+| 136 | | CAM0_D1_P | Input Camera0 D1 positive |
202
+| 137 | | GND | Ground (0V) |
203
+| 138 | | GND | Ground (0V) |
204
+| 139 | | CAM1_D3_N | Input Camera1 D3 negative |
205
+| 140 | | CAM0_C_N | Input Camera0 clock negative |
206
+| 141 | | CAM1_D3_P | Input Camera1 D3 positive |
207
+| 142 | | CAM0_C_P | Input Camera0 clock positive |
208
+| 143 | | HDMI1_HOTPLUG | Input HDMI1 hotplug. Internally pulled down with a 100kΩ. 5V tolerant. (It can be connected directly to a HDMI connector; a small amount of ESD protection is provided on the CM4 by an on-board HDMI05-CL02F3) |
209
+| 144 | | GND | Ground (0V) |
210
+| 145 | | HDMI1_SDA | Bidirectional HDMI1 SDA. Internally pulled up with a 1.8kΩ. 5V tolerant. (It can be connected directly to a HDMI connector; a small amount of ESD protection is provided on the CM4 by an on-board HDMI05-CL02F3) |
211
+| 146 | | HDMI1_TX2_P | Output HDMI1 TX2 positive |
212
+| 147 | | HDMI1_SCL | Bidirectional HDMI1 SCL. Internally pulled up with a 1.8kΩ. 5V tolerant. (It can beconnected directly to a HDMI connector; a small amount of ESD protection is provided onthe CM4 by an on-board HDMI05-CL02F3) |
213
+| 148 | | HDMI1_TX2_N | Output HDMI1 TX2 negative |
214
+| 149 | GPIO28 | HDMI1_CEC | Input HDMI1 CEC. Internally pulled up with a 27kΩ. 5V tolerant. (It can be connecteddirectly to a HDMI connector; a small amount of ESD protection is provided on the CM4by an on-board HDMI05-CL02F3) |
215
+| 150 | | GND | Ground (0V) |
216
+| 151 | | HDMI0_CEC | Input HDMI0 CEC. Internally pulled up with a 27kΩ. 5V tolerant (It can be connecteddirectly to a HDMI connector; a small amount of ESD protection is provided on the CM4by an on-board HDMI05-CL02F3) |
217
+| 152 | | HDMI1_TX1_P | Output HDMI1 TX1 positive |
218
+| 153 | | HDMI0_HOTPLUG | Input HDMI0 hotplug. Internally pulled down 100kΩ. 5V tolerant. (It can be connecteddirectly to a HDMI connector; a small amount of ESD protection is provided on the CM4by an on-board HDMI05-CL02F3) |
219
+| 154 | | HDMI1_TX1_N | Output HDMI1 TX1 negative |
220
+| 155 | | GND | Ground (0V) |
221
+| 156 | | GND | Ground (0V) |
222
+| 157 | | DSI0_D0_N | Output Display0 D0 negative |
223
+| 158 | | HDMI1_TX0_P | Output HDMI1 TX0 positive |
224
+| 159 | | DSI0_D0_P | Output Display0 D0 positive |
225
+| 160 | | HDMI1_TX0_N | Output HDMI1 TX0 negative |
226
+| 161 | | GND | Ground (0V) |
227
+| 162 | | GND | Ground (0V) |
228
+| 163 | | DSI0_D1_N | Output Display0 D1 negative |
229
+| 164 | | HDMI1_CLK_P | Output HDMI1 clock positive |
230
+| 165 | | DSI0_D1_P | Output Display0 D1 positive |
231
+| 166 | | HDMI1_CLK_N | Output HDMI1 clock negative |
232
+| 167 | | GND | Ground (0V) |
233
+| 168 | | GND | Ground (0V) |
234
+| 169 | | DSI0_C_N | Output Display0 clock negative |
235
+| 170 | | HDMI0_TX2_P | Output HDMI0 TX2 positive |
236
+| 171 | | DSI0_C_P | Output Display0 clock positive |
237
+| 172 | | HDMI0_TX2_N | Output HDMI0 TX2 negative |
238
+| 173 | | GND | Ground (0V) |
239
+| 174 | | GND | Ground (0V) |
240
+| 175 | | DSI1_D0_N | Output Display1 D0 negative |
241
+| 176 | | HDMI0_TX1_P | Output HDMI0 TX1 positive |
242
+| 177 | | DSI1_D0_P | Output Display1 D0 positive |
243
+| 178 | | HDMI0_TX1_N | Output HDMI0 TX1 negative |
244
+| 179 | | GND | Ground (0V) |
245
+| 180 | | GND | Ground (0V) |
246
+| 181 | | DSI1_D1_N | Output Display1 D1 negative |
247
+| 182 | | HDMI0_TX0_P | Output HDMI0 TX0 positive |
248
+| 183 | | DSI1_D1_P | Output Display1 D1 positive |
249
+| 184 | | HDMI0_TX0_N | Output HDMI0 TX0 negative |
250
+| 185 | | GND | Ground (0V) |
251
+| 186 | | GND | Ground (0V) |
252
+| 187 | | DSI1_C_N | Output Display1 clock negative |
253
+| 188 | | HDMI0_CLK_P | Output HDMI0 clock positive |
254
+| 189 | | DSI1_C_P | Output Display1 clock positive |
255
+| 190 | | HDMI0_CLK_N | Output HDMI0 clock negative |
256
+| 191 | | GND | Ground (0V) |
257
+| 192 | | GND | Ground (0V) |
258
+| 193 | | DSI1_D2_N | Output Display1 D2 negative |
259
+| 194 | | DSI1_D3_N | Output Display1 D3 negative |
260
+| 195 | | DSI1_D2_P | Output Display1 D2 positive |
261
+| 196 | | DSI1_D3_P | Output Display1 D3 positive |
262
+| 197 | | GND | Ground (0V) |
263
+| 198 | | GND | Ground (0V) |
264
+| 199 | | HDMI0_SDA | Bidirectional HDMI0 SDA. Internally pulled up with a 1.8kΩ. 5V tolerant. (It can be connected directly to a HDMI connector; a small amount of ESD protection is provided on the CM4 by an on-board HDMI05-CL02F3) |
265
+| 200 | | HDMI0_SCL | Bidirectional HDMI0 SCL. Internally pulled up with a 1.8kΩ. 5V tolerant. (It can be connected directly to a HDMI connector; a small amount of ESD protection is provided on the CM4 by an on-board HDMI05-CL02F3) |
... ...
\ No newline at end of file
Tech-dat/SBC-dat/RPI-dat/RPI-CM4-expansion-board-dat/RPI-CM4-expansion-board-dat.md
... ...
@@ -81,3 +81,4 @@
81 81
82 82
- [[RPI-CM4-expansion-board]]
83 83
84
+- official clone - https://oshwlab.com/stateblood/compute-module-4
... ...
\ No newline at end of file
Tech-dat/SBC-dat/RPI-dat/RPI-dat.md
... ...
@@ -1,15 +1,16 @@
1 1
2 2
# raspberry pi dat
3 3
4
+- [[RPI3-dat]] - [[RPI-CM4-dat]] - [[RPI-CM4-expansion-board-dat]]
5
+
6
+- [[RPI-zero-dat]]
7
+
8
+- official documentation - https://www.raspberrypi.com/documentation/
4 9
5 10
## hardware
6 11
7 12
- [[rpi-pin-dat]]
8 13
9
-- [[RPI3-dat]]
10
-
11
-- [[RPI-CM4-dat]] - [[RPI-CM4-expansion-board-dat]]
12
-
13 14
- [[RPI-OS-dat]]
14 15
15 16
... ...
@@ -17,14 +18,18 @@
17 18
18 19
In summary, the Raspberry Pi 3 can deliver a maximum of 50 mA to 150 mA from the 3.3V GPIO pins, but care should be taken not to exceed the individual pin limit of 16 mA for each GPIO pin. Always ensure that the total current drawn does not exceed the recommended limits to avoid damaging the board.
19 20
20
-## 3.3V power delivery
21
+### 3.3V power delivery
21 22
22 23
All Raspberry Pi since the Model B+ can provide quite a bit more, up to 500mA to remain on the safe side, thanks to a switching regulator.
23 24
24 25
- ref - https://pinout.xyz/pinout/pin1_3v3_power/#:~:text=The%203v3%20supply%20pin%20on,regulator%20for%203.3v%20projects.
25 26
26 27
27
-## Shields
28
+### chip
29
+
30
+- [[BCM2835-dat]] - [[BCM2711-dat]]
31
+
32
+### Boards and Shields
28 33
29 34
- [[MPC1029-dat]]
30 35
... ...
@@ -32,17 +37,39 @@ All Raspberry Pi since the Model B+ can provide quite a bit more, up to 500mA to
32 37
33 38
- BCM2711B0: cortex-A72
34 39
40
+## Usage and Software
41
+
42
+copy file to /boot/myfiles
43
+
44
+ To get files across you put the SD into your PC and make a folder (lets say myfiles) on the SD card for your files and put your files in there.
45
+
46
+ Then, when you plug the SD card back into your RPi, these files are available in a folder called /boot/myfiles.
35 47
48
+ You can then copy them to anywhere you need on your RPi
36 49
50
+or use a USB driver
51
+
52
+
53
+You can log in using the default username: “pi” and the default password: “raspberry”.
54
+
55
+For raspberry pi OS: raspi-config config "administrator" password to "pi"
56
+
57
+ root@2W:/boot# lsblk
58
+
59
+ NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
60
+ sda 8:0 1 14.8G 0 disk
61
+ └─sda1 8:1 1 14.8G 0 part /media/administrator/_¼Ӿ_
62
+ mmcblk0 179:0 0 15G 0 disk
63
+ ├─mmcblk0p1 179:1 0 512M 0 part /boot/firmware
64
+ └─mmcblk0p2 179:2 0 14.5G 0 part /
65
+
66
+ cd /media/administrator/_¼Ӿ_
37 67
38 68
## I2C
39 69
40 70
- turn on I2C functions at [[raspi-config]]
41 71
42 72
43
-## chip
44
-
45
-- [[BCM2835-dat]] - [[BCM2711-dat]]
46 73
47 74
48 75
## demo code
... ...
@@ -62,5 +89,7 @@ can use commands nohup to run script in background for long term.
62 89
- RPI prog - https://github.com/Edragon/RPI-PROG
63 90
- RPI serial - https://github.com/Edragon/RPI-Serial
64 91
92
+## Competitors
65 93
94
+- [[RK3588-dat]] - [[rocketchip-dat]]
66 95
Tech-dat/SBC-dat/RPI-dat/RPI-pin-dat/RPI-pin-dat.md
... ...
@@ -36,6 +36,8 @@
36 36
![](2024-10-03-20-12-54.png)
37 37
38 38
39
+
40
+
39 41
## ref
40 42
41 43
- [[RPI-dat]] - [[rpi-python-dat]]
... ...
\ No newline at end of file
Tech-dat/SBC-dat/RPI-dat/RPI-zero-2W-dat/2024-11-13-16-34-59.png
... ...
Binary files a/Tech-dat/SBC-dat/RPI-dat/RPI-zero-2W-dat/2024-11-13-16-34-59.png and /dev/null differ
Tech-dat/SBC-dat/RPI-dat/RPI-zero-2W-dat/RPI-zero-2W-dat.md
... ...
@@ -1,20 +0,0 @@
1
-
2
-# RPI-zero-2W-dat
3
-
4
-【Raspberry Pi Zero 2W Features】
5
-
6
-- Broadcom BCM2710A1, 1GHz quad-core 64-bit Arm Cortex-A53 CPU
7
-- 512MB LPDDR2 SDRAM
8
-- 2.4GHz 802.11 b/g/n wireless LAN
9
-- Bluetooth 4.2, Bluetooth Low Energy (BLE), onboard antenna
10
-- Mini HDMI-compatible port and micro USB On-The-Go (OTG) port
11
-- microSD card slot
12
-- CSI-2 camera connector
13
-- HAT-compatible 40-pin header footprint (unpopulated)
14
-- Micro USB power
15
-- Composite video and reset pins via solder test points
16
-- H.264, MPEG-4 decode (1080p30); H.264 encode (1080p30)
17
-- OpenGL ES 1.1, 2.0 graphics
18
-
19
-
20
-![](2024-11-13-16-34-59.png)
... ...
\ No newline at end of file
Tech-dat/SBC-dat/RPI-dat/RPI-zero-dat/2024-11-13-16-34-59.png
... ...
Binary files /dev/null and b/Tech-dat/SBC-dat/RPI-dat/RPI-zero-dat/2024-11-13-16-34-59.png differ
Tech-dat/SBC-dat/RPI-dat/RPI-zero-dat/RPI-zero-dat.md
... ...
@@ -0,0 +1,30 @@
1
+
2
+# RPI-zero-dat
3
+
4
+【Raspberry Pi Zero 2W Features】
5
+
6
+- Broadcom BCM2710A1, 1GHz quad-core 64-bit Arm Cortex-A53 CPU
7
+- 512MB LPDDR2 SDRAM
8
+- 2.4GHz 802.11 b/g/n wireless LAN
9
+- Bluetooth 4.2, Bluetooth Low Energy (BLE), onboard antenna
10
+- Mini HDMI-compatible port and micro USB On-The-Go (OTG) port
11
+- microSD card slot
12
+- CSI-2 camera connector
13
+- HAT-compatible 40-pin header footprint (unpopulated)
14
+- Micro USB power
15
+- Composite video and reset pins via solder test points
16
+- H.264, MPEG-4 decode (1080p30); H.264 encode (1080p30)
17
+- OpenGL ES 1.1, 2.0 graphics
18
+
19
+
20
+![](2024-11-13-16-34-59.png)
21
+
22
+
23
+## Common Needed Accessories
24
+
25
+- micro HDMI cable or converter
26
+- microUSB expansion USB hub or cable
27
+- MicroUSB power cable
28
+
29
+
30
+
Tech-dat/Sensor-dat/CT-VT-dat/ZMCT103-dat/2024-12-04-18-44-22.png
... ...
Binary files /dev/null and b/Tech-dat/Sensor-dat/CT-VT-dat/ZMCT103-dat/2024-12-04-18-44-22.png differ
Tech-dat/Sensor-dat/CT-VT-dat/ZMCT103-dat/ZMCT103-dat.md
... ...
@@ -0,0 +1,14 @@
1
+
2
+# ZMCT103-dat
3
+
4
+ZMCT103C
5
+
6
+- Model: ZMCT103C
7
+- Brand: ZM
8
+- Package: DIP
9
+- Packaging: Boxed
10
+- Quality: 100% brand new, original and genuine
11
+
12
+![](2024-12-04-18-44-22.png)
13
+
14
+Note: Ratio 1000:1
... ...
\ No newline at end of file
Tech-dat/Sensor-dat/CT-VT-dat/ZMPT107-dat/2024-12-04-18-43-01.png
... ...
Binary files /dev/null and b/Tech-dat/Sensor-dat/CT-VT-dat/ZMPT107-dat/2024-12-04-18-43-01.png differ
Tech-dat/Sensor-dat/CT-VT-dat/ZMPT107-dat/ZMPT107-dat.md
... ...
@@ -0,0 +1,18 @@
1
+
2
+# ZMPT107-dat
3
+
4
+ZMPT107-1
5
+
6
+- Model: ZMPT107
7
+- Brand: ZM
8
+- Package: DIP2
9
+- Packaging: Boxed
10
+- Quality: 100% brand new, original and genuine
11
+
12
+![](2024-12-04-18-43-01.png)
13
+
14
+Note: ratio: 1000:1000
15
+
16
+## ref
17
+
18
+- [[ZMPT107]]
... ...
\ No newline at end of file
Tech-dat/application-dat/alarm-dat/alarm-dat.md
... ...
@@ -0,0 +1,4 @@
1
+
2
+# alarm dat
3
+
4
+- [[SCU1080-dat]]
... ...
\ No newline at end of file
Tech-dat/application-dat/fan-dat/fan-dat.md
... ...
@@ -0,0 +1,51 @@
1
+
2
+# fan-dat
3
+
4
+## Inspect Control Circuitry
5
+
6
+- Fan Speed Controller (if applicable): If the fan uses a speed controller or PWM signal, ensure that the controller is functioning and providing a signal to the fan.
7
+- Transistors or MOSFETs: Check for faulty transistors or MOSFETs in the control circuit using a multimeter.
8
+- Check Capacitors: Inspect capacitors in the control circuit for bulging or leakage, as they might need replacement.
9
+
10
+
11
+## failed blade
12
+
13
+
14
+### Stuck or Jammed Bearings
15
+
16
+Symptom: The fan requires manual assistance to start and might run slower than usual.
17
+
18
+Solution:
19
+- Remove the fan from its mount and inspect the bearings for dust or debris.
20
+- Clean the bearings and apply a small amount of lubricant, such as machine oil or WD-40.
21
+- Check for signs of wear or damage to the shaft or bearings. Replace them if necessary.
22
+
23
+### Insufficient Startup Torque
24
+
25
+Symptom: The motor doesn’t generate enough force to overcome initial resistance.
26
+
27
+Causes:
28
+- Low input voltage.
29
+- Damaged or worn-out motor windings.
30
+
31
+Solution:
32
+- Verify the power supply voltage matches the fan's specifications.
33
+- Test the motor windings' resistance using a multimeter. Replace the motor if the resistance is out of range.
34
+
35
+### Weak or Failing Capacitor
36
+
37
+Symptom: The fan only starts when blades are pushed, especially in capacitor-start motors.
38
+
39
+Solution:
40
+- Locate the capacitor on the fan's circuit board.
41
+- Use a multimeter with a capacitance setting to test the capacitor.
42
+- Replace the capacitor if it shows low or no capacitance.
43
+
44
+### Faulty Driver Circuit or PWM Signal
45
+
46
+Symptom: The fan struggles to start, especially in speed-controlled or brushless DC fans.
47
+
48
+Solution:
49
+- Inspect the control circuit for damage (e.g., transistors, MOSFETs, or ICs).
50
+- If a pulse-width modulation (PWM) signal controls the fan, ensure the signal is present and within the correct range.
51
+- Bypass the control circuit and directly connect the fan to a power source to see if it runs without assistance.
... ...
\ No newline at end of file
Tech-dat/application/alarm-dat.md
... ...
@@ -1,4 +0,0 @@
1
-
2
-# alarm dat
3
-
4
-- [[SCU1080-dat]]
... ...
\ No newline at end of file
Tech-dat/interactive-dat/LED-strip-dat/2024-12-08-18-19-20.png
... ...
Binary files /dev/null and b/Tech-dat/interactive-dat/LED-strip-dat/2024-12-08-18-19-20.png differ
Tech-dat/interactive-dat/LED-strip-dat/led-strip-dat.md
... ...
@@ -15,17 +15,25 @@
15 15
## power supply power adapter
16 16
- [[CPP1040-dat]]
17 17
18
+https://www.electrodragon.com/?product=wall-adapter-power-supply
19
+
20
+
21
+
22
+
18 23
## control box
19 24
- [[ILSS001-dat]]
20 25
- [[NWI1126-dat]]
21 26
27
+https://www.electrodragon.com/?product=led-strips-control-box-and-remote-controller
22 28
23
-
24
-## Modify
29
+## Modify / cutting or connecting
25 30
26 31
27 32
![](2024-01-13-11-57-11.png)
28 33
34
+![](2024-12-08-18-19-20.png)
35
+
36
+
29 37
## Protection Type
30 38
31 39
![](2024-01-13-12-00-58.png)
board-series-dat/RMP-driver-dat/2024-12-06-18-10-13.png
... ...
Binary files /dev/null and b/board-series-dat/RMP-driver-dat/2024-12-06-18-10-13.png differ
board-series-dat/RMP-driver-dat/RMP-driver-dat.md
... ...
@@ -11,7 +11,7 @@
11 11
12 12
## matrix panel
13 13
14
-- [[led-rgb-panel-dat]]
14
+- [[led-rgb-panel-dat]] - [[RPI-pin-dat]] - [[rpi-dat]]
15 15
16 16
## knowledge
17 17
... ...
@@ -65,6 +65,14 @@ ref
65 65
- reference link - https://github.com/hzeller/rpi-rgb-led-matrix/blob/a3eea997a9254b83ab2de97ae80d83588f696387/wiring.md
66 66
67 67
68
+### Extra GPIOs for [[MPC1073-dat]]
69
+
70
+- Toggle Switch to left side to discard using P2 chain, and use free pin GPIO2 and GPIO3
71
+
72
+![](2024-12-06-18-10-13.png)
73
+
74
+
75
+
68 76
69 77
70 78
... ...
@@ -72,6 +80,11 @@ ref
72 80
73 81
- [[RMP-RPI-CM4-dat]]
74 82
83
+
84
+
85
+
86
+
87
+
75 88
## ref
76 89
77 90
- [[RPI-dat]] - [[RMP-driver]]
code-dat/wiringpi-dat/wiringpi-dat.md
... ...
@@ -3,6 +3,46 @@
3 3
4 4
https://github.com/WiringPi/WiringPi/releases
5 5
6
+## install arm64
7
+
8
+https://github.com/WiringPi/WiringPi/releases/tag/3.10
9
+
10
+ wget https://github.com/WiringPi/WiringPi/releases/download/3.10/wiringpi_3.10_arm64.deb
11
+
12
+ apt install ./wiringpi_3.10_arm64.deb
13
+
14
+
15
+
16
+ root@rpi:/home/admin# gpio readall
17
+ +-----+-----+---------+------+---+---Pi ?---+---+------+---------+-----+-----+
18
+ | BCM | wPi | Name | Mode | V | Physical | V | Mode | Name | wPi | BCM |
19
+ +-----+-----+---------+------+---+----++----+---+------+---------+-----+-----+
20
+ | | | 3.3v | | | 1 || 2 | | | 5v | | |
21
+ | 2 | 8 | SDA.1 | IN | 1 | 3 || 4 | | | 5v | | |
22
+ | 3 | 9 | SCL.1 | IN | 1 | 5 || 6 | | | 0v | | |
23
+ | 4 | 7 | GPIO. 7 | IN | 1 | 7 || 8 | 1 | IN | TxD | 15 | 14 |
24
+ | | | 0v | | | 9 || 10 | 1 | IN | RxD | 16 | 15 |
25
+ | 17 | 0 | GPIO. 0 | IN | 0 | 11 || 12 | 0 | IN | GPIO. 1 | 1 | 18 |
26
+ | 27 | 2 | GPIO. 2 | IN | 0 | 13 || 14 | | | 0v | | |
27
+ | 22 | 3 | GPIO. 3 | IN | 0 | 15 || 16 | 0 | IN | GPIO. 4 | 4 | 23 |
28
+ | | | 3.3v | | | 17 || 18 | 0 | IN | GPIO. 5 | 5 | 24 |
29
+ | 10 | 12 | MOSI | IN | 0 | 19 || 20 | | | 0v | | |
30
+ | 9 | 13 | MISO | IN | 0 | 21 || 22 | 0 | IN | GPIO. 6 | 6 | 25 |
31
+ | 11 | 14 | SCLK | IN | 0 | 23 || 24 | 1 | IN | CE0 | 10 | 8 |
32
+ | | | 0v | | | 25 || 26 | 1 | IN | CE1 | 11 | 7 |
33
+ | 0 | 30 | SDA.0 | IN | 1 | 27 || 28 | 1 | IN | SCL.0 | 31 | 1 |
34
+ | 5 | 21 | GPIO.21 | IN | 1 | 29 || 30 | | | 0v | | |
35
+ | 6 | 22 | GPIO.22 | IN | 1 | 31 || 32 | 0 | IN | GPIO.26 | 26 | 12 |
36
+ | 13 | 23 | GPIO.23 | IN | 0 | 33 || 34 | | | 0v | | |
37
+ | 19 | 24 | GPIO.24 | IN | 0 | 35 || 36 | 0 | IN | GPIO.27 | 27 | 16 |
38
+ | 26 | 25 | GPIO.25 | IN | 0 | 37 || 38 | 0 | IN | GPIO.28 | 28 | 20 |
39
+ | | | 0v | | | 39 || 40 | 0 | IN | GPIO.29 | 29 | 21 |
40
+ +-----+-----+---------+------+---+----++----+---+------+---------+-----+-----+
41
+ | BCM | wPi | Name | Mode | V | Physical | V | Mode | Name | wPi | BCM |
42
+ +-----+-----+---------+------+---+---Pi ?---+---+------+---------+-----+-----+
43
+
44
+
45
+
6 46
## install method 1
7 47
8 48
Unzip/use the portable prebuilt verison:
service-dat/refund-dat/refund-dat.md
... ...
@@ -0,0 +1,13 @@
1
+
2
+# refund-dat
3
+
4
+
5
+## credit card refund
6
+
7
+According to payment system "stripe":
8
+
9
+ Refunds take 5-10 days to appear on a customer's statement. Stripe's fees for the original payment won't be returned, but there are no additional fees for the refund.
10
+
11
+## Paypal refund
12
+
13
+- should be instantly
... ...
\ No newline at end of file