nicolaus-hee / esp8266-benq-rs232-mqtt

Control a BenQ TH530 projector via its RS232 interface with an ESP8266, MQTT and openHAB.

esp8266-benq-rs232-mqtt

Objective: Control this BenQ TH530 projector via its RS232 interface with an ESP8266, MQTT and openHAB.

Features

ℹ️ Read power / source / volume status
💡 Read lamp mode & hours
⚡ Trigger power (on/off) commands
📺 Trigger source changes (HDMI etc.)
🔇 Change volume or mute
🍃 Change lamp mode
📣 Publish status updates via MQTT
👂 Listen for MQTT commands
👉 Send custom commands via MQTT
💬 Respond to custom commands via MQTT

Installation

1️⃣ Required hardware

• ESP8266 (I used a Wemos D1 Mini)
• RS232 to TTL converter with female DB9

2️⃣ ESP8266 and RS232 to TTL converter

1. Wire ESP8266 and RS232 to TTL converter.
   (ESP → TTL)
   G → GND
   5V → VCC
   D4 → TXD
   RX → RXD
2. Add your MQTT broker & WiFI credentials to the esp8266-benq-rs232-mqtt.ino sketch, then flash it to your board.
3. Plug the DB9 connector to the RS232 port of the projector.

✅ Your ESP will now publish projector status MQTT messages and listen for commands.

3️⃣ openHAB (optional)

1. Make sure you have the JsonPath transformation service, MQTT binding and a MQTT broker installed.
2. Create a new Generic MQTT thing, choose 34c510f090:20807f1aae as the identifier.
3. Edit the new thing, paste the contents of benq_thing.yaml in the 'Code' tab and save.
4. Place benq.items in your openhab-conf/items folder (e.g. /etc/openhab/items)
5. Place benq.sitemap in your openhab-conf/sitemaps folder or paste the contents to your existing sitemap.

✅ You can now control the projector using the openHAB GUI.

4️⃣ Google Assistant via openHAB (optional)

1. Complete the openHAB steps above.
2. Connect your openHAB instance to the openHAB Cloud connector.
3. Expose the newly created projector items to the openHAB Cloud (Settings → openHAB Cloud → Items to Expose).
4. Ask Google Assistant to "Talk to openHAB" to link your openHAB Cloud account to your Assistant.

✅ A TV device will appear in your Google Home app and you can now control the projector via the app or with voice commands such as "mute my TV".

MQTT implementation

stat topics are published by the module and contain status messages. cmnd topics are used to execute commands on the projector.

Topic	Payload	Comment
stat/projector/STATUS	{"POWER":"ON","SOURCE":"HDMI","VOLUME":4, "LAMP_MODE":"ECO","LAMP_HOURS":105,"MUTE":"OFF"}	Every 5 seconds
cmnd/projector/POWER	ON, OFF	Power on / off
cmnd/projector/SOURCE	HDMI, SVID, VID, RGB, RGB2	Set source
cmnd/projector/VOLUME	0...10	Set volume
cmnd/projector/MUTE	ON, OFF	(Un)mute
cmnd/projector/LAMP_MODE	LNOR, ECO, SECO, SECO2	Set lamp mode
cmnd/projector/COMMAND	See BenQ docu, e.g. VOL=?
stat/projector/COMMAND	{"COMMAND":"...","RESPONSE":"..."}	Returns result of above