Changes

<big>Although this installation tutorial is still available, but we strongly recommend that you use [[X729-script]] new tutorial, and we no longer maintain this page.</big> ==Setup script==The following test is base on * [https://downloads.raspberrypi.org/raspios_arm64/images/raspios_arm64-2023-05-03/2023-05-03-raspios-bullseye-arm64.img.xz 2023-05-03-raspios-bullseye-arm64.img.xz]* [https://www.raspberrypi.com/software/operating-systems/ 2022-09-22-raspios-bullseye-armhf.img.xz]* [https://www.raspberrypi.com/software/operating-systems/ 2022-09-22-raspios-buster-armhf.img.xz] PS: To buster version, the default user name is 'pi, but bullseye version, you need to manually create a new user. In our example script, the new user name we created is 'pi'. If you create your own user name, you need to modify the corresponding user name directory in the script. For Example: You may need to change '/home/pi/' => '/home/XX/', 'XX' is user name you created.

==='''1. Enable I2C funcion on Raspbian:''' reter to [[How to enable I2C]]===

Please reter to [[How to enable I2C]] ==='''2. Check & review I2C portaddress'''===

sudo apt-get -y upgrade sudo apt-get -y install i2c-tools python3-smbus python3-rpi.gpio sudo apt-get -y install python3-pip python3-pil #sudo apt-get -y install pigpio python-smbuspigpio python3-pigpio

#3c - address of oled display，This value only exists when the oled is inserted，check if the OLED displayis inserted in the correct direction if you don't found the above i2c port

==='''3. Setting up the power management script'''===

#Reboot the Raspberry Pior long press on-board button switch to turn off sudo rebootnow

==='''4. Setting up the PWM cooling fan'''===

cd cd x729

==='''5. Set and Read Test PLD/PLSD/buzzer function'''===  5.1 Test AC Power loss or power adapter failure detection (PLD) Run the script test the RTC timePLD function #If you need to set sudo python3 pld.py[[File:X729-8.png|none]] 5.2 Test Auto shutdown when AC power loss or power adapter failure Run the system time for any reason you can use the following command script and then remove your power adapter pi@raspberrypi: ~/x729 $ sudo python3 plsd.py Safe shutdown will be implemented in 5 seconds.  5.3 Test the buzzer alarm when AC power loss or power adapter failure Run the script and unplug your power adapter from the UPS. date -s "5 MAR 2019 13pi@raspberrypi:00:00"~/x729 $ sudo python3 buzzer.py Once power adapter is removed then the buzzer will generate a beep sound continuously. 

#Write the system date ==='''6. Set and time to Read the RTC module after your correct the system date and time : sudo hwclock -w'''===

#Read 6.1 Run the date and time back from following command on your Raspberry PI to begin editing the RTC module: /boot/config.txt file. sudo hwclock -rnano /boot/config.txt

6. How add one of the following lines to reading battery voltage and percentage, this is the sample codebottom of the file, you can modify it by your request. sudo python /home/pi/x728bat.py[[File:X728dtoverlay=i2c-bat-2.jpg]]rtc,ds1307

User Guide[[File: https://githubX729-5.com/geekworm-com/x728 to know more details;png|none]]

But we hope Save and exit. In nano, you do that the script can be executed automatically by hitting CTRL + X, answering Y and hitting Enter when the Raspberry Pi board boots, we can use crontab system command to achieve itprompted. Refer to [[How to add crontab job]] or refer to the following:

6.2 Run the commands to disable the "fake hwclock" which interferes with the 'real' hwclock pi@raspberrypi ~ $ `sudo crontab apt-e`get -y remove fake-hwclock pi@raspberrypi ~ $ sudo update-rc.d -f fake-hwclock remove pi@raspberrypi ~ $ sudo systemctl disable fake-hwclock[[File:X729-6.png|none]]

Add a line at 6.4 Reboot the end of Raspberry Pi pi@raspberrypi ~ $ sudo reboot 6.5 Run the file command to verify the time is correct. Plug in Ethernet or WiFi to let the Pi sync the right time from the Internet pi@raspberrypi ~ $ date 6.6 Run the command to write the time pi@raspberrypi ~ $ sudo hwclock -w 6.7 Run the command to read the time pi@raspberrypi ~ $ sudo hwclock -r Once the time is set, make sure the batteries are inserted so that reads like this:the time is saved. You only have to set the time once. That's it! Next time you boot the time will automatically be synced from the [[X729]].

===7. How to enable automatic shutdown when low voltage===7.1 Run the command to read battery voltage and percentage `pi@reboot python raspberrypi:~/home/pi/x728batx729 $ sudo python3 bat.py`

7. Power off command on Raspbian from software x728off* x728off is 2 Change the battery low voltage to implement safe shutdown command. default is less than 3.00Vdc.* press on-board blue button 1-2 seconds to reboot pi@raspberrypi ~ $ sudo nano bat.py * press on[[File:X729-board blue button 3 seconds to safe shutdown,.png|none]]* press on-board blue button 7-8 seconds to force shutdownNote: the voltage range must be 2.5~4.1vdc.

[[File7.3 Optional - if you want to run Python Script automatically on Bootup then run the command pi@raspberrypi:X728-pld~/x729 $ sudo crontab -2.jpg]]e

==uninstall x728 script==uninsatll x728 shell script, run 7.4 Add a line at the end of the following commandfile that reads like this: sudo @reboot python3 /home/pi/x729/bat./uninstall_x728py[[File:X729-4.shpng|none]]

For the x728 old shell scriptSave and exit. In nano, you also run this command to remove itdo that by hitting CTRL + X, then re-install the x728 scriptanswering Y and hitting Enter when prompted.

==FAQ=8. How to enable OLED display===Q: We want Refer to [[How to automatically shut down when the battery voltage is lower than a certain specified value, is it possible?enable OLED display]]

A: Please ==Uninstall cript==uninsatll x729 shell script, run the followng following command to achieve this function.(Note: 3V is default shut down voltage value ) python3 /home/pi/x728sudo ./x728v2-asduninstall_x729.py &sh

X728==Other resource==X729-Chip-Specifications：

 Return to [[X728X729]] or [[X729-hardware]]