Byd Byd BatteryBox Commercial C130 Modbus TCP template

Byd BatteryBox Commercial C130

The Byd BatteryBox Commercial C130 is a high-voltage lithium iron phosphate battery storage system designed for commercial and industrial applications including peak shaving, self-consumption optimization, and frequency regulation. Paired with the REFUstore 88K inverter, it communicates via Modbus TCP. This template reads state of charge, battery work state, cluster run state, BMS charge and discharge power limits, and per-cell voltages and temperatures across all 216 cells in cluster 1, plus the power circuit control register. These registers give operators granular cell-level visibility to verify pack health and detect imbalance across the full string.

Protocol
Modbus TCP
Connection
Ethernet, Modbus TCP
Registers
275, read and write
Brand
Byd
Last updated

Registers (275)

274 read, 1 write

NameUnitAccessAddress (Hidden until you enter your email)Function (hidden)Type (hidden)
power_circuit_control_aRead
power_circuit_control_bWrite
battery_work_stateRead
soc%Read
cluster_1_max_cell_voltage_idRead
cluster_1_min_cell_voltage_idRead
cluster_1_max_cell_temperature_idRead
cluster_1_min_cell_temperature_idRead
cluster_run_stateRead
bp_charge_bmsWRead
bp_discharge_bmsWRead
cluster_1_battery_001_voltageVRead
cluster_1_battery_002_voltageVRead
cluster_1_battery_003_voltageVRead
cluster_1_battery_004_voltageVRead
cluster_1_battery_005_voltageVRead
cluster_1_battery_006_voltageVRead
cluster_1_battery_007_voltageVRead
cluster_1_battery_008_voltageVRead
cluster_1_battery_009_voltageVRead
cluster_1_battery_010_voltageVRead
cluster_1_battery_011_voltageVRead
cluster_1_battery_012_voltageVRead
cluster_1_battery_013_voltageVRead
cluster_1_battery_014_voltageVRead
cluster_1_battery_015_voltageVRead
cluster_1_battery_016_voltageVRead
cluster_1_battery_017_voltageVRead
cluster_1_battery_018_voltageVRead
cluster_1_battery_019_voltageVRead
cluster_1_battery_020_voltageVRead
cluster_1_battery_021_voltageVRead
cluster_1_battery_022_voltageVRead
cluster_1_battery_023_voltageVRead
cluster_1_battery_024_voltageVRead
cluster_1_battery_025_voltageVRead
cluster_1_battery_026_voltageVRead
cluster_1_battery_027_voltageVRead
cluster_1_battery_028_voltageVRead
cluster_1_battery_029_voltageVRead
cluster_1_battery_030_voltageVRead
cluster_1_battery_031_voltageVRead
cluster_1_battery_032_voltageVRead
cluster_1_battery_033_voltageVRead
cluster_1_battery_034_voltageVRead
cluster_1_battery_035_voltageVRead
cluster_1_battery_036_voltageVRead
cluster_1_battery_037_voltageVRead
cluster_1_battery_038_voltageVRead
cluster_1_battery_039_voltageVRead
cluster_1_battery_040_voltageVRead
cluster_1_battery_041_voltageVRead
cluster_1_battery_042_voltageVRead
cluster_1_battery_043_voltageVRead
cluster_1_battery_044_voltageVRead
cluster_1_battery_045_voltageVRead
cluster_1_battery_046_voltageVRead
cluster_1_battery_047_voltageVRead
cluster_1_battery_048_voltageVRead
cluster_1_battery_049_voltageVRead
cluster_1_battery_050_voltageVRead
cluster_1_battery_051_voltageVRead
cluster_1_battery_052_voltageVRead
cluster_1_battery_053_voltageVRead
cluster_1_battery_054_voltageVRead
cluster_1_battery_055_voltageVRead
cluster_1_battery_056_voltageVRead
cluster_1_battery_057_voltageVRead
cluster_1_battery_058_voltageVRead
cluster_1_battery_059_voltageVRead
cluster_1_battery_060_voltageVRead
cluster_1_battery_061_voltageVRead
cluster_1_battery_062_voltageVRead
cluster_1_battery_063_voltageVRead
cluster_1_battery_064_voltageVRead
cluster_1_battery_065_voltageVRead
cluster_1_battery_066_voltageVRead
cluster_1_battery_067_voltageVRead
cluster_1_battery_068_voltageVRead
cluster_1_battery_069_voltageVRead
cluster_1_battery_070_voltageVRead
cluster_1_battery_071_voltageVRead
cluster_1_battery_072_voltageVRead
cluster_1_battery_073_voltageVRead
cluster_1_battery_074_voltageVRead
cluster_1_battery_075_voltageVRead
cluster_1_battery_076_voltageVRead
cluster_1_battery_077_voltageVRead
cluster_1_battery_078_voltageVRead
cluster_1_battery_079_voltageVRead
cluster_1_battery_080_voltageVRead
cluster_1_battery_081_voltageVRead
cluster_1_battery_082_voltageVRead
cluster_1_battery_083_voltageVRead
cluster_1_battery_084_voltageVRead
cluster_1_battery_085_voltageVRead
cluster_1_battery_086_voltageVRead
cluster_1_battery_087_voltageVRead
cluster_1_battery_088_voltageVRead
cluster_1_battery_089_voltageVRead
cluster_1_battery_090_voltageVRead
cluster_1_battery_091_voltageVRead
cluster_1_battery_092_voltageVRead
cluster_1_battery_093_voltageVRead
cluster_1_battery_094_voltageVRead
cluster_1_battery_095_voltageVRead
cluster_1_battery_096_voltageVRead
cluster_1_battery_097_voltageVRead
cluster_1_battery_098_voltageVRead
cluster_1_battery_099_voltageVRead
cluster_1_battery_100_voltageVRead
cluster_1_battery_101_voltageVRead
cluster_1_battery_102_voltageVRead
cluster_1_battery_103_voltageVRead
cluster_1_battery_104_voltageVRead
cluster_1_battery_105_voltageVRead
cluster_1_battery_106_voltageVRead
cluster_1_battery_107_voltageVRead
cluster_1_battery_108_voltageVRead
cluster_1_battery_109_voltageVRead
cluster_1_battery_110_voltageVRead
cluster_1_battery_111_voltageVRead
cluster_1_battery_112_voltageVRead
cluster_1_battery_113_voltageVRead
cluster_1_battery_114_voltageVRead
cluster_1_battery_115_voltageVRead
cluster_1_battery_116_voltageVRead
cluster_1_battery_117_voltageVRead
cluster_1_battery_118_voltageVRead
cluster_1_battery_119_voltageVRead
cluster_1_battery_120_voltageVRead
cluster_1_battery_121_voltageVRead
cluster_1_battery_122_voltageVRead
cluster_1_battery_123_voltageVRead
cluster_1_battery_124_voltageVRead
cluster_1_battery_125_voltageVRead
cluster_1_battery_126_voltageVRead
cluster_1_battery_127_voltageVRead
cluster_1_battery_128_voltageVRead
cluster_1_battery_129_voltageVRead
cluster_1_battery_130_voltageVRead
cluster_1_battery_131_voltageVRead
cluster_1_battery_132_voltageVRead
cluster_1_battery_133_voltageVRead
cluster_1_battery_134_voltageVRead
cluster_1_battery_135_voltageVRead
cluster_1_battery_136_voltageVRead
cluster_1_battery_137_voltageVRead
cluster_1_battery_138_voltageVRead
cluster_1_battery_139_voltageVRead
cluster_1_battery_140_voltageVRead
cluster_1_battery_141_voltageVRead
cluster_1_battery_142_voltageVRead
cluster_1_battery_143_voltageVRead
cluster_1_battery_144_voltageVRead
cluster_1_battery_145_voltageVRead
cluster_1_battery_146_voltageVRead
cluster_1_battery_147_voltageVRead
cluster_1_battery_148_voltageVRead
cluster_1_battery_149_voltageVRead
cluster_1_battery_150_voltageVRead
cluster_1_battery_151_voltageVRead
cluster_1_battery_152_voltageVRead
cluster_1_battery_153_voltageVRead
cluster_1_battery_154_voltageVRead
cluster_1_battery_155_voltageVRead
cluster_1_battery_156_voltageVRead
cluster_1_battery_157_voltageVRead
cluster_1_battery_158_voltageVRead
cluster_1_battery_159_voltageVRead
cluster_1_battery_160_voltageVRead
cluster_1_battery_161_voltageVRead
cluster_1_battery_162_voltageVRead
cluster_1_battery_163_voltageVRead
cluster_1_battery_164_voltageVRead
cluster_1_battery_165_voltageVRead
cluster_1_battery_166_voltageVRead
cluster_1_battery_167_voltageVRead
cluster_1_battery_168_voltageVRead
cluster_1_battery_169_voltageVRead
cluster_1_battery_170_voltageVRead
cluster_1_battery_171_voltageVRead
cluster_1_battery_172_voltageVRead
cluster_1_battery_173_voltageVRead
cluster_1_battery_174_voltageVRead
cluster_1_battery_175_voltageVRead
cluster_1_battery_176_voltageVRead
cluster_1_battery_177_voltageVRead
cluster_1_battery_178_voltageVRead
cluster_1_battery_179_voltageVRead
cluster_1_battery_180_voltageVRead
cluster_1_battery_181_voltageVRead
cluster_1_battery_182_voltageVRead
cluster_1_battery_183_voltageVRead
cluster_1_battery_184_voltageVRead
cluster_1_battery_185_voltageVRead
cluster_1_battery_186_voltageVRead
cluster_1_battery_187_voltageVRead
cluster_1_battery_188_voltageVRead
cluster_1_battery_189_voltageVRead
cluster_1_battery_190_voltageVRead
cluster_1_battery_191_voltageVRead
cluster_1_battery_192_voltageVRead
cluster_1_battery_193_voltageVRead
cluster_1_battery_194_voltageVRead
cluster_1_battery_195_voltageVRead
cluster_1_battery_196_voltageVRead
cluster_1_battery_197_voltageVRead
cluster_1_battery_198_voltageVRead
cluster_1_battery_199_voltageVRead
cluster_1_battery_200_voltageVRead
cluster_1_battery_201_voltageVRead
cluster_1_battery_202_voltageVRead
cluster_1_battery_203_voltageVRead
cluster_1_battery_204_voltageVRead
cluster_1_battery_205_voltageVRead
cluster_1_battery_206_voltageVRead
cluster_1_battery_207_voltageVRead
cluster_1_battery_208_voltageVRead
cluster_1_battery_209_voltageVRead
cluster_1_battery_210_voltageVRead
cluster_1_battery_211_voltageVRead
cluster_1_battery_212_voltageVRead
cluster_1_battery_213_voltageVRead
cluster_1_battery_214_voltageVRead
cluster_1_battery_215_voltageVRead
cluster_1_battery_216_voltageVRead
cluster_1_battery_00_temperature°CRead
cluster_1_battery_01_temperature°CRead
cluster_1_battery_02_temperature°CRead
cluster_1_battery_03_temperature°CRead
cluster_1_battery_04_temperature°CRead
cluster_1_battery_05_temperature°CRead
cluster_1_battery_06_temperature°CRead
cluster_1_battery_07_temperature°CRead
cluster_1_battery_08_temperature°CRead
cluster_1_battery_09_temperature°CRead
cluster_1_battery_10_temperature°CRead
cluster_1_battery_11_temperature°CRead
cluster_1_battery_12_temperature°CRead
cluster_1_battery_13_temperature°CRead
cluster_1_battery_14_temperature°CRead
cluster_1_battery_15_temperature°CRead
cluster_1_battery_16_temperature°CRead
cluster_1_battery_17_temperature°CRead
cluster_1_battery_18_temperature°CRead
cluster_1_battery_19_temperature°CRead
cluster_1_battery_20_temperature°CRead
cluster_1_battery_21_temperature°CRead
cluster_1_battery_22_temperature°CRead
cluster_1_battery_23_temperature°CRead
cluster_1_battery_24_temperature°CRead
cluster_1_battery_25_temperature°CRead
cluster_1_battery_26_temperature°CRead
cluster_1_battery_27_temperature°CRead
cluster_1_battery_28_temperature°CRead
cluster_1_battery_29_temperature°CRead
cluster_1_battery_30_temperature°CRead
cluster_1_battery_31_temperature°CRead
cluster_1_battery_32_temperature°CRead
cluster_1_battery_33_temperature°CRead
cluster_1_battery_34_temperature°CRead
cluster_1_battery_35_temperature°CRead
cluster_1_battery_36_temperature°CRead
cluster_1_battery_37_temperature°CRead
cluster_1_battery_38_temperature°CRead
cluster_1_battery_39_temperature°CRead
cluster_1_battery_40_temperature°CRead
cluster_1_battery_41_temperature°CRead
cluster_1_battery_42_temperature°CRead
cluster_1_battery_43_temperature°CRead
cluster_1_battery_44_temperature°CRead
cluster_1_battery_45_temperature°CRead
cluster_1_battery_46_temperature°CRead
cluster_1_battery_47_temperature°CRead

