gpio_control

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
gpio_control [2021/11/21 09:12] – [RTL8380 pin muxing] Add GPIO1, 15-18 svanheulegpio_control [2025/01/15 10:56] (current) – Update RTL8390 pin muxing table svanheule
Line 1: Line 1:
 ====== GPIO control ====== ====== GPIO control ======
  
-===== RTL8380 pin muxing ===== 
- 
-^ Peripheral ^ Package pin ^ GPIO index ^ Alternative function ^ Pin configuration ^ 
-| System LED | 113 | 0 | sys-led | Use the SYS_LED_EN bit in LED_GLB_CTRL to mux sys-led peripheral | 
-| GPIO1 | 112 | 1 | N/A | No known alternative functions | 
-| RTL8231 MIIM bus | 111 | 2 | MDC  | Setting the enable bit (BIT(0)) in the EXTRA_GPIO_CTRL register (0xBB00A0E0) selects the MIIM peripheral, otherwise the GPIO function is used. | 
-| :::              | 110 | 3 | MDIO | ::: | 
-| UART1 | 116 | ? | RX | Setting BIT(4) in GMII_INTF_SEL (0xBB001000) enables UART1, Clearing BIT(4) selects SPI_SLAVE mode. | 
-| :::   | 117 | ? | TX | ::: | 
-| JTAG | 29 | 12 | TMS   | BIT(2) and BIT(3) in GMII_INTF_SEL (0xBB001000) allow selecting the JTAG interface. | 
-| :::  | 28 | 13 | TCK   | ::: | 
-| :::  | 32 | 14 | /TRST | ::: | 
-| :::  | 30 | 10 | TDO   | ::: | 
-| :::  | 31 | 11 | TDI   | ::: | 
-| GPIO15 | ? | 15 | N/A | Configured by the [[GS310TP]], no known mux or pin location | 
-| GPIO16 | ? | 16 | N/A | Configured by the [[GS310TP]], no known mux or pin location 
-| GPIO17 | ? | 17 | N/A | Configured by the [[GS310TP]], no known mux or pin location 
-| GPIO18 | ? | 18 | N/A | Configured by the [[GS310TP]], no known mux or pin location 
 ===== Built-in GPIO ===== ===== Built-in GPIO =====
  
