![\"MicroPython:](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/ESP32-ESP8266-Micropython-get-system-info.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThe code used in this tutorial was created and shared by Charles E. Hamilton, one of our readers.<\/p>\n\n\n\n
New to MicroPython?<\/strong> Check out our eBook: MicroPython Programming with ESP32 and ESP8266 eBook (2nd Edition)<\/a><\/p>\n\n\n\n To follow this tutorial you need MicroPython firmware installed on your ESP32 or ESP8266 boards. You also need an IDE to write and upload the code to your board. We suggest using Thonny IDE or uPyCraft IDE:<\/p>\n\n\n\n Learn more about MicroPython: MicroPython Programming with ESP32 and ESP8266<\/a><\/p>\n\n\n\n After loading MicroPython firmware on your board, copy the following code to Thonny IDE or the IDE of your choice.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n The following section prints information about the Chip and CPU: platform used, the micropython version, board model, and CPU frequency.<\/p>\n\n\n\n These lines print the board MAC address. The MAC address is a unique identifier assigned to your device’s network interface. It\u2019s used for communication on Wi-Fi and other networks.<\/p>\n\n\n\n We print information about the board memory. The heap allocated is the amount of RAM currently in use by your program, while free heap is the amount of RAM still available for use.<\/p>\n\n\n\n There’s also a section to print the board flash size and if there’s PSRAM available.<\/p>\n\n\n\n Finally, we print the filesystem total size and free space.<\/p>\n\n\n\n And if there are any files in the filesystem root directory.<\/p>\n\n\n\n With the board connected to your computer and with a connection established with Thonny IDE, click the green run button to run the program on your board.<\/p>\n\n\n The information about your board will be printed in the MicroPython shell.<\/p>\n\n\n\n Below you can see the report for an ESP32 DOIT board.<\/p>\n\n\n We also tested this script with an ESP32S3, and ESP8266, and a Raspberry Pi Pico board (you can click on the images to enlarge).<\/p>\n\n\n In this quick guide, we shared a useful sketch that you can use and adapt in your projects to get essential information about your board chip and CPU, as well as information about the memory and filesystem.<\/p>\n\n\n\n To learn more about MicroPython, check out our resources:<\/p>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" In this quick guide, we’ll share a simple MicroPython script that displays useful information about your board. It’s a great tool for diagnostics and testing. The script retrieves details about … <\/p>\nPrerequisites<\/h2>\n\n\n\n
\n
\n
\n
Get System Info – MicroPython Script<\/h2>\n\n\n\n
# WhatsInIt.py - MicroPython Hardware & Environment Diagnostic Tool\n# For ESP32 \/ ESP8266 boards\n# Last updated: April 26, 2025 by Charles E. Hamilton\n# This program is released into the public domain free of license and without warranties of any kind\n# https:\/\/RandomNerdTutorials.com\/micropython-esp32-esp8266-device-info\/\n\nimport os\nimport sys\nimport gc\nimport machine\nimport network\nimport ubinascii\n\ntry:\n import esp\nexcept ImportError:\n esp = None\n\ntry:\n import esp32\nexcept ImportError:\n esp32 = None\n\nprint("\\n" + "=" * 40)\nprint(" WHATS IN IT REPORT")\nprint("=" * 40)\n\n# --- Chip & CPU Info ---\nprint("\\n[CHIP INFO]")\nprint(f"Platform: {sys.platform}")\nprint(f"MicroPython ver: {os.uname().release} ({os.uname().version})")\nprint(f"Machine ID: {os.uname().machine}")\nprint(f"CPU Frequency: {machine.freq()} Hz")\n\n# --- MAC Address ---\nprint("\\n[NETWORK]")\nwlan = network.WLAN(network.STA_IF)\nwlan.active(True)\nmac = ubinascii.hexlify(wlan.config('mac'), ':').decode()\nprint(f"MAC Address: {mac}")\n\n# --- Memory Info ---\nprint("\\n[MEMORY]")\nprint(f"Heap Allocated: {gc.mem_alloc()} bytes")\nprint(f"Heap Free: {gc.mem_free()} bytes")\n\n# Flash size (ESP32 only)\nif esp:\n try:\n flash_size = esp.flash_size()\n print(f"Flash Size: {flash_size \/\/ (1024*1024)} MB")\n except:\n print("Flash Size: Not available")\n\n# PSRAM status (ESP32 only)\nif esp32:\n try:\n psram_status = "Available" if esp32.ULP() is not None else "Not available"\n except:\n psram_status = "Not detected"\n print(f"PSRAM: {psram_status}")\n\n# --- Filesystem Info ---\nprint("\\n[FILESYSTEM]")\ntry:\n fs_stats = os.statvfs("\/")\n block_size = fs_stats[0]\n total_blocks = fs_stats[2]\n free_blocks = fs_stats[3]\n total = (block_size * total_blocks) \/\/ 1024\n free = (block_size * free_blocks) \/\/ 1024\n print(f"Total Size: {total} KB")\n print(f"Free Space: {free} KB")\nexcept:\n print("Filesystem info: Not available")\n\n# --- Directory Contents ---\nprint("\\n[FILES IN ROOT DIR]")\ntry:\n files = os.listdir()\n for f in files:\n print(f" - {f}")\nexcept:\n print("Cannot list files.")\n\n# --- Closing ---\nprint("\\n[END OF REPORT]")\nprint("=" * 40)\n<\/code><\/pre>\n\t# --- Chip & CPU Info ---\nprint(\"\\n[CHIP INFO]\")\nprint(f\"Platform: {sys.platform}\")\nprint(f\"MicroPython ver: {os.uname().release} ({os.uname().version})\")\nprint(f\"Machine ID: {os.uname().machine}\")\nprint(f\"CPU Frequency: {machine.freq()} Hz\")<\/code><\/pre>\n\n\n\n# --- MAC Address ---\nprint(\"\\n[NETWORK]\")\nwlan = network.WLAN(network.STA_IF)\nwlan.active(True)\nmac = ubinascii.hexlify(wlan.config('mac'), ':').decode()\nprint(f\"MAC Address: {mac}\")<\/code><\/pre>\n\n\n\n# --- Memory Info ---\nprint(\"\\n[MEMORY]\")\nprint(f\"Heap Allocated: {gc.mem_alloc()} bytes\")\nprint(f\"Heap Free: {gc.mem_free()} bytes\")<\/code><\/pre>\n\n\n\n# Flash size (ESP32 only)\nif esp:\n try:\n flash_size = esp.flash_size()\n print(f\"Flash Size: {flash_size \/\/ (1024*1024)} MB\")\n except:\n print(\"Flash Size: Not available\")\n\n# PSRAM status (ESP32 only)\nif esp32:\n try:\n psram_status = \"Available\" if esp32.ULP() is not None else \"Not available\"\n except:\n psram_status = \"Not detected\"\n print(f\"PSRAM: {psram_status}\")<\/code><\/pre>\n\n\n\n# --- Filesystem Info ---\nprint(\"\\n[FILESYSTEM]\")\ntry:\n fs_stats = os.statvfs(\"\/\")\n block_size = fs_stats[0]\n total_blocks = fs_stats[2]\n free_blocks = fs_stats[3]\n total = (block_size * total_blocks) \/\/ 1024\n free = (block_size * free_blocks) \/\/ 1024\n print(f\"Total Size: {total} KB\")\n print(f\"Free Space: {free} KB\")\nexcept:\n print(\"Filesystem info: Not available\")<\/code><\/pre>\n\n\n\n# --- Directory Contents ---\nprint(\"\\n[FILES IN ROOT DIR]\")\ntry:\n files = os.listdir()\n for f in files:\n print(f\" - {f}\")\nexcept:\n print(\"Cannot list files.\")<\/code><\/pre>\n\n\n\nTesting the Code<\/h3>\n\n\n\n
![\"Run](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/thonny-ide-run-button.png?resize=470%2C114&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/ESP32-Get-system-info-micropython.png?resize=750%2C674&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"ESP8266](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/ESP8266-Get-system-info-micropython.png?resize=750%2C582&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/Rpi-Pico-Get-system-info-micropython.png?resize=750%2C560&quality=100&strip=all&ssl=1\")
<\/a><\/figure>\n<\/div>\n\n\n\n![\"ESP32S3](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/ESP32S3-Get-system-info-micropython.png?resize=750%2C676&quality=100&strip=all&ssl=1\")
<\/a><\/figure>\n<\/div>\n<\/div>\n\n\n\nWrapping Up<\/h2>\n\n\n\n
\n