![\"MicroPython](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/ESP32-ESP8266-Send-Email-Sensor-Readings-Micropython.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAre you going to use a different sensor? We have guides for the following sensors that will help you get started:<\/p>\n\n\n\n
- \n
- MicroPython: HC-SR04 Ultrasonic Sensor<\/strong> with ESP32 and ESP8266<\/a><\/li>\n\n\n\n
- MicroPython: BME680<\/strong> with ESP32 and ESP8266 (Temperature, Humidity, Pressure, Gas)<\/a><\/li>\n\n\n\n
- MicroPython: DS18B20<\/strong> Temperature Sensor with ESP32 and ESP8266<\/a><\/li>\n\n\n\n
- MicroPython: ESP32\/ESP8266 with DHT11\/DHT22<\/strong> Temperature and Humidity Sensor<\/a><\/li>\n\n\n\n
- MicroPython: Interrupts with ESP32 and ESP8266 (PIR Motion Sensor<\/strong>)<\/a><\/li>\n<\/ul>\n\n\n\n
Prerequisites<\/h2>\n\n\n\n
New to MicroPython? You can get started here: Getting Started with MicroPython on ESP32 and ESP8266<\/a>.<\/p>\n\n\n\n
To follow this tutorial you need MicroPython firmware installed in 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
- \n
- Thonny IDE:\n
- \n
- Installing and getting started with Thonny IDE<\/a><\/li>\n\n\n\n
- Flashing MicroPython Firmware with esptool.py<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n
- uPyCraft IDE:\n
- \n
- Getting Started with uPyCraft IDE<\/a><\/li>\n\n\n\n
- Install uPyCraft IDE (Windows<\/a>, Mac OS X<\/a>, Linux<\/a>)<\/li>\n\n\n\n
- Flash\/Upload MicroPython Firmware to ESP32 and ESP8266<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
Or, if you’re familiar with VS Code, you may want to use the PyMakr extension:<\/p>\n\n\n\n
- \n
- MicroPython: Program ESP32\/ESP8266 using VS Code and Pymakr<\/a><\/li>\n<\/ul>\n\n\n\n
For a comparison between different MicroPython IDEs, read: MicroPython IDEs for ESP32 and ESP8266<\/a>.<\/p>\n\n\n\n
Learn more about MicroPython: MicroPython Programming with ESP32 and ESP8266 eBook<\/a>.<\/p>\n\n\n\n
Parts Required<\/h3>\n\n\n\n
For this tutorial you need the following parts:<\/p>\n\n\n\n
- \n
- ESP32<\/a> (read Best ESP32 development boards<\/a>) or ESP8266<\/a><\/li>\n\n\n\n
- BME280<\/a> \u2013 BME280 with ESP32\/ESP8266 Guide<\/a><\/li>\n\n\n\n
- Jumper wires<\/a><\/li>\n\n\n\n
- Breadboard<\/a><\/li>\n<\/ul>\n\n\n
You can use the preceding links or go directly to MakerAdvisor.com\/tools<\/a> to find all the parts for your projects at the best price!<\/p>
![](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2017\/10\/header-200.png?w=1200&quality=100&strip=all&ssl=1\")
<\/a><\/p>\n\n\n\nuMail Module<\/h3>\n\n\n\n
To easily send emails with MicroPython, we’ll use a module called uMail<\/a>. This module is not part of the standard collection of MicroPython libraries, so we’ll need to upload it separately to our board\u2014we’ll provide instructions for this later in the tutorial.<\/p>\n\n\n\n
To get familiar with sending emails using this library, take a look at our tutorial:<\/p>\n\n\n\n
- \n
- MicroPython: Send Emails with the ESP32\/ESP826<\/a><\/li>\n<\/ul>\n\n\n\n
BME280 Module<\/h3>\n\n\n\n
To read from the BME280 sensor, we’ll use a module that’s not also part of the standard MicroPython libraries by default. So, we’ll need to upload it to the board before start writing the code. The BME280 module can be found here<\/a>.<\/p>\n\n\n\n
For a getting started guide to learn how to interface the BME280 with the ESP32\/ESP8266 using MicroPython, you can read the following tutorial:<\/p>\n\n\n\n
- \n
- MicroPython: BME280 with ESP32 and ESP8266 (Pressure, Temperature, Humidity)<\/a><\/li>\n<\/ul>\n\n\n\n
Sender Email (New Account)<\/h3>\n\n\n\n
We recommend creating a new email account to send the emails to your main personal email address. Do not use your main personal email to send emails via ESP32 or ESP8266<\/strong>. If something goes wrong in your code or if by mistake you make too many requests, you can be banned or have your account temporarily disabled. We recommend using a Gmail account, but other email providers should also work.<\/p>\n\n\n\n
Create an App Password<\/h3>\n\n\n\n
You need to create an app password so that new devices can send emails using your Gmail account. An App Password is a 16-digit passcode that gives a less secure app or device permission to access your Google Account. Learn more about sign-in with app passwords here<\/a>.<\/p>\n\n\n\n
You can follow these instructions<\/strong> to learn how to create your app password<\/a>.<\/p>\n\n\n\n
If you’re using another email provider, check how to create an app password. You should be able to find the instructions with a quick google search “your_email_provider<\/strong> + create app password”.<\/p>\n\n\n\n
Wiring the BME280<\/h2>\n\n\n\n
In this tutorial, we’ll create a sample project that sends BME280 sensor readings to your email. So, you need to wire the BME280 sensor to your board. Follow one of the next schematic diagrams.<\/p>\n\n\n\n
ESP32 with BME280<\/h4>\n\n\n\n
We’re going to use I2C communication with the BME280 sensor module. Wire the sensor to the default ESP32 SCL (GPIO 22<\/span>) and SDA (GPIO 21<\/span>) pins, as shown in the following schematic diagram.<\/p>\n\n\n
\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/10\/ESP32-BME280-Sensor-Temperature-Humidity-Pressure-Wiring-Diagram-Circuit_f.png?resize=675%2C670&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nESP8266 with BME280 <\/h4>\n\n\n\n
We’re going to use I2C communication with the BME280 sensor module. For that, wire the sensor to the ESP8266 SDA (GPIO 4<\/span>) and SCL (GPIO 5<\/span>) pins, as shown in the following schematic diagram.<\/p>\n\n\n
\n![\"ESP8266](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/07\/ESP8266-NodeMCU-BME280-Sensor-Temperature-Humidity-Pressure-Wiring-Diagram-Circuit.png?resize=675%2C531&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNot familiar with the BME280 with the ESP32\/ESP8266 using MicroPython? Read this tutorial: MicroPython: BME280 with ESP32 and ESP8266 (Pressure, Temperature, Humidity)<\/a>.<\/p>\n\n\n\n
Uploading the uMail Module<\/h2>\n\n\n\n
To send the emails, we’ll use the uMail module. You can check its Github page and several examples here<\/a>. This library isn\u2019t part of the standard MicroPython library by default. So, you need to upload the following file to your ESP32\/ESP8266 board (save it with the name umail.py<\/span>) before using the library.<\/p>\n\n\n
# Complete project details: https:\/\/RandomNerdTutorials.com\/micropython-send-emails-esp32-esp826\/\n# uMail (MicroMail) for MicroPython\n# Copyright (c) 2018 Shawwwn <shawwwn1@gmai.com> https:\/\/github.com\/shawwwn\/uMail\/blob\/master\/umail.py\n# License: MIT\nimport usocket\n\nDEFAULT_TIMEOUT = 10 # sec\nLOCAL_DOMAIN = '127.0.0.1'\nCMD_EHLO = 'EHLO'\nCMD_STARTTLS = 'STARTTLS'\nCMD_AUTH = 'AUTH'\nCMD_MAIL = 'MAIL'\nAUTH_PLAIN = 'PLAIN'\nAUTH_LOGIN = 'LOGIN'\n\nclass SMTP:\n def cmd(self, cmd_str):\n sock = self._sock;\n sock.write('%s\\r\\n' % cmd_str)\n resp = []\n next = True\n while next:\n code = sock.read(3)\n next = sock.read(1) == b'-'\n resp.append(sock.readline().strip().decode())\n return int(code), resp\n\n def __init__(self, host, port, ssl=False, username=None, password=None):\n import ssl\n self.username = username\n addr = usocket.getaddrinfo(host, port)[0][-1]\n sock = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM)\n sock.settimeout(DEFAULT_TIMEOUT)\n sock.connect(addr)\n if ssl:\n sock = ssl.wrap_socket(sock)\n code = int(sock.read(3))\n sock.readline()\n assert code==220, 'cant connect to server %d, %s' % (code, resp)\n self._sock = sock\n\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\n assert code==250, '%d' % code\n if not ssl and CMD_STARTTLS in resp:\n code, resp = self.cmd(CMD_STARTTLS)\n assert code==220, 'start tls failed %d, %s' % (code, resp)\n self._sock = ssl.wrap_socket(sock)\n\n if username and password:\n self.login(username, password)\n\n def login(self, username, password):\n self.username = username\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\n assert code==250, '%d, %s' % (code, resp)\n\n auths = None\n for feature in resp:\n if feature[:4].upper() == CMD_AUTH:\n auths = feature[4:].strip('=').upper().split()\n assert auths!=None, "no auth method"\n\n from ubinascii import b2a_base64 as b64\n if AUTH_PLAIN in auths:\n cren = b64("\\0%s\\0%s" % (username, password))[:-1].decode()\n code, resp = self.cmd('%s %s %s' % (CMD_AUTH, AUTH_PLAIN, cren))\n elif AUTH_LOGIN in auths:\n code, resp = self.cmd("%s %s %s" % (CMD_AUTH, AUTH_LOGIN, b64(username)[:-1].decode()))\n assert code==334, 'wrong username %d, %s' % (code, resp)\n code, resp = self.cmd(b64(password)[:-1].decode())\n else:\n raise Exception("auth(%s) not supported " % ', '.join(auths))\n\n assert code==235 or code==503, 'auth error %d, %s' % (code, resp)\n return code, resp\n\n def to(self, addrs, mail_from=None):\n mail_from = self.username if mail_from==None else mail_from\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\n assert code==250, '%d' % code\n code, resp = self.cmd('MAIL FROM: <%s>' % mail_from)\n assert code==250, 'sender refused %d, %s' % (code, resp)\n\n if isinstance(addrs, str):\n addrs = [addrs]\n count = 0\n for addr in addrs:\n code, resp = self.cmd('RCPT TO: <%s>' % addr)\n if code!=250 and code!=251:\n print('%s refused, %s' % (addr, resp))\n count += 1\n assert count!=len(addrs), 'recipient refused, %d, %s' % (code, resp)\n\n code, resp = self.cmd('DATA')\n assert code==354, 'data refused, %d, %s' % (code, resp)\n return code, resp\n\n def write(self, content):\n self._sock.write(content)\n\n def send(self, content=''):\n if content:\n self.write(content)\n self._sock.write('\\r\\n.\\r\\n') # the five letter sequence marked for ending\n line = self._sock.readline()\n return (int(line[:3]), line[4:].strip().decode())\n\n def quit(self):\n self.cmd("QUIT")\n self._sock.close()\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
Regardless of the IDE you’re using, these are the general instructions to upload the uMail library to your board:<\/p>\n\n\n\n
- \n
- First, make sure your board is running MicroPython firmware\u2014check the Prerequisites section<\/a>.<\/li>\n\n\n\n
- Create a new file in your IDE with the name umail.py<\/span> and paste the previous code there. Save that file.<\/li>\n\n\n\n
- Establish a serial communication with your board using your IDE.<\/li>\n\n\n\n
- Upload the umail.py<\/span> file to your board.<\/li>\n\n\n\n
- At this point, the library should have been successfully uploaded to your board. Now, you can use the library functionalities in your code by importing the library: import umail<\/span>.<\/li>\n<\/ol>\n\n\n\n
Uploading the BME280 Module<\/h2>\n\n\n\n
To get temperature, humidity, and pressure from the BME280 sensor, we’ll use the following module (name it BME280.py<\/span> before uploading it to your board).<\/p>\n\n\n
from machine import I2C\nimport time\n\n# BME280 default address.\nBME280_I2CADDR = 0x76\n\n# Operating Modes\nBME280_OSAMPLE_1 = 1\nBME280_OSAMPLE_2 = 2\nBME280_OSAMPLE_4 = 3\nBME280_OSAMPLE_8 = 4\nBME280_OSAMPLE_16 = 5\n\n# BME280 Registers\n\nBME280_REGISTER_DIG_T1 = 0x88 # Trimming parameter registers\nBME280_REGISTER_DIG_T2 = 0x8A\nBME280_REGISTER_DIG_T3 = 0x8C\n\nBME280_REGISTER_DIG_P1 = 0x8E\nBME280_REGISTER_DIG_P2 = 0x90\nBME280_REGISTER_DIG_P3 = 0x92\nBME280_REGISTER_DIG_P4 = 0x94\nBME280_REGISTER_DIG_P5 = 0x96\nBME280_REGISTER_DIG_P6 = 0x98\nBME280_REGISTER_DIG_P7 = 0x9A\nBME280_REGISTER_DIG_P8 = 0x9C\nBME280_REGISTER_DIG_P9 = 0x9E\n\nBME280_REGISTER_DIG_H1 = 0xA1\nBME280_REGISTER_DIG_H2 = 0xE1\nBME280_REGISTER_DIG_H3 = 0xE3\nBME280_REGISTER_DIG_H4 = 0xE4\nBME280_REGISTER_DIG_H5 = 0xE5\nBME280_REGISTER_DIG_H6 = 0xE6\nBME280_REGISTER_DIG_H7 = 0xE7\n\nBME280_REGISTER_CHIPID = 0xD0\nBME280_REGISTER_VERSION = 0xD1\nBME280_REGISTER_SOFTRESET = 0xE0\n\nBME280_REGISTER_CONTROL_HUM = 0xF2\nBME280_REGISTER_CONTROL = 0xF4\nBME280_REGISTER_CONFIG = 0xF5\nBME280_REGISTER_PRESSURE_DATA = 0xF7\nBME280_REGISTER_TEMP_DATA = 0xFA\nBME280_REGISTER_HUMIDITY_DATA = 0xFD\n\n\nclass Device:\n """Class for communicating with an I2C device.\n\n Allows reading and writing 8-bit, 16-bit, and byte array values to\n registers on the device."""\n\n def __init__(self, address, i2c):\n """Create an instance of the I2C device at the specified address using\n the specified I2C interface object."""\n self._address = address\n self._i2c = i2c\n\n def writeRaw8(self, value):\n """Write an 8-bit value on the bus (without register)."""\n value = value & 0xFF\n self._i2c.writeto(self._address, value)\n\n def write8(self, register, value):\n """Write an 8-bit value to the specified register."""\n b=bytearray(1)\n b[0]=value & 0xFF\n self._i2c.writeto_mem(self._address, register, b)\n\n def write16(self, register, value):\n """Write a 16-bit value to the specified register."""\n value = value & 0xFFFF\n b=bytearray(2)\n b[0]= value & 0xFF\n b[1]= (value>>8) & 0xFF\n self.i2c.writeto_mem(self._address, register, value)\n\n def readRaw8(self):\n """Read an 8-bit value on the bus (without register)."""\n return int.from_bytes(self._i2c.readfrom(self._address, 1),'little') & 0xFF\n\n def readU8(self, register):\n """Read an unsigned byte from the specified register."""\n return int.from_bytes(\n self._i2c.readfrom_mem(self._address, register, 1),'little') & 0xFF\n\n def readS8(self, register):\n """Read a signed byte from the specified register."""\n result = self.readU8(register)\n if result > 127:\n result -= 256\n return result\n\n def readU16(self, register, little_endian=True):\n """Read an unsigned 16-bit value from the specified register, with the\n specified endianness (default little endian, or least significant byte\n first)."""\n result = int.from_bytes(\n self._i2c.readfrom_mem(self._address, register, 2),'little') & 0xFFFF\n if not little_endian:\n result = ((result << 8) & 0xFF00) + (result >> 8)\n return result\n\n def readS16(self, register, little_endian=True):\n """Read a signed 16-bit value from the specified register, with the\n specified endianness (default little endian, or least significant byte\n first)."""\n result = self.readU16(register, little_endian)\n if result > 32767:\n result -= 65536\n return result\n\n def readU16LE(self, register):\n """Read an unsigned 16-bit value from the specified register, in little\n endian byte order."""\n return self.readU16(register, little_endian=True)\n\n def readU16BE(self, register):\n """Read an unsigned 16-bit value from the specified register, in big\n endian byte order."""\n return self.readU16(register, little_endian=False)\n\n def readS16LE(self, register):\n """Read a signed 16-bit value from the specified register, in little\n endian byte order."""\n return self.readS16(register, little_endian=True)\n\n def readS16BE(self, register):\n """Read a signed 16-bit value from the specified register, in big\n endian byte order."""\n return self.readS16(register, little_endian=False)\n\n\nclass BME280:\n def __init__(self, mode=BME280_OSAMPLE_1, address=BME280_I2CADDR, i2c=None,\n **kwargs):\n # Check that mode is valid.\n if mode not in [BME280_OSAMPLE_1, BME280_OSAMPLE_2, BME280_OSAMPLE_4,\n BME280_OSAMPLE_8, BME280_OSAMPLE_16]:\n raise ValueError(\n 'Unexpected mode value {0}. Set mode to one of '\n 'BME280_ULTRALOWPOWER, BME280_STANDARD, BME280_HIGHRES, or '\n 'BME280_ULTRAHIGHRES'.format(mode))\n self._mode = mode\n # Create I2C device.\n if i2c is None:\n raise ValueError('An I2C object is required.')\n self._device = Device(address, i2c)\n # Load calibration values.\n self._load_calibration()\n self._device.write8(BME280_REGISTER_CONTROL, 0x3F)\n self.t_fine = 0\n\n def _load_calibration(self):\n\n self.dig_T1 = self._device.readU16LE(BME280_REGISTER_DIG_T1)\n self.dig_T2 = self._device.readS16LE(BME280_REGISTER_DIG_T2)\n self.dig_T3 = self._device.readS16LE(BME280_REGISTER_DIG_T3)\n\n self.dig_P1 = self._device.readU16LE(BME280_REGISTER_DIG_P1)\n self.dig_P2 = self._device.readS16LE(BME280_REGISTER_DIG_P2)\n self.dig_P3 = self._device.readS16LE(BME280_REGISTER_DIG_P3)\n self.dig_P4 = self._device.readS16LE(BME280_REGISTER_DIG_P4)\n self.dig_P5 = self._device.readS16LE(BME280_REGISTER_DIG_P5)\n self.dig_P6 = self._device.readS16LE(BME280_REGISTER_DIG_P6)\n self.dig_P7 = self._device.readS16LE(BME280_REGISTER_DIG_P7)\n self.dig_P8 = self._device.readS16LE(BME280_REGISTER_DIG_P8)\n self.dig_P9 = self._device.readS16LE(BME280_REGISTER_DIG_P9)\n\n self.dig_H1 = self._device.readU8(BME280_REGISTER_DIG_H1)\n self.dig_H2 = self._device.readS16LE(BME280_REGISTER_DIG_H2)\n self.dig_H3 = self._device.readU8(BME280_REGISTER_DIG_H3)\n self.dig_H6 = self._device.readS8(BME280_REGISTER_DIG_H7)\n\n h4 = self._device.readS8(BME280_REGISTER_DIG_H4)\n h4 = (h4 << 24) >> 20\n self.dig_H4 = h4 | (self._device.readU8(BME280_REGISTER_DIG_H5) & 0x0F)\n\n h5 = self._device.readS8(BME280_REGISTER_DIG_H6)\n h5 = (h5 << 24) >> 20\n self.dig_H5 = h5 | (\n self._device.readU8(BME280_REGISTER_DIG_H5) >> 4 & 0x0F)\n\n def read_raw_temp(self):\n """Reads the raw (uncompensated) temperature from the sensor."""\n meas = self._mode\n self._device.write8(BME280_REGISTER_CONTROL_HUM, meas)\n meas = self._mode << 5 | self._mode << 2 | 1\n self._device.write8(BME280_REGISTER_CONTROL, meas)\n sleep_time = 1250 + 2300 * (1 << self._mode)\n\n sleep_time = sleep_time + 2300 * (1 << self._mode) + 575\n sleep_time = sleep_time + 2300 * (1 << self._mode) + 575\n time.sleep_us(sleep_time) # Wait the required time\n msb = self._device.readU8(BME280_REGISTER_TEMP_DATA)\n lsb = self._device.readU8(BME280_REGISTER_TEMP_DATA + 1)\n xlsb = self._device.readU8(BME280_REGISTER_TEMP_DATA + 2)\n raw = ((msb << 16) | (lsb << 8) | xlsb) >> 4\n return raw\n\n def read_raw_pressure(self):\n """Reads the raw (uncompensated) pressure level from the sensor."""\n """Assumes that the temperature has already been read """\n """i.e. that enough delay has been provided"""\n msb = self._device.readU8(BME280_REGISTER_PRESSURE_DATA)\n lsb = self._device.readU8(BME280_REGISTER_PRESSURE_DATA + 1)\n xlsb = self._device.readU8(BME280_REGISTER_PRESSURE_DATA + 2)\n raw = ((msb << 16) | (lsb << 8) | xlsb) >> 4\n return raw\n\n def read_raw_humidity(self):\n """Assumes that the temperature has already been read """\n """i.e. that enough delay has been provided"""\n msb = self._device.readU8(BME280_REGISTER_HUMIDITY_DATA)\n lsb = self._device.readU8(BME280_REGISTER_HUMIDITY_DATA + 1)\n raw = (msb << 8) | lsb\n return raw\n\n def read_temperature(self):\n """Get the compensated temperature in 0.01 of a degree celsius."""\n adc = self.read_raw_temp()\n var1 = ((adc >> 3) - (self.dig_T1 << 1)) * (self.dig_T2 >> 11)\n var2 = ((\n (((adc >> 4) - self.dig_T1) * ((adc >> 4) - self.dig_T1)) >> 12) *\n self.dig_T3) >> 14\n self.t_fine = var1 + var2\n return (self.t_fine * 5 + 128) >> 8\n\n def read_pressure(self):\n """Gets the compensated pressure in Pascals."""\n adc = self.read_raw_pressure()\n var1 = self.t_fine - 128000\n var2 = var1 * var1 * self.dig_P6\n var2 = var2 + ((var1 * self.dig_P5) << 17)\n var2 = var2 + (self.dig_P4 << 35)\n var1 = (((var1 * var1 * self.dig_P3) >> 8) +\n ((var1 * self.dig_P2) >> 12))\n var1 = (((1 << 47) + var1) * self.dig_P1) >> 33\n if var1 == 0:\n return 0\n p = 1048576 - adc\n p = (((p << 31) - var2) * 3125) \/\/ var1\n var1 = (self.dig_P9 * (p >> 13) * (p >> 13)) >> 25\n var2 = (self.dig_P8 * p) >> 19\n return ((p + var1 + var2) >> 8) + (self.dig_P7 << 4)\n\n def read_humidity(self):\n adc = self.read_raw_humidity()\n # print 'Raw humidity = {0:d}'.format (adc)\n h = self.t_fine - 76800\n h = (((((adc << 14) - (self.dig_H4 << 20) - (self.dig_H5 * h)) +\n 16384) >> 15) * (((((((h * self.dig_H6) >> 10) * (((h *\n self.dig_H3) >> 11) + 32768)) >> 10) + 2097152) *\n self.dig_H2 + 8192) >> 14))\n h = h - (((((h >> 15) * (h >> 15)) >> 7) * self.dig_H1) >> 4)\n h = 0 if h < 0 else h\n h = 419430400 if h > 419430400 else h\n return h >> 12\n\n @property\n def temperature(self):\n "Return the temperature in degrees."\n t = self.read_temperature()\n ti = t \/\/ 100\n td = t - ti * 100\n return "{}.{:02d}C".format(ti, td)\n\n @property\n def pressure(self):\n "Return the temperature in hPa."\n p = self.read_pressure() \/\/ 256\n pi = p \/\/ 100\n pd = p - pi * 100\n return "{}.{:02d}hPa".format(pi, pd)\n\n @property\n def humidity(self):\n "Return the humidity in percent."\n h = self.read_humidity()\n hi = h \/\/ 1024\n hd = h * 100 \/\/ 1024 - hi * 100\n return "{}.{:02d}%".format(hi, hd)\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
Regardless of the IDE you’re using, these are the general instructions to upload the BME280 library to your board:<\/p>\n\n\n\n
- \n
- First, make sure your board is running MicroPython firmware\u2014check the Prerequisites section<\/a>.<\/li>\n\n\n\n
- Create a new file in your IDE with the name BME280.py<\/span> and paste the previous code there. Save that file.<\/li>\n\n\n\n
- Establish a serial communication with your board using your IDE.<\/li>\n\n\n\n
- Upload the BME280.py<\/span> file to your board.<\/li>\n\n\n\n
- At this point, the library should have been successfully uploaded to your board. Now, you can use the library functionalities in your code by importing the library: import BME280<\/span>.<\/li>\n<\/ol>\n\n\n\n
Sending Sensor Readings via Email – MicroPython – Code<\/h2>\n\n\n\n
Now you should have uploaded the umail.py<\/span>, and BME280.py<\/span> files to your board to be able to send emails and read from the BME280 sensor. <\/p>\n\n\n\n
The following script sends a new email with the current sensor readings when the ESP32\/ESP8266 board first boots\/resets.<\/p>\n\n\n
# Complete project details: https:\/\/RandomNerdTutorials.com\/micropython-sensor-readings-email-esp32-esp826\/\nimport umail # Micropython lib to send emails: https:\/\/github.com\/shawwwn\/uMail\nimport network\nimport BME280\nfrom machine import Pin, SoftI2C\n\n# Your network credentials\nssid = 'REPLACE_WITH_YOUR_SSID'\npassword = 'REPLACE_WITH_YOUR_PASSWORD'\n\n# Email details\nsender_email = 'REPLACE_WITH_THE_SENDER_EMAIL'\nsender_name = 'ESP32' #sender name\nsender_app_password = 'REPLACE_WITH_THE_SENDER_EMAIL_APP_PASSWORD'\nrecipient_email ='REPLACE_WITH_THE_RECIPIENT_EMAIL'\nemail_subject ='BME280 Sensor Readings'\n\n# BME280 pin assignment - ESP32\ni2c = SoftI2C(scl=Pin(22), sda=Pin(21), freq=10000)\n# BME280 pin assignment - ESP8266\n#i2c = I2C(scl=Pin(5), sda=Pin(4), freq=10000)\nbme = BME280.BME280(i2c=i2c)\n\ndef read_bme_sensor():\n try:\n temp = str(bme.temperature[:-1]) + " \u00baC"\n #uncomment for temperature in Fahrenheit\n #temp = str((bme.read_temperature()\/100) * (9\/5) + 32) + " \u6f5eF"\n hum = str(bme.humidity[:-1]) + " %"\n pres = str(bme.pressure[:-3]) + " hPa"\n\n return temp, hum, pres\n #else:\n # return('Invalid sensor readings.')\n except OSError as e:\n return('Failed to read sensor.')\n \ndef connect_wifi(ssid, password):\n #Connect to your network\n station = network.WLAN(network.STA_IF)\n station.active(True)\n station.connect(ssid, password)\n while station.isconnected() == False:\n pass\n print('Connection successful')\n print(station.ifconfig())\n \n# Connect to your network\nconnect_wifi(ssid, password)\n\n# Get sensor readings\ntemp, hum, pres = read_bme_sensor()\nprint(temp)\nprint(hum)\nprint(pres)\n\n# Send the email\nsmtp = umail.SMTP('smtp.gmail.com', 465, ssl=True) # Gmail's SSL port\nsmtp.login(sender_email, sender_app_password)\nsmtp.to(recipient_email)\nsmtp.write("From:" + sender_name + "<"+ sender_email+">\\n")\nsmtp.write("Subject:" + email_subject + "\\n")\nsmtp.write("Temperature " + temp + "\\n")\nsmtp.write("Humidity " + hum + "\\n")\nsmtp.write("Pressure " + pres + "\\n")\nsmtp.send()\nsmtp.quit()\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
You need to insert your own details in the code before uploading the code to the board: SSID and password, sender email, sender name, and corresponding app password, recipient’s email, and email subject.<\/p>\n\n\n\n
After inserting all your details you can upload the code to your board. The file with the code needs to be named main.py<\/span>, otherwise, it will not work.<\/p>\n\n\n\n
How the Code Works<\/h3>\n\n\n\n
Continue reading to learn how the code works, or skip to the Demonstration <\/a>section.<\/p>\n\n\n\n
Including Libraries<\/h4>\n\n\n\n
First, include the required libraries. The umail<\/span> library, which we loaded previously to the board, so that we can send emails, and the network<\/span> library so that we can set the ESP32\/ESP8266 as a wi-fi station to be able to connect to the internet (local network). Additionally, you need to import the BME280<\/span> module to read from the BME280 sensor, and the Pin<\/span> and I2C<\/span> classes from the machine<\/span> module to establish an I2C communication with the sensor.<\/p>\n\n\n\n
import umail # Micropython lib to send emails: https:\/\/github.com\/shawwwn\/uMail\nimport network\nimport BME280\nfrom machine import Pin, SoftI2C<\/code><\/pre>\n\n\n\nNetwork Credentials<\/h4>\n\n\n\n
Insert your network credentials, SSID, and password, on the following variables so that your board can connect to the internet:<\/p>\n\n\n\n
ssid = 'REPLACE_WITH_YOUR_SSID'\npassword = 'REPLACE_WITH_YOUR_PASSWORD'<\/code><\/pre>\n\n\n\nEmail Details<\/h4>\n\n\n\n
Insert the email details: sender email, sender name, and corresponding app password. You really need to create an app password\u2014using the regular email password won’t work, check these instructions<\/a><\/strong>.<\/p>\n\n\n\n
# Email details\nsender_email = 'REPLACE_WITH_THE_SENDER_EMAIL'\nsender_name = 'ESP32' #sender name\nsender_app_password = 'REPLACE_WITH_THE_SENDER_EMAIL_APP_PASSWORD'<\/code><\/pre>\n\n\n\nInsert the recipient’s email on the recipient_email<\/span> variable:<\/p>\n\n\n\n
recipient_email ='REPLACE_WITH_THE_RECIPIENT_EMAIL'<\/code><\/pre>\n\n\n\nBME280<\/h4>\n\n\n\n
The email subject is set to BME280 Sensor Readings<\/span>, but you can change it on the email_subject<\/span> variable.<\/p>\n\n\n\n
email_subject ='BME280 Sensor Readings'<\/code><\/pre>\n\n\n\nCreate an i2c object using the board I2C pins. The ESP32 uses GPIO 22 and GPIO 21 as I2C pins.<\/p>\n\n\n\n
i2c = SoftI2C(scl=Pin(22), sda=Pin(21), freq=10000)<\/code><\/pre>\n\n\n\nIf you’re using an ESP8266 board, you should use GPIO 4 and GPIO 5 instead. <\/p>\n\n\n\n
i2c = I2C(scl=Pin(5), sda=Pin(4), freq=10000)<\/code><\/pre>\n\n\n\nIf you’re using a board with different I2C pins, make sure that you modify this previous line.<\/p>\n\n\n\n
Now that we have an i2c<\/span> object, we can create a BME280<\/span> object (in this case called bme<\/span>) on those pins.<\/p>\n\n\n\n
bme = BME280.BME280(i2c=i2c)<\/code><\/pre>\n\n\n\nReading BME280: Temperature, Humidity, and Pressure<\/h4>\n\n\n\n
To read from the BME280 sensor, we created a function called read_bme_sensor()<\/span> that returns the temperature, humidity, and pressure as strings with the corresponding units, which is the ideal format to use in the email body.<\/p>\n\n\n\n
def read_bme_sensor():\n try:\n temp = str(bme.temperature[:-1]) + \" \u00baC\"\n #uncomment for temperature in Fahrenheit\n #temp = str((bme.read_temperature()\/100) * (9\/5) + 32) + \" \u00baF\"\n hum = str(bme.humidity[:-1]) + \" %\"\n pres = str(bme.pressure[:-3]) + \" hPa\"\n\n return temp, hum, pres\n #else:\n # return('Invalid sensor readings.')\n except OSError as e:\n return('Failed to read sensor.')<\/code><\/pre>\n\n\n\nBy default, the function returns the temperature in Celcius degrees. If you want to get the temperature in Fahrenheit, you just need to uncomment the following line:<\/p>\n\n\n\n
#temp = str((bme.read_temperature()\/100) * (9\/5) + 32) + \" \u00baF\"<\/code><\/pre>\n\n\n\nConnecting to Wi-Fi<\/h4>\n\n\n\n
To connect the board to Wi-Fi, we created a function called connect_wifi()<\/span> that accepts as arguments the SSID and password of the network you want to connect to. You should call this function later to actually connect the ESP board to the internet.<\/p>\n\n\n\n
def connect_wifi(ssid, password):\n #Connect to your network\n station = network.WLAN(network.STA_IF)\n station.active(True)\n station.connect(ssid, password)\n while station.isconnected() == False:\n pass\n print('Connection successful')\n print(station.ifconfig())<\/code><\/pre>\n\n\n\nBefore sending the email, we need to connect the ESP32\/ESP8266 to the internet, so call the connect_wifi()<\/span> function (pass as arguments the ssid and password).<\/p>\n\n\n\n
# Connect to your network\nconnect_wifi(ssid, password)<\/code><\/pre>\n\n\n\nGetting New Readings<\/h4>\n\n\n\n
To get readings from the sensor in the format we want, we just need to call the read_bme_sensor()<\/span> function we created previously. The temperature, humidity and pressure are saved on the temp<\/span>, hum<\/span>, and pres<\/span> variables. These are string variables that already include the units (\u00baC, %, and hPa). The following lines, get the latest readings and print them on the shell.<\/p>\n\n\n\n
# Get sensor readings\ntemp, hum, pres = read_bme_sensor()\nprint(temp)\nprint(hum)\nprint(pres)<\/code><\/pre>\n\n\n\nSending the Email<\/h4>\n\n\n\n
Now, we can finally start preparing and sending the email.<\/p>\n\n\n\n
Start by creating an SMTP client using your email provider SMTP settings called smtp<\/span>. Here we’re using a Gmail account. Change the settings if you’re using a different email provider\u2014set the server, port, and if SSL is required or not.<\/p>\n\n\n\n
smtp = umail.SMTP('smtp.gmail.com', 465, ssl=True) # Gmail's SSL port<\/code><\/pre>\n\n\n\nThen, login into your account using the login()<\/span> method on the smtp<\/span> client\u2014pass as arguments the email and corresponding app password.<\/p>\n\n\n\n
smtp.login(sender_email, sender_app_password)<\/code><\/pre>\n\n\n\nSet the recipient using the to()<\/span> method and pass the recipient’s email as an argument:<\/p>\n\n\n\n
smtp.to(recipient_email)<\/code><\/pre>\n\n\n\nThen, use the write()<\/span> method to write the email. You can use this method as follows to set the sender name.<\/p>\n\n\n\n
smtp.write(\"From:\" + sender_name + \"<\"+ sender_email+\">\\n\")<\/code><\/pre>\n\n\n\nAnd you can use the following line to set the email subject.<\/p>\n\n\n\n
smtp.write(\"Subject:\" + email_subject + \"\\n\")<\/code><\/pre>\n\n\n\nFinally, you can actually write your email content. We’re just sending the temperature, humidity, and pressure values in the email body, but you can add more text or even some HTML to format the email body. The write()<\/span> method sends the email to the SMTP server.<\/p>\n\n\n\n
smtp.write(\"Temperature \" + temp + \"\\n\")\nsmtp.write(\"Humidity \" + hum + \"\\n\")\nsmtp.write(\"Pressure \" + pres + \"\\n\")<\/code><\/pre>\n\n\n\nIf you need to send a long string as the email body, break the email message into smaller chunks and send each chunk using the write()<\/span> method\u2014see the uMail library documentation<\/a>.<\/p>\n\n\n\n
Finally, use the send()<\/span> method to make the SMTP server send the email to the recipient.<\/p>\n\n\n\n
smtp.send()<\/code><\/pre>\n\n\n\nIn the end, close the connection with the server using the quit()<\/span> method.<\/p>\n\n\n\n
smtp.quit()<\/code><\/pre>\n\n\n\nDemonstration<\/h2>\n\n\n\n
After uploading the umail<\/span>, and the BME280<\/span> modules, and the main.py<\/span> script to your board, run the code or reset\/restart your board. You should get a similar message in the shell indicating that your board connected successfully to the internet, and the current sensor readings.<\/p>\n\n\n
\n![\"Sensor](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/Send-Sensor-Readings-via-Email-Micropython-shell.png?resize=552%2C105&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter a while, you should receive a new email on the recipient’s email account.<\/p>\n\n\n
\n![\"email](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/BME280-Sensor-Readings-Email.jpg?resize=712%2C399&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nOpen the email to check the current sensor readings.<\/p>\n\n\n
\n![\"BME280](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/BME280-Sensor-Readings-Email-2.jpg?resize=750%2C358&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWrapping Up<\/h2>\n\n\n\n
In this tutorial, you learned the basics of sending sensor readings via email with the ESP32\/ESP8266 programmed with MicroPython firmware. As an example, we sent readings from a BME280 sensor, but you can easily modify the code to use a different sensor.<\/p>\n\n\n\n
The example we’ve built sends the current sensor readings when the board resets\/restarts. The idea is to add this feature to your own projects. For example, send sensor readings to your email every day, send the readings when they are above or below a certain threshold, send the readings when you click on a button… The possibilities are endless.<\/p>\n\n\n\n
We hope you find this tutorial useful. If you want to use a different notification method, we have a tutorial showing how to send messages to WhatsApp using MicroPython (ESP32 and ESP8266):<\/p>\n\n\n\n
- \n
- MicroPython: Send Messages to WhatsApp with the ESP32\/ESP826<\/a><\/li>\n<\/ul>\n\n\n\n
You can check all our MicroPython projects here<\/a>.<\/p>\n\n\n\n
If you want to learn more about programming the ESP32 and ESP8266 boards with MicroPython, check out our eBook: MicroPython Programming with ESP32 and ESP8266<\/strong><\/a>.<\/strong><\/p>\n\n\n\n
Thanks for reading<\/p>\n","protected":false},"excerpt":{"rendered":"
In this tutorial, you’ll learn how to program the ESP32 and ESP8266 boards with MicroPython to send sensor readings to your email. As an example, we’ll send temperature, humidity, and … <\/p>\n
- Create a new file in your IDE with the name BME280.py<\/span> and paste the previous code there. Save that file.<\/li>\n\n\n\n
- Create a new file in your IDE with the name umail.py<\/span> and paste the previous code there. Save that file.<\/li>\n\n\n\n
- First, make sure your board is running MicroPython firmware\u2014check the Prerequisites section<\/a>.<\/li>\n\n\n\n
- MicroPython: BME280 with ESP32 and ESP8266 (Pressure, Temperature, Humidity)<\/a><\/li>\n<\/ul>\n\n\n\n
- BME280<\/a> \u2013 BME280 with ESP32\/ESP8266 Guide<\/a><\/li>\n\n\n\n
- ESP32<\/a> (read Best ESP32 development boards<\/a>) or ESP8266<\/a><\/li>\n\n\n\n
- Install uPyCraft IDE (Windows<\/a>, Mac OS X<\/a>, Linux<\/a>)<\/li>\n\n\n\n
- Flashing MicroPython Firmware with esptool.py<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Installing and getting started with Thonny IDE<\/a><\/li>\n\n\n\n
- MicroPython: BME680<\/strong> with ESP32 and ESP8266 (Temperature, Humidity, Pressure, Gas)<\/a><\/li>\n\n\n\n