WiFi Module

Overview

The WiFi module provides comprehensive cloud connectivity including WiFi management, MQTT messaging, Firebase integration, and Google Sheets API for ESP32/ESP8266 platforms.

WiFi Connection

WiFiHandler

Basic WiFi connection management with auto-reconnect.

#define ENABLE_MODULE_WIFI_HANDLER
#include "Kinematrix.h"

WiFiHandler wifi;

void reconnectCallback() {
  Serial.println("Reconnecting to WiFi...");
}

void setup() {
  if (wifi.connectToWiFi("MySSID", "MyPassword", reconnectCallback)) {
    Serial.println("Connected!");
    Serial.println(WiFi.localIP());
  }
}

void loop() {
  if (!wifi.isConnect()) {
    wifi.connectToWiFi("MySSID", "MyPassword", reconnectCallback);
  }
}

connectToWiFi

bool

Connect to WiFi network

Show parameters

ssid

const char*

Network SSID

pwd

const char*

Network password

reconnectCallback

void (*)()

default:"nullptr"

Callback during reconnection attempts

Show returns

Returns true if connected successfully

isConnect

bool

Check WiFi connection status

Show returns

Returns true if connected

MQTT Messaging

MQTTManager

Comprehensive MQTT client with auto-reconnect and JSON support.

#define ENABLE_MODULE_MQTT_MANAGER
#include "Kinematrix.h"

MQTTManager mqtt;

void messageReceived(char* topic, byte* payload, unsigned int length) {
  Serial.printf("Message on %s: ", topic);
  for (int i = 0; i < length; i++) {
    Serial.print((char)payload[i]);
  }
  Serial.println();
}

void setup() {
  mqtt.beginWiFi("MySSID", "MyPassword");
  mqtt.beginMQTT("mqtt.server.com", 1883, "user", "pass");
  mqtt.setCallback(messageReceived);
  
  if (mqtt.connect()) {
    mqtt.subscribe("sensor/temperature");
    mqtt.publish("device/status", "online");
  }
}

void loop() {
  mqtt.loop();
}

beginWiFi

bool

Initialize WiFi connection

Show parameters

ssid

const char*

Network SSID

password

const char*

Network password

timeout

uint32_t

default:"20000"

Connection timeout in ms

beginMQTT

bool

Initialize MQTT connection

Show parameters

server

const char*

MQTT broker address

port

uint16_t

default:"1883"

MQTT port

username

const char*

default:"NULL"

MQTT username

password

const char*

default:"NULL"

MQTT password

setCallback

void

Set message callback

Show parameters

callback

MQTT_CALLBACK_SIGNATURE

Callback function(char* topic, byte* payload, unsigned int length)

connect

bool

Connect to MQTT broker

Show returns

Returns true if connected

publish

bool

Publish message

Show parameters

topic

const char*

Topic name

payload

const char*

Message payload

retained

bool

default:"false"

Retain message

publishJson

bool

Publish JSON document

Show parameters

topic

const char*

Topic name

doc

const T&

ArduinoJson document

retained

bool

default:"false"

Retain message

Subscribe to topic

Show parameters

topic

const char*

