Edit - Arduino Stack Exchange

You are not logged in. Your edit will be placed in a queue until it is peer reviewed.

We welcome edits that make the post easier to understand and more valuable for readers. Because community members review edits, please try to make the post substantially better than how you found it, for example, by fixing grammar or adding additional resources and hyperlinks.

Required fields*

Rev

Required fields*

How can I update a sketch to a NodeMCU "over the air" with the Arduino IDE?

I’m trying to use a sketch from this repository which uses MQTT to send a notification to Home-Assistant that acts a "presence sensor". When the NodeMCU comes into range of the specified SSID, the controller connects to WiFi and sends a MQTT message to home-assistant which can then perform some home automation commands. This code does exactly that. The MQTT messages are sent and received.

What is not working is that I can’t update the sketch over the air (OTA) via the included ArduinoOTA library. After uploading this sketch to the NodeMCU, it connects to WiFi and I am getting a message from the console output that the device is ready for OTA updates. From everything that I’ve read I beleive there is supposed to be an option in the Arduino menus where I can specify that I want to update OTA instead of a com port. How can I enable this in the IDE? Also, is there a way to "connect" to the serial monitor so that I can also see the output OTA?

I’m attaching the sketch for your convenience:

////////////////////////////////////////////////////////////////////////////////////////////////////
// Modify these values for your environment
const char* wifiSSID = "wifissid"; // Your WiFi network name
const char* wifiPassword = "wifipassword"; // Your WiFi network password
const char* otaPassword = "myotapassword"; // OTA update password
const char* mqttServer = "192.168.1.2"; // Your MQTT server IP address
const char* mqttUser = ""; // mqtt username, set to "" for no user
const char* mqttPassword = ""; // mqtt password, set to "" for no password
const String mqttNode = "CarPresence"; // Your unique hostname for this device
const String mqttDiscoveryPrefix = "homeassistant"; // Home Assistant MQTT Discovery, see https://home-assistant.io/docs/mqtt/discovery/
////////////////////////////////////////////////////////////////////////////////////////////////////
// Home Assistant MQTT Discovery, see https://home-assistant.io/docs/mqtt/discovery/
// We'll create one binary_sensor device to track MQTT connectivity
const String mqttDiscoBinaryStateTopic = mqttDiscoveryPrefix + "/binary_sensor/" + mqttNode + "/state";
const String mqttDiscoBinaryConfigTopic = mqttDiscoveryPrefix + "/binary_sensor/" + mqttNode + "/config";
// And a sensor for WiFi signal strength
const String mqttDiscoSignalStateTopic = mqttDiscoveryPrefix + "/sensor/" + mqttNode + "-signal/state";
const String mqttDiscoSignalConfigTopic = mqttDiscoveryPrefix + "/sensor/" + mqttNode + "-signal/config";
// And a sensor for device uptime
const String mqttDiscoUptimeStateTopic = mqttDiscoveryPrefix + "/sensor/" + mqttNode + "-uptime/state";
const String mqttDiscoUptimeConfigTopic = mqttDiscoveryPrefix + "/sensor/" + mqttNode + "-uptime/config";
// The strings below will spill over the PubSubClient_MAX_PACKET_SIZE 128
// You'll need to manually set MQTT_MAX_PACKET_SIZE in PubSubClient.h to 512
const String mqttDiscoBinaryConfigPayload = "{\"name\": \"" + mqttNode + "\", \"device_class\": \"connectivity\", \"state_topic\": \"" + mqttDiscoBinaryStateTopic + "\"}";
const String mqttDiscoSignalConfigPayload = "{\"name\": \"" + mqttNode + "-signal\", \"state_topic\": \"" + mqttDiscoSignalStateTopic + "\", \"unit_of_measurement\": \"dBm\", \"value_template\": \"{{ value }}\"}";
const String mqttDiscoUptimeConfigPayload = "{\"name\": \"" + mqttNode + "-uptime\", \"state_topic\": \"" + mqttDiscoUptimeStateTopic + "\", \"unit_of_measurement\": \"msec\", \"value_template\": \"{{ value }}\"}";
// Set the signal strength and uptime reporting interval in milliseconds
const unsigned long reportInterval = 5000;
unsigned long reportTimer = millis();
// Set LED "twinkle" time for maximum daylight visibility
const unsigned long twinkleInterval = 50;
unsigned long twinkleTimer = millis();
#include <ESP8266WiFi.h>
#include <ESP8266mDNS.h>
#include <WiFiUdp.h>
#include <ArduinoOTA.h>
#include <PubSubClient.h>
WiFiClient wifiClient;
PubSubClient mqttClient(wifiClient);
////////////////////////////////////////////////////////////////////////////////////////////////////
// System setup
void setup() {
 pinMode(LED_BUILTIN, OUTPUT);
 digitalWrite(LED_BUILTIN, HIGH);
 Serial.begin(115200);
 Serial.println("\nHardware initialized, starting program load");
 // Start up networking
 setupWifi();
 // Create server and assign callbacks for MQTT
 mqttClient.setServer(mqttServer, 1883);
 mqttClient.setCallback(mqtt_callback);
 // Start up OTA
 if (otaPassword[0]) {
 setupOTA();
 }
 Serial.println("Initialization complete\n");
}
////////////////////////////////////////////////////////////////////////////////////////////////////
// Main execution loop
void loop() {
 // check WiFi connection
 if (WiFi.status() != WL_CONNECTED) {
 setupWifi();
 }
 // check MQTT connection
 if (!mqttClient.connected()) {
 mqttConnect();
 }
 // MQTT client loop
 if (mqttClient.connected()) {
 mqttClient.loop();
 }
 // LED twinkle
 if (mqttClient.connected() && ((millis() - twinkleTimer) >= twinkleInterval)) {
 digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN));
 twinkleTimer = millis();
 }
 // Report signal strength and uptime
 if (mqttClient.connected() && ((millis() - reportTimer) >= reportInterval)) {
 String signalStrength = String(WiFi.RSSI());
 String uptimeTimer = String(millis());
 mqttClient.publish(mqttDiscoSignalStateTopic.c_str(), signalStrength.c_str());
 mqttClient.publish(mqttDiscoUptimeStateTopic.c_str(), uptimeTimer.c_str());
 reportTimer = millis();
 }
 // OTA loop
 if (otaPassword[0]) {
 ArduinoOTA.handle();
 }
}
////////////////////////////////////////////////////////////////////////////////////////////////////
// Functions
////////////////////////////////////////////////////////////////////////////////////////////////////
// Handle incoming commands from MQTT
void mqtt_callback(char* topic, byte* payload, unsigned int payloadLength) {
}
////////////////////////////////////////////////////////////////////////////////////////////////////
// Connect to WiFi
void setupWifi() {
 Serial.print("Connecting to WiFi network: " + String(wifiSSID));
 WiFi.hostname(mqttNode.c_str());
 WiFi.mode(WIFI_STA);
 WiFi.begin(wifiSSID, wifiPassword);
 while (WiFi.status() != WL_CONNECTED) {
 // Wait 500msec seconds before retrying
 delay(500);
 Serial.print(".");
 }
 Serial.println("\nWiFi connected successfully and assigned IP: " + WiFi.localIP().toString());
}
////////////////////////////////////////////////////////////////////////////////////////////////////
// MQTT connection and subscriptions
void mqttConnect() {
 digitalWrite(LED_BUILTIN, HIGH);
 Serial.println("Attempting MQTT connection to broker: " + String(mqttServer));
 // Attempt to connect to broker, setting last will and testament
 if (mqttClient.connect(mqttNode.c_str(), mqttUser, mqttPassword, mqttDiscoBinaryStateTopic.c_str(), 1, 1, "OFF")) {
 // when connected, record signal strength and reset reporting timer
 String signalStrength = String(WiFi.RSSI());
 reportTimer = millis();
 String uptimeTimer = String(millis());
 // publish MQTT discovery topics and device state
 Serial.println("MQTT discovery connectivity config: [" + mqttDiscoBinaryConfigTopic + "] : [" + mqttDiscoBinaryConfigPayload + "]");
 Serial.println("MQTT discovery connectivity state: [" + mqttDiscoBinaryStateTopic + "] : [ON]");
 Serial.println("MQTT discovery signal config: [" + mqttDiscoSignalConfigTopic + "] : [" + mqttDiscoSignalConfigPayload + "]");
 Serial.println("MQTT discovery signal state: [" + mqttDiscoSignalStateTopic + "] : " + WiFi.RSSI());
 Serial.println("MQTT discovery uptime config: [" + mqttDiscoUptimeConfigTopic + "] : [" + mqttDiscoUptimeConfigPayload + "]");
 Serial.println("MQTT discovery uptime state: [" + mqttDiscoUptimeStateTopic + "] : " + uptimeTimer);
 mqttClient.publish(mqttDiscoUptimeConfigTopic.c_str(), mqttDiscoUptimeConfigPayload.c_str(), true);
 mqttClient.publish(mqttDiscoUptimeStateTopic.c_str(), uptimeTimer.c_str());
 mqttClient.publish(mqttDiscoBinaryConfigTopic.c_str(), mqttDiscoBinaryConfigPayload.c_str(), true);
 mqttClient.publish(mqttDiscoBinaryStateTopic.c_str(), "ON");
 mqttClient.publish(mqttDiscoSignalConfigTopic.c_str(), mqttDiscoSignalConfigPayload.c_str(), true);
 mqttClient.publish(mqttDiscoSignalStateTopic.c_str(), signalStrength.c_str());
 Serial.println("MQTT connected");
 digitalWrite(LED_BUILTIN, LOW);
 }
 else {
 Serial.println("MQTT connection failed, rc=" + String(mqttClient.state()));
 }
}
////////////////////////////////////////////////////////////////////////////////////////////////////
// (mostly) boilerplate OTA setup from library examples
void setupOTA() {
 // Start up OTA
 // ArduinoOTA.setPort(8266); // Port defaults to 8266
 ArduinoOTA.setHostname(mqttNode.c_str());
 ArduinoOTA.setPassword(otaPassword);
 ArduinoOTA.onStart([]() {
 Serial.println("ESP OTA: update start");
 });
 ArduinoOTA.onEnd([]() {
 Serial.println("ESP OTA: update complete");
 });
 ArduinoOTA.onProgress([](unsigned int progress, unsigned int total) {
 //Serial.printf("Progress: %u%%\r", (progress / (total / 100)));
 });
 ArduinoOTA.onError([](ota_error_t error) {
 Serial.println("ESP OTA: ERROR code " + String(error));
 if (error == OTA_AUTH_ERROR) Serial.println("ESP OTA: ERROR - Auth Failed");
 else if (error == OTA_BEGIN_ERROR) Serial.println("ESP OTA: ERROR - Begin Failed");
 else if (error == OTA_CONNECT_ERROR) Serial.println("ESP OTA: ERROR - Connect Failed");
 else if (error == OTA_RECEIVE_ERROR) Serial.println("ESP OTA: ERROR - Receive Failed");
 else if (error == OTA_END_ERROR) Serial.println("ESP OTA: ERROR - End Failed");
 });
 ArduinoOTA.begin();
 Serial.println("ESP OTA: Over the Air firmware update ready");
}

