ioBroker.rct

!Number of Installations (latest)
!Number of Installations (stable)



Tests: !Test and Release

RCT adapter for ioBroker

Please note that this is a private project and that I (Andreas Ruttkamp) am not related to RCT in any way.
Read values of a RCT Power photovoltaics power converter.

REMARKS

By using the "RCT Elements" field, one may select which data shall be read from the power converter.
If nothing is entered here, default will be used:

"battery.bat_status,battery.soc,battery.soc_target,battery.soc_target_high,battery.soc_target_low,dc_conv.dc_conv_struct[0].p_dc_lp,dc_conv.dc_conv_struct[1].p_dc_lp,fault[0].flt,fault[1].flt,fault[2].flt,fault[3].flt,g_sync.p_ac_grid_sum_lp,g_sync.p_ac_load_sum_lp,g_sync.p_ac_sum_lp,g_sync.p_acc_lp,g_sync.u_sg_avg[0],g_sync.u_sg_avg[1],io_board.s0_external_power,power_mng.is_heiphoss,power_mng.state,power_mng.u_acc_mix_lp,prim_sm.island_flag"

Other elements can be found in the code (file "rct/rc_core2.js"). Since this is not self descriptive, use at own risk!

The object "battery.bat_status" indicates the status of a connected battery:
* 0 -> charge/discharge (normal operation)
* 1 -> idle (no CAN-connection inverter -> battery)
* 3 -> connecting (inverter -> battery)
* 5 -> synchronizing (inverter -> battery)
* 8 -> calibrating - charging phase (0% --> 100%)
* 1024 -> calibrating - discharge phase (xx% --> 0%)
* 2048 -> balancing

The object "inverter_state" indicates the status of the inverter
* 0 -> 'Standby'
* 1 -> 'Initialization'
* 2 -> 'Standby'
* 3 -> 'Efficiency (debug state for development purposes)'
* 4 -> 'Insulation check'
* 5 -> 'Island check (decision where to go - grid connected or island)'
* 6 -> 'Power check (decision if enougth energy to start or not)'
* 7 -> 'Symmetry (DC-link alignment)'
* 8 -> 'Relays test'
* 9 -> 'Grid passive (inverter get power from grid without bridge clocking)'
* 10 -> 'Prepare battery passive'
* 11 -> 'Battery passive (off-grid)'
* 12 -> 'Hardware test'
* 13 -> 'Grid feeding'

Known Issues

None

Changelog

$3

* (Andreas Ruttkamp) repro checker issues resolved
* (Andreas Ruttkamp) npm trusted publishing integrated

$3

* (Andreas Ruttkamp) dev dependencies updated
* (Andreas Ruttkamp) minimum version for admin now 7.6.17
* (Andreas Ruttkamp) minimum version for js controller now 6.0.11

$3

* (Andreas Ruttkamp) enhancement issue #241

$3

* (Andreas Ruttkamp) update deps
* (Andreas Ruttkamp) testing node24 implemented

$3

* (Andreas Ruttkamp) update deps
* (Andreas Ruttkamp) minimum node.js version changed to 20

$3

* (Andreas Ruttkamp) update deps
* (Andreas Ruttkamp) minimum version for admin now 7.4.10

$3

* (NCIceWolf) Debug mode in Admin added
* (NCIceWolf) update dependencies

$3

* (Andreas Ruttkamp) update deps
* (Andreas Ruttkamp) update copyright

$3

* (NCIceWolf) Changed admin to type "panel"

$3

* (Andreas Ruttkamp) update deps
* (Andreas Ruttkamp) include node.js 22 testing
* (Andreas Ruttkamp) IMPLEMENTING eslint 9

$3

* (Andreas Ruttkamp) removed .npmignore

$3

* (NCIceWolf) Added multiple debugging messages
* (NCIceWolf) Corrected debug messages to be shown as debug, not info
* (NCIceWolf) corrected connection abortion if not successfully established
* (NCIceWolf) elements from inverter are only requested once a connection is successfully established
* (NCIceWolf) added requested and received elements to/from inverter to debug logging
* (NCIceWolf) merged recent dependabot suggestions
* (Andreas Ruttkamp) Dependabot suggested updates
* (Andreas Ruttkamp) some Code cosmetics

