Control with Commands — SunFounder Pironman 5 documentation (2024)

View the Basic Configurations¶

The pironman5 module offers basic configurations for Pironman, which you can review with the following command.

pironman5 -c

The standard configurations appear as follows:

{ "auto": { "rgb_color": "#0a1aff", "rgb_brightness": 50, "rgb_style": "breathing", "rgb_speed": 50, "rgb_enable": true, "rgb_led_count": 4, "temperature_unit": "C", "gpio_fan_mode": 2, "gpio_fan_pin": 6 }}

Customize these configurations to fit your needs.

Use pironman5 or pironman5 -h for instructions.

usage: pironman5-service [-h] [-c] [-rc [RGB_COLOR]] [-rb [RGB_BRIGHTNESS]] [-rs [{solid,breathing,flow,flow_reverse,rainbow,rainbow_reverse,hue_cycle}]] [-rp [RGB_SPEED]] [-re [RGB_ENABLE]] [-rl [RGB_LED_COUNT]] [-u [{C,F}]] [-gm [GPIO_FAN_MODE]] [-gp [GPIO_FAN_PIN]] [{start,stop}]Pironman5positional arguments: {start,stop} Commandoptions: -h, --help show this help message and exit -c, --config Show config -rc [RGB_COLOR], --rgb-color [RGB_COLOR] RGB color in hex format with or without # (e.g. #FF0000 or 00aabb) -rb [RGB_BRIGHTNESS], --rgb-brightness [RGB_BRIGHTNESS] RGB brightness 0-100 -rs [{solid,breathing,flow,flow_reverse,rainbow,rainbow_reverse,hue_cycle}], --rgb-style [{solid,breathing,flow,flow_reverse,rainbow,rainbow_reverse,hue_cycle}] RGB style -rp [RGB_SPEED], --rgb-speed [RGB_SPEED] RGB speed 0-100 -re [RGB_ENABLE], --rgb-enable [RGB_ENABLE] RGB enable True/False -rl [RGB_LED_COUNT], --rgb-led-count [RGB_LED_COUNT] RGB LED count int -u [{C,F}], --temperature-unit [{C,F}] Temperature unit -gm [GPIO_FAN_MODE], --gpio-fan-mode [GPIO_FAN_MODE] GPIO fan mode, 0: Always On, 1: Performance, 2: Cool, 3: Balanced, 4: Quiet -gp [GPIO_FAN_PIN], --gpio-fan-pin [GPIO_FAN_PIN] GPIO fan pin

sudo systemctl restart pironman5.service

• Verify the pironman5 program status using the systemctl tool.

  sudo systemctl status pironman5.service

• Alternatively, inspect the program-generated log files.

  cat /opt/pironman5/log

Control RGB LEDs¶

The board features 4 WS2812 RGB LEDs, offering customizable control. Users can turn them on or off, change the color, adjust the brightness, switch RGB LED display modes, and set the speed of changes.

sudo systemctl restart pironman5.service

• To modify the on and off state of the RGB LEDs, true to turn on the RGB LEDs, false to turn them off.

pironman5 -re true

• To change their color, input the desired hexadecimal color values, such as fe1a1a.

pironman5 -rc fe1a1a

• To change the brightness of the RGB LED (range: 0 ~ 100%):

pironman5 -rb 100

• To switch RGB LED display modes, choose from options: solid/breathing/flow/flow_reverse/rainbow/rainbow_reverse/hue_cycle:

pironman5 -rs breathing

• To modify the speed of change (range: 0 ~ 100%):

pironman5 -rp 80

• The default setup includes 4 RGB LEDs. Connect additional LEDs and update the count using:

pironman5 -rl 12

Control RGB Fans¶

The IO expansion board supports up to two 5V non-PWM fans. Both fans are controlled together.

sudo systemctl restart pironman5.service

• You can use command to configure the operating mode of the two RGB fans. These modes determine the conditions under which the RGB fans will activate.

For instance, if set to 1: Performance mode, the RGB fans will activate at 50°C.

sudo pironman5 -gm 3

• 4: Quiet: The RGB fans will activate at 70°C.

• 3: Balanced: The RGB fans will activate at 67.5°C.

• 2: Cool: The RGB fans will activate at 60°C.

• 1: Performance: The RGB fans will activate at 50°C.

• 0: Always On: The RGB fans will always on.

• If you connect the control pin of the RGB fan to different pins on the Raspberry Pi, you can use the following command to change the pin number.

sudo pironman5 -gp 18

Check the OLED Screen¶

When you have installed the pironman5 library, the OLED screen displays CPU, RAM, Disk Usage, CPU Temperature, and the Raspberry Pi’s IP Address, and it shows this every time you reboot.

If your OLED screen does not display any content, you need to first check if the OLED’s FPC cable is connected properly.

Then you can check the program log to see what might be the problem through the following command.

cat /var/log/pironman5/

Or check if the OLED’s i2c address 0x3C is recognized:

i2cdetect -y 1

Checkout the Infrared Receiver¶

To utilize the IR receiver, verify its connection and install the necessary module:

• Test the connection:

  sudo ls /dev |grep lirc

• Install the lirc module:

  sudo apt-get install lirc -y

• Now, test the IR Receiver by running the following command.

  mode2 -d /dev/lirc0

• After running the command, press a button on the remote control, and the code of that button will be printed.