X735 Software

 ⚠️  Deprecated: This page is outdated and may contain inaccurate information. It is kept for reference only. Please refer to X735-script.

Overview

This guide also applies to X735 V3.0 / V2.5 shield；

For Raspbian / Raspbian Lite / RetroPie / Twister OS v2.0.2

Test '2022-04-04-raspios-bullseye-armhf-lite.img' on May 6th 2022;

install

sudo apt-get update
sudo apt-get upgrade

sudo apt-get install -y git
sudo apt-get install -y pigpio python3-pigpio
sudo apt-get install -y python3-smbus python3-rpi.gpio
git clone https://github.com/geekworm-com/x735-v2.5
cd x735-v2.5
sudo chmod +x *.sh
sudo bash install.sh
echo "alias x735off='sudo /usr/local/bin/x735softsd.sh'" >> ~/.bashrc
sudo reboot

If reboot fails, please force shutdown or power off and restart

Test safe shutdown

x735off

• x735off is safe shutdown command, you can run this command to safe shutdown.
• press button 1-2 seconds to reboot
• press button 3 seconds to safe shutdown,
• press 7-8 seconds to force shutdown.

uninstall

sudo ./uninstall.sh

read-fan-speed.py

sudo  python3 read_fan_speed.py

or

sudo  python read_fan_speed.py

After a reboot, we can run ```sudo python read_fan_speed.py``` to get an update on the fan's current speed.

How to make the fan script run automatically after booting?

There are two ways to achieve it：

1. Put the command line in the /etc/rc.local file: （Default)

vi /etc/rc.local

#!/bin/sh -e
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will "exit 0" on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.

# Print the IP address
_IP=$(hostname -I) || true
if [ "$_IP" ]; then
  printf "My IP address is %s\n" "$_IP"
fi

/etc/x735pwr.sh &
python /home/pi/x735-v2.5/pwm_fan_control.py&
exit 0

NOTE:

• The install.sh script will make sure this command line is put into the rc.local file, you don't need to do anything.
• Please change 'python' to 'python3' if you are using python3.
• Please make sure the file path of pwm_fan_control.py is correct.

2. Use crontab to add a timed task. For details, please refer to How to add crontab job.

For DietPi

install

sudo apt-get install -y python-smbus python python3-rpi.gpio
sudo apt-get install -y pigpio python-pigpio python3-pigpio git
git clone https://github.com/geekworm-com/x735-v2.5
cd x735-v2.5
sudo chmod +x *.sh
sudo bash install-dietpi.sh

echo "alias x735off='sudo /usr/local/bin/x735softsd'" >> ~/.bashrc
sudo reboot

PS: according to the customer feedback, the above shell script is also work with Citadel, please test yourself, thanks!

For Volumio 3

Test the following script base on the 'Volumio-3.175-2021-12-13-pi.img'

The default username and passpword are both 'volumio'

install

# Enable SSH

Visit 'http://volumio.local/dev/' to click 'Enable' button to enable SSH

# install software and tools via SSH window
sudo apt-get update
sudo apt-get install python-smbus
sudo apt-get -y install python-rpi.gpio python3-rpi.gpio

# download the install script
sudo git clone https://github.com/geekworm-com/x735-v2.5
cd x735-v2.5
sudo chmod +x *.sh
sudo bash install-volumio3.sh

# add x735off alias 
echo "alias x735off='sudo /usr/local/bin/x735softsd'" >> ~/.bashrc
sudo reboot

Test safe shutdown

x735off

• x735off is safe shutdown command, you can run this command to safe shutdown.
• press button 1-2 seconds to reboot
• press button 3 seconds to safe shutdown,
• press 7-8 seconds to force shutdown.

uninstall

sudo ./uninstall.sh

read-fan-speed.py

sudo python3 read_fan_speed.py

For Ubuntu Server

Test the following script base on Ubuntu Server 21.10 on March 24th, 2022

install

# install software and tools
cd ~
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install -y unzip make gcc git 
sudo apt-get install -y wiringpi python python3-pigpio python-setuptools python3-distutils python3-rpi.gpio

# install pigpio library, also refer to http://abyz.me.uk/rpi/pigpio/download.html
wget https://github.com/joan2937/pigpio/archive/master.zip
unzip master.zip
cd pigpio-master
sudo make
sudo make install

# download X735 installation scripts
cd ~
git clone https://github.com/geekworm-com/x735-v2.5
cd x735-v2.5
sudo chmod +x *.sh

# create pigpiod service
sudo bash create-pigpiod.service.sh

# create /etc/rc.local file
sudo bash create-rc.local.sh

# install script
sudo bash install.sh

# add x735off alias
echo "alias x735off='sudo /usr/local/bin/x735softsd.sh'" >> ~/.bashrc
sudo reboot

Test safe shutdown

x735off

• x735off is safe shutdown command, you can run this command to safe shutdown.
• press button 1-2 seconds to reboot
• press button 3 seconds to safe shutdown,
• press 7-8 seconds to force shutdown.

uninstall

sudo ./uninstall.sh

read-fan-speed.py

sudo python3 read_fan_speed.py

For myNode OS and Umbrel

About myNode, please refer to http://www.mynodebtc.com/

About Umbrel, please refetrto https://getumbrel.com/, we test it base on 'umbrel-os-v0.4.4.img'

We tested umbrel v0.4.16 on Apr. 18th, 2022 base on 'umbrel-os-v0.4.16.img'

Install

login to mynode teminal via Putty or Xsheel tool, the default user name is `admin`, password is `bolt`, then run the following command:

Login to mynode teminal via Putty or Xsheel tool, the default user name is `umbrel`, default password is `moneyprintergobrrr`, then run the following command:

FAQ

Q: What are the credentials to SSH into my Umbrel?

A: ssh host is umbrel.local (or ssh <local IP address of your Umbrel>). The default user name is umbrel, and the default password moneyprintergobrrr

 sudo apt-get update
 sudo apt-get install -y python-smbus python pigpio python-pigpio python3-pigpio git wiringpi
 sudo apt-get install -y python-rpi.gpio python3-rpi.gpio rpi.gpio
 git clone https://github.com/geekworm-com/x735-v2.5
 cd x735-v2.5
 chmod +x *.sh
 sudo bash install-mynode.sh
 echo "alias x735off='sudo /usr/local/bin/x735softsd.sh'" >> ~/.bashrc
 sudo reboot
 If you fail to reboot, please unplug the power directly and restart;

PWM fan control

The script is installed successfully and the fan starts to run

Test safe shutdown

x735off

• Please run 'x735off' to shut down or press the on-board button switch to shut down. DON'T run the 'shutdown' linux command to shut down, otherwise the power of x735 will not be shut down.
• press button switch 1-2 seconds to reboot
• press button switch 3 seconds to safe shutdown,
• press 7-8 seconds to force shutdown.

uninstall

./uninstall-mynode.sh

For Version 2.1 or more low version

Please refer to Hardware and Software and read them and follow the instructions before ask any questions, thank you!

The safe shutdown script is same with X730.

• Github

We test this shell script base official Raspbian '2018-11-13-raspbian-stretch.img' version;other operating systems not be tested!

#Download run script

git clone https://github.com/geekworm-com/x730-script

cd x730-script

#Setting file attributes
sudo chmod +x x730.sh

#Install the script
sudo bash x730.sh

#Setting up the command to turn off X730 from software 
printf "%s\\n" "alias x730off='sudo x730shutdown.sh'" >> ~/.bashrc

#Reboot the Raspberry Pi
sudo reboot

#Powering off the Raspberry Pi from software
x730off

Return to X735