Difference between revisions of "FMB battery"

From Wiki Knowledge Base | Teltonika GPS
 
Line 1: Line 1:
−
{{Template:FMB FW development notice}}
+
[[Image:battery.png|400px|right]]
−
 
+
Example:<br/>  
−
Example:<br/> "BatState: 1 FSMState: ACTIVE ChargerIC: OFF ExtV: 11796 BatV: 3942 BatI: 0"
+
<code>BatState: 1 FSMState: ACTIVE ChargerIC: OFF ExtV: 11796 BatV: 3942 BatI: 0</code>
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|+
 
|+
 
! style="width: 150px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | Response details
 
! style="width: 150px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | Response details
−
! style="width: 500px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | Description
+
! style="width: 300px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | Description
 +
! style="width: 150px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | Description
 
|-
 
|-
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | BatState
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | BatState
−
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery connected (1) or disconnected (0) from device
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery:<br>
 +
0 - disconnected<br>
 +
1 - connected
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |BatState: 1
 
|-
 
|-
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | FSMState
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | FSMState
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Current battery state
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Current battery state
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |FSMState: ACTIVE
 
|-
 
|-
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | ChargerIC
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | ChargerIC
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery charging status
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery charging status
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |ChargerIC: OFF
 
|-
 
|-
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | ExtV
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | ExtV
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | External voltage
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | External voltage
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |ExtV: 11796
 
|-
 
|-
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | BatV
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | BatV
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery voltage
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery voltage
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |BatV: 3942
 
|-
 
|-
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | BatI
 
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | BatI
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery charging current
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery charging current
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |BatI: 0
 +
|}
 +
<br>
 +
<b>Note:</b> If you want to know device <b>battery level %</b>, send <b>SMS/GPRS</b> command: <b>readio 113</b><br>
 +
<b>Example:</b> Device has battery level 100 %<br>
 +
<b>Sending command:</b> <code>readio 113</code><br>
 +
<b>Answer sent from the device:</b> <code>IO ID:113 Value:100</code><br>
 +
<b>Value: 100</b> means that battery level is 100% !
 +
 +
==Command for Personal Trackers==
 +
 +
 +
[[Image:Battery_reply.png|thumb|right|Example of battery SMS command response]]
 +
After issuing ‘battery’ request via SMS, we get the following result:<br>
 +
 +
''Example:''<br/>
 +
<code>ChargerType: INTERNAL BatStatus: CHARGER_IN ChargerIC: CHARGING ExtV: 4712 BatV: 3607 BatI: 403 BatLvl: 29</code>
 +
 +
{| class="wikitable"
 +
|+
 +
! style="width: 150px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | Response details
 +
! style="width: 300px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | Description
 +
|-
 +
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | ChargerType:
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | INTERNAL
 +
|-
 +
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | BatStatus
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | Current battery state
 +
|-
 +
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | ChargerIC
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | Battery charging status
 +
|-
 +
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | ExtV
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | External voltage
 +
|-
 +
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | BatV
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | Battery voltage in mV
 +
|-
 +
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | BatI
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | Battery charging current in mA
 +
|-
 +
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | BatLvl
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; | Battery level in percents
 +
|}
 +
 +
{| class="wikitable" style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;"
 +
|-
 +
! style="width: 150px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | BatStatus details
 +
! style="width: 300px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | Note
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;| '''PRESENT''' || style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;| Battery is present, notify voltage
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''CHARGER_IN'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Charger plugged in, charging
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''CHARGER_OUT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Charger was removed
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''OVERVOLPROTECT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Abnormal behaviour, charging error
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''OVERBATTEMP'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Battery’s temperature over 45C when device is on charge and 58C when device is in discharge mode
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''LOWBATTEMP'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Battery’s temperature under -15C
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''OVERCHARGECURRENT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Abnormal behaviour, charging error
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''CHARGE_COMPLETE'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Battery fully charged
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''INVALID_BATTERY'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Abnormal behaviour, battery error
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''INVALID_CHARGER'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Abnormal behaviour, charging error
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''CHARGING_TIMEOUT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Abnormal behaviour, charging error
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''LOWCHARGECURRENT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Abnormal behaviour, charging error
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''CHARGE_BAD_CONTACT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Abnormal behaviour, charging error
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''BATTERY_BAD_CONTACT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Abnormal behaviour, battery error
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''USB_CHARGER_IN'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Charger plugged in, charging
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''USB_CHARGER_OUT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Charger was removed
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''USB_NO_CHARGER_IN'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Charger plugged in, not charging
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''USB_NO_CHARGER_OUT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Charger was removed
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''BATTERY_IN'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Battery is attached
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|'''BATTERY_OUT'''
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;|Battery is removed
 +
|-
 +
 +
{| class="wikitable" style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;"
 +
|-
 +
! style="width: 150px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" | ChargerIC Status
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;text-align: center; center;| '''STANDBY'''
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white; text-align: center;|'''CHARGING'''
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;text-align: center;|'''DONE'''
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;text-align: center;|'''ERROR'''
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;text-align: center;|'''OFF'''
 
|-
 
|-
 
|}
 
|}