Loading registers…

Send your device list

If a device is not in the library yet, we build the template for free as soon as we have the register data.

Number of installations (optional)

Use cases

  • Monitor state of charge trends over weeks to verify the system delivers expected capacity during peak-shaving cycles.
  • Track BMS charge and discharge power limits to confirm the BMS is not restricting output below contractual demand targets.
  • Alert on elevated max cell temperature IDs in cluster 1 to catch thermal hotspots before they trigger a protective shutdown.
  • Compare min and max cell voltages across all 216 cells to detect imbalance developing in the string over time.
  • Verify cluster run state and battery work state after a grid event to confirm the system returned to normal operation.

Installation

  1. Confirm Modbus TCP is active on the BatteryBox Commercial C130 BMS: connect a laptop to the system LAN and verify the BMS web interface or REFUcontrol EMS is reachable, then enable Modbus TCP under the communication or Modbus section.

  2. Connect the ModbusCloud Gateway to the same Ethernet network as the C130 BMS, ensuring the Gateway can reach the BMS IP address on port 502.

  3. In your ModbusCloud portal, add the Gateway, import the Byd BatteryBox Commercial C130 template, and assign the correct Modbus unit ID configured on the BMS (check the BMS communication settings for the slave address).

  4. Spot-check the connection by reading register 8451 (soc): a value between 0 and 100 confirms the Gateway is polling correctly; if no value appears, verify the IP address, port 502 firewall rules, and unit ID.

