EP-0256 - Revision history

Yoyojacky: /* Quick Start */

2026-06-16T01:54:23Z

Quick Start

← Older revision		Revision as of 09:54, 16 June 2026
Line 26:		Line 26:
	* Download the script		* Download the script
	<pre>		<pre>
	curl -O https://~~example~~.com/install_sbs_battery.sh		curl -O https://github.com/geeekpi/sbs_battery_for_UPS_Gen6/blob/main/install_sbs_battery.sh
	chmod +x install_sbs_battery.sh		chmod +x install_sbs_battery.sh
	</pre>		</pre>

Yoyojacky: /* Quick Start */

2026-04-29T05:26:17Z

Quick Start

← Older revision		Revision as of 13:26, 29 April 2026
Line 36:		Line 36:
	<pre>		<pre>
	sudo reboot		sudo reboot
	<pre>		</pre>
	* After reboot, check battery status		* After reboot, check battery status
	<pre>		<pre>

Yoyojacky: /* SBS Module for UPS Gen 6 */

2026-04-29T05:25:19Z

SBS Module for UPS Gen 6

← Older revision		Revision as of 13:25, 29 April 2026
Line 1:		Line 1:
	=SBS Module for UPS Gen 6=		=SBS Module for UPS Gen 6=
			'''Product SKU''': EP-0256
	==Description==		==Description==
	The SBS (Smart Battery System) Module is an advanced battery management solution designed specifically for the UPS Gen 6 platform. This module implements the industry-standard SBS communication protocol to provide intelligent monitoring and control of lithium battery packs. By integrating precision analog front-end circuitry with a compliant SBS firmware stack, it delivers real-time battery telemetry including voltage, current, state of charge, and runtime estimation. The module supports I2C communication interfaces compatible with both PikaPython embedded environments and native Raspberry Pi I2C buses, making it versatile for various development scenarios. With open-source firmware architecture, users benefit from transparent battery management algorithms while maintaining flexibility for customization. The module ensures safe and efficient battery operation through balanced charging capabilities and configurable I2C addressing, making it an ideal power management companion for UPS Gen 6 battery expansion boards.		The SBS (Smart Battery System) Module is an advanced battery management solution designed specifically for the UPS Gen 6 platform. This module implements the industry-standard SBS communication protocol to provide intelligent monitoring and control of lithium battery packs. By integrating precision analog front-end circuitry with a compliant SBS firmware stack, it delivers real-time battery telemetry including voltage, current, state of charge, and runtime estimation. The module supports I2C communication interfaces compatible with both PikaPython embedded environments and native Raspberry Pi I2C buses, making it versatile for various development scenarios. With open-source firmware architecture, users benefit from transparent battery management algorithms while maintaining flexibility for customization. The module ensures safe and efficient battery operation through balanced charging capabilities and configurable I2C addressing, making it an ideal power management companion for UPS Gen 6 battery expansion boards.

Yoyojacky: /* Auto Setup */

2026-04-29T05:24:17Z

Auto Setup

