MagTag - 2.9" Grayscale E-Ink WiFi Display
The Adafruit MagTag combines the new ESP32-S2 wireless module and a 2.9” grayscale E-Ink display to make a low-power IoT display that can show data on its screen even when power is removed! The ESP32-S2 is great because it builds on the years of code and support for the ESP32 and also adds native USB support so you can use this board with Arduino or CircuitPython!
We designed this board to be low-power friendly - with a spot for a 350 or 420 mAh battery and built in battery charging over USB C. During deep sleep, with the NeoPixels and speaker amplifier disabled, we measured 250uA power draw so you can run for a few weeks between charges.
And of course, the Mag in MagTag stands for magnetic. We have four M3 standoffs that will work perfectly with these mini magnet feet. (Originally they’re designed for RGB Matrices but they’ll do an excellent job here as well). Screw on the feet and you can attach this display to a metallic shelf, fridge, or bench.
Here’s the cool hardware we put together:
- ESP32-S2 240MHz Tensilica processor - the next generation of ESP32, now with native USB so it can act like a keyboard/mouse, MIDI device, disk drive, etc!
- WROVER module has FCC/CE certification and comes with 4 MByte of Flash and 2 MByte of PSRAM - you can have huge data buffers
- 2.9” grayscale display with 296x128 pixels. Each pixel can be white, light gray, dark gray or black. Compared to ‘tri-color’ displays with a red pigment, this display takes a lot less time to update, only about a second instead of 15 seconds!
- USB C power and data connector
- Four RGB side-emitting NeoPixels so you can light up the display with any color or pattern
- Four buttons can be used to wake up the ESP32 from deep-sleep, or select different modes
- Triple-axis accelerometer (LIS3DH) can be used to detect orientation of the display
- Speaker/Buzzer with mini class D amplifier on DAC output A0 can play tones or lo-fi audio clips.
- Front facing light sensor
- STEMMA QT port for attaching all sorts of I2C devices
- Two STEMMA 3 pin JST connectors for attaching NeoPixels, speakers, servos or relays.
- On/Off switch
- Boot and Reset buttons for re-programming
Have some info to add for this board? Edit the source for this page here.
This is the latest stable release of CircuitPython that will work with the MagTag - 2.9" Grayscale E-Ink WiFi Display.
Start here if you are new to CircuitPython.
Built-in modules available: _bleio, adafruit_bus_device, adafruit_pixelbuf, aesio, alarm, analogio, atexit, audiobusio, audiocore, audiomixer, binascii, bitbangio, bitmaptools, board, busio, canio, countio, digitalio, displayio, dualbank, errno, fontio, framebufferio, frequencyio, getpass, imagecapture, ipaddress, json, keypad, math, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, paralleldisplay, ps2io, pulseio, pwmio, qrio, rainbowio, random, re, rgbmatrix, rotaryio, rtc, sdcardio, sharpdisplay, socketpool, ssl, storage, struct, supervisor, synthio, terminalio, time, touchio, traceback, ulab, usb_cdc, usb_hid, usb_midi, vectorio, watchdog, wifi
Every time we commit new code to CircuitPython we automatically build binaries for each board and language. The binaries are stored on Amazon S3, organized by board, and then by language. Try them if you want the absolute latest and are feeling daring or want to see if a problem has been fixed.
All previous releases are listed on GitHub, with release notes, and are available for download from Amazon S3. They are handy for testing, but otherwise we recommend using the latest stable release. Some older GitHub release pages include the same binaries for downloading. But we have discontinued including binaries as assets on newer release pages because of the large number of files for each release.
Install, Repair, or Update UF2 Bootloader
Latest version: 0.5.2
The UF2 bootloader allows you to load CircuitPython, MakeCode, and Arduino programs. The bootloader is not CircuitPython. If a UF2 bootloader is installed, you can check its version by looking in the INFO_UF2.TXT file when the BOOT drive is visible (FTHRS2BOOT, MAGTAGBOOT, HOUSEBOOT, etc.)
It is not necessary to reinstall a UF2 bootloader you unless a BOOT drive is not visible when in UF2 bootloader mode, or you know of a problem with your current UF2 bootloader.
If a UF2 bootloader has never been installed on the board, or the UF2 bootloader was removed by erasing or overwriting the flash, the UF2 bootloader must be installed in order to flash .uf2 files onto the board. .bin files can be uploaded without a UF2 bootloader, using the Adafruit WebSerial ESPTool or esptool.py.
Note: update.uf2 files are not currently working on ESP32-S2 boards.
Important: this will erase previously flashed firmware and sketches from the board, but needs to be perfomed only once.
- Unzip to find the file combined.bin.
- Place board in bootloader mode:
- Plug board into a USB port on your computer using a data/sync cable. Make sure it is the only board plugged in, and that a charge-only cable is not being used.
- Press and hold down the BOOT or 0 button.
- Press and release the RESET or RST button.
- Release the BOOT button.
- Upload combined.bin (Google Chrome 89 or newer):
- Open Adafruit WebSerial ESPTool in a new window/tab.
- Select 460800 Baud from the pull-down menu (top-right).
- Click Connect (top-right).
- Select the COM or Serial port from the pop-up window.
- After successful connection, click Erase.
- After successful erase, click any Choose a file..., then locate and select the combined.bin file unzipped earlier.
- After successfully choosing combined.bin, click Program.
- After the TinyUF2 firmware update is complete, press the RESET button on the board. A new drive BOOT should be visible in your file browser.
After you update, check INFO_UF2.TXT to verify that the bootloader version has been updated. Then you will need to load or reload CircuitPython using the .uf2 file.