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
Docs Home
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
Datasheets
Notecard Datasheet
Functional DescriptionPackage ConfigurationBlock DiagramPower InformationAntenna RequirementsCellular ServicePin InformationTechnical DetailsSpecificationsOrdering InformationCertificationsBoard ErrataTerms and ConditionsRevision HistoryContact Information
Notecarrier Datasheet
Starnote Datasheet
Cygnet Datasheet
Swan Datasheet
Wireless for Arduino Opta Datasheet
Mojo Datasheet
Sparrow Datasheet
Scoop Datasheet
Application Notes
Notecarrier A Series Solar JST Input
Notecard Host System Design Guide
Future-Proofing Notecard-Based Designs
Low-Power Hardware Design
Designing for XP Variants of the Blues Notecard
Airnote Datasheet
homechevron_rightDocschevron_rightDatasheetschevron_rightNotecard Datasheet - NOTE-LORA v2.1

Blues Notecard® Datasheet: NOTE-LORA v2.1

LoRa Device-to-Cloud Data Pump

For developers looking for the ability to expand their wireless connectivity options beyond cellular and Wi-Fi without sacrificing the simplicity and power of the Notecard.

The Notecard for LoRa is a version of the Blues Notecard that allows for connecting to LoRaWAN gateways. The device follows the same M.2 pinout as the cellular and Wi-Fi Notecards. What's more, the Notecard for LoRa uses the same powerful JSON-based programming interface, meaning that developers can easily add LoRa as a deployment option for their IoT solutions, with minimal impact to their existing host applications.

Functional Description

As an embeddable device-to-cloud data pump, the Notecard eliminates all complexity and friction that exists with existing IoT solutions. It enables development and rapid iteration of production-quality secure cellular, Wi-Fi, or LoRa IoT solutions at an extremely low, fixed cost. With as little as two lines of code on the controlling MCU, and with no external libraries or dependencies, data can be sent from device to cloud.

Notecard is:

  • A drop-in embeddable data storage and transport module for LoRa IoT products, pumping JSON-formatted or binary data ("Notes") bi-directionally between device and cloud:
    • JSON from/to MCU application using I2C, Serial, or USB.
    • JSON to/from your cloud app using HTTPS or MQTT.
    • JSON is auto-tagged with date/time.
  • A removable and field-upgradable 30mm x 35mm system-on-a-module (SOM).

Features

  • Low-power. Designed to operate on battery power, be "always-on", maintain time & location, while typically drawing less than ~8µA@5V when idle.
  • MCU-agnostic. Will support any MCU or single-board computer as your app processor - even low-memory, 8-bit microcontrollers.
  • Simple. Uses a JSON command interface over I2C, UART, or USB. Allows you to connect your 3.3V MCU.
  • Power-conscious. Mostly-offline data sync mode for low power.
  • Efficient. Battery-powered LoRa without the complexity of managing connections, queues, or storage.
  • Integrated. Utilizes an extremely thin cloud infrastructure that directly routes your data to where it belongs: AWS, Azure, GCP, or your own cloud.
  • Built for data. Data routing and simple "no code/low code" visual data stream analysis through Notehub.io (SaaS), or host and integrate Notehub functionality into your own app (OSS).
  • Embeddable. Castellated edges enable product builder to embed the Notecard for LoRa directly onto a PCB for volume production.

Package Configuration

NOTE-LORA

  • Product Name: Notecard for LoRa
  • Module: STM32WLE5
  • LoRa Frequency: Either 868 MHz (Europe) or 915 MHz (United States). Set by Blues during provisioning.

View in Store

Block Diagram

The Notecard for LoRa is packaged using a compact removable form factor, 30mm x 35mm.

Open hardware schematics for both the Notecard and Notecarrier boards are available on GitHub , making it a straightforward task to embed the Notecard into a broad variety of host device designs.

The Notecard can interface with the host MCU at 3.3v levels.

FrontBack
front image of lora notecardrear image of lora notecard

Typical Application

As shown below, Notecard is not an application processor and hosts no customer application code. It can be used as a data pump peripheral that is focused on bidirectional, asynchronous, secure data staging and transfer of JSON Notes.

Typical hardware configuration diagram

Key Features

  • Low Power Consumption

    The Notecard has sophisticated power control and makes heavy use of variable clock speeds. This enables the Notecard to have a typical idle current consumption of ~8µA@5V, while still supporting active UART and I2C communication.

Power Information

The Notecard's main supply voltage (VMODEM_P) is used for the LoRa radio and associated circuitry. The Notecard has on-board regulators designed for direct connection to a battery, so any voltage in the range of 2.5V to 5.5V may be provided.

