2021-10-31 15:33:56 +00:00
|
|
|
#!/usr/bin/env python3
|
2021-10-31 17:14:22 +00:00
|
|
|
# -*- coding: utf-8 -*-
|
2021-11-04 00:52:48 +00:00
|
|
|
|
2021-10-31 15:33:56 +00:00
|
|
|
import datetime
|
2021-10-31 17:14:22 +00:00
|
|
|
import struct
|
2021-11-03 03:35:49 +00:00
|
|
|
import sys
|
2021-10-31 17:14:22 +00:00
|
|
|
import time
|
2021-11-05 05:51:35 +00:00
|
|
|
from io import RawIOBase
|
2021-11-08 03:29:43 +00:00
|
|
|
from typing import Optional, cast
|
2021-10-31 15:33:56 +00:00
|
|
|
|
|
|
|
from bluepy import btle
|
|
|
|
from libscrc import modbus
|
|
|
|
|
2021-11-05 05:51:35 +00:00
|
|
|
from feasycom_ble import BTLEUart
|
|
|
|
|
2021-10-31 15:33:56 +00:00
|
|
|
MAC = "DC:0D:30:9C:61:BA"
|
|
|
|
|
2021-10-31 17:14:22 +00:00
|
|
|
# write_service = "0000ffd0-0000-1000-8000-00805f9b34fb"
|
|
|
|
# read_service = "0000fff0-0000-1000-8000-00805f9b34fb"
|
2021-10-31 15:33:56 +00:00
|
|
|
|
2021-11-05 02:01:43 +00:00
|
|
|
ACTION_READ = 0x03
|
|
|
|
ACTION_WRITE = 0x03
|
|
|
|
|
|
|
|
POSSIBLE_MARKER = (0x01, 0xFD, 0xFE, 0xFF)
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# get(255, 12, 2)
|
|
|
|
# "ff 03 00 0c 00 02"
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_1 = b"\xff\x03\x00\x0c\x00\x02"
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 04 20 20 20 20
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# get(255, 12, 8)
|
|
|
|
# ff 03 00 0c 00 08
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_MODEL = b"\xff\x03\x00\x0c\x00\x08"
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 10 20 20 20 20 4d 4c 32 34 32 30 20 20 20 20 20 20
|
|
|
|
# Device SKU: ML2420
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# get(255, 20, 4)
|
|
|
|
# ff 03 00 14 00 04
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_VERSION = b"\xff\x03\x00\x14\x00\x04"
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 08 00 04 02 00 02 00 00 03
|
|
|
|
# CC ?? 11 22 33 ?? 44 55 66
|
|
|
|
# Version: 4.2.0
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# get(255, 24, 3)
|
|
|
|
# ff 03 00 18 00 03
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_SERIAL = b"\xff\x03\x00\x18\x00\x03"
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 06 3c 13 02 67 00 01
|
|
|
|
# CC 11 22 33 33 ?? ??
|
|
|
|
# SN: 60-19-0615
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# get(255, 256, 7)
|
|
|
|
# ff 03 01 00 00 07
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_BATTERY_STATE = b"\xff\x03\x01\x00\x00\x07"
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 0e 00 48 00 7e 00 1d 0e 0d 00 7e 00 1c 00 03
|
|
|
|
# CC 11 11 22 22 33 33 44 55 66 66 77 77 88 88
|
2021-10-31 17:14:22 +00:00
|
|
|
# 1: Battery charge: 72 %
|
|
|
|
# 2: Battery voltage: 12.6 V
|
|
|
|
# 3: Battery current: 0.29 A
|
|
|
|
# 4: Internal temperature?
|
|
|
|
# 5: External temperature probe for battery signet 8bit: 13 degC
|
|
|
|
# 6: Load voltage: 12.6 V
|
|
|
|
# 7: Load current: 0.28 A
|
|
|
|
# 8: Load power: 3 W
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# get(255, 263, 4)
|
|
|
|
# ff 03 01 07 00 04
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_PANEL_STATUS = b"\xff\x03\x01\x07\x00\x04"
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 08 00 c8 00 14 00 04 00 01
|
|
|
|
# CC 11 11 22 22 33 33 ?? ??
|
|
|
|
# 1: Panel voltage: 20.0 V
|
|
|
|
# 2: Panel current: 0.20 A
|
|
|
|
# 3: Panel power: 4 W
|
|
|
|
# Charging status?
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# set(255, 266, 1 or 0)
|
|
|
|
# ff 06 01 0a 00 01
|
|
|
|
CMD_ENABLE_LOAD = b"\xff\x06\x01\x0a\x00\x01"
|
|
|
|
CMD_DISABLE_LOAD = b"\xff\x06\x01\x0a\x00\x00"
|
|
|
|
REG_LOAD_ENABLE = 0x010A
|
|
|
|
|
|
|
|
# get(255, 267, 21)
|
|
|
|
# ff 03 01 0b 00 15
|
|
|
|
CMD_GET_LOAD_PARAMETERS = b"\xff\x03\x01\x0b\x00\x15"
|
|
|
|
# > ff 03 2a 00 7c 00 7f 00 51 00 20 00 0a 00 03 00 00 00 00 00
|
|
|
|
# > 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
|
|
|
|
# > 00 00 00 00 00
|
|
|
|
|
|
|
|
# get(255, 288, 3)
|
|
|
|
# ff 03 01 20 00 03
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_2 = b"\xff\x03\x01\x20\x00\x03"
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 06 80 02 00 00 00 00
|
|
|
|
# CC 11 22 33 33 33 33
|
|
|
|
# 1: boolean flag?: 1
|
|
|
|
# 2: ?: 2
|
|
|
|
# 3: ?: 0
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# get(255, 57345, 33)
|
|
|
|
# ff 03 e0 01 00 21
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_BATTERY_PARAMETERS = b"\xff\x03\xe0\x01\x00\x21"
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 42 07 d0 00 c8 ff 0c 00 02 00 a0 00 9b 00 92 00 90 00
|
|
|
|
# > 8a 00 84 00 7e 00 78 00 6f 00 6a 64 32 00 05 00 78 00 78 00
|
|
|
|
# > 1e 00 03 00 41 00 a3 00 4b 00 a3 00 00 00 00 00 00 00 00 00
|
|
|
|
# > 0f 00 05 00 05 00 04 01 00
|
|
|
|
# 33 * uint16
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# get(1, 61440, 10)
|
|
|
|
# 01 03 f0 00 00 0a
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_GET_HISTORICAL_TODAY = b"\x01\x03\xf0\x00\x00\x0a"
|
|
|
|
CMD_GET_HISTORICAL_YESTERDAY = b"\x01\x03\xf0\x01\x00\x0a"
|
|
|
|
CMD_GET_HISTORICAL_D2 = b"\x01\x03\xf0\x02\x00\x0a"
|
|
|
|
CMD_GET_HISTORICAL_D3 = b"\x01\x03\xf0\x03\x00\x0a"
|
2021-10-31 15:33:56 +00:00
|
|
|
|
|
|
|
# ,- battery_min_voltage
|
|
|
|
# | ,- battery_max_voltage
|
|
|
|
# | | ,- ?1 max charge %?
|
|
|
|
# | | | ,- ?2
|
|
|
|
# | | | | ,- charge_max_power
|
|
|
|
# | | | | | ,- discharge_max_power
|
|
|
|
# | | | | | | ,- charge_amp_hour
|
|
|
|
# | | | | | | | ,- discharge_amp_hour
|
|
|
|
# | | | | | | | | ,- production_power
|
|
|
|
# | | | | | | | | | ,- consumption_power
|
|
|
|
# _|___ _|___ _|___ _|___ _|___ _|___ _|___ _|___ _|___ _|___
|
|
|
|
# > 01 03 14 00 7c 00 7f 00 51 00 20 00 0a 00 03 00 00 00 00 00 00 00 00
|
|
|
|
# > 01 03 14 00 7c 00 7f 00 53 00 20 00 0a 00 03 00 00 00 00 00 00 00 00
|
|
|
|
# battery_min_voltage = 12.4 V
|
|
|
|
# battery_max_voltage = 12.7 V
|
|
|
|
# ?1 = 83 % ?
|
|
|
|
# ?2 =
|
|
|
|
# charge_max_power = 10 W
|
|
|
|
# discharge_max_power = 3 W
|
|
|
|
# charge_amp_hour = 0 Ah
|
|
|
|
# discharge_amp_hour = 0 Ah
|
|
|
|
# production_power = 0 Wh
|
|
|
|
# consumption_power = 0 Wh
|
|
|
|
|
2021-11-02 03:26:40 +00:00
|
|
|
# ff 78 00 00 00 01
|
2021-10-31 17:14:22 +00:00
|
|
|
CMD_ = b"\xff\x78\x00\x00\x00\x01"
|
2021-10-31 15:33:56 +00:00
|
|
|
|
2021-10-31 17:14:22 +00:00
|
|
|
# CMD_GET_BATTERY_STATE = b'\xff\x03\x01\x00\x00\x07'
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 0e 00 48 00 7e 00 1d 0e 0d 00 7e 00 1c 00 03
|
|
|
|
# CC 11 11 22 22 33 33 44 55 66 66 77 77 88 88
|
2021-10-31 17:14:22 +00:00
|
|
|
# 1: Battery charge: 72 %
|
|
|
|
# 2: Battery voltage: 12.6 V
|
|
|
|
# 3: Battery current: 0.29 A
|
|
|
|
# 4: Internal temperature?
|
|
|
|
# 5: External temperature probe for battery signed 8bit: 13 degC
|
|
|
|
# 6: Load voltage: 12.6 V
|
|
|
|
# 7: Load current: 0.28 A
|
|
|
|
# 8: Load power: 3 W
|
|
|
|
|
|
|
|
# CMD_GET_PANEL_STATUS = b'\xff\x03\x01\x07\x00\x04'
|
2021-10-31 15:33:56 +00:00
|
|
|
# > ff 03 08 00 c8 00 14 00 04 00 01
|
|
|
|
# CC 11 11 22 22 33 33 ?? ??
|
|
|
|
# > ff 03 08 00 00 00 00 00 00 00 00
|
|
|
|
# 1: Panel voltage: 20.0 V
|
|
|
|
# 2: Panel current: 0.20 A
|
|
|
|
# 3: Panel power: 4 W
|
|
|
|
# ?: load_enabled
|
|
|
|
|
|
|
|
|
2021-11-06 18:54:50 +00:00
|
|
|
def parse_temperature(bin):
|
|
|
|
if bin & 0x80:
|
|
|
|
return (bin & 0x7F) * -1
|
|
|
|
return bin & 0x7F
|
|
|
|
|
|
|
|
|
2021-11-05 05:51:35 +00:00
|
|
|
# GET_BATTERY_STATE
|
|
|
|
def parse_battery_state(data: bytes) -> dict:
|
|
|
|
res = dict(
|
|
|
|
zip(
|
|
|
|
(
|
2021-11-08 03:29:43 +00:00
|
|
|
"battery_charge", # %
|
|
|
|
"battery_voltage", # V
|
|
|
|
"battery_current", # A
|
|
|
|
"_internal_temperature?", # °C
|
|
|
|
"battery_temperature", # °C
|
|
|
|
"load_voltage", # V
|
|
|
|
"load_current", # A
|
|
|
|
"load_power", # W
|
|
|
|
"panel_voltage", # V
|
|
|
|
"panel_current", # A
|
|
|
|
"panel_power", # W
|
|
|
|
"load_enabled", # bool
|
2021-11-05 05:51:35 +00:00
|
|
|
),
|
2021-11-08 03:29:43 +00:00
|
|
|
struct.unpack("!HHHBBHHHHHHx?", data),
|
2021-11-05 05:51:35 +00:00
|
|
|
)
|
|
|
|
)
|
|
|
|
res["battery_voltage"] /= 10
|
|
|
|
res["battery_current"] /= 100
|
|
|
|
res["load_voltage"] /= 10
|
|
|
|
res["load_current"] /= 100
|
2021-11-06 18:54:50 +00:00
|
|
|
res["_internal_temperature?"] = parse_temperature(res["_internal_temperature?"])
|
|
|
|
res["battery_temperature"] = parse_temperature(res["battery_temperature"])
|
2021-11-08 03:29:43 +00:00
|
|
|
res["panel_voltage"] /= 10
|
|
|
|
res["panel_current"] /= 100
|
2021-11-05 05:51:35 +00:00
|
|
|
|
|
|
|
return res
|
|
|
|
|
|
|
|
|
2021-11-08 03:29:43 +00:00
|
|
|
def parse_historical_entry(data: bytes) -> dict:
|
2021-11-05 05:51:35 +00:00
|
|
|
res = dict(
|
|
|
|
zip(
|
2021-11-08 03:29:43 +00:00
|
|
|
(
|
|
|
|
"battery_voltage_min", # V
|
|
|
|
"battery_voltage_max", # V
|
|
|
|
"unknown1",
|
|
|
|
"unknown2",
|
|
|
|
"charge_max_power",
|
|
|
|
"discharge_max_power",
|
|
|
|
"charge_amp_hour",
|
|
|
|
"discharge_amp_hour",
|
|
|
|
"production_power",
|
|
|
|
"consumption_power",
|
|
|
|
),
|
|
|
|
struct.unpack_from("!10H", data),
|
2021-11-05 05:51:35 +00:00
|
|
|
)
|
|
|
|
)
|
2021-11-08 03:29:43 +00:00
|
|
|
res["battery_voltage_min"] /= 10
|
|
|
|
res["battery_voltage_max"] /= 10
|
|
|
|
|
|
|
|
if len(data) > 20:
|
|
|
|
res.update(
|
|
|
|
dict(
|
|
|
|
zip(
|
|
|
|
(
|
|
|
|
"run_days",
|
|
|
|
"discharge_count",
|
|
|
|
"full_charge_count",
|
|
|
|
"total_charge_amp_hours",
|
|
|
|
"total_discharge_amp_hours",
|
|
|
|
"total_production_power",
|
|
|
|
"total_consumption_power",
|
|
|
|
),
|
|
|
|
struct.unpack_from("!3H4L", data, offset=20),
|
|
|
|
),
|
|
|
|
)
|
|
|
|
)
|
2021-11-05 05:51:35 +00:00
|
|
|
|
|
|
|
return res
|
2021-10-31 15:33:56 +00:00
|
|
|
|
2021-10-31 17:14:22 +00:00
|
|
|
|
2021-10-31 15:33:56 +00:00
|
|
|
def write(fh, data):
|
|
|
|
bdata = bytes(data)
|
|
|
|
crc = modbus(bdata)
|
2021-10-31 17:14:22 +00:00
|
|
|
bcrc = bytes([crc & 0xFF, (crc & 0xFF00) >> 8])
|
2021-10-31 15:33:56 +00:00
|
|
|
fh.write(data + bcrc)
|
|
|
|
|
2021-10-31 17:14:22 +00:00
|
|
|
|
2021-11-05 02:01:43 +00:00
|
|
|
def construct_request(address, words=1, action=ACTION_READ, marker=0xFF):
|
2021-11-05 05:58:12 +00:00
|
|
|
assert marker in POSSIBLE_MARKER, f"marker should be one of {POSSIBLE_MARKER}"
|
2021-11-05 02:01:43 +00:00
|
|
|
return struct.pack("!BBHH", marker, action, address, words)
|
2021-10-31 15:33:56 +00:00
|
|
|
|
|
|
|
|
2021-11-08 03:32:49 +00:00
|
|
|
def log(*message: object):
|
|
|
|
print(datetime.datetime.utcnow().isoformat(" "), *message)
|
2021-11-03 03:35:49 +00:00
|
|
|
sys.stdout.flush()
|
2021-10-31 15:33:56 +00:00
|
|
|
|
|
|
|
|
2021-11-03 21:25:39 +00:00
|
|
|
def parse_packet(data):
|
|
|
|
tag, operation, size = struct.unpack_from("BBB", data)
|
|
|
|
_unpacked = struct.unpack_from(f"<{size}BH", data, offset=3)
|
|
|
|
crc = _unpacked[-1]
|
|
|
|
payload = _unpacked[:-1]
|
|
|
|
calculated_crc = modbus(bytes([tag, operation, size, *payload]))
|
|
|
|
|
|
|
|
if crc != calculated_crc:
|
|
|
|
e = ValueError(f"CRC missmatch: expected {crc:04X}, got {calculated_crc:04X}.")
|
|
|
|
e.tag = tag
|
|
|
|
e.operation = operation
|
|
|
|
e.size = size
|
|
|
|
e.payload = payload
|
|
|
|
e.crc = crc
|
|
|
|
e.calculated_crc = calculated_crc
|
|
|
|
raise e
|
|
|
|
|
|
|
|
return payload
|
|
|
|
|
|
|
|
|
2021-11-05 05:51:35 +00:00
|
|
|
def readMemory(fh: RawIOBase, address: int, words: int = 1):
|
2021-11-06 18:54:50 +00:00
|
|
|
# log(f"Reading {words} words from 0x{address:04X}")
|
2021-11-05 05:51:35 +00:00
|
|
|
write(fh, construct_request(address, words=words))
|
|
|
|
header = fh.read(3)
|
|
|
|
if header and len(header) == 3:
|
|
|
|
tag, operation, size = header
|
|
|
|
data = fh.read(size)
|
|
|
|
_crc = fh.read(2)
|
|
|
|
if data and _crc:
|
|
|
|
crc = struct.unpack_from("<H", _crc)[0]
|
|
|
|
calculated_crc = modbus(bytes([tag, operation, size, *data]))
|
|
|
|
if crc == calculated_crc:
|
|
|
|
return data
|
|
|
|
|
|
|
|
|
2021-11-08 03:29:43 +00:00
|
|
|
class Periodical:
|
|
|
|
prev: float
|
|
|
|
interval: float
|
|
|
|
|
|
|
|
def __init__(self, interval: float, start: Optional[float] = None):
|
|
|
|
self.prev = time.time() - interval if start is None else start
|
|
|
|
self.interval = interval
|
|
|
|
|
|
|
|
def __call__(self, now: Optional[float] = None) -> bool:
|
|
|
|
if now is None:
|
|
|
|
now = time.time()
|
|
|
|
|
|
|
|
if (now - self.prev) >= self.interval:
|
|
|
|
self.prev += self.interval
|
|
|
|
return True
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
2021-11-03 03:35:49 +00:00
|
|
|
if __name__ == "__main__":
|
2021-10-31 15:33:56 +00:00
|
|
|
|
2021-11-08 03:29:43 +00:00
|
|
|
per_voltages = Periodical(interval=15)
|
|
|
|
per_current_hist = Periodical(interval=60)
|
2021-11-02 22:48:06 +00:00
|
|
|
|
2021-11-03 03:35:49 +00:00
|
|
|
while True:
|
|
|
|
try:
|
|
|
|
log("Connecting...")
|
2021-11-05 05:51:35 +00:00
|
|
|
with BTLEUart(MAC, timeout=10) as dev:
|
2021-11-03 03:35:49 +00:00
|
|
|
log("Connected.")
|
|
|
|
|
2021-11-05 05:51:35 +00:00
|
|
|
# write(dev, construct_request(0, 32))
|
2021-11-03 03:35:49 +00:00
|
|
|
|
|
|
|
# Memory dump
|
|
|
|
# for address in range(0, 0x10000, 16):
|
|
|
|
# log(f"Reading 0x{address:04X}...")
|
|
|
|
# write(wd, construct_request(address, 16))
|
2021-11-08 03:29:43 +00:00
|
|
|
days = 7
|
|
|
|
res = readMemory(dev, 0x010B, 21)
|
|
|
|
if res:
|
|
|
|
d = parse_historical_entry(res)
|
|
|
|
log(d)
|
|
|
|
days = cast(int, d.get("run_days", 7))
|
|
|
|
|
|
|
|
for i in range(days):
|
|
|
|
res = readMemory(dev, 0xF000 + i, 10)
|
|
|
|
if res:
|
|
|
|
d = parse_historical_entry(res)
|
|
|
|
log({i: d})
|
2021-11-03 03:35:49 +00:00
|
|
|
|
|
|
|
while True:
|
|
|
|
now = time.time()
|
2021-11-08 03:29:43 +00:00
|
|
|
if per_voltages(now):
|
|
|
|
# CMD_GET_BATTERY_STATE + CMD_GET_PANEL_STATUS
|
|
|
|
res = readMemory(dev, 0x0100, 11)
|
2021-11-05 05:51:35 +00:00
|
|
|
if res:
|
2021-11-08 03:32:49 +00:00
|
|
|
try:
|
|
|
|
d = parse_battery_state(res)
|
|
|
|
log(d)
|
|
|
|
except struct.error:
|
|
|
|
log("0x0100 Unpack error:", res)
|
2021-11-08 03:29:43 +00:00
|
|
|
if per_current_hist(now):
|
|
|
|
res = readMemory(dev, 0x010B, 21)
|
2021-11-05 05:51:35 +00:00
|
|
|
if res:
|
2021-11-08 03:32:49 +00:00
|
|
|
try:
|
|
|
|
d = parse_historical_entry(res)
|
|
|
|
log(d)
|
|
|
|
except struct.error:
|
|
|
|
log("0x010B Unpack error:", res)
|
2021-11-08 03:29:43 +00:00
|
|
|
# print(".")
|
2021-11-05 05:58:12 +00:00
|
|
|
time.sleep(1)
|
|
|
|
|
2021-11-03 03:35:49 +00:00
|
|
|
# if STATUS.get('load_enabled'):
|
|
|
|
# write(wd, CMD_DISABLE_LOAD)
|
|
|
|
# else:
|
|
|
|
# write(wd, CMD_ENABLE_LOAD)
|
|
|
|
|
|
|
|
except btle.BTLEDisconnectError:
|
|
|
|
log("ERROR: Disconnected")
|
|
|
|
time.sleep(1)
|
2021-11-08 03:29:43 +00:00
|
|
|
except KeyboardInterrupt:
|
|
|
|
break
|