Welcome to rctclient's documentation!

This documentation covers the rctclient python library, used to interact with solar inverters by RCT Power GmbH by implementing their proprietary "RCT Power Serial Communication Protocol". It also serves as documentation of the protocol itself.

Disclaimer: Neither the python library nor this documentation is in any way affiliated with or supported by RCT Power GmbH in any way. Do not ask them for support regarding anything concerning the content of the material provided by this project.

2nd Disclaimer: Use the material provided by this project (code, documentation etc.) at your own risk. None of the contributors can be held liable for any damage that may occur by using the information provided. See also the LICENSE file for further information.

Module contents

• Usage
  • Parts overview
  • Basic workflow
  • Basic example
  • Caveats
  • Conclusion
• CLI
• Registry
  • acc_conv
  • adc
  • bat_mng_struct
  • battery
  • buf_v_control
  • can_bus
  • cs_map
  • cs_neg
  • db
  • dc_conv
  • display_struct
  • energy
  • fault
  • flash_param
  • flash_rtc
  • grid_lt
  • grid_mon
  • g_sync
  • hw_test
  • io_board
  • iso_struct
  • line_mon
  • logger
  • modbus
  • net
  • nsm
  • others
  • power_mng
  • p_rec
  • prim_sm
  • rb485
  • switch_on_cond
  • temperature
  • wifi
• Simulator
  • Starting the simulator
  • How it works
  • Limitations
• API
  • Types
  • Exceptions
  • Classes
  • Functions
• Tools and scripts
  • timeseries2csv.py
  • csv2influxdb.py
  • read_pcap.py
• Changelog
  • Release 0.0.3 - 2021-05-22
  • Release 0.0.2 - 2021-02-17
  • Release 0.0.1 - 2020-10-07

Protocol

• Overview
• Event Table
• Timeseries

History

The original implementation was done by GitHub user pob90, including a simulator that can be used for development and a command line tool to manually query single objects from the device. The simulator proved to be invaluable when developing software that interfaces with RCT devices and when porting the code to Python 3. According to a forum post and comments in the code base, the implementation is based on the official documentation by the vendor, version 1.8.

The original implementation can be found here: https://github.com/pob90/openWB/tree/master/modules/rct_power

The implementation was done for use with the OpenWB project. The projects goal is to provide an open source wall box for charging electric cars, and it needs to interface with various devices in order to optimize its usage of energy, such as only charging when the solar inverter signals an abundance of energy.

The integration can be found in their repository:

• bezug_rct (python implementation and call example using shell).

• speicher_rct (shell calls only)

• wr_rct (shell calls only)

The project was, however, implemented as pure Python 2 code. As Python 2 is officially dead and (as of writing this) the first distributions completed its removal, the first step was to convert everything to Python 3. Once the code worked (again), the structure was changed to span multiple files instead of one single file, some classes were split, many were renamed and variable constants were converted to enums and PEP-484 type hinting was added.