led_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
led_control [2021/02/22 08:14] – biotled_control [2025/01/06 19:30] (current) – Add LED modes from Realtek docs svanheule
Line 13: Line 13:
 Both the RTL838x and the RTL839x have a LED control register, named ''RTL83XX_LED_GLB_CTRL'', which allows to enable and configure the serial LED interface and control the system LED. Both the RTL838x and the RTL839x have a LED control register, named ''RTL83XX_LED_GLB_CTRL'', which allows to enable and configure the serial LED interface and control the system LED.
  
-Manual control seems necessary in case where serially connected LEDs are not used as port-leds (such as additional status LEDs for PoE, "cloud connection" and the like). In that case it appears that the setup of all the serial LEDs is too complex to be controlled by the SoC alone. The user needs to disable SoC control over *all* the serially connected LEDs in that case. On both the RTL839x and RTL838x, software control is enabled by setting the respective bits in the ''RTL83XX_LED_SW_P_EN_CTRL(port)'' register. One of these registers holds the settings for 10 ports and 3 bits define the state of the LED:+Manual control seems necessary in case where serially connected LEDs are not used as port-leds (such as additional status LEDs for PoE, "cloud connection" and the like). In that case it appears that the setup of all the serial LEDs is too complex to be controlled by the SoC alone. The user needs to disable SoC control over **all** the serially connected LEDs in that case. On both the RTL839x and RTL838x, software control is enabled by setting the respective bits in the ''RTL83XX_LED_SW_P_EN_CTRL(port)'' register. One of these registers holds the settings for 10 ports and 3 bits define the state of the LED:
   * 0x0: SoC controls LED   * 0x0: SoC controls LED
   * 0x1: One Single Color LED connected here   * 0x1: One Single Color LED connected here
