Compare commits

...

20 Commits
v1.1 ... main

Author SHA1 Message Date
a080869c5c Version 1.41
Fixed one bug with generating of message ID.
2023-03-05 15:05:40 +03:00
9c3d35e1c3 Minor changes 2023-02-11 09:35:25 +03:00
49a4bd210d Minor changes 2023-02-11 08:39:58 +03:00
5e0822b8e9 Merge branch 'main' of http://git.zh.com.ru/alexey.zholtikov/ZHNetwork 2023-02-11 08:26:45 +03:00
915e2bf7b7 Minor changes 2023-02-11 08:26:43 +03:00
0812c15b85 Merge branch 'main' of http://git.zh.com.ru/alexey.zholtikov/ZHNetwork 2023-02-11 08:17:36 +03:00
4189c860aa Minor changes 2023-02-11 08:17:28 +03:00
7a8dbe40f0 Merge branch 'main' of http://git.zh.com.ru/alexey.zholtikov/ZHNetwork 2023-02-11 08:16:20 +03:00
6eab8cde49 Minor changes 2023-02-11 08:16:18 +03:00
d94bbe028c Minor Changes 2023-02-10 15:33:49 +03:00
341f314895 Version 1.4
Added simple XOR crypting.
2023-01-19 18:36:57 +03:00
32f7c013b8 Version 1.32
Fixed bug with periodically absence a confirmation message.
2023-01-14 09:27:07 +03:00
62acd2a386 Version 1.31
Added gateway mode support.
2023-01-03 17:55:08 +03:00
506acf1fc0 Minor changes 2022-12-24 13:48:16 +03:00
b328ad916c Version 1.3
Removed a lot of unnecessary functions.
2022-12-22 18:27:17 +03:00
1d5198e0ab Minor changes 2022-12-18 18:02:23 +03:00
aae51f907c Minor changes 2022-12-18 09:34:51 +03:00
8942471c6f Minor changes 2022-12-18 09:16:28 +03:00
c1fe139756 Version 1.12
Fixed one minor bug.
2022-12-16 10:41:28 +03:00
4f58a04eae Version 1.11
Minor code optimization.
2022-12-12 18:58:03 +03:00
6 changed files with 209 additions and 276 deletions

138
README.md
View File