$3

* (Andreas Ruttkamp) Dependabot suggested updates
* (NCIceWolf) Improving connectivity to inverter

$3

* (NCIceWolf) mistyping corrected

$3

* (NCIceWolf) stability improvements for data connection to inverter
* (Andreas Ruttkamp) some code corrections

$3

* (Andreas Ruttkamp) wrong type for next_calib_date corrected

$3

* (NCIceWolf) Implementation of new adminUI
* (Andreas Ruttkamp) index_m.html deleted
* (Andreas Ruttkamp) Datatype battery_stack_cycles corrected
* (NCIceWolf) style.css deleted (not needed for json admin)
* (NCIceWolf) removed tab-materialize (leftover from initial adapter creation)
* (NCIceWolf) updated minimum js-controller version to >= 5.0.0
* (NCIceWolf) added minimum admin version to >= 5.0.0
* (NCIceWolf) prepared translations for adminUI

$3

* (Andreas Ruttkamp) prim_sm.state added
* (NCIceWolf) handling of type errors added
* (Andreas Ruttkamp) some Code cleaning
* (NCIceWolf) Update io-package.json

$3

* (Andreas Ruttkamp) unused parameter deleted

$3

* (Andreas Ruttkamp) misspelling in rct_core2 corrected
* (Andreas Ruttkamp) Missing ack:true added ( issue:#89)
* (Andreas Ruttkamp) datatypes corrected ( issue:#106)
* (NCIceWolf) changes to correct loosing connection ( issue:#114 )

$3

* (Andreas Ruttkamp) adapter not running in 1.2.3 - fixed

$3

* (Andreas Ruttkamp) prim_sm.state added
* (Andreas Ruttkamp) states for battery added
* (Andreas Ruttkamp) output of data points power_mng.soc_min and soc_min_island corrected

$3

* (Andreas Ruttkamp) data type for power_mng.bat_next_calib_date corrected
* (Andreas Ruttkamp) data type for battery.stack_cycles[x] corrected

$3

* (Andreas Ruttkamp) configured rct elements will now be used correctly ( in 1.2.0 only power_mng.bat_next_calib_date was read)

$3

* (Andreas Ruttkamp) connection state corrected when adapter is stopped
* (Andreas Ruttkamp) dependancies updated

$3

* (Andreas Ruttkamp) connection state corrected

$3

* (Andreas Ruttkamp) rct_core.js deleted (now rct_core2 is used)
* (Andreas Ruttkamp) parameters in default setting deleted
* (Andreas Ruttkamp) min. Node 18

$3

* (Andreas Ruttkamp) Fix: crash reading UInt8 corrected
* (Andreas Ruttkamp) some cleaning actions

$3

* (Andreas Ruttkamp) Fix: proofments corrected.

$3

* (Andreas Ruttkamp) Fix: more data checks implemented

$3

* (Andreas Ruttkamp) Fix: adapter crashes

$3

* (Andreas Ruttkamp) data for g_sync.p_ac_load[0-2] / dc_conv.dc_conv_struct[0-1].u_sg_lp added
* (Andreas Ruttkamp) more parameters added
* (Andreas Ruttkamp) date conversions fixed
* (Andreas Ruttkamp) conversions of percentages fixed
* (Andreas Ruttkamp) instance crash if data failure fixed

$3

* (Andreas Ruttkamp) some internal work
* (Andreas Ruttkamp) preparation for new admin
* (Andreas Ruttkamp) dependecies update

$3

* (Andreas Ruttkamp) Release Script added and update dev-components
* (Andreas Ruttkamp) Preparation of new backend

$3

* (Andreas Ruttkamp) Release Script added and update dev-components

$3

* (Markus Lauff) fixing review comments - thanks to Apollon77

$3

* (Markus Lauff) 0.0.6 version proved stable and fulfilling minimal functional requirements, so releasing it as version 1.0.0 for productive usage

$3

* (Markus Lauff) adding further channels/states, major stability improvements

$3

* (Markus Lauff) some fixes / minor improvements

$3

* (Markus Lauff) initially bare minimum working release

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Copyright (c) 2025 Andreas Ruttkamp