Things to watch for

All cell voltage registers return zero or no value. What is wrong?

The 216 cell voltage registers start at address 10240 and are only populated when the cluster is in an active run state. Confirm cluster_run_state (address 8514) shows a non-zero operational code. If the cluster is in standby or fault state, the BMS may suppress cell data. Resolve any active fault first.

The gateway connects but soc always reads zero. Why?

Register 8451 returns a raw uint16. A value of zero at startup can be normal: the Byd BMS may report 0% until a full charge or discharge calibration cycle is completed. Cross-check the physical BMS display. If the display also shows zero, initiate a full cycle to recalibrate the SOC.

Writing to power_circuit_control_b causes the system to stop. What happened?

Register 8208 written via FC16 directly controls the power circuit. Sending an unexpected command word can trigger a shutdown or transition to a fault state. Always verify the current status via power_circuit_control_a before writing, use values from the BMS protocol documentation only, and test during a planned maintenance window to avoid unintended production impact or warranty implications.

Modbus TCP connection is refused or times out intermittently. What should I check?

The C130 BMS has limited simultaneous Modbus TCP connections. If the REFUcontrol EMS or another client holds the session, the ModbusCloud Gateway may be refused. Check that no other client is polling the same BMS IP. Also verify the BMS firmware is current: older firmware versions have known TCP keep-alive handling issues that cause intermittent drops.

More TCP templates

Want to see how it works?

Electrician working in an open distribution board