Library for managing Charge Controllers

XY-L10A or XY-L30A

Controllers XY-L10A and XY-L30A working via UART

For connecting to controller you should set file and baudrate of port

Baudrate in datasheet is 115200

Actual baudrate is 9600

Basic Usage

Class init

import xy_lxxa as CTRL
ups = CTRL.XYCTRL(port='/dev/ttyUSB0', baudrate=9600, timeout=0.1)

timeout=0.1 is used after sending command to controller

Get Controller-settings

try:
    data = ups.readSettings()
    if data == 'NO_DATA':
        print('Can not read settings from controller...')
    else:
        LV, HV, T = data
        print(f'Low Voltage: {LV}')
        print(f'High Voltage: {HV}')
        print(f'Time: {T}\n')
except Exception as e:
    print(e)

Get Measures

try:
    data = ups.readMeasure()
    if data == 'NO_DATA':
        print('Can not read measures from controller...')
    else:
        V, P, T, S = data
        print(f'Battery: {V}')
        print(f'Charge: {P}')
        print(f'Time: {T}')
        state = 'ON' if S == 'CL' else 'OFF'
        print(f'State: {state}')
except Exception as e:
    print(e)

Setup Voltage histeresis

try:
    if ups.setVoltage(12.1, 12.6) == 'OK':
        print('Set Voltage OK')
except Exception as e:
    print(e)

Relay Switch ON

try:
    if ups.control(1) == 'ON':
        print('Relay is ON')
    else:
        print('Relay is OFF')
except Exception as e:
    print(e)

Relay Switch OFF

try:
    if ups.control(0) == 'ON':
        print('Relay is ON')
    else:
        print('Relay is OFF')
except Exception as e:
    print(e)

Set Timer

try:
    if ups.setTime(0, 10) == 'OK':
        print('Set timer OK (10 minutes)')
    else:
        print('Can not set up timer')
except Exception as e:
    print(e)

Start data-stream and subscribe to it

streamWorks = False
try:
    if ups.startStream() == 'STREAM_STARTED':
        print('Stream started successfully')
        streamWorks = True
except Exception as e:
    print(e)
# Read data from stream
count = 1
try:
    while streamWorks:
        data = ups.readFromStream()
        if data == 'NO_DATA':
            print('Can not read measures from stream')
        else:
            V, P, T, S = data
            counter = '{:0>5.0f}'.format(count)
            print(f'\n----------{counter}----------')
            print(f'Battery: {V}')
            print(f'Charge: {P}')
            print(f'Time: {T}')
            state = 'ON' if S == 'CL' else 'OFF'
            print(f'State: {state}')
        count += 1
        time.sleep(3)
except Exception as e:
    print(e)
    streamWorks = False

except KeyboardInterrupt:
    pass
finally:
    try:
        if ups.stopStream() == 'STREAM_STOPPED':
            print('Stream stop OK')
        else:
            print('Can not stop stream')
    except Exception as e:
        print(e)
    ups.disconnect()

Disconnect

try:
    if ups.disconnect() == 'DISCONNECTED':
        print('Disconnected successfully')
    else:
        print('Can not disconnect')
except Exception as e:
    print(e)