TrueNAS UGREEN DXP4800 Plus Status LED Guide

ugreen_truenas_led.md

UGREEN DXP4800 Plus TrueNAS Status LED Guide

The following is a quick guide on getting basic status LED functionality working with TrueNAS running on the UGREEN DXP4800 Plus. Theoretically, it should work on all models (with some small revisions to the script), but I only have a DXP4800 Plus. :)

This guide is for cron job that runs a script to update the LEDs every couple minutes, but I'm sure the following can be modified for blinky LEDs as well.

Steps:

1. Manually build or download the ugreen_leds_cli tool from https://github.com/miskcoo/ugreen_dx4600_leds_controller.
2. Plop it somewhere on your NAS (E.g. a dataset).
3. In the same dataset, create your .sh script that controls the LEDs. At the bottom of this gist is my modified version of meyergru's.
4. Make the script executable: chmod +X your-script.sh.
   • You may also need to make ugreen_leds_cli executable as well.
5. In TrueNas, navigate over to System Settings → Advanced
6. Under Init/Shutdown Scripts Create the following to load the i2c-dev module on boot:
   • Description: Enable i2c-dev
   • Type: Command
   • Command: modprobe i2c-dev
   • When: Pre Init
7. Under Cron Jobs we then create a task to run every x minutes:
   • Description: Update Status LEDS
   • Command: /mnt/path/to/your/script.sh
   • Run as User: root
   • Schedule: */5 * * * * (or however often you desire)
8. Reboot and wait a bit for your cron job to run.

Sources:

• https://github.com/miskcoo/ugreen_dx4600_leds_controller
• https://github.com/meyergru/ugreen_dxp8800_leds_controller

Example script:

#! /bin/bash

#set -x

SCRIPTPATH=$(dirname "$0")
echo $SCRIPTPATH

devices=(p n x x x x)
map=(power netdev disk1 disk2 disk3 disk4)

# Check network status
gw=$(ip route | awk '/default/ { print $3 }')
if ping -q -c 1 -W 1 $gw >/dev/null; then
    devices[1]=u
fi

# Map sdX1 to hardware device
declare -A hwmap
echo "Mapping devices..."
while read line; do
    MAP=($line)
    device=${MAP[0]}
    hctl=${MAP[1]}
    partitions=$(lsblk -l -o NAME | grep "^${device}[0-9]\+$")
    for part in $partitions; do
        hwmap[$part]=${hctl:0:1}
        echo "Mapped $part to ${hctl:0:1}"
    done
done <<< "$(lsblk -S -o NAME,HCTL | tail -n +2)"

# Print the hwmap for verification
echo "Hardware mapping (hwmap):"
for key in "${!hwmap[@]}"; do
    echo "$key: ${hwmap[$key]}"
done

# Check status of zpool disks
echo "Checking zpool status..."
while read line; do
    DEV=($line)
    partition=${DEV[0]}
    echo "Processing $partition with status ${DEV[1]}"
    if [[ -n "${hwmap[$partition]}" ]]; then
        index=$((${hwmap[$partition]} + 2))
        echo "Device $partition maps to index $index"
        if [ ${DEV[1]} = "ONLINE" ]; then
            devices[$index]=o
        else
            devices[$index]=f
        fi
    else
        echo "Warning: No mapping found for $partition"
    fi
done <<< "$(zpool status -L | grep -E '^\s+sd[a-h][0-9]')"

# Output the final device statuses
echo "Final device statuses:"
for i in "${!devices[@]}"; do
    echo "$i: ${devices[$i]}"
    case "${devices[$i]}" in
        p)
            "$SCRIPTPATH/ugreen_leds_cli" ${map[$i]} -color 255 255 255 -on -brightness 64
            ;;
        u)
            "$SCRIPTPATH/ugreen_leds_cli" ${map[$i]} -color 255 255 255 -on -brightness 64
            ;;
        o)
            "$SCRIPTPATH/ugreen_leds_cli" ${map[$i]} -color 0 255 0 -on -brightness 64
            ;;
        f)
            "$SCRIPTPATH/ugreen_leds_cli" ${map[$i]} -color 255 0 0 -blink 400 600 -brightness 64
            ;;
        *)
            "$SCRIPTPATH/ugreen_leds_cli" ${map[$i]} -off
            ;;
    esac
done

@republicandaddy

The script was not built with spares in mind and treats any status besides ONLINE as being "unhealthy". An unused spare should have a status of AVAIL, so you should be able to update this line:

            if [[ "${zstatus^^}" != "ONLINE" ]]; then

Like this:

            if [[ "${zstatus^^}" != "ONLINE" && "${zstatus^^}" != "AVAIL" ]]; then

Then the LED for your spare slot will not blink.

Thank you very much for these instructions! It worked for me.

I had to set ownership and group of the shell script and ugreen_leds_cli to the root user. Than I did chmod +X your-script.sh under the root
user in the Truenas shell. I enabled the root user password.

I had to change the zpool command to /sbin/zpool because sbin is not in the PATH definition.

The instruction is difficult for somebody without Unix knowledge.

Guide is not working or i am to dumb for the steps: Downloaded the file placed it into a smb folder. Created the script, which i copied from below. Tried it in the terminal with the command you wrote here: chmod +X your-script.sh. Copied it in the same folder. Then implemented the 6 & 7 restarted but nothing happened. Maybe im not into depth of truenas scale but dont know what i did wrong.

Might have the same issue as I do. I copy/pasted the script on my windows machine before copying to the NAS. When I ran the script with the -x parameter to debug there was an error about the windows style EOL marker '/r'. From the shell in TrueNAS I ran the following to correct the issue:

sed -i 's/\r$//' /mnt/pool_name/dataset_name/LED.sh