Line 29: Line 29:
 ^ Offset ^ Name ^ Description ^ ^ Offset ^ Name ^ Description ^
 | 0x00 | [[#Global LED control|LED_GLB_CTRL]] | | | 0x00 | [[#Global LED control|LED_GLB_CTRL]] | |
-| 0x04 | [[#Port LED mode control|''LED_MODE_CTRL'']] | |+| 0x04 | [[#Port LED mode control|LED_MODE_CTRL]] | |
 | 0x08 | ''LED_P_EN_CTRL'' | Bit mask indicating which LEDs are ASIC controlled. Bit position corresponds to the MAC/phy number. Set to 1 to enable the LED output for this phy. | | 0x08 | ''LED_P_EN_CTRL'' | Bit mask indicating which LEDs are ASIC controlled. Bit position corresponds to the MAC/phy number. Set to 1 to enable the LED output for this phy. |
 | 0x0C | ''LED_SW_CTRL'' | | | 0x0C | ''LED_SW_CTRL'' | |
 | 0x10+4×n | ''LED_n_SW_P_EN_CTRL'' | LED index n = {0, 1, 2}. Bit mask indicating which LEDs are controlled by the user. Bit position corresponds to the MAC/phy number. Set to 0 for automatic control, 1 for manual control. The corresponding bit in LED_P_EN_CTRL must also be set for this setting to be effective. | | 0x10+4×n | ''LED_n_SW_P_EN_CTRL'' | LED index n = {0, 1, 2}. Bit mask indicating which LEDs are controlled by the user. Bit position corresponds to the MAC/phy number. Set to 0 for automatic control, 1 for manual control. The corresponding bit in LED_P_EN_CTRL must also be set for this setting to be effective. |
-| 0x1C+4×p | [[#Port LED user control|''LED_SW_P_p_CTRL'']] | Port index p = {0, .., 27} |+| 0x1C+4×p | [[#Port LED user control|LED_SW_P_p_CTRL]] | Port index p = {0, .., 27} |
 | 0x8C + 4×i | ''EXT_GPIO_DIR_i_CTRL'' | i = floor(index/32), index = {0, .., 54} | | 0x8C + 4×i | ''EXT_GPIO_DIR_i_CTRL'' | i = floor(index/32), index = {0, .., 54} |
 | 0x94 + 4×i | ''EXT_GPIO_DATA_i_CTRL'' | i = floor(index/32), index = {0, .., 54} | | 0x94 + 4×i | ''EXT_GPIO_DATA_i_CTRL'' | i = floor(index/32), index = {0, .., 54} |
-| 0x9C | [[#Extra GPIO command register|''EXT_GPIO_INDIRECT_ACCESS'']] | |+| 0x9C | [[#Extra GPIO command register|EXT_GPIO_INDIRECT_ACCESS]] | |
 | 0xA0 | ''LED_LOAD_LV1'' | | | 0xA0 | ''LED_LOAD_LV1'' | |
 | 0xA4 | ''LED_LOAD_LV2'' | | | 0xA4 | ''LED_LOAD_LV2'' | |
 | 0xA8 | ''LED_LOAD_LV3'' | | | 0xA8 | ''LED_LOAD_LV3'' | |
-| 0xAC+4×k | [[#Port LED status registers|''LED0_LO_STSk_CTRL'']] | Low ports LED0 status control | +| 0xAC+4×k | [[#Port LED status registers|LED0_LO_STSk_CTRL]] | Low ports LED0 status control | 
-| 0xB8+4×k | [[#Port LED status registers|''LED1_LO_STSk_CTRL'']] | Low ports LED1 status control | +| 0xB8+4×k | [[#Port LED status registers|LED1_LO_STSk_CTRL]] | Low ports LED1 status control | 
-| 0xC4+4×k | [[#Port LED status registers|''LED2_LO_STSk_CTRL'']] | Low ports LED2 status control | +| 0xC4+4×k | [[#Port LED status registers|LED2_LO_STSk_CTRL]] | Low ports LED2 status control | 
-| 0xD0 | [[#Port LED status registers|''LED0_HI_STS_CTRL'']] | High ports LED0 status control | +| 0xD0 | [[#Port LED status registers|LED0_HI_STS_CTRL]] | High ports LED0 status control | 
-| 0xD4 | [[#Port LED status registers|''LED1_HI_STS_CTRL'']] | High ports LED1 status control | +| 0xD4 | [[#Port LED status registers|LED1_HI_STS_CTRL]] | High ports LED1 status control | 
-| 0xD8 | [[#Port LED status registers|''LED2_HI_STS_CTRL'']] | High ports LED2 status control |+| 0xD8 | [[#Port LED status registers|LED2_HI_STS_CTRL]] | High ports LED2 status control |
 | 0xDC | ''LED_RTCT_CTRL'' | (To confirm) Realtek Cable Test control register | | 0xDC | ''LED_RTCT_CTRL'' | (To confirm) Realtek Cable Test control register |
 | 0xE0 | ''EXTRA_GPIO_CTRL'' | | | 0xE0 | ''EXTRA_GPIO_CTRL'' | |
Line 54: Line 54:
  
 === Global LED control === === Global LED control ===
 +The SoCs have been designed with the RTL8231 LED 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 RTL93xx) RTL8231 chip(s). The SoC's have dedicated pins and controllers for this task. For rtl930x C1 `LED_MDC` and C2 `LED_MDIO` For rtl931x, AL18 `LED_MDC` and AK18 `LED_MDIO`. This does require the RTL8231 connected to only function as a LED expander. This should not be confused with the dedicated `EXT_GPIO_MDxx` pins! 
 +
 Main control register for hardware accelerated LEDs and [[RTL8231]] access. Main control register for hardware accelerated LEDs and [[RTL8231]] access.
  
Line 82: Line 84:
   * 3: Act Rx   * 3: Act Rx
   * 4: Act Tx   * 4: Act Tx
 +  * 5: Col/Full duplex
 +  * 6: Full duplex
   * 7: Link 1G   * 7: Link 1G
   * 8: Link 100M   * 8: Link 100M
Line 91: Line 95:
   * 14: Link/Act 1G/10M   * 14: Link/Act 1G/10M
   * 15: Link/Act 100M/10M   * 15: Link/Act 100M/10M
 +  * 16: Link 10M flashing
 +  * 17: Link 100M flashing
 +  * 18: Link 1G flashing
 +  * 19: Link 10G flashing (RTL839x)
 +  * 20: Link 10G (RTL839x)
 +  * 21: Link/Act 10G (RTL839x)
   * 31: Off   * 31: Off
  
Line 138: Line 148:
 ==== LEDs on the RTL839x ==== ==== LEDs on the RTL839x ====
 On the RTL839x ''RTL8390_LED_GLB_CTRL'' has the following bits: On the RTL839x ''RTL8390_LED_GLB_CTRL'' has the following bits:
-  * Bits 0-1: Interface selection: Defined by board config variable ''pModel->led.led_if_sel''. ''LED_IF_SEL_SERIAL'': 0; ''LED_IF_SEL_SINGLE_COLOR_SCAN'': 1; ''LED_IF_SEL_BI_COLOR_SCAN'': 2+  * Bits 0-1: Interface selection: Defined by board config variable ''pModel->led.led_if_sel'': 
 +    * ''LED_IF_SEL_SERIAL'': 0 
 +    * ''LED_IF_SEL_SINGLE_COLOR_SCAN'': 1 
 +    * ''LED_IF_SEL_BI_COLOR_SCAN'': 2
   * Bits 2-3: LED number selection: Number of LEDs per port, configured from ''pModel->led.num''   * Bits 2-3: LED number selection: Number of LEDs per port, configured from ''pModel->led.num''
   * Bit 4: LED MDIO-Clock duty (cycle?)   * Bit 4: LED MDIO-Clock duty (cycle?)
Line 209: Line 222:
 | 0x25C | ''BUZZER_CTRL'' | RTL8231 buzzer settings shadow register | | 0x25C | ''BUZZER_CTRL'' | RTL8231 buzzer settings shadow register |
  
 +=== Port LED user control ===
 +52 registers, at offsets (0x144 + 4×port). After making modifications to the registers, the new configuration need to be committed by writing 0x1 to LED_SW_CTRL.
 +This sets the SW_LED_LOAD bit, updates the output, and self-clears afterwards.
  
 +^ Bits ^ Field description ^ Field values ^
 +| 0-2 | LED0 (cop0) control | 0: off \\ 1: toggle every 32ms \\ 2: toggle every 64ms \\ 3: toggle every 128ms \\ 4: toggle every 256ms \\ 5: toggle every 512ms \\ 6: toggle every 1024ms \\ 7: on |
 +| 3-5 | LED1 (cop1) control | ::: |
 +| 6-8 | LED2 (cop2) control | ::: |
 +| 9-11 | LED3 (fib0) control | ::: |
 +| 12-14 | LED4 (fib1) control | ::: |
 +| 15-17 | LED5 (fib2) control | ::: |
 ==== LEDs on the RTL930x ==== ==== LEDs on the RTL930x ====
 These registers are at a base address of ''0xBB00C400''. These registers are at a base address of ''0xBB00C400''.
  • led_control.1613981674.txt.gz
  • Last modified: 2021/02/22 08:14
  • by biot