Topic name (wildcards supported: # and +)

qos

uint8_t

default:"0"

QoS level (0, 1, or 2)

reconnect

bool

Attempt reconnection

Show parameters

interval

unsigned long

default:"5000"

Retry interval in ms

loop

void

Process MQTT messages (call in loop)

setWill

void

Set last will message

Show parameters

topic

const char*

Will topic

message

const char*

Will message

retained

bool

default:"false"

Retain will

qos

uint8_t

default:"0"

Will QoS

enableAutoReconnect

void

Enable automatic reconnection

Show parameters

enable

bool

default:"true"

Enable flag

Firebase Integration

FirebaseV3Application

Modern Firebase SDK integration with multiple authentication methods.

#define ENABLE_MODULE_FIREBASE_V3
#include "Kinematrix.h"

FirebaseV3Application* firebase = FirebaseV3Application::getInstance();

void authCallback(AsyncResult& result) {
  if (result.isEvent()) {
    Serial.println("Authentication event");
  }
}

void setup() {
  // Email/password authentication
  firebase->begin("API_KEY", "[email protected]", "password", 
                  "project-id", authCallback);
  
  // Wait for ready
  while (!firebase->isReady()) {
    firebase->loop();
    delay(100);
  }
  
  Serial.println("Firebase ready!");
}

void loop() {
  firebase->loop();
}

getInstance

FirebaseV3Application*

Get singleton instance

Show returns

Returns Firebase application instance

begin

bool

Initialize Firebase with authentication

Show overloads

Email/Password

apiKey, userEmail, userPassword, projectId, callback

User authentication

Service Account

clientEmail, projectId, privateKey, callback

Service account authentication

Anonymous

projectId, callback

Anonymous authentication

loop

void

Process Firebase events (call in loop)

isReady

bool

Check if Firebase is ready

Show returns

Returns true when authenticated and ready

getProjectId

String

Get Firebase project ID

getApp

FirebaseApp&

Get FirebaseApp reference for services

Google Sheets API

GoogleSheetClient

Google Sheets integration for data logging and retrieval.

#define ENABLE_MODULE_GOOGLE_SHEETS
#include "Kinematrix.h"

GoogleSheetClient sheets;

void setup() {
  sheets.addAP("MySSID", "MyPassword");
  
  // Service account credentials
  sheets.begin("[email protected]",
               "project-id",
               "-----BEGIN PRIVATE KEY-----\n...");
               
  while (!sheets.ready()) {
    sheets.process();
    delay(100);
  }
  
  // Append data
  FirebaseJson valueRange;
  valueRange.set("values/[0]/[0]", "Temperature");
  valueRange.set("values/[0]/[1]", 25.5);
  
  sheets.appendValues("SPREADSHEET_ID", "Sheet1!A1", &valueRange);
}

void loop() {
  sheets.process();
}

begin

bool

Initialize Google Sheets client

Show parameters

clientEmail

const char*

Service account email

projectId

const char*

Google Cloud project ID

privateKey

const char*

Service account private key (PEM format)

addAP

void

Add WiFi access point

Show parameters

ssid

const char*

Network SSID

password

const char*

Network password

process

void

Process API requests (call in loop)

ready

bool

Check if client is ready

Show returns

Returns true when authenticated

updateValues

bool

Update cell values

Show parameters

spreadsheetId

const char*

Spreadsheet ID from URL

range

const char*

A1 notation range (e.g., “Sheet1!A1:B2”)

valueRange

FirebaseJson*

Value range JSON object

appendValues

bool

Append values to sheet

Show parameters

spreadsheetId

const char*

Spreadsheet ID

range

const char*

Starting range

valueRange

FirebaseJson*

Values to append

getValues

String

Get cell values

Show parameters

spreadsheetId

const char*

Spreadsheet ID

range

const char*

A1 notation range

Show returns

Returns JSON string with values

createSpreadsheet

String

Create new spreadsheet

Show parameters

title

const char*

Spreadsheet title

sheetName

const char*

Initial sheet name

rowCount

int

Number of rows

columnCount

int

Number of columns

userEmail

const char*

Email to share with

Show returns

Returns spreadsheet ID

Example: Complete IoT Logger

#define ENABLE_MODULE_MQTT_MANAGER
#define ENABLE_MODULE_GOOGLE_SHEETS
#include "Kinematrix.h"

MQTTManager mqtt;
GoogleSheetClient sheets;
float temperature = 0;

void messageReceived(char* topic, byte* payload, unsigned int length) {
  String msg = String((char*)payload).substring(0, length);
  temperature = msg.toFloat();
  
  // Log to Google Sheets
  FirebaseJson values;
  values.set("values/[0]/[0]", millis());
  values.set("values/[0]/[1]", temperature);
  sheets.appendValues("SPREADSHEET_ID", "Sheet1!A1", &values);
}

void setup() {
  mqtt.beginWiFi("SSID", "Password");
  mqtt.beginMQTT("mqtt.server.com");
  mqtt.setCallback(messageReceived);
  mqtt.connect();
  mqtt.subscribe("sensor/temp");
  
  sheets.addAP("SSID", "Password");
  sheets.begin("[email protected]",
               "project-id", "private-key");
}

void loop() {
  mqtt.loop();
  sheets.process();
}

Platform Support

WiFi modules are only available on ESP32 and ESP8266 platforms. Code is conditionally compiled with #if defined(ESP32) || defined(ESP8266).

ESP32

Full support - recommended platform

ESP8266

Full support with memory optimization

Core API

Sensors

Modules

AutoLight

Overview

WiFi Connection

WiFiHandler

MQTT Messaging

MQTTManager

Firebase Integration

FirebaseV3Application

Google Sheets API

GoogleSheetClient

Example: Complete IoT Logger

Platform Support

ESP32

ESP8266

Build docs developers (and LLMs) love

Core API

Sensors

Modules

AutoLight

​Overview

​WiFi Connection

​WiFiHandler

​MQTT Messaging

​MQTTManager

​Firebase Integration

​FirebaseV3Application

​Google Sheets API

​GoogleSheetClient

​Example: Complete IoT Logger

​Platform Support

ESP32

ESP8266

Build docs developers (and LLMs) love

Overview

WiFi Connection

WiFiHandler

MQTT Messaging

MQTTManager

Firebase Integration

FirebaseV3Application

Google Sheets API

GoogleSheetClient

Example: Complete IoT Logger

Platform Support