Mer/Documentation/BME Protocol
(New page: This documentation is entirely for the purpose of implementing software gathering battery information, not alteration of battery management state. General protocol, published https://gara...) |
|||
Line 1: | Line 1: | ||
- | This documentation is entirely for the purpose of implementing software gathering battery information, not alteration of battery management state. | + | This documentation is entirely for the purpose of implementing software gathering battery information on Nokia Internet Tablets, not alteration of battery management state. |
General protocol, published https://garage.maemo.org/plugins/scmsvn/viewcvs.php/dsme/trunk/adhoc/dummy_bme.c?revision=155&root=dsm&view=markup , released as LGPL 2.1 | General protocol, published https://garage.maemo.org/plugins/scmsvn/viewcvs.php/dsme/trunk/adhoc/dummy_bme.c?revision=155&root=dsm&view=markup , released as LGPL 2.1 | ||
Line 7: | Line 7: | ||
* Server: send('\n') | * Server: send('\n') | ||
- | + | After handshake: | |
- | < | + | <pre> |
typedef struct { | typedef struct { | ||
uint16 type, subtype; | uint16 type, subtype; | ||
} BMEHeader; | } BMEHeader; | ||
- | </ | + | </pre> |
types so far (NAME, (type, subtype)): | types so far (NAME, (type, subtype)): | ||
Line 19: | Line 19: | ||
== EM_BATTERY_INFO_REQ (0x06, 0x00) == | == EM_BATTERY_INFO_REQ (0x06, 0x00) == | ||
- | < | + | <pre> |
typedef struct { | typedef struct { | ||
BMEHeader header; | BMEHeader header; | ||
- | u_int32_t flags; | + | u_int32_t flags; // Set to 0xFFFFFFFF to get all data |
} BME_EM_BATTERY_INFO_Req; | } BME_EM_BATTERY_INFO_Req; | ||
Line 30: | Line 30: | ||
uint16 c; | uint16 c; | ||
uint16 d; | uint16 d; | ||
- | uint16 temp; | + | uint16 temp; // Battery temperature measured in Kelvin |
uint16 f; | uint16 f; | ||
uint16 g; | uint16 g; | ||
Line 39: | Line 39: | ||
uint16 l; | uint16 l; | ||
}; | }; | ||
- | </ | + | </pre> |
+ | |||
+ | == Some BULK0 message (0x42, 0x00) == | ||
+ | |||
+ | <pre> | ||
+ | typedef struct { | ||
+ | BMEHeader header; | ||
+ | u_int32_t flags; // Set to 0xFFFFFFFF to get all data | ||
+ | } BME_EM_BULK_Req; | ||
+ | |||
+ | struct emsg_bme_bulk_reply { | ||
+ | uint32 unknown1; | ||
+ | uint32 unknown2; | ||
+ | uint32 unknown3; | ||
+ | uint16 sw_status; // Battery monitor SW status | ||
+ | uint16 instaneous_battery_voltage; // Instantaneous battery voltage (mV) | ||
+ | uint16 // Remaining standby time to battery low (mins) | ||
+ | uint16 unknown4; | ||
+ | uint16 unknown5; | ||
+ | uint16 unknown6; | ||
+ | uint16 // Battery monitor check voltage (mV) | ||
+ | uint16 // Battery low warning interval counter | ||
+ | uint16 // Double median filtered battery voltage | ||
+ | uint16 // Initial battery monitor voltage (mV) | ||
+ | uint16 // Time per battery bar (mins) | ||
+ | uint16 // DMF voltage sampled at first battery low (mV) | ||
+ | uint32 // Average phone current (uA) | ||
+ | uint16 // Most recent battery charge condition (mAh) | ||
+ | uint16 // Lowest TX-Off voltage (mV) | ||
+ | uint16 // Lowest TX-On voltage (mV) | ||
+ | uint16 // Largest TX-Off/On voltage difference (mV) | ||
+ | uint8 // Battery bar level log mask | ||
+ | uint8 // Previous battery bar level | ||
+ | uint8 // Battery low reason | ||
+ | uint8 // CS state information | ||
+ | uint16 // Number of battery bars | ||
+ | uint16 // Battery type | ||
+ | uint16 // Temperature, in kelvin | ||
+ | uint16 // Battery capacity | ||
+ | uint16 // Battery impedance (mOhm) | ||
+ | uint16 // Present value of v_bat_full_level | ||
+ | uint16 // Present value of v_bat_low_ths_mv | ||
+ | uint16 unknown7; | ||
+ | uint16 unknown8; | ||
+ | uint16 unknown9; | ||
+ | uint16 // Load current estimated by Batmon4 (uA) | ||
+ | uint16 unknown10; | ||
+ | }; | ||
+ | </pre> |
Revision as of 15:44, 7 February 2009
This documentation is entirely for the purpose of implementing software gathering battery information on Nokia Internet Tablets, not alteration of battery management state.
General protocol, published https://garage.maemo.org/plugins/scmsvn/viewcvs.php/dsme/trunk/adhoc/dummy_bme.c?revision=155&root=dsm&view=markup , released as LGPL 2.1
- UNIX socket connection to /tmp/.bmesrv
- Client: send('BMentity')
- Server: send('\n')
After handshake:
typedef struct { uint16 type, subtype; } BMEHeader;
types so far (NAME, (type, subtype)):
EM_BATTERY_INFO_REQ (0x06, 0x00)
typedef struct { BMEHeader header; u_int32_t flags; // Set to 0xFFFFFFFF to get all data } BME_EM_BATTERY_INFO_Req; struct emsg_battery_info_reply { uint32 a; uint32 flags; uint16 c; uint16 d; uint16 temp; // Battery temperature measured in Kelvin uint16 f; uint16 g; uint16 h; uint16 i; uint16 j; uint16 k; uint16 l; };
Some BULK0 message (0x42, 0x00)
typedef struct { BMEHeader header; u_int32_t flags; // Set to 0xFFFFFFFF to get all data } BME_EM_BULK_Req; struct emsg_bme_bulk_reply { uint32 unknown1; uint32 unknown2; uint32 unknown3; uint16 sw_status; // Battery monitor SW status uint16 instaneous_battery_voltage; // Instantaneous battery voltage (mV) uint16 // Remaining standby time to battery low (mins) uint16 unknown4; uint16 unknown5; uint16 unknown6; uint16 // Battery monitor check voltage (mV) uint16 // Battery low warning interval counter uint16 // Double median filtered battery voltage uint16 // Initial battery monitor voltage (mV) uint16 // Time per battery bar (mins) uint16 // DMF voltage sampled at first battery low (mV) uint32 // Average phone current (uA) uint16 // Most recent battery charge condition (mAh) uint16 // Lowest TX-Off voltage (mV) uint16 // Lowest TX-On voltage (mV) uint16 // Largest TX-Off/On voltage difference (mV) uint8 // Battery bar level log mask uint8 // Previous battery bar level uint8 // Battery low reason uint8 // CS state information uint16 // Number of battery bars uint16 // Battery type uint16 // Temperature, in kelvin uint16 // Battery capacity uint16 // Battery impedance (mOhm) uint16 // Present value of v_bat_full_level uint16 // Present value of v_bat_low_ths_mv uint16 unknown7; uint16 unknown8; uint16 unknown9; uint16 // Load current estimated by Batmon4 (uA) uint16 unknown10; };