The Notecard for LoRa typically sits in an ~8µA@5V idle mode waiting for a request from the host MCU, however the Notecard current draw increases when the LoRa radio is active (consult the STM32WLE5 datasheet for details). The module also draws 10's of mA when the CPU is performing session encryption. As such, it's recommended that VMODEM_P be directly connected to a battery or other supply that is capable of such brief spikes. It is also recommended that PCB traces for VMODEM_P and GND be designed to handle such current.

The Notecard's logic voltage (VIO_P) is provided by the Notecarrier or host system for digital communication; it will be 3.3V. Although the Notecard typically draws very little current, this supply should be designed with a 150mA budget allocated to the Notecard.

Pin NameDirectionPin NumbersUsage
GND--3,5,6,11,18,33,39,45,51,57,71,73Ground
VIO_PIN2,43.3V @ 150mA
VUSBIN13USB Serial proxy for "line power", with respect to dynamic line voltage detection
VMODEM_PIN70,72,742.5V to 5.5V, capable of sustained 250mA draw
warning

Reset and Loss of Power

The modems from all manufacturers used on all Notecard variants are designed to be robust in the condition of a sudden loss of power or reset. That said, there is a very small chance of corruption in the flash file system of the modem on loss of power at VMODEM_P.

In addition, while Notecard itself also utilizes a wear-leveling flash filesystem designed to be resilient to a sudden loss of power, there is a very small chance of filesystem corruption on loss of power to VIO_P.

Upon sudden loss of power at VIO_P or upon any reset with NRST and once power is restored, Notecard will initiate a procedure to ensure filesystem integrity. Notecard will also conduct a procedure upon first connection to Notehub after power loss to ensure consistency between Notecard's flash filesystem and Notehub's replica copy of those files.

All of the above, when taken together, mean that hardware designs utilizing Notecard should provide constant power to VMODEM_P and VIO_P and should make diligent efforts to ensure that power failures and resets do not occur frequently and as a matter of course in the design of the product. Failure to do so will result in an increase in cellular data used and additional wear on the flash filesystem over time.

Antenna Requirements

The Notecard for LoRa requires usage of an external antenna attached to its u.FL connector. The external antenna must support a frequency band appropriate for the region-specific LoRa frequency in use.

Cellular Service

This section does not apply to the Notecard for LoRa.

Pin Information

Pin Definitions

Pin NamePin Description
ATTN_PAttention pin (requires protection)
AUX_RXAuxiliary UART receive (requires protection)
AUX_TXAuxiliary UART transmit (requires protection)
AUX1Auxiliary GPIO pin 1
AUX2Auxiliary GPIO pin 2
AUX3Auxiliary GPIO pin 3
AUX4Auxiliary GPIO pin 4
AUX_CHARGINGCharge detection
CTXGPIO
RTXGPIO
GNDGround
NCNo connection (reserved and must be left open)
NRSTActive-low (not) reset*
RX_PUART receive (requires protection - Notecard has onboard 10K pull-up resistors)
SCL_PI2C clock (requires protection - Notecard has onboard 10K pull-up resistors)
SDA_PI2C data (requires protection - Notecard has onboard 10K pull-up resistors)
SIM_CLKExternal SIM clock
SIM_IOExternal SIM input/output
SIM_NPRESENTExternal SIM active-low (not) present
SIM_RSTExternal SIM reset
SIM_VCCExternal SIM positive (common collector) voltage
TX_PUART transmit (requires protection)
USB_DNUSB data negative
USB_DPUSB data positive
VACT_GPS_INActive antenna GPS bias voltage
VACT_GPS_OUTActive antenna GPS 3.8V from Notecard
VIO_PI/O Voltage (requires protection)*
VMODEM_PVoltage modem (requires protection)*
VUSBUSB Active indicator from 3V3 to 5V

* See the power information section for important product design considerations related to reset and loss of power conditions.

Pin Description

Notecard M.2 Key E, Edge Connector Pinout

