Scaling an IoT deployment? Join our webinar on May 28th where we dive into real-world scaling pain points and how to overcome them.

Blues Developers
What’s New
Resources
Blog
Technical articles for developers
Newsletter
The monthly Blues developer newsletter
Terminal
Connect to a Notecard in your browser
Developer Certification
Get certified on wireless connectivity with Blues
Webinars
Listing of Blues technical webinars
Blues.comNotehub.io
Shop
Docs
Button IconHelp
Notehub StatusVisit our Forum
Button IconSign In
Sign In
Sign In
What’s New
Resources
Blog
Technical articles for developers
Newsletter
The monthly Blues developer newsletter
Terminal
Connect to a Notecard in your browser
Developer Certification
Get certified on wireless connectivity with Blues
Webinars
Listing of Blues technical webinars
Blues.comNotehub.io
Shop
Docs
homechevron_rightBlogchevron_rightEasiest Way to Add Cellular to the Raspberry Pi Zero 2

Easiest Way to Add Cellular to the Raspberry Pi Zero 2

Easiest Way to Add Cellular to the Raspberry Pi Zero 2 banner

May 17, 2023

Learn how to add an affordable cellular option to your Raspberry Pi Zero.

  • Cellular
  • Raspberry Pi
Rob Lauer
Rob LauerSenior Director of Developer Relations
email

This holiday season I'm thankful for many things, not the least of which is the fact that I got my hands on the new Raspberry Pi Zero 2 W ! And I have to say, it's been an absolute dream to work with.

raspberry pi zero 2

Building on the foundation of the original Raspberry Pi Zero, the 2 W includes a significantly improved CPU (a quad core Cortex-A53 @ 1 GHz to be precise) and improved wireless performance over its Wi-Fi enabled predecessor.

Now while Wi-Fi is a great connectivity method for the IoT, adding cellular access to the Zero can turn it into a truly "off-grid" Raspberry Pi. You may also want to enable cellular as a fallback connectivity method in case Wi-Fi goes down. Either way, read on for a quick tutorial on the easiest way to add cellular connectivity to the Raspberry Pi Zero (1 or 2!).

Introducing the Notecard

The key to your success with adding cellular communication capabilities to the Raspberry Pi Zero is the Notecard .

blues cellular notecard

The Notecard is a tiny 30mm x 35mm device-to-cloud data pump. With both cellular and GPS capabilities (and predictable pricing that starts at $49 for 10 years and 500 MB of data) the Notecard is a no-brainer for when you want to start pushing data to the cloud over LTE-M, NB-IoT, or Cat-1 cellular.

But what about that M.2 edge connector at the bottom of the Notecard? How on earth do you use this with a Raspberry Pi single-board computer (SBC)? The answer comes in the form of a HAT (the Notecarrier Pi HAT that is).

blues raspberry pi notecarrier-pi hat

The Notecarrier Pi is a HAT (Hardware Attached on Top) that's compatible with every Raspberry Pi SBC. It includes pass-through headers for stacking multiple HATs, a Grove I2C port, and an external antenna.

Installing the Notecard and Notecarrier Pi HAT

I'm not here to insult your intelligence, nor do I want to waste your time. I state this because the physical installation steps are about as simple as you might expect when working in the Raspberry Pi ecosystem!

  1. Slot the Notecard into the provided M.2 slot and screw the Notecard onto the HAT:

    placing notecard in notecarrier-pi hat

  2. Plug the Pi HAT into your Raspberry Pi Zero's 40-pin header:

    notecarrier pi hat on raspberry pi zero

  3. Plug the provided molex antenna into the MAIN u.FL connector on the Notecard:

    molex cellular antenna raspberry pi

And yes, that's the end of the installation tutorial!

Get the Raspberry Pi Zero Ready

There are a few one-time configuration steps to make the development experience as seamless as possible.

First, open up the "Raspberry Pi Configuration Tool" with:

$ sudo raspi-config

...and enable the I2C interface if it isn't already enabled.