Line 36: Line 18:
 | 0x14 | IMR_LOW    | Low port interrupt mask register. Each port has two bits to indicate on which edges the pin should trigger. Set the lowest bit to trigger on falling edges, the highest bit to trigger on rising edges, or both to trigger on both edges. \\ Register is packed as two big-endian U16 values, the first port at sub-offset 0x0, the second at sub-offset 0x2. | | 0x14 | IMR_LOW    | Low port interrupt mask register. Each port has two bits to indicate on which edges the pin should trigger. Set the lowest bit to trigger on falling edges, the highest bit to trigger on rising edges, or both to trigger on both edges. \\ Register is packed as two big-endian U16 values, the first port at sub-offset 0x0, the second at sub-offset 0x2. |
 | 0x18 | IMR_HIGH   | High port interrupt mask register, see IMR_LOW.\\ Register is packed as two big-endian U16 values, the third port at sub-offset 0x0, the fourth at sub-offset 0x2. | | 0x18 | IMR_HIGH   | High port interrupt mask register, see IMR_LOW.\\ Register is packed as two big-endian U16 values, the third port at sub-offset 0x0, the fourth at sub-offset 0x2. |
 +| 0x38 | C0_IER     | (optional) VPE0 interrupt enable register.\\ Enables routing of GPIO interrupts to VPE0. |
 +| 0x3C | C1_IER     | (optional) VPE1 interrupt enable register.\\ Enables routing of GPIO interrupts to VPE1. |
 +
 +===== RTL8380 pin muxing =====
 +
 +^ Peripheral ^ Package pin ^ GPIO index ^ Alternative function ^ Pin configuration ^
 +| System LED | 113 | 0 | sys-led | Use the SYS_LED_EN bit in LED_GLB_CTRL to mux sys-led peripheral |
 +| GPIO1 | 112 | 1 | N/A | No known alternative functions |
 +| RTL8231 MIIM bus | 111 | 2 | MDC  | Setting the enable bit (BIT(0)) in the EXTRA_GPIO_CTRL register (0xBB00A0E0) selects the MIIM peripheral, otherwise the GPIO function is used. |
 +| :::              | 110 | 3 | MDIO | ::: |
 +| UART1 | 116 | ? | RX | Setting BIT(4) in GMII_INTF_SEL (0xBB001000) enables UART1, Clearing BIT(4) selects SPI_SLAVE mode. |
 +| :::   | 117 | ? | TX | ::: |
 +| GPIO8 | ? | 8 | N/A | Configured by the [[GS1900-24EP]], no known mux or pin location |
 +| GPIO9 | ? | 9 | N/A | Configured by the [[GS1900-24EP]], no known mux or pin location |
 +| JTAG | 29 | 12 | TMS   | BIT(2) and BIT(3) in GMII_INTF_SEL (0xBB001000) allow selecting the JTAG interface. \\ Set to 0 for JTAG (default), 2 for GPIO. |
 +| :::  | 28 | 13 | TCK   | ::: |
 +| :::  | 32 | 14 | /TRST | ::: |
 +| :::  | 30 | 10 | TDO   | ::: |
 +| :::  | 31 | 11 | TDI   | ::: |
 +| GPIO15 | ? | 15 | N/A | Configured by the [[GS310TP]] and [[GS1900-24EP]], no known mux or pin location |
 +| GPIO16 | ? | 16 | N/A | Configured by the [[GS310TP]] and [[GS1900-24EP]], no known mux or pin location |
 +| GPIO17 | ? | 17 | N/A | Configured by the [[GS310TP]] and [[GS1900-24EP]], no known mux or pin location |
 +| GPIO18 | ? | 18 | N/A | Configured by the [[GS310TP]] and [[GS1900-24EP]], no known mux or pin location |
 +| GPIO19 | ? | 19 | N/A | Configured by the [[GS1900-24EP]], no known mux or pin location |
 +| GPIO20 | ? | 20 | N/A | Configured by the [[GS1900-24EP]], no known mux or pin location |
 +| GPIO21 | ? | 21 | N/A | Configured by the [[GS1900-24EP]], no known mux or pin location |
 +| GPIO22 | ? | 22 | N/A | Configured by the [[GS1900-24EP]], no known mux or pin location |
 +| GPIO23 | ? | 23 | N/A | Configured by the [[GS1900-24EP]], no known mux or pin location | 
 +
 +===== RTL8390 pin muxing =====
 +
 +^ Peripheral ^ Package pin ^ GPIO index ^ Alternative function ^ Pin configuration ^
 +| System LED |  | 0 | sys-led | Use the SYS_LED_EN bit in LED_GLB_CTRL to mux sys-led peripheral |
 +| RTL8231 MIIM bus |  | 1 | MDC  |  |
 +| :::              |  | 2 | MDIO | ::: |
 +| JTAG |  | 3 | TMS   | Set JTAG_SEL to 0 (default) for JTAG, 2 for GPIO |
 +| :::  |  | 4 | TCK   | ::: |
 +| :::  |  | 5 | /TRST | ::: |
 +| :::  |  | 6 | TDI   | ::: |
 +| :::  |  | 7 | TDO   | ::: |
 +| UART1 |  | 3 | /RTS | Set JTAG_SEL to 1 for UART1, 2 for GPIO |
 +| :::   |  | 4 | /CTS | ::: |
 +| :::   |  | 6 | RXD   | ::: |
 +| :::   |  | 7 | TXD   | ::: |
 +| SPI CS |  | 8 | /CS2 | Set SPI_CS_IF_SEL to 1 for extra chip selects, 0 for GPIO |
 +| :::    |  | 9 | /CS3 | ::: |
 +| IEEE 1588 |  | 12 |  | OUTPUT_1588_SEL |
 +
  
 ===== External GPIO ===== ===== External GPIO =====
 The SoCs have been designed with the [[RTL8231]] GPIO expanders in mind as a first-class citizen. The SoCs have been designed with the [[RTL8231]] GPIO expanders in mind as a first-class citizen.
-A hardware peripheral is present that can keep track of the state of one (or two on RTL9310) RTL8231 chip(s).+A hardware peripheral is present that can keep track of the state of one (or two on RTL93xx) RTL8231 chip(s). 
 +The SoC's have dedicated pins and controllers for this task. For rtl930x B6 `EXT_GPIO_MDIO` and A5 `EXT_GPIO_MDC` For rtl931x, AM25: `GPIO_MDC` and AL25: `GPIO_MDIO`. This does require the RTL8231 connected to only function as GPIO expander. This should not be confused with the dedicated `LED_MDxx` pins!
  
 To allow direct access to the devices, a raw command can be sent. For RTL8380 and RTL8390, there is no indication of request failure. RTL9300 and RTL9310 do have a flag to indicate failed read commands. To allow direct access to the devices, a raw command can be sent. For RTL8380 and RTL8390, there is no indication of request failure. RTL9300 and RTL9310 do have a flag to indicate failed read commands.
Line 58: Line 89:
 | 0x1188 | ISR_LOW    | Interrupt status register | | 0x1188 | ISR_LOW    | Interrupt status register |
 | 0x118C | ISR_HIGH   | Interrupt status register | | 0x118C | ISR_HIGH   | Interrupt status register |
 +
 +==== RTL930x muxing ====
 +The RTL930x doesn't have a dedicated muxing section in the address space. Instead, the GPIO pin muxing is all over the SoC's addressing space, so this will be a challange. A dedicated page exists to inventory the [[rtl93xx:gpio_space|GPIO mux registers]].
  • gpio_control.1637485928.txt.gz
  • Last modified: 2021/11/21 09:12
  • by svanheule