Pin #Pin NameFunc. InterfaceFunc. InterfacePin NamePin #
1NCPowerVIO_P2
3GNDPowerPowerVIO_P4
5GNDPowerPowerGND6
7USB_DPUSB SerialSIM_VCC8
9USB_DNUSB SerialSIM_RST10
11GNDPowerSIM_IO12
13VUSBUSB SerialSIM_CLK14
15NCSIM_NPRESENT16
17NCPowerGND18
19NCVACT_GPS_OUT20
21NCVACT_GPS_OUT22
23NCMODULE KEY--24
25--MODULE KEYMODULE KEY--26
27--MODULE KEYMODULE KEY--28
29--MODULE KEYMODULE KEY--30
31--MODULE KEYNC32
33GNDPowerNC34
35NCNC36
37NCAUX_CHARGING38
39GNDPowerI2C SerialSCL_P40
41ALT_DFU_RXI2C SerialSDA_P42
43ALT_DFU_TXNC44
45GNDPowerAuxiliary PortsAUX146
47RTXAuxiliary PortsAUX248
49CTXAuxiliary PortsAUX350
51GNDPowerAuxiliary PortsAUX452
53NCAttentionATTN_P54
55NCAuxiliary PortsNC56
57GNDPowerNC58
59NCNC60
61NCUART SerialRX_P62
63JT_RSTUART SerialTX_P64
65BOOTNC66
67NRSTResetNC68
69NCPowerVMODEM_P70
71GNDPowerPowerVMODEM_P72
73GNDPowerPowerVMODEM_P74
75NC

Notecard for LoRa v2.1 Castellated Edge Pinout

Pin #Pin NameFunc. InterfaceFunc. InterfacePin NamePin #
1NCNC19
2AUX_TXAuxiliary PortsNC20
3AUX_RXAuxiliary PortsNC21
4NCNC22
5AUX1Auxiliary PortsNC23
6AUX2Auxiliary PortsI2C SerialSCL24
7AUX3Auxiliary PortsI2C SerialSDA25
8AUX4Auxiliary PortsNC26
9RXUART SerialAttentionATTN27
10TXUART SerialNC28
11SWDIONC29
12SWCLKUSB SerialVUSB30
13LED_BUSYUSB SerialUSB_DP31
14NRSTResetUSB SerialUSB_DN32
15VINPowerPowerVIO33
16VINPowerPowerVIO34
17GNDPowerPowerGND35
18GNDPowerPowerGND36

Link: Digi-Key part number of the connector - Both Digi-Key and Mouser have pictures for this part number that show a component with a different key, but both have links to datasheet/drawing/CAD models.

note

All pins whose Functional Interface is marked "Power" must be connected.

All pins named NC MUST have no connection and be left open because they are reserved for future use. Furthermore, any pin not used in a design MUST also be left open.

Those pins ending with _P may be optionally protected from anomalous external conditions on some Notecarrier designs, depending upon use-case specific requirements.

Technical Details

Host Microcontroller API

Notecard supports a rich, simple API whose syntax is standard JSON. The developer can communicate requests to Notecard, generally by using little more than printf functions available in most programming languages.

Serial Communication

