Return

1、When the power bank is returned to the cabinet, regardless of success or failure, the MQTT result is reported.
2、When the power bank is returned to the cabinet, only the success status is available, and the HTTP result is reported.

Command Reply △

Publish to topic: /powerbank/{uuid}/user/update

Data format: bytecode data, Hex, hexadecimal analysis

Bytecode	Name	Identification code	Remarks
byte[0]	Header code	head	Default: 0xA8
byte[1~2]	Packet length	length	Default: 0x00 0x15, converted to decimal, equal to 21
byte[3]	Command name	cmd	Default: 0x28, return the power bank (self-test)
byte[4]	Movement board address	controlIndex	Default: 0x01
↓↓↓↓↓↓	↓↓↓↓↓↓	↓↓↓↓↓↓	↓The following fields are synchronized with Position Information
byte[5]	Location address	holeIndex	Range: 1-100
byte[6]	Status information	state
byte[7]	Power bank current	powerbankCurr	Keep 1 decimal place For example: 0x10=16, indicating 1.6A
byte[8]	Voltage of power bank cells	powerbankVolt	Keep 1 decimal place For example, 0x10=16 means 1.6V
byte[9]	Area code	area	Customized
byte[10~13]	Power bank SN	powerbankSN	0x05 0x11 0x49 0xF1=85019121
byte[14]	Battery level	soc	0x00、0xFF：0% 0x10：16% 0x64：100%
byte[15]	Temperature	temp	0x00: No NTC 0x10: 16℃ 0x64: 100℃
byte[16]	Charging voltage	chargeVolt	Keep 1 decimal place For example, 0x10=16 means 1.6V
byte[17]	Charging current	chargeCurr	Keep 1 decimal place For example, 0x10=16, indicating 1.6A
byte[18]	version	version	0x00: 0 0x10: V16 0xFF: V255
byte[19]	sensor detection	sensor
↑↑↑↑↑↑	↑↑↑↑↑↑	↑↑↑↑↑↑	↑↑↑↑↑↑
byte[20]	Verification code	verify	Data packet complement verification

Example: Report SN pop-up data

A8 00 15 28 02 08 01 00 00 01 05 11 2F FA 4B 21 00 00 0D 01 56

A8 -------------------------------------------- byte[0] Header code
00 15 ----------------------------------------- byte[1~2] Packet length 21
28 -------------------------------------------- byte[3] Return power bank command (self-fix)
02 -------------------------------------------- byte[4] Movement board address
08 -------------------------------------------- byte[5] Position number: 8
01 -------------------------------------------- byte[6] Return status: 01 Normal
00 -------------------------------------------- byte[7] Reserved
00 -------------------------------------------- byte[8] Reserved
01 -------------------------------------------- byte[9] Area code: 01
05 11 2F FA ------------------------------------byte[10~13] Power bank SN: 85012474
4B -------------------------------------------- byte[14] Battery level: 75%
21 -------------------------------------------- byte[15] Temperature: 33℃
00 -------------------------------------------- byte[16] Charging voltage: 0V
00 -------------------------------------------- byte[17] Charging current: 0V
0D -------------------------------------------- byte[18] Software version: V13
01 -------------------------------------------- byte[19] Hardware version: V1
56 -------------------------------------------- byte[20] Checksum

API Request

After the power bank self-checks successfully, the entire device will be reported immediately via HTTP.

Example

/powerbank-protocol-v1/guide/protocol-upload.html#api-example