How can I reset ESP8266 MicroPython after main.py crashes?

When dealing with crashes in ESP8266 MicroPython, we can implement several strategies to ensure the system restarts effectively and returns to normal operation. First, it is important to understand that the causes of main.py crashes can vary, such as memory exhaustion, programming logic errors, or external interrupt errors. Below are some solutions and steps:

1. Monitoring and Restarting

In MicroPython, we can implement a monitoring script to detect if main.py has crashed and automatically restart the device. A common approach is to use the reset() method from the machine module to restart the device. Example code follows:

python
import machine
try:
    import main
except Exception as e:
    print('Error:', e)
    machine.reset()

This script attempts to run main.py; if an exception occurs, it catches the exception and restarts the ESP8266.

2. Using Watchdog Timer

A watchdog timer is a hardware feature used to detect and recover from device anomalies. On ESP8266, we can enable the watchdog timer using MicroPython's machine.WDT(). If the watchdog is not fed within the specified time, the device will automatically restart, preventing it from freezing due to software errors.

python
from machine import WDT

# Set watchdog timer with a timeout of 30 seconds
wdt = WDT(timeout=30000)  # 30 seconds

def loop():
    while True:
        # Your main program logic
        do_something()

        # Feed the watchdog periodically to prevent restart
        wdt.feed()

try:
    loop()
except Exception as e:
    print("Error:", e)
    machine.reset()

In the above code, we periodically call wdt.feed() to "feed the watchdog" and prevent the watchdog timeout from restarting the device.

3. Software Restart and Hardware Restart

In some cases, if a software restart (using machine.reset()) is insufficient, consider a hardware restart. A hardware restart can be achieved by power cycling the ESP8266—disconnecting its power and reconnecting it. This is useful in extreme cases, such as when firmware is corrupted or persistent hardware faults occur.

4. Debugging and Logging

To better understand why main.py crashes, it is recommended to add logging functionality to the code, recording critical runtime information and errors. These logs help developers quickly identify issues.

python
import logging

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

try:
    # Main program logic
    do_critical_operations()
except Exception as e:
    logger.error("Program crashed, error message: %s", e)
    machine.reset()

By implementing these strategies and steps, we can effectively handle crashes in ESP8266 MicroPython's main.py and ensure the system quickly returns to normal operation. This is crucial for maintaining the reliability and stability of IoT devices.