JSON requests and responses (the Notecard's Application Programming Interface "API") may be sent over any of the following interfaces:

  • USB Serial Interface
  • UART Serial Interface
  • I2C Interface
API Reference

For API usage, names, and parameters, please refer to the Notecard API Reference.

USB Serial Interface

The USB Serial Interface appears to the host as a USB 2.0 Full Speed CDC device. You can access it from Linux, Windows, or macOS without a device driver using terminal emulation software. Newline-delimited JSON requests may be sent directly as UTF-8 text over this port, or you may use the open-source Blues libraries for C, Python, Go, and Arduino.

Pin NameDirectionPin NumberUsage
USB_DMI/O9USB D- data signal
USB_DPI/O7USB D+ data signal
VUSBIN13+5V from USB
GNDI/O11Ground from USB
UART Serial Interface

The UART Serial Interface operates at VIO_P at a fixed baud rate of 9600 using eight data bits, no parity bit, and one stop bit. Newline-delimited JSON requests may be sent directly as UTF-8 text over this port, or you may use the open-source Blues libraries for C, Python, Go, and Arduino.

Pin NameDirectionPin NumberUsage
RX_PIN62Receive data signal
TX_POUT64Transmit data signal
I2C Interface

The Notecard acts as an I2C secondary device operating at VIO_P, and it implements a simple Serial-over-I2C protocol. You can access it from an embedded host using open-source Blues libraries for C, Python, Go, and Arduino.

Pin NameDirectionPin NumberUsage
SCL_PIN40I2C clock
SDA_PI/O42I2C data

Host Microcontroller Hardware Interface

Attention Interrupt

Using software, you can optionally configure Notecard to use the ATTN output pin to:

  • Inform the host MCU of certain asynchronous events (such as incoming data availability) in an interrupt-driven manner rather than just polling.
  • Place the host MCU into a power-off sleep state and wake it back up again.
Pin NameDirectionPin NumberUsage
ATTN_POUT54Attention pin
note

This pin operates at VIO_P. If it is unused it can be left disconnected.

Auxiliary Ports

The AUX1-4 pins operate at VIO_P and can be configured in software to operate in several optional modes such as GPS Tracking Mode, GPIO Mode, and Internet Button Mode. If these pins are unused, they can be left disconnected.

Pin NameDirectionPin NumberUsage
AUX1I/O46General Purpose IO
AUX2I/O48General Purpose IO
AUX3I/O50General Purpose IO
AUX4I/O52General Purpose IO
AUX_CHARGINGI/O38Alt. attention pin or charge detection

Reset

Use of this pin is optional. If the host system has a global reset line, caution should be used when connecting this pin to the host system's reset because the Notecard may independently pull the line low in software. Restrictions on this pin are:

  • If this pin is not used, it must remain not connected (NC).
  • The pin is active-low. It must be held low for at least 350nS for a clean reset.
  • This pin must never be pulled-up. A pull-up would interfere with the Notecard's own internal watchdog timer and thus will prevent reliable operations.
  • Some Notecarriers may invert this signal to be active-high.
Pin NameDirectionPin NumberUsage
NRSTI/O67Active-low reset

Network Communication Behavior

The Notecard includes a built-in connection to Notehub.io and communicates though any available (and in-range) LoRaWAN gateway and LoRaWAN Network Server (LNS) with a secure connection to Notehub.io. Outbound connections communicate with Notehub via the LNS for provisioning and device authentication. By default, the connection is unidirectional, but can operate bi-directionally, if needed.

Specifications

General Characteristics

DescriptionValue
Weight3 grams

Electrical Characteristics

Absolute Maximum Ratings

DescriptionMinimumMaximumUnit
Storage temperature-4090°C
Ambient operating temperature-4085°C

DC Characteristics

Ordering Information

Blues Shop

Certifications

Certifications are currently pending.

Board Errata

  • On units shipped where all large black capacitors indicate JJ8, the idle current of the notecard may measure slightly higher than the expected current draw indicated above.

Terms and Conditions

Visit Blues Hardware Terms & Conditions

Security and Vulnerability Scanning

As a part of our regular audit and scanning process, Blues Inc. performs full vulnerability scanning every six months. Any identified vulnerabilities will be analyzed, reported, and patched in a timely fashion, where appropriate.

Revision History

AuthorDateSummary
Ray Ozzie2019-2020Document drafted
John Wiedey2020Various improvements
Sean Taylor2020Various improvements
Zachary J. Fields11 SEP 2020Updated information and translated to markdown
Brandon Satrom13 APR 2021Updated Country list based on carrier audit
Carlton Henderson12 JUL 2021Update coverage information
Carlton Henderson12 JUL 2021Fix block diagram photo
Brandon Satrom11 NOV 2021Added Certification Dates
Brandon Satrom07 JAN 2022Added RoHS Certification Dates
Brandon Satrom15 FEB 2022Add Wi-Fi Notecard Datasheet
Rob Lauer25 AUG 2022Added updated certification data
Rob Lauer27 OCT 2022Update country coverage information
Rob Lauer13 JAN 2023Added RF performance information
Rob Lauer2 FEB 2023Warning re: STM32 light sensitivity
Kimball Johnson21 SEP 2023Updated for new Cell+WiFi, LoRa, and Wi-Fi Notecards
Rob Lauer23 OCT 2023Update and clarify power consumption values
Rob Lauer31 JAN 2023Update Notecard for LoRa datasheet details
Rob Lauer16 APR 2024Updated for new Cellular (black PCB) Notecards, MB Cellular Notecards, and Notecard XP
Rob Lauer6 JUN 2024Added cell band support for Cellular Notecards
Rob Lauer23 JUL 2024Update pin definitions
TJ VanToll24 SEP 2024Adding Notecard for LoRa v2.1 information
Rob Lauer01 NOV 2024Adding Notecard for LoRa v2.1 castellated pin info
Rob Lauer06 NOV 2024Added errata for Notecard Cell+WiFi
Brandon Satrom06 DEC 2024Expanded reset and loss of power guidance
Rob Lauer20 DEC 2024Added PTCRB certifications for WBNAN, NBNAN, NBGLN
Rob Lauer5 MAR 2025Update AUX5 to AUX_CHARGING

Contact Information

Blues Inc.
https://blues.com
50 Dunham Ridge Suite 1650
Beverly, MA 01915
support@blues.com

Can we improve this page? Send us feedback
© 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