Verify that the Pi HAT is correctly installed by using i2c-tools:

sudo apt-get install -y i2c-tools
sudo i2cdetect -y 1

The second command should show the Notecard on the correct I2C address (0x17).

Install the note-python and python-periphery libraries:

sudo pip3 install note-python python-periphery

And you are good to go!

Send Some Data to the Cloud Over Cellular

Since the Notecard API is 100% JSON-based (literally, everything is JSON in and JSON out), it doesn't matter what programming language you use. But since we are on a Raspberry Pi, we are going to stick with Python.

Open up your preferred text editor (Thonny is a nice one for Python development on the Pi) and paste in this entire code block. We'll go through a few important bits afterwards:

import notecard
from notecard import hub, card, note
from periphery import I2C

productUID = "com.gmail.something:pizero"
port = I2C("/dev/i2c-1")
nCard = notecard.OpenI2C(port, 0, 0)

# associate Notecard with a project on Notehub.io
rsp = hub.set(nCard, product=productUID, mode="continuous")

# send a single "note" to the cloud over cellular!
rsp = note.add(nCard, file="pi.qo", body={"Hello":"World!"})

Now what's all going on here?

  • We are opening a communication port on the I2C bus (/dev/i2c-1).
  • We are using the hub.set API to associate the Notecard with a Notehub project (more on Notehub below).
  • We are sending the JSON "Hello World!" object to the cloud, over cellular.

Viewing Your Cellular Data in the Cloud

Yes, we did put the cart before the horse by going through the Python code prior to setting up the cloud service that receives data. So now is a good time to run through what Notehub is all about.

Notehub is a cloud service from Blues that provides the ability to securely receive, process, and route data to your cloud endpoint of choice. This could be AWS, Azure, Google Cloud, or any number of IoT platforms like Datacake or Ubidots (or even your own custom RESTful API).

blues notehub and notecard data flow

Notehub also provides OTA firmware update features, fleet management, and cloud-based environment variables for easily sharing data across fleets of Notecards.

After creating a free account at Notehub.io and setting up your first project, you'll want to copy the provided ProductUID and paste that into the product parameter in the hub.set call in the Python script above.

Upon running the Python script, the note.add function will be executed. You can then log into the Notehub project and view related events in the Event panel:

raspberry pi data in notehub

From here you can set up routes to start relaying data to any cloud endpoint.

note

The Notecard can also receive data as documented in the Inbound Requests & Shared Data Guide.

Next Steps with the Pi

Clearly we've only just scratched the surface with the Notecard and Raspberry Pi Zero. Hopefully you've witnessed how ridiculously easy it is to add cellular connectivity and send data to the cloud in a matter of minutes.

If you're looking for some good next steps, I can recommend:

  • Grabbing your own Raspberry Pi Starter Kit .
  • Following the complete Notecard Quickstart Tutorial.
  • Learn how to route data to your cloud of choice.

Happy hacking on the Pi Zero! 👩‍💻🥧0️⃣

In This Article

  • Introducing the Notecard
  • Installing the Notecard and Notecarrier Pi HAT
  • Get the Raspberry Pi Zero Ready
  • Send Some Data to the Cloud Over Cellular
  • Viewing Your Cellular Data in the Cloud
  • Next Steps with the Pi

Blues Developer News

The latest IoT news for developers, delivered right to your inbox.

Comments

Join the conversation for this article on our Community Forum

Blues Developer Newsletter

The latest IoT news for developers, delivered right to your inbox.

© 2025 Blues Inc.
© 2025 Blues Inc.
TermsPrivacy
Notecard Disconnected
Having trouble connecting?

Try changing your USB cable as some cables do not support transferring data. If that does not solve your problem, contact us at support@blues.com and we will get you set up with another tool to communicate with the Notecard.

Advanced Usage

The help command gives more info.

Connect a Notecard
Use USB to connect and start issuing requests from the browser.
Try Notecard Simulator
Experiment with Notecard's latest firmware on a Simulator assigned to your free Notehub account.

Don't have an account? Sign up