2019-12-15 15:02:41 +00:00
|
|
|
/*
|
|
|
|
xdrv_23_zigbee_1_headers.ino - zigbee support for Tasmota
|
|
|
|
|
2019-12-31 13:23:34 +00:00
|
|
|
Copyright (C) 2020 Theo Arends and Stephan Hadinger
|
2019-12-15 15:02:41 +00:00
|
|
|
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
GNU General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifdef USE_ZIGBEE
|
|
|
|
|
2020-11-11 11:09:18 +00:00
|
|
|
#ifdef USE_ZIGBEE_EZSP
|
|
|
|
#include "Eeprom24C512.h"
|
|
|
|
#endif // USE_ZIGBEE_EZSP
|
|
|
|
|
2019-12-15 15:02:41 +00:00
|
|
|
// contains some definitions for functions used before their declarations
|
|
|
|
|
2020-10-18 18:24:45 +01:00
|
|
|
//
|
|
|
|
// structure containing all needed information to send a ZCL packet
|
|
|
|
//
|
2020-09-06 19:51:20 +01:00
|
|
|
class ZigbeeZCLSendMessage {
|
|
|
|
public:
|
|
|
|
uint16_t shortaddr;
|
|
|
|
uint16_t groupaddr;
|
2020-10-13 21:45:11 +01:00
|
|
|
uint16_t cluster;
|
2020-09-06 19:51:20 +01:00
|
|
|
uint8_t endpoint;
|
2020-10-13 21:45:11 +01:00
|
|
|
uint8_t cmd;
|
2020-09-06 19:51:20 +01:00
|
|
|
uint16_t manuf;
|
|
|
|
bool clusterSpecific;
|
|
|
|
bool needResponse;
|
2020-10-19 19:34:40 +01:00
|
|
|
bool direct; // true if direct, false if discover router
|
2020-09-06 19:51:20 +01:00
|
|
|
uint8_t transacId; // ZCL transaction number
|
|
|
|
const uint8_t *msg;
|
|
|
|
size_t len;
|
|
|
|
};
|
|
|
|
|
2020-10-18 18:24:45 +01:00
|
|
|
typedef int32_t (*ZB_Func)(uint8_t value);
|
|
|
|
typedef int32_t (*ZB_RecvMsgFunc)(int32_t res, const class SBuffer &buf);
|
|
|
|
|
|
|
|
// Labels used in the State Machine -- internal only
|
|
|
|
const uint8_t ZIGBEE_LABEL_RESTART = 1; // Restart the state_machine in a different mode
|
|
|
|
const uint8_t ZIGBEE_LABEL_INIT_COORD = 10; // Start ZNP as coordinator
|
|
|
|
const uint8_t ZIGBEE_LABEL_START_COORD = 11; // Start ZNP as coordinator
|
|
|
|
const uint8_t ZIGBEE_LABEL_INIT_ROUTER = 12; // Init ZNP as router
|
|
|
|
const uint8_t ZIGBEE_LABEL_START_ROUTER = 13; // Start ZNP as router
|
|
|
|
const uint8_t ZIGBEE_LABEL_INIT_DEVICE = 14; // Init ZNP as end-device
|
|
|
|
const uint8_t ZIGBEE_LABEL_START_DEVICE = 15; // Start ZNP as end-device
|
|
|
|
const uint8_t ZIGBEE_LABEL_START_ROUTER_DEVICE = 16; // Start common to router and device
|
|
|
|
const uint8_t ZIGBEE_LABEL_FACT_RESET_ROUTER_DEVICE_POST = 19; // common post configuration for router and device
|
|
|
|
const uint8_t ZIGBEE_LABEL_READY = 20; // goto label 20 for main loop
|
|
|
|
const uint8_t ZIGBEE_LABEL_MAIN_LOOP = 21; // main loop
|
|
|
|
const uint8_t ZIGBEE_LABEL_NETWORK_CONFIGURED = 22; // main loop
|
|
|
|
const uint8_t ZIGBEE_LABEL_BAD_CONFIG = 23; // EZSP configuration is not the right one
|
|
|
|
const uint8_t ZIGBEE_LABEL_PERMIT_JOIN_CLOSE = 30; // disable permit join
|
|
|
|
const uint8_t ZIGBEE_LABEL_PERMIT_JOIN_OPEN_60 = 31; // enable permit join for 60 seconds
|
|
|
|
const uint8_t ZIGBEE_LABEL_PERMIT_JOIN_OPEN_XX = 32; // enable permit join for 60 seconds
|
|
|
|
// factory reset or reconfiguration
|
|
|
|
const uint8_t ZIGBEE_LABEL_FACT_RESET_COORD = 50; // main loop
|
|
|
|
const uint8_t ZIGBEE_LABEL_FACT_RESET_ROUTER = 51; // main loop
|
|
|
|
const uint8_t ZIGBEE_LABEL_FACT_RESET_DEVICE = 52; // main loop
|
|
|
|
const uint8_t ZIGBEE_LABEL_CONFIGURE_EZSP = 53; // main loop
|
|
|
|
// errors
|
|
|
|
const uint8_t ZIGBEE_LABEL_ABORT = 99; // goto label 99 in case of fatal error
|
|
|
|
const uint8_t ZIGBEE_LABEL_UNSUPPORTED_VERSION = 98; // Unsupported ZNP version
|
|
|
|
|
2020-11-11 11:09:18 +00:00
|
|
|
class ZigbeeStatus {
|
|
|
|
public:
|
|
|
|
ZigbeeStatus()
|
|
|
|
#ifdef USE_ZIGBEE_EZSP
|
|
|
|
: eeprom(USE_ZIGBEE_ZBBRIDGE_EEPROM)
|
|
|
|
#endif // USE_ZIGBEE_EZSP
|
|
|
|
{}
|
|
|
|
|
2020-10-18 18:24:45 +01:00
|
|
|
bool active = true; // is Zigbee active for this device, i.e. GPIOs configured
|
|
|
|
bool state_machine = false; // the state machine is running
|
|
|
|
bool state_waiting = false; // the state machine is waiting for external event or timeout
|
|
|
|
bool state_no_timeout = false; // the current wait loop does not generate a timeout but only continues running
|
|
|
|
bool ready = false; // cc2530 initialization is complet, ready to operate
|
|
|
|
bool init_phase = true; // initialization phase, before accepting zigbee traffic
|
|
|
|
bool recv_until = false; // ignore all messages until the received frame fully matches
|
2020-11-11 11:09:18 +00:00
|
|
|
bool eeprom_present = false; // is the ZBBridge EEPROM present?
|
2020-11-21 09:31:27 +00:00
|
|
|
bool eeprom_ready = false; // is the ZBBridge EEPROM formatted and ready?
|
2020-12-12 18:05:47 +00:00
|
|
|
// Zigbee mapping
|
|
|
|
bool mapping_in_progress = false; // is there a mapping in progress
|
|
|
|
bool mapping_ready = false; // do we have mapping information ready
|
|
|
|
uint32_t mapping_end_time = 0;
|
2020-10-18 18:24:45 +01:00
|
|
|
|
|
|
|
uint8_t on_error_goto = ZIGBEE_LABEL_ABORT; // on error goto label, 99 default to abort
|
|
|
|
uint8_t on_timeout_goto = ZIGBEE_LABEL_ABORT; // on timeout goto label, 99 default to abort
|
|
|
|
uint8_t *recv_filter = nullptr; // receive filter message
|
|
|
|
uint8_t recv_filter_len = 0;
|
|
|
|
int16_t pc = 0; // program counter, -1 means abort
|
|
|
|
uint32_t next_timeout = 0; // millis for the next timeout
|
|
|
|
|
|
|
|
ZB_RecvMsgFunc recv_func = nullptr; // function to call when message is expected
|
|
|
|
ZB_RecvMsgFunc recv_unexpected = nullptr; // function called when unexpected message is received
|
2020-10-19 19:34:40 +01:00
|
|
|
|
|
|
|
uint32_t permit_end_time = 0; // timestamp when permit join ends
|
2020-11-11 11:09:18 +00:00
|
|
|
|
|
|
|
#ifdef USE_ZIGBEE_EZSP
|
|
|
|
Eeprom24C512 eeprom; // takes only 1 bytes of RAM
|
|
|
|
#endif // USE_ZIGBEE_EZSP
|
2020-10-18 18:24:45 +01:00
|
|
|
};
|
|
|
|
struct ZigbeeStatus zigbee;
|
|
|
|
SBuffer *zigbee_buffer = nullptr;
|
|
|
|
|
2020-09-06 19:51:20 +01:00
|
|
|
void ZigbeeZCLSend_Raw(const ZigbeeZCLSendMessage &zcl);
|
2020-09-14 21:06:19 +01:00
|
|
|
bool ZbAppendWriteBuf(SBuffer & buf, const Z_attribute & attr, bool prepend_status_ok = false);
|
2019-12-15 15:02:41 +00:00
|
|
|
|
2020-10-18 18:24:45 +01:00
|
|
|
// parse Hex formatted attribute names like '0301/0001"
|
2020-03-14 13:17:30 +00:00
|
|
|
uint32_t parseHex(const char **data, size_t max_len = 8) {
|
|
|
|
uint32_t ret = 0;
|
|
|
|
for (uint32_t i = 0; i < max_len; i++) {
|
|
|
|
int8_t v = hexValue(**data);
|
|
|
|
if (v < 0) { break; } // non hex digit, we stop parsing
|
|
|
|
ret = (ret << 4) | v;
|
|
|
|
*data += 1;
|
|
|
|
}
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
2019-12-15 15:02:41 +00:00
|
|
|
#endif // USE_ZIGBEE
|