ONOKOM AIR TCL-1-MB-B
Controls TCL air conditioners via the ONOKOM TCL-1-MB-B Modbus gateway.
This template connects TCL air conditioners via the ONOKOM TCL-1-MB-B Modbus RTU gateway to the ModbusCloud platform. It provides temperature readings, operating mode status, fan speed, error reporting, and full HVAC control including target temperature, vane position, and eco/turbo/sleep/quiet modes.
- Protocol
- Modbus RTU
- Connection
- RS485, 9600 baud
- Registers
- 28, read and write
- Brand
- Onokom
- Key readings
- Indoor air temperature · Outdoor air temperature · Indoor/Outdoor heat exchanger temperature · Current fan speed · Error count and last error code · AC connected status
- Available commands
- Target temperature · Active (on/off) · Operating modes (Eco, Turbo, Sleep, Quiet) · Vane position (Vertical/Horizontal)
- Compatible models
- TCL-1-MB-B
- Last updated
Registers (28)
22 read, 19 write
| Name | Unit | Access | Address (Hidden until you enter your email) | Function (hidden) | Type (hidden) |
|---|---|---|---|---|---|
| Indoor air temperature | °C | Read | |||
| Outdoor air temperature | °C | Read | |||
| AC connected (Status) | Read | ||||
| Screen light (Status) | Read and write | ||||
| Heating 8 deg (Status) | Read and write | ||||
| Beeper (Status) | Read and write | ||||
| Gentle wind (Status) | Read and write | ||||
| Mold protection (Status) | Read and write | ||||
| Ionization (Status) | Read and write | ||||
| Self cleaning (Status) | Read and write | ||||
| Sleep mode (Status) | Read and write | ||||
| Quiet mode (Status) | Read and write | ||||
| Turbo mode (Status) | Read and write | ||||
| Eco mode (Status) | Read and write | ||||
| Vertical vanes (Status) | Read and write | ||||
| Outdoor heat exchanger temperature (Status) | °C | Read | |||
| Indoor heat exchanger temperature (Status) | °C | Read | |||
| Current fan speed (Status) | Read | ||||
| Error count | Read | ||||
| Last error code | Read | ||||
| Error count | count | Read | |||
| Horizontal vanes | Read and write | ||||
| Active (Control) | Write | ||||
| Loxone modes (Control) | Write | ||||
| Smart fan speed | Write | ||||
| Target temperature | °C | Write | |||
| Modbus address (Service) | Write | ||||
| Vertical vanes (Control) | Write |
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.
Use cases
- Monitor indoor and outdoor temperatures of TCL air conditioners on a live cloud dashboard for your customer.
- Create an alert when the AC unit reports an error code or loses connection to the gateway.
- Adjust target temperature and operating mode remotely without visiting the site.
- Track fan speed and heat exchanger temperatures to verify correct operation after installation.
- Switch between Eco, Turbo, Sleep, and Quiet modes based on time schedules or occupancy patterns.
- Log historical temperature data to support energy audits and comfort optimization.
Installation
Wire the ONOKOM TCL-1-MB-B gateway to the TCL air conditioner according to the ONOKOM installation manual and verify the AC connected status LED.
Connect the RS-485 A and B terminals of the TCL-1-MB-B to the RS-485 port on your ModbusCloud Gateway, observing correct polarity.
Set the Modbus slave address on the TCL-1-MB-B gateway and note it for configuration in the ModbusCloud platform.
Confirm the baud rate is set to 9600 on both the TCL-1-MB-B and the ModbusCloud gateway.
Import the ONOKOM AIR TCL-1-MB-B template in the ModbusCloud portal, enter the correct slave address, and verify that readings appear on your dashboard.
Things to watch for
Why do some registers seem to return unexpected values?
Some register addresses are shared between different functions, such as address 4 for outdoor air temperature and quiet mode. The template uses specific function codes to distinguish read and write operations. Make sure you have not manually altered the function code assignments in the template.
The gateway shows no data or the AC connected status is false. What should I check?
Verify the wiring between the ONOKOM TCL-1-MB-B and the TCL indoor unit. Ensure the unit is powered on and that the communication cable is seated correctly on both ends. Check that the TCL model is supported by the TCL-1-MB-B gateway.
What baud rate should I use?
The default baud rate for the ONOKOM TCL-1-MB-B is 9600. Make sure both the gateway and the ModbusCloud gateway RS-485 port are configured to 9600 baud, 8 data bits, no parity, 1 stop bit (8N1).
Can I control multiple TCL units from one ModbusCloud gateway?
Yes. Connect each ONOKOM TCL-1-MB-B on the same RS-485 bus with a unique Modbus slave address. Import a separate template instance for each unit and assign the matching address in the ModbusCloud portal.
Want to see how it works?