Answer*

Follow the instruction here https://arduino-esp8266.readthedocs.io/en/latest/ota_updates/readme.html#application-example

First load the OTA example specified. Do not waste your time implementing it in your code until you have the supplied example working. 

If you are running Windows then it helps to have an application called Bonjour Browser. The OTA method makes use of mDNS. I use Bonjour Browser to confirm that the ESP is being seen. Then I go to ports in the IDE and there is an entry for the newly added OTA device. 

Select the entry instead of the com ports. Then compile and upload.

If you get an error then do a power cycle on the ESP board. You should only need to do this once after the serial upload. 

I use this method but sometimes the device does not appear below the com listed. I have had to close and restart the IDE to refresh the device listing. (I think this is a Windows issue) Because of this I prefer the webupdater method. 
https://arduino-esp8266.readthedocs.io/en/latest/ota_updates/readme.html#web-browser

Draft saved

Draft discarded

Edit Summary*

Cancel

good answer Rudy. In Sloeber (Arduino Eclipse plugin) I can enter the IP address and must not relay on mDNS

Juraj
– Juraj ♦

2018年11月05日 05:15:00 +00:00
Commented Nov 5, 2018 at 5:15
of the available OTA methods, this one is the simplest imho.

dandavis
– dandavis

2018年11月05日 20:29:40 +00:00
Commented Nov 5, 2018 at 20:29

Add a comment |

How to Edit

Correct minor typos or mistakes
Clarify meaning without changing it
Add related resources or links
Always respect the author’s intent
Don’t use edits to reply to the author

How to Format

create code fences with backticks ` or tildes ~
```
like so
```
add language identifier to highlight code
```python
def function(foo):
print(foo)
```
put returns between paragraphs
for linebreak add 2 spaces at end
_italic_ or **bold**
indent code by 4 spaces
backtick escapes `like _so_`
quote by placing > at start of line
to make links (use https whenever possible)

<https://example.com>

[example](https://example.com)

<a href="https://example.com">example</a>

formatting help »
answering help »

How to Tag

A tag is a keyword or label that categorizes your question with other, similar questions. Choose one or more (up to 5) tags that will help answerers to find and interpret your question.

complete the sentence: my question is about...
use tags that describe things or concepts that are essential, not incidental to your question
favor using existing popular tags
read the descriptions that appear below the tag

If your question is primarily about a topic for which you can't find a tag:

combine multiple words into single-words with hyphens (e.g. arduino-uno), up to a maximum of 35 characters
creating new tags is a privilege; if you can't yet create a tag you need, then post this question without it, then ask the community to create it for you

popular tags »