Uploading IoT Application From Command Line: Difference between revisions

Latest revision as of 09:39, 6 June 2025

Uploading Code to NodeMCU (ESP8266) via Command Line

This guide explains how to compile and upload code to a NodeMCU (ESP8266) board using the command line, and how to monitor its serial output without using the Arduino IDE interface.

Prerequisites

Install Python from: https://www.python.org/downloads

 - Make sure to check "Add Python to PATH" during installation.

Open a command prompt and install the required Python packages:

pip install esptool

Install the Arduino IDE from: https://www.arduino.cc/en/software

Step 1: Compile the Sketch

Open your `.ino` sketch in the Arduino IDE.
Go to:

Tools → Board → NodeMCU 1.0 (ESP-12E Module)

Then export the compiled binary:

Sketch → Export Compiled Binary

The binary file (e.g., MySketch.ino.bin) will appear in the same folder as your sketch.

Step 2: Identify the COM Port

Connect your NodeMCU via USB.
Open the command prompt and type:

mode

Look for a line similar to:

Status for device COM3: - Note the COM port (e.g., COM3), which will be used in later steps.

Step 3: Flash the Code to NodeMCU

Navigate to the folder where your `.bin` file is saved:

cd "C:\Users\YourName\Documents\Arduino\MySketch"

Run the following command to upload the binary:

python -m esptool --port COM3 --baud 115200 write_flash 0x00000 MySketch.ino.bin

- Replace COM3 with your actual COM port. - Replace MySketch.ino.bin with the correct filename if different.

(Optional) Erase Flash Before Uploading

If you want to erase previous data on the chip before uploading new code:

python -m esptool --port COM3 erase_flash

Notes

Close the Arduino IDE's serial monitor before using the command-line monitor to avoid port conflicts.
If the command esptool or miniterm is not recognized, make sure Python's Scripts folder is added to your system PATH.
USB-to-Serial drivers such as CH340 or CP210x may be required depending on your NodeMCU model.

@@ Line 1: / Line 1: @@
-== Upload Code to NodeMCU (ESP8266) Using CMD ==
+== Uploading Code to NodeMCU (ESP8266) via Command Line ==
+This guide explains how to compile and upload code to a NodeMCU (ESP8266) board using the command line, and how to monitor its serial output without using the Arduino IDE interface.
 === Prerequisites ===
-# Install Python from https://www.python.org/downloads (Check "Add Python to PATH")
+# Install Python from: https://www.python.org/downloads
-# Install required tools:
+  - Make sure to check "Add Python to PATH" during installation.
+# Open a command prompt and install the required Python packages:
 <code>
-pip install esptool pyserial
+pip install esptool
 </code>
-# Install Arduino IDE: https://www.arduino.cc/en/software
+# Install the Arduino IDE from: https://www.arduino.cc/en/software
 === Step 1: Compile the Sketch ===
-# Open the sketch in Arduino IDE
+# Open your `.ino` sketch in the Arduino IDE.
-# Select board: <code>NodeMCU 1.0 (ESP-12E Module)</code> under Tools → Board
+# Go to:
-# Go to Sketch → Export Compiled Binary
+<code>
-# A <code>.bin</code> file will be generated in the sketch folder
+Tools → Board → NodeMCU 1.0 (ESP-12E Module)
+</code>
+# Then export the compiled binary:
+<code>
+Sketch → Export Compiled Binary
+</code>
+# The binary file (e.g., <code>MySketch.ino.bin</code>) will appear in the same folder as your sketch.
-=== Step 2: Find the COM Port ===
+=== Step 2: Identify the COM Port ===
-# Plug in NodeMCU
+# Connect your NodeMCU via USB.
-# Open Command Prompt and type:
+# Open the command prompt and type:
 <code>
 mode
 </code>
-# Look for a line like <code>Status for device COM3:</code>
+# Look for a line similar to:
+<code>
+Status for device COM3:
+</code>
+- Note the COM port (e.g., COM3), which will be used in later steps.
-=== Step 3: Flash the Code ===
+=== Step 3: Flash the Code to NodeMCU ===
-# Open CMD and go to the folder where the .bin file is located:
+# Navigate to the folder where your `.bin` file is saved:
 <code>
 cd "C:\Users\YourName\Documents\Arduino\MySketch"
 </code>
-# Upload the binary to NodeMCU:
+# Run the following command to upload the binary:
 <code>
-python -m esptool --port COM3 --baud 115200 write_flash 0x00000 MySketch.ino.bin
+python -m esptool --port COM3 --baud 115200 write_flash 0x00000 MySketch.ino.bin</code>
-</code>
+- Replace <code>COM3</code> with your actual COM port.
+- Replace <code>MySketch.ino.bin</code> with the correct filename if different.
-=== (Optional) Erase Flash Before Upload ===
+=== (Optional) Erase Flash Before Uploading ===
+# If you want to erase previous data on the chip before uploading new code:
 <code>
 python -m esptool --port COM3 erase_flash
 </code>
-=== Step 4: View Serial Output (Serial Monitor) ===
-# Open CMD and run:
-<code>
-python -m serial.tools.miniterm COM3 115200
-</code>
-# To exit, press <code>Ctrl + ]</code>
 === Notes ===
-* Make sure the COM port matches the one detected
+* Close the Arduino IDE's serial monitor before using the command-line monitor to avoid port conflicts.
-* Close Arduino Serial Monitor before using miniterm
+* If the command <code>esptool</code> or <code>miniterm</code> is not recognized, make sure Python's <code>Scripts</code> folder is added to your system PATH.
-* Ensure <code>Serial.begin(115200)</code> in your sketch matches the miniterm baud rate
+* USB-to-Serial drivers such as CH340 or CP210x may be required depending on your NodeMCU model.