WifiEspNow.h

Go to the documentation of this file.

 
#ifndef WIFIESPNOW_H
#define WIFIESPNOW_H
 
#if defined(ARDUINO_ARCH_ESP8266)
#include <ESP8266WiFi.h>
#elif defined(ARDUINO_ARCH_ESP32)
#include <WiFi.h>
#endif
 
#include <cstddef>
#include <cstdint>
 
static const int WIFIESPNOW_ALEN = 6;
 
static const int WIFIESPNOW_KEYLEN = 16;
 
static const int WIFIESPNOW_MAXMSGLEN = 250;
 
struct WifiEspNowPeerInfo {
  uint8_t mac[WIFIESPNOW_ALEN];
  uint8_t channel;
};
 
enum class WifiEspNowSendStatus : uint8_t {
  NONE = 0, 
  OK   = 1, 
  FAIL = 2, 
};
 
class WifiEspNowClass
{
public:
  bool
  begin();
 
  void
  end();
 
  bool
  setPrimaryKey(const uint8_t key[WIFIESPNOW_KEYLEN]);
 
  int
  listPeers(WifiEspNowPeerInfo* peers, int maxPeers) const;
 
  bool
  hasPeer(const uint8_t mac[WIFIESPNOW_ALEN]) const;
 
#if defined(ARDUINO_ARCH_ESP8266)
  bool
  addPeer(const uint8_t mac[WIFIESPNOW_ALEN], int channel = 0, const uint8_t key[WIFIESPNOW_KEYLEN] = nullptr);
#elif defined(ARDUINO_ARCH_ESP32)
  bool
  addPeer(const uint8_t mac[WIFIESPNOW_ALEN], int channel = 0, const uint8_t key[WIFIESPNOW_KEYLEN] = nullptr, int netif = ESP_IF_WIFI_AP);
#endif
 
  bool
  removePeer(const uint8_t mac[WIFIESPNOW_ALEN]);
 
  using RxCallback = void (*)(const uint8_t mac[WIFIESPNOW_ALEN], const uint8_t* buf, size_t count, void* arg);
 
  void
  onReceive(RxCallback cb, void* arg);
 
  bool
  send(const uint8_t mac[WIFIESPNOW_ALEN], const uint8_t* buf, size_t count);
 
  WifiEspNowSendStatus
  getSendStatus() const
  {
    return m_txRes;
  }
 
private:
  static void
  rx(const uint8_t* mac, const uint8_t* data, uint8_t len);
 
  static void
  tx(const uint8_t* mac, uint8_t status);
 
private:
  RxCallback m_rxCb = nullptr;
  void* m_rxArg = nullptr;
  WifiEspNowSendStatus m_txRes = WifiEspNowSendStatus::NONE;
  bool m_ready = false;
};
 
extern WifiEspNowClass WifiEspNow;
 
#endif // WIFIESPNOW_H