Unraid UGREEN LED Driver Plugin
This is the repository for the Unraid UGREEN LED Driver plugin based on: https://github.com/miskcoo/ugreen_dx4600_leds_controller
Support Thread: https://forums.unraid.net/topic/92865-support-ich777-amd-vendor-reset-coraltpu-hpsahba/
What This Plugin Does
This Unraid plugin adds comprehensive LED control functionality to UGREEN NAS devices, transforming your NAS into a visual monitoring system. It provides:
- Disk Activity Monitoring: Individual hard drive activity indicators with LED flashing
- Network Status Monitoring: Real-time network connectivity and speed visualization
- System Health Monitoring: Disk health and availability status indicators
- Hardware Compatibility: Support for multiple UGREEN NAS models
Supported UGREEN Models
The driver supports these UGREEN NAS models:
- DXP6800 series (tested on DXP6800 Pro)
- DX4600 series (tested on DX4600 Pro)
- DX4700 series
- DXP2800 series
- DXP4800 series
- DXP8800 series (tested on DXP8800 Plus)
- DXP480T series (tested on DXP480T Plus) - uses static white LED only
LED Color Meanings
Disk LED Colors
| Color | RGB Values | Meaning |
|---|---|---|
| White | 255 255 255 |
Healthy disk - Normal operation (solid) |
| White | 255 255 255 |
Disk activity - Brief flash when I/O detected |
| Red | 255 0 0 |
Disk unavailable/offline - Disk has gone offline or is not accessible (solid) |
Network LED Colors
| Color | RGB Values | Meaning |
|---|---|---|
| Orange | 255 165 0 |
Normal network - Default state when speed is unknown (solid) |
| Green | 0 255 0 |
100 Mbps connection (solid) |
| Blue | 0 0 255 |
1 Gbps connection (solid) |
| Yellow | 255 255 0 |
2.5 Gbps connection (solid) |
| White | 255 255 255 |
10 Gbps connection (solid) |
| Red | 255 0 0 |
Gateway unreachable - Network connectivity issues (solid) |
| Any Color | Various | Network activity - Flashes on TX/RX activity |
Monitoring Features
Disk Monitoring
- Activity Detection: LEDs flash briefly (100ms on/off) when disk I/O activity is detected
- Health Monitoring: Continuously checks if disks are online every 5 seconds (configurable)
- Status Indicators: Solid white = healthy disk, solid red = disk offline/unavailable
- Slot Mapping: Maps physical disk slots to LED indicators using ATA, HCTL, or serial number mapping
- Empty Slot Handling: LEDs are turned off for disk slots that don't have drives installed
Network Monitoring
- Speed Detection: Automatically detects network interface speed and changes LED color accordingly (solid color)
- Activity Indicators: LED flashes on network transmit/receive activity (500ms interval)
- Gateway Connectivity: Pings the default gateway every 30 seconds (configurable) to verify connectivity
- Interface Detection: Automatically detects the primary network interface from Unraid configuration
Special Cases
- DXP480T Model: Uses a special static white LED configuration instead of dynamic monitoring
- Model-Specific Mapping: Different models may use different disk-to-LED mappings (e.g., DXP6800 has custom mapping)
Configuration Options
The plugin creates a settings.cfg file with these configurable parameters. The settings file is stored at: /boot/config/plugins/ugreenleds-driver/settings.cfg
| Parameter | Default | Description |
|---|---|---|
MAPPING_METHOD |
"ata" |
How to map disks to LEDs (ata, hctl, or serial) |
DISK_SERIAL |
"SN1 SN2 SN3 SN4" |
Serial numbers for disk mapping |
COLOR_DISK_HEALTH |
"255 255 255" |
Color for healthy disks (white) |
BRIGHTNESS_DISK_LEDS |
"255" |
LED brightness level |
COLOR_DISK_UNAVAIL |
"255 0 0" |
Color for unavailable disks (red) |
LED_REFRESH_INTERVAL |
"0.5" |
How often to check for disk activity (seconds) |
CHECK_DISK_ONLINE_INTERVAL |
"5" |
How often to check disk online status (seconds) |
CHECK_GATEWAY_CONNECTIVITY |
"true" |
Whether to monitor network connectivity |
COLOR_NETDEV_NORMAL |
"255 165 0" |
Color for normal network (orange) |
COLOR_NETDEV_LINK_100 |
"0 255 0" |
Color for 100 Mbps (green) |
COLOR_NETDEV_LINK_1000 |
"0 0 255" |
Color for 1 Gbps (blue) |
COLOR_NETDEV_LINK_2500 |
"255 255 0" |
Color for 2.5 Gbps (yellow) |
COLOR_NETDEV_LINK_10000 |
"255 255 255" |
Color for 10 Gbps (white) |
COLOR_NETDEV_GATEWAY_UNREACHABLE |
"255 0 0" |
Color for gateway issues (red) |
CHECK_NETDEV_INTERVAL |
"30" |
How often to check network status (seconds) |
Installation
- Install the plugin through the Unraid Community Applications or manually
- The plugin will automatically detect your UGREEN NAS model
- Configuration file will be created at
/boot/config/plugins/ugreenleds-driver/settings.cfg - LEDs will start working immediately after installation
Troubleshooting
- LEDs not working: Check if your model is supported and ensure the kernel module loaded correctly
- Wrong disk mapping: Adjust the
MAPPING_METHODin settings.cfg - Network LED issues: Verify network interface detection and gateway connectivity
- Performance issues: Adjust refresh intervals in the configuration file
Credits
Based on the excellent work by miskcoo for the original UGREEN LED controller implementation.