/* RF BRIDGE MODULE Copyright (C) 2016-2019 by Xose PĂ©rez */ #include "rfbridge.h" #if RF_SUPPORT #include #include "api.h" #include "relay.h" #include "terminal.h" #include "mqtt.h" #include "ws.h" // ----------------------------------------------------------------------------- // DEFINITIONS // ----------------------------------------------------------------------------- // EFM8 Protocol #define RF_MESSAGE_SIZE 9 #define RF_MAX_MESSAGE_SIZE (112+4) #define RF_CODE_START 0xAA #define RF_CODE_ACK 0xA0 #define RF_CODE_LEARN 0xA1 #define RF_CODE_LEARN_KO 0xA2 #define RF_CODE_LEARN_OK 0xA3 #define RF_CODE_RFIN 0xA4 #define RF_CODE_RFOUT 0xA5 #define RF_CODE_SNIFFING_ON 0xA6 #define RF_CODE_SNIFFING_OFF 0xA7 #define RF_CODE_RFOUT_NEW 0xA8 #define RF_CODE_LEARN_NEW 0xA9 #define RF_CODE_LEARN_KO_NEW 0xAA #define RF_CODE_LEARN_OK_NEW 0xAB #define RF_CODE_RFOUT_BUCKET 0xB0 #define RF_CODE_STOP 0x55 // Settings #define RF_MAX_KEY_LENGTH (9) // ----------------------------------------------------------------------------- // GLOBALS TO THE MODULE // ----------------------------------------------------------------------------- unsigned char _uartbuf[RF_MESSAGE_SIZE+3] = {0}; unsigned char _uartpos = 0; unsigned char _learnId = 0; bool _learnStatus = true; bool _rfbin = false; struct rfb_message_t { uint8_t code[RF_MESSAGE_SIZE]; uint8_t times; }; static std::queue _rfb_message_queue; #if RFB_DIRECT RCSwitch * _rfModem; bool _learning = false; #endif bool _rfb_receive = false; bool _rfb_transmit = false; unsigned char _rfb_repeat = RF_SEND_TIMES; // ----------------------------------------------------------------------------- // PRIVATES // ----------------------------------------------------------------------------- // From a byte array to an hexa char array ("A220EE...", double the size) static bool _rfbToChar(uint8_t * in, char * out, int n = RF_MESSAGE_SIZE) { for (unsigned char p = 0; p()); } bool _rfbWebSocketOnKeyCheck(const char * key, JsonVariant& value) { return (strncmp(key, "rfb", 3) == 0); } void _rfbWebSocketOnData(JsonObject& root) { _rfbWebSocketSendCodeArray(root, 0, relayCount()); } #endif // WEB_SUPPORT // From an hexa char array ("A220EE...") to a byte array (half the size) static int _rfbToArray(const char * in, uint8_t * out, int length = RF_MESSAGE_SIZE * 2) { int n = strlen(in); if (n > RF_MAX_MESSAGE_SIZE*2 || (length > 0 && n != length)) return 0; char tmp[3] = {0,0,0}; n /= 2; for (unsigned char p = 0; psetProtocol(protocol); if (timing > 0) { _rfModem->setPulseLength(timing); } _rfModem->send(rf_code, bitlength); _rfModem->resetAvailable(); } void _rfbReceive() { if (!_rfb_receive) return; static long learn_start = 0; if (!_learning && learn_start) { learn_start = 0; } if (_learning) { if (!learn_start) { DEBUG_MSG_P(PSTR("[RF] Arming learn timeout\n")); learn_start = millis(); } if (learn_start > 0 && millis() - learn_start > RF_LEARN_TIMEOUT) { DEBUG_MSG_P(PSTR("[RF] Learn timeout triggered\n")); memset(_uartbuf, 0, sizeof(_uartbuf)); _uartbuf[0] = RF_CODE_LEARN_KO; _rfbDecode(); _learning = false; } } if (_rfModem->available()) { static unsigned long last = 0; if (millis() - last > RF_DEBOUNCE) { last = millis(); unsigned long rf_code = _rfModem->getReceivedValue(); if ( rf_code > 0) { DEBUG_MSG_P(PSTR("[RF] Received code: %08X\n"), rf_code); unsigned int timing = _rfModem->getReceivedDelay(); memset(_uartbuf, 0, sizeof(_uartbuf)); unsigned char *msgbuf = _uartbuf + 1; _uartbuf[0] = _learning ? RF_CODE_LEARN_OK: RF_CODE_RFIN; msgbuf[0] = 0xC0; msgbuf[1] = _rfModem->getReceivedProtocol(); msgbuf[2] = timing >> 8; msgbuf[3] = timing >> 0; msgbuf[4] = _rfModem->getReceivedBitlength(); msgbuf[5] = rf_code >> 24; msgbuf[6] = rf_code >> 16; msgbuf[7] = rf_code >> 8; msgbuf[8] = rf_code >> 0; _rfbDecode(); _learning = false; } } _rfModem->resetAvailable(); } yield(); } #endif // RFB_DIRECT void _rfbSendRaw(const uint8_t *message, const unsigned char n = RF_MESSAGE_SIZE) { for (unsigned char j=0; j 1) { message.times = message.times - 1; _rfb_message_queue.push(message); } yield(); } void _rfbSendRawOnce(uint8_t *code, unsigned char length) { char buffer[length*2]; _rfbToChar(code, buffer, length); DEBUG_MSG_P(PSTR("[RF] Sending RAW MESSAGE '%s'\n"), buffer); _rfbSendRaw(code, length); } bool _rfbCompare(const char * code1, const char * code2) { return strcmp(&code1[12], &code2[12]) == 0; } bool _rfbSameOnOff(unsigned char id) { return _rfbCompare(rfbRetrieve(id, true).c_str(), rfbRetrieve(id, false).c_str()); } void _rfbParseRaw(char * raw) { uint8_t message[RF_MAX_MESSAGE_SIZE]; int len = _rfbToArray(raw, message, 0); if (len > 0) { _rfbSendRawOnce(message, len); } } void _rfbParseCode(char * code) { // The payload may be a code in HEX format ([0-9A-Z]{18}) or // the code comma the number of times to transmit it. char * tok = strtok(code, ","); // Check if a switch is linked to that message unsigned char id; unsigned char status = 0; if (_rfbMatch(tok, id, status)) { if (status == 2) { relayToggle(id); } else { relayStatus(id, status == 1); } return; } uint8_t message[RF_MESSAGE_SIZE]; int len = _rfbToArray(tok, message, 0); if (len) { tok = strtok(NULL, ","); uint8_t times = (tok != NULL) ? atoi(tok) : 1; _rfbSend(message, times); } } #if MQTT_SUPPORT void _rfbMqttCallback(unsigned int type, const char * topic, const char * payload) { if (type == MQTT_CONNECT_EVENT) { char buffer[strlen(MQTT_TOPIC_RFLEARN) + 3]; snprintf_P(buffer, sizeof(buffer), PSTR("%s/+"), MQTT_TOPIC_RFLEARN); mqttSubscribe(buffer); if (_rfb_transmit) { mqttSubscribe(MQTT_TOPIC_RFOUT); } #if !RFB_DIRECT mqttSubscribe(MQTT_TOPIC_RFRAW); #endif } if (type == MQTT_MESSAGE_EVENT) { // Match topic String t = mqttMagnitude((char *) topic); // Check if should go into learn mode if (t.startsWith(MQTT_TOPIC_RFLEARN)) { _learnId = t.substring(strlen(MQTT_TOPIC_RFLEARN)+1).toInt(); if (_learnId >= relayCount()) { DEBUG_MSG_P(PSTR("[RF] Wrong learnID (%d)\n"), _learnId); return; } _learnStatus = (char)payload[0] != '0'; _rfbLearnImpl(); return; } if (t.equals(MQTT_TOPIC_RFOUT)) { _rfbParseCode((char *) payload); } #if !RFB_DIRECT if (t.equals(MQTT_TOPIC_RFRAW)) { _rfbParseRaw((char *) payload); } #endif } } #endif // MQTT_SUPPORT #if API_SUPPORT void _rfbAPISetup() { apiRegister(MQTT_TOPIC_RFOUT, [](char * buffer, size_t len) { snprintf_P(buffer, len, PSTR("OK")); }, [](const char * payload) { _rfbParseCode((char *) payload); } ); apiRegister(MQTT_TOPIC_RFLEARN, [](char * buffer, size_t len) { snprintf_P(buffer, len, PSTR("OK")); }, [](const char * payload) { // The payload must be the relayID plus the mode (0 or 1) char * tok = strtok((char *) payload, ","); if (NULL == tok) return; if (!isNumber(tok)) return; _learnId = atoi(tok); if (_learnId >= relayCount()) { DEBUG_MSG_P(PSTR("[RF] Wrong learnID (%d)\n"), _learnId); return; } tok = strtok(NULL, ","); if (NULL == tok) return; _learnStatus = (char) tok[0] != '0'; _rfbLearnImpl(); } ); #if !RFB_DIRECT apiRegister(MQTT_TOPIC_RFRAW, [](char * buffer, size_t len) { snprintf_P(buffer, len, PSTR("OK")); }, [](const char * payload) { _rfbParseRaw((char *)payload); } ); #endif } #endif // API_SUPPORT #if TERMINAL_SUPPORT void _rfbInitCommands() { terminalRegisterCommand(F("LEARN"), [](Embedis* e) { if (e->argc < 3) { terminalError(F("Wrong arguments")); return; } int id = String(e->argv[1]).toInt(); if (id >= relayCount()) { DEBUG_MSG_P(PSTR("-ERROR: Wrong relayID (%d)\n"), id); return; } int status = String(e->argv[2]).toInt(); rfbLearn(id, status == 1); terminalOK(); }); terminalRegisterCommand(F("FORGET"), [](Embedis* e) { if (e->argc < 3) { terminalError(F("Wrong arguments")); return; } int id = String(e->argv[1]).toInt(); if (id >= relayCount()) { DEBUG_MSG_P(PSTR("-ERROR: Wrong relayID (%d)\n"), id); return; } int status = String(e->argv[2]).toInt(); rfbForget(id, status == 1); terminalOK(); }); } #endif // TERMINAL_SUPPORT // ----------------------------------------------------------------------------- // PUBLIC // ----------------------------------------------------------------------------- void rfbStore(unsigned char id, bool status, const char * code) { DEBUG_MSG_P(PSTR("[RF] Storing %d-%s => '%s'\n"), id, status ? "ON" : "OFF", code); if (status) { setSetting({"rfbON", id}, code); } else { setSetting({"rfbOFF", id}, code); } } String rfbRetrieve(unsigned char id, bool status) { if (status) { return getSetting({"rfbON", id}); } else { return getSetting({"rfbOFF", id}); } } void rfbStatus(unsigned char id, bool status) { String value = rfbRetrieve(id, status); if (value.length() > 0) { bool same = _rfbSameOnOff(id); uint8_t message[RF_MAX_MESSAGE_SIZE]; int len = _rfbToArray(value.c_str(), message, 0); if (len == RF_MESSAGE_SIZE && // probably a standard msg (message[0] != RF_CODE_START || // raw would start with 0xAA message[1] != RF_CODE_RFOUT_BUCKET || // followed by 0xB0, message[2] + 4 != len || // needs a valid length, message[len-1] != RF_CODE_STOP)) { // and finish with 0x55 if (!_rfbin) { unsigned char times = same ? 1 : _rfb_repeat; _rfbSend(message, times); } } else { _rfbSendRawOnce(message, len); // send a raw message } } _rfbin = false; } void rfbLearn(unsigned char id, bool status) { _learnId = id; _learnStatus = status; _rfbLearnImpl(); } void rfbForget(unsigned char id, bool status) { char key[RF_MAX_KEY_LENGTH] = {0}; snprintf_P(key, sizeof(key), PSTR("rfb%s%d"), status ? "ON" : "OFF", id); delSetting(key); // Websocket update #if WEB_SUPPORT wsPost([id](JsonObject& root) { _rfbWebSocketSendCodeArray(root, id, 1); }); #endif } // ----------------------------------------------------------------------------- // SETUP & LOOP // ----------------------------------------------------------------------------- void rfbSetup() { #if MQTT_SUPPORT mqttRegister(_rfbMqttCallback); #endif #if API_SUPPORT _rfbAPISetup(); #endif #if WEB_SUPPORT wsRegister() .onVisible(_rfbWebSocketOnVisible) .onConnected(_rfbWebSocketOnConnected) .onData(_rfbWebSocketOnData) .onAction(_rfbWebSocketOnAction) .onKeyCheck(_rfbWebSocketOnKeyCheck); #endif #if TERMINAL_SUPPORT _rfbInitCommands(); #endif _rfb_repeat = getSetting("rfbRepeat", RF_SEND_TIMES); #if RFB_DIRECT const auto rx = getSetting("rfbRX", RFB_RX_PIN); const auto tx = getSetting("rfbTX", RFB_TX_PIN); _rfb_receive = gpioValid(rx); _rfb_transmit = gpioValid(tx); if (!_rfb_transmit && !_rfb_receive) { DEBUG_MSG_P(PSTR("[RF] Neither RX or TX are set\n")); return; } _rfModem = new RCSwitch(); if (_rfb_receive) { _rfModem->enableReceive(rx); DEBUG_MSG_P(PSTR("[RF] RF receiver on GPIO %u\n"), rx); } if (_rfb_transmit) { _rfModem->enableTransmit(tx); _rfModem->setRepeatTransmit(_rfb_repeat); DEBUG_MSG_P(PSTR("[RF] RF transmitter on GPIO %u\n"), tx); } #else _rfb_receive = true; _rfb_transmit = true; #endif // Register loop only when properly configured espurnaRegisterLoop([]() -> void { _rfbReceive(); _rfbSend(); }); } #endif