← Older revision		Revision as of 13:24, 29 April 2026
Line 21:		Line 21:
	==How to setup?==		==How to setup?==
	===Auto Setup===		===Auto Setup===
	* Download setup shell script from GitHub: [ ]		* Download setup shell script from GitHub: [ https://github.com/geeekpi/sbs_battery_for_UPS_Gen6 ]
	* Execute the setup.sh shell script.		* Execute the setup.sh shell script.
			===Quick Start===
			* Download the script
	<pre>		<pre>
	~~bash ~~~/~~sbs-setup~~/~~setup~~.sh		curl -O https://example.com/install_sbs_battery.sh
			chmod +x install_sbs_battery.sh
	</pre>		</pre>
	* Reboot ~~Raspberry Pi~~.		* Run full installation
			<pre>
			sudo ./install_sbs_battery.sh
			</pre>
			* Reboot to activate
			<pre>
			sudo reboot
			<pre>
			* After reboot, check battery status
			<pre>
			batt
			</pre>
			* More information please visit: [ https://github.com/geeekpi/sbs_battery_for_UPS_Gen6 ]

	===Hand-crafting step by step===		===Hand-crafting step by step===
	Raspberry Pi SBS Battery Module Compilation Guide		Raspberry Pi SBS Battery Module Compilation Guide

Yoyojacky: /* upower Command Reference */

2026-03-20T08:41:20Z

upower Command Reference

@@ Line 244: / Line 244: @@
 [[File:Upower-e output.png|left|800px]]
 <br style="clear:both;">
 Perfect! SBS battery is detected at I2C address 0x0a (shown as sbs_1_000a).
 Let me verify the full status and update the scripts for your specific device path:<br>
 * Verify Your Battery
 <pre>
 upower -i /org/freedesktop/UPower/devices/battery_sbs_1_000a
 </pre>
 [[File:Upower-i output.png|left|800px]]
 <br style="clear:both;">

Yoyojacky: /* Part C: Configure Automatic Module Loading */

2026-03-20T08:23:59Z

Part C: Configure Automatic Module Loading

← Older revision		Revision as of 16:23, 20 March 2026
Line 233:		Line 233:

	[[File:Ls sbs status.png\|left\|800px]]		[[File:Ls sbs status.png\|left\|800px]]
			<br style="clear:both;">

			=====upower Command Reference=====
			* upower -e — Enumerate Power Devices
			* Purpose: Lists all power device paths recognized by the UPower daemon.
			<pre>
			upower -e
			</pre>
			Typical Output:<br>
			[[File:Upower-e output.png\|left\|800px]]
			<br style="clear:both;">

			ou can use `upower` tool to read battery's information as following:
			<pre>
			upower -e
			</pre>
			Perfect! Your SBS battery is detected at I2C address 0x0a (shown as sbs_1_000a).
			Let me verify the full status and update the scripts for your specific device path:<br>
			* Verify Your Battery
			<pre>
			upower -i /org/freedesktop/UPower/devices/battery_sbs_1_000a
			</pre>
			[[File:Upower-i output.png\|left\|800px]]
	<br style="clear:both;">		<br style="clear:both;">

Yoyojacky: /* Part B: Create Device Tree Overlay */

2026-03-20T08:04:34Z

Part B: Create Device Tree Overlay

← Older revision		Revision as of 16:04, 20 March 2026
Line 173:		Line 173:
	Compile the Device Tree overlay:<br>		Compile the Device Tree overlay:<br>
	<pre>		<pre>
	dtc -@ -I dts -O dtb -o sbs-battery~~-overlay~~.dtbo sbs-battery-overlay.dts		dtc -@ -I dts -O dtb -o sbs-battery.dtbo sbs-battery-overlay.dts
	</pre>		</pre>
	Install the compiled overlay to the system overlays directory:<br>		Install the compiled overlay to the system overlays directory:<br>
	<pre>		<pre>
	sudo install -D -m 0644 sbs-battery~~-overlay~~.dtbo /boot/firmware/overlays/~~sbs-battery-overlay.dtbo~~		sudo install -D -m 0644 sbs-battery.dtbo /boot/firmware/overlays/
	</pre>		</pre>

Yoyojacky: /* Part B: Create Device Tree Overlay */

2026-03-20T07:43:18Z

Part B: Create Device Tree Overlay

← Older revision		Revision as of 15:43, 20 March 2026
Line 119:		Line 119:
	echo "DT_PATH=${OF#/sys/firmware/devicetree/base}"		echo "DT_PATH=${OF#/sys/firmware/devicetree/base}"
	</pre>		</pre>
			[[File:Output sbs.png\|left\|800px]]
			<br style="clear:both;">

	<font color=red>NOTE: for other Pi models, you will need to determine the appropriate path individually. </font><br>		<font color=red>NOTE: for other Pi models, you will need to determine the appropriate path individually. </font><br>

Yoyojacky: /* Part B: Create Device Tree Overlay */

2026-03-20T07:39:07Z

Part B: Create Device Tree Overlay

← Older revision		Revision as of 15:39, 20 March 2026
Line 152:		Line 152:
	#size-cells = <0>;		#size-cells = <0>;

	battery@b {		sbs-battery@a {
	compatible = "sbs,sbs-battery";		compatible = "sbs,sbs-battery";
	reg = <~~0x0b~~>;		reg = <0x0a>; /* I2C addrss default is 0x0A */
			status = "okay";
	};		};
	};		};
Line 162:		Line 163:

	Address notation explanation: <br>		Address notation explanation: <br>
	* battery@b — Node name (hexadecimal without prefix, following DT convention)		* battery@a — Node name (hexadecimal without prefix, following DT convention)
	* reg = <~~0x0b~~> — Actual I2C device address (~~0x0B~~ = 11 in decimal)		* reg = <0x0a> — Actual I2C device address (0x0a = 11 in decimal)

	<font color=red>It is recommended to keep the node name consistent with the reg value for clarity.</font><br>		<font color=red>It is recommended to keep the node name consistent with the reg value for clarity.</font><br>

Yoyojacky: /* Part C: Configure Automatic Module Loading */

2026-03-20T07:37:22Z

Part C: Configure Automatic Module Loading

← Older revision		Revision as of 15:37, 20 March 2026
Line 230:		Line 230:
	[[File:Ls sbs status.png\|left\|800px]]		[[File:Ls sbs status.png\|left\|800px]]
	<br style="clear:both;">		<br style="clear:both;">



	~~<pre>~~
	~~mkdir sbs-project~~
	~~cd sbs-project/~~
	~~wget https://raw.githubusercontent.com/raspberrypi/linux/refs/heads/rpi-6.12.y/drivers/power/supply/sbs-battery.c~~