@ -4,14 +4,15 @@ A simple library for creating ESP-NOW based Mesh network for ESP8266/ESP32.
## Features ## Features
1. The maximum size of transmitted data is 200 bytes. Currently only unencrypted messages. 1. The maximum size of transmitted data is 200 bytes.
2. All nodes are not visible to the network scanner (for the ESP_NOW mode only). 2. Encrypted and unencrypted messages. Simple XOR crypting.
3. Not required a pre-pairings for data transfer. 3. All nodes are not visible to the network scanner.
4. Broadcast or unicast data transmission. 4. Not required a pre-pairings for data transfer.
5. There are no periodic/synchronous messages on the network. All devices are in "silent mode" and do not "hum" into the air (for the ESP_NOW mode only). 5. Broadcast or unicast data transmissions.
6. Each node has its own independent routing table, updated only as needed. 6. There are no periodic/synchronous messages on the network. All devices are in "silent mode" and do not "hum" into the air.
7. Each node will receive/send a message if it "sees" at least one device on the network. 7. Each node has its own independent routing table, updated only as needed.
8. The number of devices on the network and the area of use is not limited (hypothetically). :-) 8. Each node will receive/send a message if it "sees" at least one device on the network.
9. The number of devices on the network and the area of use is not limited (hypothetically). :-)
## Testing ## Testing
@ -22,6 +23,11 @@ A simple library for creating ESP-NOW based Mesh network for ESP8266/ESP32.
5. Voila. ;-) 5. Voila. ;-)
6. P.S. Uncomment #define PRINT_LOG in ZHNetwork.h for display to serial port the full operation log. 6. P.S. Uncomment #define PRINT_LOG in ZHNetwork.h for display to serial port the full operation log.
## Notes
1. Possibility uses WiFi AP or STA modes at the same time with ESP-NOW using the standard libraries.
2. For correct work at ESP-NOW + STA mode your WiFi router must be set on channel 1 and set gateway mode.
## Function descriptions ## Function descriptions
### Sets the callback function for processing a received broadcast message ### Sets the callback function for processing a received broadcast message
@ -54,82 +60,35 @@ Note. Called only at broadcast or unicast with confirm message. Status will alwa
```cpp ```cpp
myNet.setOnConfirmReceivingCallback(onConfirmReceiving); myNet.setOnConfirmReceivingCallback(onConfirmReceiving);
void onConfirmReceiving(const uint8_t *target, const bool status) void onConfirmReceiving(const uint8_t *target, const uint16_t id, const bool status)
{ {
// Do something when receiving a delivery/undelivery confirm message. // Do something when receiving a delivery/undelivery confirm message.
} }
``` ```
### Sets one of the three possibility operating modes ### ESP-NOW Mesh network initialization
* ESP_NOW. Default mode. ESP-NOW Mesh network only.
* ESP_NOW_AP. ESP-NOW Mesh network + access point.
* ESP_NOW_STA. ESP-NOW Mesh network + connect to your WiFi router.
Attention! For correct work on ESP_NOW_STA mode at ESP8266 your WiFi router must be set on channel 1.
```cpp
myNet.setWorkMode(ESP_NOW);
```
### Gets used operating mode
```cpp
myNet.getWorkMode();
```
### Sets ESP-NOW Mesh network name
1-20 characters. 1-20 characters.
Note. If network name not set node will work with all ESP-NOW networks. If set node will work with only one network. Note. If network name not set node will work with all ESP-NOW networks. If set node will work with only one network.
```cpp ```cpp
myNet.setNetName("ZHNetwork"); myNet.begin("ZHNetwork");
``` myNet.begin("ZHNetwork", true); // Gateway mode.
### Gets used ESP-NOW Mesh network name
```cpp
myNet.getNetName();
```
### Sets WiFi ssid and password for ESP_NOW_STA mode
Note. Must be called before Mesh network initialization.
```cpp
myNet.setStaSetting("SSID", "PASSWORD");
```
### Sets access point ssid and password for ESP_NOW_AP mode
Note. Must be called before Mesh network initialization.
```cpp
myNet.setApSetting("SSID", "PASSWORD");
```
### ESP-NOW Mesh network initialization
```cpp
myNet.begin();
```
### ESP-NOW Mesh network deinitialization
```cpp
myNet.stop();
``` ```
### Sends broadcast message to all nodes ### Sends broadcast message to all nodes
Returns message ID.
```cpp ```cpp
myNet.sendBroadcastMessage("Hello world!"); myNet.sendBroadcastMessage("Hello world!");
``` ```
### Sends unicast message to node ### Sends unicast message to node
Returns message ID.
```cpp ```cpp
myNet.sendUnicastMessage("Hello world!", target); // Without confirm. myNet.sendUnicastMessage("Hello world!", target); // Without confirm.
myNet.sendUnicastMessage("Hello world!", target, true); // With confirm. myNet.sendUnicastMessage("Hello world!", target, true); // With confirm.
@ -149,12 +108,6 @@ myNet.maintenance();
myNet.getNodeMac(); myNet.getNodeMac();
``` ```
### Gets node IP address
```cpp
myNet.getNodeIp();
```
### Gets version of this library ### Gets version of this library
```cpp ```cpp
@ -174,6 +127,14 @@ uint8_t mac[6]
myNet.stringToMac(string, mac); myNet.stringToMac(string, mac);
``` ```
### Sets crypt key
1-20 characters.
```cpp
myNet.setCryptKey("VERY_LONG_CRYPT_KEY");
```
### Sets max number of attempts to send message ### Sets max number of attempts to send message
1-10. 3 default value. 1-10. 3 default value.
@ -223,11 +184,11 @@ myNet.getMaxWaitingTimeForRoutingInfo();
void onBroadcastReceiving(const char *data, const uint8_t *sender); void onBroadcastReceiving(const char *data, const uint8_t *sender);
void onUnicastReceiving(const char *data, const uint8_t *sender); void onUnicastReceiving(const char *data, const uint8_t *sender);
void onConfirmReceiving(const uint8_t *target, const bool status); void onConfirmReceiving(const uint8_t *target, const uint16_t id, const bool status);
ZHNetwork myNet; ZHNetwork myNet;
uint64_t messagelastTime{0}; uint64_t messageLastTime{0};
uint16_t messageTimerDelay{5000}; uint16_t messageTimerDelay{5000};
const uint8_t target[6]{0xA8, 0x48, 0xFA, 0xDC, 0x5B, 0xFA}; const uint8_t target[6]{0xA8, 0x48, 0xFA, 0xDC, 0x5B, 0xFA};
@ -235,27 +196,13 @@ void setup()
{ {
Serial.begin(115200); Serial.begin(115200);
Serial.println(); Serial.println();
// *** ESP-NOW mode only. myNet.begin("ZHNetwork");
myNet.setWorkMode(ESP_NOW); // myNet.setCryptKey("VERY_LONG_CRYPT_KEY"); // If encryption is used, the key must be set same of all another ESP-NOW devices in network.
// *** Or ESP-NOW + access point mode.
// myNet.setWorkMode(ESP_NOW_AP);
// myNet.setApSetting("ESP NODE TEST", "12345678");
// *** Or ESP-NOW + connect to your router mode.
// myNet.setWorkMode(ESP_NOW_STA);
// myNet.setStaSetting("SSID", "PASSWORD");
// ***
myNet.setNetName("ZHNetwork"); // Optional.
myNet.setMaxNumberOfAttempts(3); // Optional.
myNet.setMaxWaitingTimeBetweenTransmissions(50); // Optional.
myNet.setMaxWaitingTimeForRoutingInfo(500); // Optional.
myNet.begin();
myNet.setOnBroadcastReceivingCallback(onBroadcastReceiving); myNet.setOnBroadcastReceivingCallback(onBroadcastReceiving);
myNet.setOnUnicastReceivingCallback(onUnicastReceiving); myNet.setOnUnicastReceivingCallback(onUnicastReceiving);
myNet.setOnConfirmReceivingCallback(onConfirmReceiving); myNet.setOnConfirmReceivingCallback(onConfirmReceiving);
Serial.print("MAC: "); Serial.print("MAC: ");
Serial.print(myNet.getNodeMac()); Serial.print(myNet.getNodeMac());
Serial.print(". IP: ");
Serial.print(myNet.getNodeIp());
Serial.print(". Firmware version: "); Serial.print(". Firmware version: ");
Serial.print(myNet.getFirmwareVersion()); Serial.print(myNet.getFirmwareVersion());
Serial.println("."); Serial.println(".");
@ -263,19 +210,23 @@ void setup()
void loop() void loop()
{ {
if ((millis() - messagelastTime) > messageTimerDelay) if ((millis() - messageLastTime) > messageTimerDelay)
{ {
Serial.println("Broadcast message sended."); Serial.println("Broadcast message sended.");
myNet.sendBroadcastMessage("Hello world!"); myNet.sendBroadcastMessage("Hello world!");
Serial.print("Unicast message to MAC "); Serial.print("Unicast message to MAC ");
Serial.print(myNet.macToString(target)); Serial.print(myNet.macToString(target));
Serial.println(" sended."); Serial.println(" sended.");
myNet.sendUnicastMessage("Hello world!", target); myNet.sendUnicastMessage("Hello world!", target);
Serial.print("Unicast with confirm message to MAC "); Serial.print("Unicast with confirm message to MAC ");
Serial.print(myNet.macToString(target)); Serial.print(myNet.macToString(target));
Serial.print(" ID ");
Serial.print(myNet.sendUnicastMessage("Hello world!", target, true));
Serial.println(" sended."); Serial.println(" sended.");
myNet.sendUnicastMessage("Hello world!", target, true);
messagelastTime = millis(); messageLastTime = millis();
} }
myNet.maintenance(); myNet.maintenance();
} }
@ -288,6 +239,7 @@ void onBroadcastReceiving(const char *data, const uint8_t *sender)
Serial.print("Message: "); Serial.print("Message: ");
Serial.println(data); Serial.println(data);
} }
void onUnicastReceiving(const char *data, const uint8_t *sender) void onUnicastReceiving(const char *data, const uint8_t *sender)
{ {
Serial.print("Unicast message from MAC "); Serial.print("Unicast message from MAC ");
@ -297,10 +249,14 @@ void onUnicastReceiving(const char *data, const uint8_t *sender)
Serial.println(data); Serial.println(data);
} }
void onConfirmReceiving(const uint8_t *target, const bool status) void onConfirmReceiving(const uint8_t *target, const uint16_t id, const bool status)
{ {
Serial.print("Message to MAC "); Serial.print("Message to MAC ");
Serial.print(myNet.macToString(target)); Serial.print(myNet.macToString(target));
Serial.print(" ID ");
Serial.print(id);
Serial.println(status ? " delivered." : " undelivered."); Serial.println(status ? " delivered." : " undelivered.");
} }
``` ```
Any feedback via [e-mail](mailto:github@zh.com.ru) would be appreciated. Or... [Buy me a coffee](https://paypal.me/aZholtikov).

View File

@ -9,26 +9,12 @@ void setup()
{ {
Serial.begin(115200); Serial.begin(115200);
Serial.println(); Serial.println();
// *** ESP-NOW mode only. myNet.begin("ZHNetwork");
myNet.setWorkMode(ESP_NOW); // myNet.setCryptKey("VERY_LONG_CRYPT_KEY"); // If encryption is used, the key must be set same of all another ESP-NOW devices in network.
// *** Or ESP-NOW + access point mode.
// myNet.setWorkMode(ESP_NOW_AP);
// myNet.setApSetting("ESP NODE TEST", "12345678");
// *** Or ESP-NOW + connect to your router mode.
// myNet.setWorkMode(ESP_NOW_STA);
// myNet.setStaSetting("SSID", "PASSWORD");
// ***
myNet.setNetName("ZHNetwork"); // Optional.
myNet.setMaxNumberOfAttempts(3); // Optional.
myNet.setMaxWaitingTimeBetweenTransmissions(50); // Optional.
myNet.setMaxWaitingTimeForRoutingInfo(500); // Optional.
myNet.begin();
myNet.setOnBroadcastReceivingCallback(onBroadcastReceiving); myNet.setOnBroadcastReceivingCallback(onBroadcastReceiving);
myNet.setOnUnicastReceivingCallback(onUnicastReceiving); myNet.setOnUnicastReceivingCallback(onUnicastReceiving);
Serial.print("MAC: "); Serial.print("MAC: ");
Serial.print(myNet.getNodeMac()); Serial.print(myNet.getNodeMac());
Serial.print(". IP: ");
Serial.print(myNet.getNodeIp());
Serial.print(". Firmware version: "); Serial.print(". Firmware version: ");
Serial.print(myNet.getFirmwareVersion()); Serial.print(myNet.getFirmwareVersion());
Serial.println("."); Serial.println(".");
@ -47,6 +33,7 @@ void onBroadcastReceiving(const char *data, const uint8_t *sender)
Serial.print("Message: "); Serial.print("Message: ");
Serial.println(data); Serial.println(data);
} }
void onUnicastReceiving(const char *data, const uint8_t *sender) void onUnicastReceiving(const char *data, const uint8_t *sender)
{ {
Serial.print("Unicast message from MAC "); Serial.print("Unicast message from MAC ");

View File

@ -1,10 +1,10 @@
#include "ZHNetwork.h" #include "ZHNetwork.h"
void onConfirmReceiving(const uint8_t *target, const bool status); void onConfirmReceiving(const uint8_t *target, const uint16_t id, const bool status);
ZHNetwork myNet; ZHNetwork myNet;
uint64_t messagelastTime{0}; uint64_t messageLastTime{0};
uint16_t messageTimerDelay{5000}; uint16_t messageTimerDelay{5000};
const uint8_t target[6]{0xA8, 0x48, 0xFA, 0xDC, 0x5B, 0xFA}; const uint8_t target[6]{0xA8, 0x48, 0xFA, 0xDC, 0x5B, 0xFA};
@ -12,25 +12,11 @@ void setup()
{ {
Serial.begin(115200); Serial.begin(115200);
Serial.println(); Serial.println();
// *** ESP-NOW mode only. myNet.begin("ZHNetwork");
myNet.setWorkMode(ESP_NOW); // myNet.setCryptKey("VERY_LONG_CRYPT_KEY"); // If encryption is used, the key must be set same of all another ESP-NOW devices in network.
// *** Or ESP-NOW + access point mode.
// myNet.setWorkMode(ESP_NOW_AP);
// myNet.setApSetting("ESP NODE TEST", "12345678");
// *** Or ESP-NOW + connect to your router mode.
// myNet.setWorkMode(ESP_NOW_STA);
// myNet.setStaSetting("SSID", "PASSWORD");
// ***
myNet.setNetName("ZHNetwork"); // Optional.
myNet.setMaxNumberOfAttempts(3); // Optional.
myNet.setMaxWaitingTimeBetweenTransmissions(50); // Optional.
myNet.setMaxWaitingTimeForRoutingInfo(500); // Optional.
myNet.begin();
myNet.setOnConfirmReceivingCallback(onConfirmReceiving); myNet.setOnConfirmReceivingCallback(onConfirmReceiving);
Serial.print("MAC: "); Serial.print("MAC: ");
Serial.print(myNet.getNodeMac()); Serial.print(myNet.getNodeMac());
Serial.print(". IP: ");
Serial.print(myNet.getNodeIp());
Serial.print(". Firmware version: "); Serial.print(". Firmware version: ");
Serial.print(myNet.getFirmwareVersion()); Serial.print(myNet.getFirmwareVersion());
Serial.println("."); Serial.println(".");
@ -38,26 +24,32 @@ void setup()
void loop() void loop()
{ {
if ((millis() - messagelastTime) > messageTimerDelay) if ((millis() - messageLastTime) > messageTimerDelay)
{ {
Serial.println("Broadcast message sended."); Serial.println("Broadcast message sended.");
myNet.sendBroadcastMessage("Hello world!"); myNet.sendBroadcastMessage("Hello world!");
Serial.print("Unicast message to MAC "); Serial.print("Unicast message to MAC ");
Serial.print(myNet.macToString(target)); Serial.print(myNet.macToString(target));
Serial.println(" sended."); Serial.println(" sended.");
myNet.sendUnicastMessage("Hello world!", target); myNet.sendUnicastMessage("Hello world!", target);
Serial.print("Unicast with confirm message to MAC "); Serial.print("Unicast with confirm message to MAC ");
Serial.print(myNet.macToString(target)); Serial.print(myNet.macToString(target));
Serial.print(" ID ");
Serial.print(myNet.sendUnicastMessage("Hello world!", target, true));
Serial.println(" sended."); Serial.println(" sended.");
myNet.sendUnicastMessage("Hello world!", target, true);
messagelastTime = millis(); messageLastTime = millis();
} }
myNet.maintenance(); myNet.maintenance();
} }
void onConfirmReceiving(const uint8_t *target, const bool status) void onConfirmReceiving(const uint8_t *target, const uint16_t id, const bool status)
{ {
Serial.print("Message to MAC "); Serial.print("Message to MAC ");
Serial.print(myNet.macToString(target)); Serial.print(myNet.macToString(target));
Serial.print(" ID ");
Serial.print(id);
Serial.println(status ? " delivered." : " undelivered."); Serial.println(status ? " delivered." : " undelivered.");
} }

View File

@ -1,5 +1,5 @@
name=ZHNetwork name=ZHNetwork
version=1.1 version=1.41
author=Alexey Zholtikov author=Alexey Zholtikov
maintainer=Alexey Zholtikov maintainer=Alexey Zholtikov
sentence=ESP-NOW based Mesh network for ESP8266/ESP32 sentence=ESP-NOW based Mesh network for ESP8266/ESP32

View File

@ -1,31 +1,19 @@
#include "ZHNetwork.h" #include "ZHNetwork.h"
routing_vector_t routingVector; routing_vector_t ZHNetwork::routingVector;
incoming_queue_t queueForIncomingData; confirmation_vector_t ZHNetwork::confirmationVector;
outgoing_queue_t queueForOutgoingData; incoming_queue_t ZHNetwork::queueForIncomingData;
waiting_queue_t queueForRoutingVectorWaiting; outgoing_queue_t ZHNetwork::queueForOutgoingData;
waiting_queue_t ZHNetwork::queueForRoutingVectorWaiting;
const char *firmware PROGMEM{"1.1"}; bool ZHNetwork::criticalProcessSemaphore{false};
const uint8_t broadcastMAC[6]{0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}; bool ZHNetwork::sentMessageSemaphore{false};
bool ZHNetwork::confirmReceivingSemaphore{false};
bool criticalProcessSemaphore{false}; bool ZHNetwork::confirmReceiving{false};
bool sentMessageSemaphore{false}; char ZHNetwork::netName_[20]{0};
bool confirmReceivingSemaphore{false}; char ZHNetwork::key_[20]{0};
bool confirmReceiving{false}; uint8_t ZHNetwork::localMAC[6]{0};
uint8_t localMAC[6]{0}; uint16_t ZHNetwork::lastMessageID[10]{0};
uint8_t numberOfAttemptsToSend{1};
uint16_t lastMessageID[10]{0};
uint64_t lastMessageSentTime{0};
work_mode_t workMode_{ESP_NOW};
char netName_[20]{0};
char apSsid_[32]{"ESP-NOW NODE"};
char apPassword_[64]{0};
char staSsid_[32]{0};
char staPassword_[64]{0};
uint8_t maxNumberOfAttempts_{3};
uint8_t maxWaitingTimeBetweenTransmissions_{50};
uint16_t maxTimeForRoutingInfoWaiting_{500};
ZHNetwork &ZHNetwork::setOnBroadcastReceivingCallback(on_message_t onBroadcastReceivingCallback) ZHNetwork &ZHNetwork::setOnBroadcastReceivingCallback(on_message_t onBroadcastReceivingCallback)
{ {
@ -45,108 +33,41 @@ ZHNetwork &ZHNetwork::setOnConfirmReceivingCallback(on_confirm_t onConfirmReceiv
return *this; return *this;
} }
error_code_t ZHNetwork::setWorkMode(const work_mode_t workMode) error_code_t ZHNetwork::begin(const char *netName, const bool gateway)
{ {
if (workMode < ESP_NOW || workMode > ESP_NOW_STA) #if defined(ESP8266)
return ERROR; randomSeed(os_random());
workMode_ = workMode; #endif
return SUCCESS; #if defined(ESP32)
} randomSeed(esp_random());
#endif
work_mode_t ZHNetwork::getWorkMode() if (strlen(netName) >= 1 && strlen(netName) <= 20)
{
return workMode_;
}
error_code_t ZHNetwork::setNetName(const char *netName)
{
if (strlen(netName) < 1 || strlen(netName) > 20)
return ERROR;
strcpy(netName_, netName); strcpy(netName_, netName);
return SUCCESS;
}
String ZHNetwork::getNetName()
{
return netName_;
}
error_code_t ZHNetwork::setStaSetting(const char *ssid, const char *password)
{
if (strlen(ssid) < 1 || strlen(ssid) > 32 || strlen(password) > 64)
return ERROR;
strcpy(staSsid_, ssid);
strcpy(staPassword_, password);
return SUCCESS;
}
error_code_t ZHNetwork::setApSetting(const char *ssid, const char *password)
{
if (strlen(ssid) < 1 || strlen(ssid) > 32 || strlen(password) < 8 || strlen(password) > 64)
return ERROR;
strcpy(apSsid_, ssid);
strcpy(apPassword_, password);
return SUCCESS;
}
error_code_t ZHNetwork::begin()
{
randomSeed(analogRead(0));
#ifdef PRINT_LOG #ifdef PRINT_LOG
Serial.begin(115200); Serial.begin(115200);
#endif #endif
switch (workMode_) WiFi.mode(gateway ? WIFI_AP_STA : WIFI_STA);
{
case ESP_NOW:
WiFi.mode(WIFI_STA);
break;
case ESP_NOW_AP:
WiFi.mode(WIFI_AP_STA);
WiFi.softAP(apSsid_, apPassword_);
break;
case ESP_NOW_STA:
WiFi.mode(WIFI_STA);
WiFi.begin(staSsid_, staPassword_);
while (WiFi.status() != WL_CONNECTED)
{
if (WiFi.status() == WL_NO_SSID_AVAIL || WiFi.status() == WL_CONNECT_FAILED)
return ERROR;
delay(500);
}
break;
default:
break;
}
esp_now_init(); esp_now_init();
#if defined(ESP8266) #if defined(ESP8266)
wifi_get_macaddr(STATION_IF, localMAC); wifi_get_macaddr(gateway ? SOFTAP_IF : STATION_IF, localMAC);
esp_now_set_self_role(ESP_NOW_ROLE_COMBO); esp_now_set_self_role(ESP_NOW_ROLE_COMBO);
#endif #endif
#if defined(ESP32) #if defined(ESP32)
esp_wifi_get_mac((wifi_interface_t)ESP_IF_WIFI_STA, localMAC); esp_wifi_get_mac(gateway ? (wifi_interface_t)ESP_IF_WIFI_AP : (wifi_interface_t)ESP_IF_WIFI_STA, localMAC);
#endif #endif
esp_now_register_send_cb(onDataSent); esp_now_register_send_cb(onDataSent);
esp_now_register_recv_cb(onDataReceive); esp_now_register_recv_cb(onDataReceive);
return SUCCESS; return SUCCESS;
} }
error_code_t stop() uint16_t ZHNetwork::sendBroadcastMessage(const char *data)
{ {
WiFi.mode(WIFI_OFF); return broadcastMessage(data, broadcastMAC, BROADCAST);
esp_now_deinit();
esp_now_unregister_recv_cb();
esp_now_unregister_send_cb();
return SUCCESS;
} }
void ZHNetwork::sendBroadcastMessage(const char *data) uint16_t ZHNetwork::sendUnicastMessage(const char *data, const uint8_t *target, const bool confirm)
{ {
broadcastMessage(data, broadcastMAC, BROADCAST); return unicastMessage(data, target, localMAC, confirm ? UNICAST_WITH_CONFIRM : UNICAST);
}
void ZHNetwork::sendUnicastMessage(const char *data, const uint8_t *target, const bool confirm)
{
unicastMessage(data, target, localMAC, confirm ? UNICAST_WITH_CONFIRM : UNICAST);
} }
void ZHNetwork::maintenance() void ZHNetwork::maintenance()
@ -166,7 +87,15 @@ void ZHNetwork::maintenance()
esp_now_del_peer(outgoingData.intermediateTargetMAC); esp_now_del_peer(outgoingData.intermediateTargetMAC);
#endif #endif
if (onConfirmReceivingCallback && macToString(outgoingData.transmittedData.originalSenderMAC) == macToString(localMAC) && outgoingData.transmittedData.messageType == BROADCAST) if (onConfirmReceivingCallback && macToString(outgoingData.transmittedData.originalSenderMAC) == macToString(localMAC) && outgoingData.transmittedData.messageType == BROADCAST)
onConfirmReceivingCallback(outgoingData.transmittedData.originalTargetMAC, true); onConfirmReceivingCallback(outgoingData.transmittedData.originalTargetMAC, outgoingData.transmittedData.messageID, true);
if (macToString(outgoingData.transmittedData.originalSenderMAC) == macToString(localMAC) && outgoingData.transmittedData.messageType == UNICAST_WITH_CONFIRM)
{
confirmation_waiting_data_t confirmationData;
confirmationData.time = millis();
memcpy(&confirmationData.targetMAC, &outgoingData.transmittedData.originalTargetMAC, 6);
memcpy(&confirmationData.messageID, &outgoingData.transmittedData.messageID, 2);
confirmationVector.push_back(confirmationData);
}
} }
else else
{ {
@ -269,7 +198,12 @@ void ZHNetwork::maintenance()
Serial.println(F(" received.")); Serial.println(F(" received."));
#endif #endif
if (onBroadcastReceivingCallback) if (onBroadcastReceivingCallback)
{
if (key_[0])
for (uint8_t i{0}; i < strlen(incomingData.transmittedData.message); ++i)
incomingData.transmittedData.message[i] = incomingData.transmittedData.message[i] ^ key_[i % strlen(key_)];
onBroadcastReceivingCallback(incomingData.transmittedData.message, incomingData.transmittedData.originalSenderMAC); onBroadcastReceivingCallback(incomingData.transmittedData.message, incomingData.transmittedData.originalSenderMAC);
}
forward = true; forward = true;
break; break;
case UNICAST: case UNICAST:
@ -285,8 +219,13 @@ void ZHNetwork::maintenance()
if (macToString(incomingData.transmittedData.originalTargetMAC) == macToString(localMAC)) if (macToString(incomingData.transmittedData.originalTargetMAC) == macToString(localMAC))
{ {
if (onUnicastReceivingCallback) if (onUnicastReceivingCallback)
{
if (key_[0])
for (uint8_t i{0}; i < strlen(incomingData.transmittedData.message); ++i)
incomingData.transmittedData.message[i] = incomingData.transmittedData.message[i] ^ key_[i % strlen(key_)];
onUnicastReceivingCallback(incomingData.transmittedData.message, incomingData.transmittedData.originalSenderMAC); onUnicastReceivingCallback(incomingData.transmittedData.message, incomingData.transmittedData.originalSenderMAC);
} }
}
else else
unicastMessage(incomingData.transmittedData.message, incomingData.transmittedData.originalTargetMAC, incomingData.transmittedData.originalSenderMAC, UNICAST); unicastMessage(incomingData.transmittedData.message, incomingData.transmittedData.originalTargetMAC, incomingData.transmittedData.originalSenderMAC, UNICAST);
break; break;
@ -303,8 +242,17 @@ void ZHNetwork::maintenance()
if (macToString(incomingData.transmittedData.originalTargetMAC) == macToString(localMAC)) if (macToString(incomingData.transmittedData.originalTargetMAC) == macToString(localMAC))
{ {
if (onUnicastReceivingCallback) if (onUnicastReceivingCallback)
{
if (key_[0])
for (uint8_t i{0}; i < strlen(incomingData.transmittedData.message); ++i)
incomingData.transmittedData.message[i] = incomingData.transmittedData.message[i] ^ key_[i % strlen(key_)];
onUnicastReceivingCallback(incomingData.transmittedData.message, incomingData.transmittedData.originalSenderMAC); onUnicastReceivingCallback(incomingData.transmittedData.message, incomingData.transmittedData.originalSenderMAC);
unicastMessage("", incomingData.transmittedData.originalSenderMAC, localMAC, DELIVERY_CONFIRM_RESPONSE); }
confirmation_id_t id;
memcpy(&id.messageID, &incomingData.transmittedData.messageID, 2);
char temp[sizeof(transmitted_data_t::message)];
memcpy(&temp, &id, sizeof(transmitted_data_t::message));
unicastMessage(temp, incomingData.transmittedData.originalSenderMAC, localMAC, DELIVERY_CONFIRM_RESPONSE);
} }
else else
unicastMessage(incomingData.transmittedData.message, incomingData.transmittedData.originalTargetMAC, incomingData.transmittedData.originalSenderMAC, UNICAST_WITH_CONFIRM); unicastMessage(incomingData.transmittedData.message, incomingData.transmittedData.originalTargetMAC, incomingData.transmittedData.originalSenderMAC, UNICAST_WITH_CONFIRM);
@ -322,7 +270,17 @@ void ZHNetwork::maintenance()
if (macToString(incomingData.transmittedData.originalTargetMAC) == macToString(localMAC)) if (macToString(incomingData.transmittedData.originalTargetMAC) == macToString(localMAC))
{ {
if (onConfirmReceivingCallback) if (onConfirmReceivingCallback)
onConfirmReceivingCallback(incomingData.transmittedData.originalSenderMAC, true); {
confirmation_id_t id;
memcpy(&id.messageID, &incomingData.transmittedData.message, 2);
for (uint16_t i{0}; i < confirmationVector.size(); ++i)
{
confirmation_waiting_data_t confirmationData = confirmationVector[i];
if (confirmationData.messageID == id.messageID)
confirmationVector.erase(confirmationVector.begin() + i);
}
onConfirmReceivingCallback(incomingData.transmittedData.originalSenderMAC, id.messageID, true);
}
} }
else else
unicastMessage(incomingData.transmittedData.message, incomingData.transmittedData.originalTargetMAC, incomingData.transmittedData.originalSenderMAC, DELIVERY_CONFIRM_RESPONSE); unicastMessage(incomingData.transmittedData.message, incomingData.transmittedData.originalTargetMAC, incomingData.transmittedData.originalSenderMAC, DELIVERY_CONFIRM_RESPONSE);
@ -460,7 +418,21 @@ void ZHNetwork::maintenance()
#endif #endif
if (waitingData.transmittedData.messageType == UNICAST_WITH_CONFIRM && macToString(waitingData.transmittedData.originalSenderMAC) == macToString(localMAC)) if (waitingData.transmittedData.messageType == UNICAST_WITH_CONFIRM && macToString(waitingData.transmittedData.originalSenderMAC) == macToString(localMAC))
if (onConfirmReceivingCallback) if (onConfirmReceivingCallback)
onConfirmReceivingCallback(waitingData.transmittedData.originalTargetMAC, false); onConfirmReceivingCallback(waitingData.transmittedData.originalTargetMAC, waitingData.transmittedData.messageID, false);
}
}
if (confirmationVector.size())
{
for (uint16_t i{0}; i < confirmationVector.size(); ++i)
{
confirmation_waiting_data_t confirmationData = confirmationVector[i];
if ((millis() - confirmationData.time) > maxTimeForRoutingInfoWaiting_)
{
confirmationVector.erase(confirmationVector.begin() + i);
broadcastMessage("", confirmationData.targetMAC, SEARCH_REQUEST);
if (onConfirmReceivingCallback)
onConfirmReceivingCallback(confirmationData.targetMAC, confirmationData.messageID, false);
}
} }
} }
} }
@ -470,15 +442,6 @@ String ZHNetwork::getNodeMac()
return macToString(localMAC); return macToString(localMAC);
} }
IPAddress ZHNetwork::getNodeIp()
{
if (workMode_ == ESP_NOW_AP)
return WiFi.softAPIP();
if (workMode_ == ESP_NOW_STA)
return WiFi.localIP();
return IPAddress(0, 0, 0, 0);
}
String ZHNetwork::getFirmwareVersion() String ZHNetwork::getFirmwareVersion()
{ {
return firmware; return firmware;
@ -506,6 +469,13 @@ uint8_t *ZHNetwork::stringToMac(const String &string, uint8_t *mac)
return mac; return mac;
} }
error_code_t ZHNetwork::setCryptKey(const char *key)
{
if (strlen(key) >= 1 && strlen(key) <= 20)
strcpy(key_, key);
return SUCCESS;
}
error_code_t ZHNetwork::setMaxNumberOfAttempts(const uint8_t maxNumberOfAttempts) error_code_t ZHNetwork::setMaxNumberOfAttempts(const uint8_t maxNumberOfAttempts)
{ {
if (maxNumberOfAttempts < 1 || maxNumberOfAttempts > 10) if (maxNumberOfAttempts < 1 || maxNumberOfAttempts > 10)
@ -600,7 +570,7 @@ void IRAM_ATTR ZHNetwork::onDataReceive(uint8_t *mac, uint8_t *data, uint8_t len
criticalProcessSemaphore = false; criticalProcessSemaphore = false;
} }
void ZHNetwork::broadcastMessage(const char *data, const uint8_t *target, message_type_t type) uint16_t ZHNetwork::broadcastMessage(const char *data, const uint8_t *target, message_type_t type)
{ {
outgoing_data_t outgoingData; outgoing_data_t outgoingData;
outgoingData.transmittedData.messageType = type; outgoingData.transmittedData.messageType = type;
@ -609,6 +579,9 @@ void ZHNetwork::broadcastMessage(const char *data, const uint8_t *target, messag
memcpy(&outgoingData.transmittedData.originalTargetMAC, target, 6); memcpy(&outgoingData.transmittedData.originalTargetMAC, target, 6);
memcpy(&outgoingData.transmittedData.originalSenderMAC, &localMAC, 6); memcpy(&outgoingData.transmittedData.originalSenderMAC, &localMAC, 6);
strcpy(outgoingData.transmittedData.message, data); strcpy(outgoingData.transmittedData.message, data);
if (key_[0] && outgoingData.transmittedData.messageType == BROADCAST)
for (uint8_t i{0}; i < strlen(outgoingData.transmittedData.message); ++i)
outgoingData.transmittedData.message[i] = outgoingData.transmittedData.message[i] ^ key_[i % strlen(key_)];
memcpy(&outgoingData.intermediateTargetMAC, &broadcastMAC, 6); memcpy(&outgoingData.intermediateTargetMAC, &broadcastMAC, 6);
queueForOutgoingData.push(outgoingData); queueForOutgoingData.push(outgoingData);
#ifdef PRINT_LOG #ifdef PRINT_LOG
@ -632,9 +605,10 @@ void ZHNetwork::broadcastMessage(const char *data, const uint8_t *target, messag
Serial.print(macToString(outgoingData.transmittedData.originalTargetMAC)); Serial.print(macToString(outgoingData.transmittedData.originalTargetMAC));
Serial.println(F(" added to queue.")); Serial.println(F(" added to queue."));
#endif #endif
return outgoingData.transmittedData.messageID;
} }
void ZHNetwork::unicastMessage(const char *data, const uint8_t *target, const uint8_t *sender, message_type_t type) uint16_t ZHNetwork::unicastMessage(const char *data, const uint8_t *target, const uint8_t *sender, message_type_t type)
{ {
outgoing_data_t outgoingData; outgoing_data_t outgoingData;
outgoingData.transmittedData.messageType = type; outgoingData.transmittedData.messageType = type;
@ -643,6 +617,9 @@ void ZHNetwork::unicastMessage(const char *data, const uint8_t *target, const ui
memcpy(&outgoingData.transmittedData.originalTargetMAC, target, 6); memcpy(&outgoingData.transmittedData.originalTargetMAC, target, 6);
memcpy(&outgoingData.transmittedData.originalSenderMAC, sender, 6); memcpy(&outgoingData.transmittedData.originalSenderMAC, sender, 6);
strcpy(outgoingData.transmittedData.message, data); strcpy(outgoingData.transmittedData.message, data);
if (key_[0] && macToString(outgoingData.transmittedData.originalSenderMAC) == macToString(localMAC) && outgoingData.transmittedData.messageType != DELIVERY_CONFIRM_RESPONSE)
for (uint8_t i{0}; i < strlen(outgoingData.transmittedData.message); ++i)
outgoingData.transmittedData.message[i] = outgoingData.transmittedData.message[i] ^ key_[i % strlen(key_)];
for (uint16_t i{0}; i < routingVector.size(); ++i) for (uint16_t i{0}; i < routingVector.size(); ++i)
{ {
routing_table_t routingTable = routingVector[i]; routing_table_t routingTable = routingVector[i];
@ -678,7 +655,7 @@ void ZHNetwork::unicastMessage(const char *data, const uint8_t *target, const ui
Serial.print(macToString(outgoingData.intermediateTargetMAC)); Serial.print(macToString(outgoingData.intermediateTargetMAC));
Serial.println(F(" added to queue.")); Serial.println(F(" added to queue."));
#endif #endif
return; return outgoingData.transmittedData.messageID;
} }
} }
memcpy(&outgoingData.intermediateTargetMAC, target, 6); memcpy(&outgoingData.intermediateTargetMAC, target, 6);
@ -711,4 +688,5 @@ void ZHNetwork::unicastMessage(const char *data, const uint8_t *target, const ui
Serial.print(macToString(outgoingData.intermediateTargetMAC)); Serial.print(macToString(outgoingData.intermediateTargetMAC));
Serial.println(F(" added to queue.")); Serial.println(F(" added to queue."));
#endif #endif
return outgoingData.transmittedData.messageID;
} }

View File

@ -50,12 +50,18 @@ typedef struct
uint8_t intermediateTargetMAC[6]{0}; uint8_t intermediateTargetMAC[6]{0};
} routing_table_t; } routing_table_t;
typedef enum typedef struct
{ {
ESP_NOW = 1, uint16_t messageID{0};
ESP_NOW_AP, char empty[198]{0}; // Just only to prevent compiler warnings.
ESP_NOW_STA } confirmation_id_t;
} work_mode_t;
typedef struct
{
uint64_t time{0};
uint8_t targetMAC[6]{0};
uint16_t messageID{0};
} confirmation_waiting_data_t;
typedef enum typedef enum
{ {
@ -74,8 +80,9 @@ typedef enum // Just for further development.
} error_code_t; } error_code_t;
typedef std::function<void(const char *, const uint8_t *)> on_message_t; typedef std::function<void(const char *, const uint8_t *)> on_message_t;
typedef std::function<void(const uint8_t *, const bool)> on_confirm_t; typedef std::function<void(const uint8_t *, const uint16_t, const bool)> on_confirm_t;
typedef std::vector<routing_table_t> routing_vector_t; typedef std::vector<routing_table_t> routing_vector_t;
typedef std::vector<confirmation_waiting_data_t> confirmation_vector_t;
typedef std::queue<outgoing_data_t> outgoing_queue_t; typedef std::queue<outgoing_data_t> outgoing_queue_t;
typedef std::queue<incoming_data_t> incoming_queue_t; typedef std::queue<incoming_data_t> incoming_queue_t;
typedef std::queue<waiting_data_t> waiting_queue_t; typedef std::queue<waiting_data_t> waiting_queue_t;
@ -87,31 +94,21 @@ public:
ZHNetwork &setOnUnicastReceivingCallback(on_message_t onUnicastReceivingCallback); ZHNetwork &setOnUnicastReceivingCallback(on_message_t onUnicastReceivingCallback);
ZHNetwork &setOnConfirmReceivingCallback(on_confirm_t onConfirmReceivingCallback); ZHNetwork &setOnConfirmReceivingCallback(on_confirm_t onConfirmReceivingCallback);
error_code_t setWorkMode(const work_mode_t workMode); error_code_t begin(const char *netName = "", const bool gateway = false);
work_mode_t getWorkMode(void);
error_code_t setNetName(const char *netName); uint16_t sendBroadcastMessage(const char *data);
String getNetName(void); uint16_t sendUnicastMessage(const char *data, const uint8_t *target, const bool confirm = false);
error_code_t setStaSetting(const char *ssid, const char *password);
error_code_t setApSetting(const char *ssid, const char *password);
error_code_t begin(void);
error_code_t stop(void);
void sendBroadcastMessage(const char *data);
void sendUnicastMessage(const char *data, const uint8_t *target, const bool confirm = false);
void maintenance(void); void maintenance(void);
String getNodeMac(void); String getNodeMac(void);
IPAddress getNodeIp(void);
String getFirmwareVersion(void); String getFirmwareVersion(void);
String readErrorCode(error_code_t code); // Just for further development. String readErrorCode(error_code_t code); // Just for further development.
static String macToString(const uint8_t *mac); static String macToString(const uint8_t *mac);
uint8_t *stringToMac(const String &string, uint8_t *mac); uint8_t *stringToMac(const String &string, uint8_t *mac);
error_code_t setCryptKey(const char *key = "");
error_code_t setMaxNumberOfAttempts(const uint8_t maxNumberOfAttempts); error_code_t setMaxNumberOfAttempts(const uint8_t maxNumberOfAttempts);
uint8_t getMaxNumberOfAttempts(void); uint8_t getMaxNumberOfAttempts(void);
error_code_t setMaxWaitingTimeBetweenTransmissions(const uint8_t maxWaitingTimeBetweenTransmissions); error_code_t setMaxWaitingTimeBetweenTransmissions(const uint8_t maxWaitingTimeBetweenTransmissions);
@ -120,6 +117,29 @@ public:
uint16_t getMaxWaitingTimeForRoutingInfo(void); uint16_t getMaxWaitingTimeForRoutingInfo(void);
private: private:
static routing_vector_t routingVector;
static confirmation_vector_t confirmationVector;
static incoming_queue_t queueForIncomingData;
static outgoing_queue_t queueForOutgoingData;
static waiting_queue_t queueForRoutingVectorWaiting;
static bool criticalProcessSemaphore;
static bool sentMessageSemaphore;
static bool confirmReceivingSemaphore;
static bool confirmReceiving;
static uint8_t localMAC[6];
static uint16_t lastMessageID[10];
static char netName_[20];
static char key_[20];
const char *firmware{"1.41"};
const uint8_t broadcastMAC[6]{0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF};
uint8_t maxNumberOfAttempts_{3};
uint8_t maxWaitingTimeBetweenTransmissions_{50};
uint8_t numberOfAttemptsToSend{1};
uint16_t maxTimeForRoutingInfoWaiting_{500};
uint32_t lastMessageSentTime{0};
#if defined(ESP8266) #if defined(ESP8266)
static void onDataSent(uint8_t *mac, uint8_t status); static void onDataSent(uint8_t *mac, uint8_t status);
static void onDataReceive(uint8_t *mac, uint8_t *data, uint8_t length); static void onDataReceive(uint8_t *mac, uint8_t *data, uint8_t length);
@ -128,8 +148,8 @@ private:
static void onDataSent(const uint8_t *mac, esp_now_send_status_t status); static void onDataSent(const uint8_t *mac, esp_now_send_status_t status);
static void onDataReceive(const uint8_t *mac, const uint8_t *data, int length); static void onDataReceive(const uint8_t *mac, const uint8_t *data, int length);
#endif #endif
void broadcastMessage(const char *data, const uint8_t *target, message_type_t type); uint16_t broadcastMessage(const char *data, const uint8_t *target, message_type_t type);
void unicastMessage(const char *data, const uint8_t *target, const uint8_t *sender, message_type_t type); uint16_t unicastMessage(const char *data, const uint8_t *target, const uint8_t *sender, message_type_t type);
on_message_t onBroadcastReceivingCallback; on_message_t onBroadcastReceivingCallback;
on_message_t onUnicastReceivingCallback; on_message_t onUnicastReceivingCallback;
on_confirm_t onConfirmReceivingCallback; on_confirm_t onConfirmReceivingCallback;