![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/Raspberry-Pi-Pico-Sending-Email-MicroPython.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNew to the Raspberry Pi Pico?<\/strong> Get started with the Raspberry Pi Pico here<\/a>.<\/p>\n\n\n\n Table of Contents:<\/strong><\/p>\n\n\n\n To follow this tutorial you need MicroPython firmware installed in your Raspberry Pi Pico board. You also need an IDE to write and upload the code to your board. <\/p>\n\n\n\n The recommended MicroPython IDE for the Raspberry Pi Pico is Thonny IDE. Follow the next tutorial to learn how to install Thonny IDE, flash MicroPython firmware, and upload code to the board.<\/p>\n\n\n\n SMTP <\/strong>means Simple Mail Transfer Protocol<\/em> and it is an internet standard for email transmission. To send emails using the Raspberry Pi Pico, you need to connect it to an SMTP Server.<\/p>\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 send emails with the Raspberry Pi Pico, you need a sender email and you’ll need to know your email SMTP server settings. Below you’ll find the settings for the most popular email providers.<\/p>\n\n\n\n If you’re using a Gmail account, these are the SMTP Server details:<\/p>\n\n\n\n For Outlook accounts, these are the SMTP Server settings:<\/p>\n\n\n\n For Live or Hotmail accounts, these are the SMTP Server settings:<\/p>\n\n\n\n If you’re using another email provider, you need to search for its SMTP Server settings\u2014you’ll easily find them with a quick Google search.<\/p>\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 the Raspberry Pi Pico<\/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.<\/p>\n\n\n\n We’ll use a Gmail.com account to send the emails, but you can use any other email provider. The receiver email can be your personal email without any problem.<\/p>\n\n\n\n Create a new email account for sending emails with the Raspberry Pi Pico. If you want to use a Gmail account, go to this link<\/a> to create a new one.<\/p>\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 An app password can only be used with accounts that have 2-step verification turned on<\/a><\/strong>. <\/p>\n\n\n\n After enabling 2-step verification, you can create an app password.<\/p>\n\n\n\n Click Create<\/strong>. Your app password will show up. Copy it to a safe place because you’ll need it later (even though it says you don’t need to).<\/p>\n\n\n Now, you should have an app password that you’ll use on the Raspberry Pi Pico micropython script to send the emails.<\/p>\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 To send the emails, we’ll use the uMail module. You can check its Github page and several examples<\/a>. This library isn\u2019t part of the standard MicroPython library by default. So, you need to upload the following file to your Raspberry Pi Pico (save it with the name umail.py<\/span>) before using the library.<\/p>\n\n\n View raw code<\/a><\/p>\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>.<\/p>\n\n\n\n The following MicroPython script sends a simple email when the Raspberry Pi Pico board first boots\/resets.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n You need to insert your details on the code before uploading the code to the board: SSID and password, sender email, sender name, and corresponding app password<\/strong> (it’s the app password<\/a> not the email password), recipient’s email, and email subject.<\/p>\n\n\n\n After inserting all your details you can run the code to test it. If you want the code to run without being connected to your computer, you need to save it on the Raspberry Pi Pico with the name main.py<\/em><\/strong>.<\/p>\n\n\n\n First, include the required libraries. The umail<\/span> library, which we loaded previously to the Pico, so that we can send emails, and the network<\/span> library so that we can set the Pico as a wi-fi station to connect to the internet (local network).<\/p>\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 Insert the email details: sender email, sender name, and corresponding app password. You need to create an app password\u2014using the regular email password won’t work, see this section<\/a>.<\/p>\n\n\n\n Insert the recipient’s email on the recipient_email<\/span> variable:<\/p>\n\n\n\n The email subject is set to Hello from RPi Pico W<\/span>, but you can change it on the email_subject<\/span> variable.<\/p>\n\n\n\n We created a function called init_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 connect the Pico board to the internet.<\/p>\n\n\n\n Before sending the email, we need to connect the Raspberry Pi Pico to the internet, so call the init_wifi()<\/span> function (pass as arguments the ssid and password).<\/p>\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 We then have try<\/span> and except<\/span> statements to send the email or print an error message if it fails.<\/p>\n\n\n\n Then, 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 Set the recipient using the to()<\/span> method and pass the recipient’s email as an argument:<\/p>\n\n\n\n Then, 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 You can use the following line to set the email subject.<\/p>\n\n\n\n Finally, you can write your email content. This is just a test email. We’re setting the message to “Hello from the Raspberry Pi Pico. Testing.”. The write()<\/span> method sends the email to the SMTP server.<\/p>\n\n\n\n If 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 If it fails to send the email, it will print an error message:<\/p>\n\n\n\n In the end, close the connection with the server using the quit()<\/span> method.<\/p>\n\n\n\n After uploading the umail.py<\/span> module, you can run our sample code to test sending an email.<\/p>\n\n\n The Pico should connect to the internet and send the email.<\/p>\n\n\n After a while, you should receive a new email on the recipient’s email account.<\/p>\n\n\n Open the email to check its content.<\/p>\n\n\n In this tutorial, you learned how to send emails with the Raspberry Pi Pico W using MicroPython. Sending an email using an SMTP server is very simple thanks to the uMail Micropython module<\/a>.<\/p>\n\n\n\n We’ve shown you a simple example of how to send emails. Now you can use this in your projects to send notification alerts, sensor readings, and other applications.<\/p>\n\n\n\n Learn more about the Raspberry Pi Pico with our eBook:<\/p>\n\n\n\n If you’re using an ESP32 or ESP8266, check the following tutorial: MicroPython: Send Emails with the ESP32\/ESP826<\/a>.<\/p>\n\n\n\n We hope you’ve found this tutorial useful. <\/p>\n\n\n\n\n
Prerequisites – MicroPython Firmware<\/h2>\n\n\n\n
\n
Introducing SMTP Servers<\/h2>\n\n\n\n
uMail Module<\/h3>\n\n\n\n
SMTP Server Settings<\/h3>\n\n\n\n
Gmail SMTP Server Settings<\/h4>\n\n\n\n
\n
Outlook SMTP Server Settings<\/h4>\n\n\n\n
\n
Live or Hotmail SMTP Server Settings<\/h4>\n\n\n\n
\n
Sender Email (New Account)<\/h2>\n\n\n\n
Create a Sender Email Account<\/h3>\n\n\n\n
![\"Gmail](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/create-gmail-account.png?resize=946%2C667&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nCreate an App Password<\/h3>\n\n\n\n
\n
\n
![\"Gmail](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/gmail-app-password.png?resize=756%2C477&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Gmail,](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/create-new-app-password-rpi-pico-f.png?resize=671%2C699&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Generated](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/generated-app-password.png?resize=542%2C454&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"App](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/app-password-create-for-Rpi-Pico-Gmail.png?resize=643%2C525&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nUploading the uMail Module<\/h2>\n\n\n\n
# Complete project details: https:\/\/RandomNerdTutorials.com\/raspberry-pi-pico-w-send-email-micropython\/\r\n# uMail (MicroMail) for MicroPython Copyright (c) 2018 Shawwwn <shawwwn1@gmai.com> https:\/\/github.com\/shawwwn\/uMail\/blob\/master\/umail.py License: MIT\r\nimport usocket\r\n\r\nDEFAULT_TIMEOUT = 10 # sec\r\nLOCAL_DOMAIN = '127.0.0.1'\r\nCMD_EHLO = 'EHLO'\r\nCMD_STARTTLS = 'STARTTLS'\r\nCMD_AUTH = 'AUTH'\r\nCMD_MAIL = 'MAIL'\r\nAUTH_PLAIN = 'PLAIN'\r\nAUTH_LOGIN = 'LOGIN'\r\n\r\nclass SMTP:\r\n def cmd(self, cmd_str):\r\n sock = self._sock;\r\n sock.write('%s\\r\\n' % cmd_str)\r\n resp = []\r\n next = True\r\n while next:\r\n code = sock.read(3)\r\n next = sock.read(1) == b'-'\r\n resp.append(sock.readline().strip().decode())\r\n return int(code), resp\r\n\r\n def __init__(self, host, port, ssl=False, username=None, password=None):\r\n import ssl\r\n self.username = username\r\n addr = usocket.getaddrinfo(host, port)[0][-1]\r\n sock = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM)\r\n sock.settimeout(DEFAULT_TIMEOUT)\r\n sock.connect(addr)\r\n if ssl:\r\n sock = ssl.wrap_socket(sock)\r\n code = int(sock.read(3))\r\n sock.readline()\r\n assert code==220, 'cant connect to server %d, %s' % (code, resp)\r\n self._sock = sock\r\n\r\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\r\n assert code==250, '%d' % code\r\n if not ssl and CMD_STARTTLS in resp:\r\n code, resp = self.cmd(CMD_STARTTLS)\r\n assert code==220, 'start tls failed %d, %s' % (code, resp)\r\n self._sock = ssl.wrap_socket(sock)\r\n\r\n if username and password:\r\n self.login(username, password)\r\n\r\n def login(self, username, password):\r\n self.username = username\r\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\r\n assert code==250, '%d, %s' % (code, resp)\r\n\r\n auths = None\r\n for feature in resp:\r\n if feature[:4].upper() == CMD_AUTH:\r\n auths = feature[4:].strip('=').upper().split()\r\n assert auths!=None, "no auth method"\r\n\r\n from ubinascii import b2a_base64 as b64\r\n if AUTH_PLAIN in auths:\r\n cren = b64("\\0%s\\0%s" % (username, password))[:-1].decode()\r\n code, resp = self.cmd('%s %s %s' % (CMD_AUTH, AUTH_PLAIN, cren))\r\n elif AUTH_LOGIN in auths:\r\n code, resp = self.cmd("%s %s %s" % (CMD_AUTH, AUTH_LOGIN, b64(username)[:-1].decode()))\r\n assert code==334, 'wrong username %d, %s' % (code, resp)\r\n code, resp = self.cmd(b64(password)[:-1].decode())\r\n else:\r\n raise Exception("auth(%s) not supported " % ', '.join(auths))\r\n\r\n assert code==235 or code==503, 'auth error %d, %s' % (code, resp)\r\n return code, resp\r\n\r\n def to(self, addrs, mail_from=None):\r\n mail_from = self.username if mail_from==None else mail_from\r\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\r\n assert code==250, '%d' % code\r\n code, resp = self.cmd('MAIL FROM: <%s>' % mail_from)\r\n assert code==250, 'sender refused %d, %s' % (code, resp)\r\n\r\n if isinstance(addrs, str):\r\n addrs = [addrs]\r\n count = 0\r\n for addr in addrs:\r\n code, resp = self.cmd('RCPT TO: <%s>' % addr)\r\n if code!=250 and code!=251:\r\n print('%s refused, %s' % (addr, resp))\r\n count += 1\r\n assert count!=len(addrs), 'recipient refused, %d, %s' % (code, resp)\r\n\r\n code, resp = self.cmd('DATA')\r\n assert code==354, 'data refused, %d, %s' % (code, resp)\r\n return code, resp\r\n\r\n def write(self, content):\r\n self._sock.write(content)\r\n\r\n def send(self, content=''):\r\n if content:\r\n self.write(content)\r\n self._sock.write('\\r\\n.\\r\\n') # the five letter sequence marked for ending\r\n line = self._sock.readline()\r\n return (int(line[:3]), line[4:].strip().decode())\r\n\r\n def quit(self):\r\n self.cmd("QUIT")\r\n self._sock.close()\r\n<\/code><\/pre>\n\t\n
Sending Emails with the Raspberry Pi Pico (MicroPython) – Code<\/h2>\n\n\n\n
# Rui Santos & Sara Santos - Random Nerd Tutorials\r\n# Complete project details at https:\/\/RandomNerdTutorials.com\/raspberry-pi-pico-w-send-email-micropython\/\r\n# Micropython lib to send emails: https:\/\/github.com\/shawwwn\/uMail\r\nimport umail\r\nimport network\r\nimport time\r\n\r\n# Your network credentials\r\nssid = 'REPLACE_WITH_YOUR_SSID'\r\npassword = 'REPLACE_WITH_YOUR_PASSWORD'\r\n\r\n# Email details\r\nsender_email = 'REPLACE_WITH_THE_SENDER_EMAIL'\r\nsender_name = 'Raspberry Pi Pico'\r\nsender_app_password = 'REPLACE_WITH_THE_SENDER_EMAIL_APP_PASSWORD'\r\nrecipient_email ='REPLACE_WITH_THE_RECIPIENT_EMAIL'\r\nemail_subject ='Hello from RPi Pico W'\r\n\r\n# Init Wi-Fi Interface\r\ndef init_wifi(ssid, password):\r\n wlan = network.WLAN(network.STA_IF)\r\n wlan.active(True)\r\n # Connect to your network\r\n wlan.connect(ssid, password)\r\n # Wait for Wi-Fi connection\r\n connection_timeout = 10\r\n while connection_timeout > 0:\r\n print(wlan.status())\r\n if wlan.status() >= 3:\r\n break\r\n connection_timeout -= 1\r\n print('Waiting for Wi-Fi connection...')\r\n time.sleep(1)\r\n # Check if connection is successful\r\n if wlan.status() != 3:\r\n print('Failed to connect to Wi-Fi')\r\n return False\r\n else:\r\n print('Connection successful!')\r\n network_info = wlan.ifconfig()\r\n print('IP address:', network_info[0])\r\n return True\r\n \r\n# Connect to your network\r\ninit_wifi(ssid, password)\r\n\r\n# Send the email\r\nsmtp = umail.SMTP('smtp.gmail.com', 465, ssl=True) # Gmail's SSL port\r\n\r\ntry:\r\n smtp.login(sender_email, sender_app_password)\r\n smtp.to(recipient_email)\r\n smtp.write("From:" + sender_name + "<"+ sender_email+">\\n")\r\n smtp.write("Subject:" + email_subject + "\\n")\r\n smtp.write("Hello from the Raspberry Pi Pico. Testing.")\r\n smtp.send()\r\n print("Email Sent Successfully")\r\n \r\nexcept Exception as e:\r\n print("Failed to send email:", e)\r\nfinally:\r\n smtp.quit()<\/code><\/pre>\n\tHow the Code Works<\/h3>\n\n\n\n
import umail\nimport network<\/code><\/pre>\n\n\n\nssid = 'REPLACE_WITH_YOUR_SSID'\npassword = 'REPLACE_WITH_YOUR_PASSWORD'<\/code><\/pre>\n\n\n\n# Email details\nsender_email = 'REPLACE_WITH_THE_SENDER_EMAIL'\nsender_name = 'Raspberry Pi Pico'\nsender_app_password = 'REPLACE_WITH_THE_SENDER_EMAIL_APP_PASSWORD'<\/code><\/pre>\n\n\n\nrecipient_email ='REPLACE_WITH_THE_RECIPIENT_EMAIL'<\/code><\/pre>\n\n\n\nemail_subject ='Hello from RPi Pico W'<\/code><\/pre>\n\n\n\n# Init Wi-Fi Interface\ndef init_wifi(ssid, password):\n wlan = network.WLAN(network.STA_IF)\n wlan.active(True)\n # Connect to your network\n wlan.connect(ssid, password)\n # Wait for Wi-Fi connection\n connection_timeout = 10\n while connection_timeout > 0:\n print(wlan.status())\n if wlan.status() >= 3:\n break\n connection_timeout -= 1\n print('Waiting for Wi-Fi connection...')\n time.sleep(1)\n # Check if connection is successful\n if wlan.status() != 3:\n print('Failed to connect to Wi-Fi')\n return False\n else:\n print('Connection successful!')\n network_info = wlan.ifconfig()\n print('IP address:', network_info[0])\n return True<\/code><\/pre>\n\n\n\n# Connect to your network\ninit_wifi(ssid, password)<\/code><\/pre>\n\n\n\nsmtp = umail.SMTP('smtp.gmail.com', 465, ssl=True) # Gmail's SSL port<\/code><\/pre>\n\n\n\nsmtp.login(sender_email, sender_app_password)<\/code><\/pre>\n\n\n\nsmtp.to(recipient_email)<\/code><\/pre>\n\n\n\nsmtp.write(\"From:\" + sender_name + \"<\"+ sender_email+\">\\n\")<\/code><\/pre>\n\n\n\nsmtp.write(\"Subject:\" + email_subject + \"\\n\")<\/code><\/pre>\n\n\n\nsmtp.write(\"Hello from the Raspberry Pi Pico. Testing.\")<\/code><\/pre>\n\n\n\nsmtp.send()<\/code><\/pre>\n\n\n\nexcept Exception as e:\n print(\"Failed to send email:\", e)<\/code><\/pre>\n\n\n\nfinally:\n smtp.quit()<\/code><\/pre>\n\n\n\nDemonstration<\/h2>\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![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/email-sent-successfully.png?resize=683%2C298&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"test](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/Received-email-raspberry-pi-pico.jpg?resize=1037%2C304&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"test](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/03\/email-sent-from-RPi-Pico.png?resize=553%2C290&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWrapping Up<\/h2>\n\n\n\n
\n