Latest revision as of 12:50, 27 March 2023

Battery.png

Example:
BatState: 1 FSMState: ACTIVE ChargerIC: OFF ExtV: 11796 BatV: 3942 BatI: 0

Response details Description Description
BatState Battery:

0 - disconnected
1 - connected

BatState: 1
FSMState Current battery state FSMState: ACTIVE
ChargerIC Battery charging status ChargerIC: OFF
ExtV External voltage ExtV: 11796
BatV Battery voltage BatV: 3942
BatI Battery charging current BatI: 0


Note: If you want to know device battery level %, send SMS/GPRS command: readio 113
Example: Device has battery level 100 %
Sending command: readio 113
Answer sent from the device: IO ID:113 Value:100
Value: 100 means that battery level is 100% !

Command for Personal Trackers

Example of battery SMS command response

After issuing ‘battery’ request via SMS, we get the following result:

Example:
ChargerType: INTERNAL BatStatus: CHARGER_IN ChargerIC: CHARGING ExtV: 4712 BatV: 3607 BatI: 403 BatLvl: 29

Response details Description
ChargerType: INTERNAL
BatStatus Current battery state
ChargerIC Battery charging status
ExtV External voltage
BatV Battery voltage in mV
BatI Battery charging current in mA
BatLvl Battery level in percents
BatStatus details Note
PRESENT Battery is present, notify voltage
CHARGER_IN Charger plugged in, charging
CHARGER_OUT Charger was removed
OVERVOLPROTECT Abnormal behaviour, charging error
OVERBATTEMP Battery’s temperature over 45C when device is on charge and 58C when device is in discharge mode
LOWBATTEMP Battery’s temperature under -15C
OVERCHARGECURRENT Abnormal behaviour, charging error
CHARGE_COMPLETE Battery fully charged
INVALID_BATTERY Abnormal behaviour, battery error
INVALID_CHARGER Abnormal behaviour, charging error
CHARGING_TIMEOUT Abnormal behaviour, charging error
LOWCHARGECURRENT Abnormal behaviour, charging error
CHARGE_BAD_CONTACT Abnormal behaviour, charging error
BATTERY_BAD_CONTACT Abnormal behaviour, battery error
USB_CHARGER_IN Charger plugged in, charging
USB_CHARGER_OUT Charger was removed
USB_NO_CHARGER_IN Charger plugged in, not charging
USB_NO_CHARGER_OUT Charger was removed
BATTERY_IN Battery is attached
BATTERY_OUT Battery is removed
ChargerIC Status
STANDBY
CHARGING
DONE
ERROR
OFF
Retrieved from "https://wiki.teltonika-gps.com/index.php?title=FMB_battery&oldid=82344"