B-Series from E-Series Migration Guide

The B-Series SoM (system-on-a-module) is a 3rd-generation cellular device. It plugs into an M.2 NGFF connector on your custom circuit board and is intended for mass production use.

Like the E-Series module, it requires your own custom base board. One difference is that the B-Series SoM does not contain the PMIC and fuel gauge chips that the E-Series does.

Additionally, different dimensions makes it possible to include a LTE Cat 1 with 2G/3G fallback cellular modem, such as the Quectel EG91-E on the B524.

All E-Series models (except for the E404X) have been deprecated. It is recommended that you migrate to the B-Series SoM, and it is required to get LTE Cat 1 with 2G/3G fallback support in Europe, Australia, and New Zealand. While the E404X has the same footprint as the other E-Series modules, it contains the same MCU as the B-Series SoM.

¹The PMIC (power management IC) and fuel gauge are used with battery-powered applications. They're omitted from the SoM as they are not needed for externally powered solutions (grid or automotive power, for example). Additionally, you may want to use different models if you are making a solar-powered device, or using a different battery technology or multiple battery pack.

²The built-in Particle SIM card is free for use up to certain limits, no credit card required.

The available models include:

• The B404X, B404, and B402 cannot be used in Central or South America.
• The B524 can be used in selected countries in Europe, Middle East, Africa, and Asia (EMEAA), including Australia and New Zealand.
• The B524 and B523 do not work out of the EMEAA region.
• See the Carrier List for compatibility in specific countries

Datasheets

• B404X datasheet
• B524/B523 datasheet
• B-Series evaluation board

Prototyping

The B-Series SoM cannot be used without a base board. Typically you will create your own board, however there are two off-the-shelf options available:

B-Series Eval board

The B-Series evaluation board provides a variety of interfaces and access to all ports and pins on the B-Series SoM. You can use the expansion connector to connect the evaluation board to a breadboard for prototyping. You can also add sensors and accessories using the Grove expansion connectors.

Mikroe Gen 3 SoM shield

The Gen 3 SoM shield connects a B-Series SoM to mikroBUS Click boards:

There is a huge library of mikroBUS Click expansion boards, however the caveat is that most of them do not already have a Particle software library. If the board is for a common sensor or chip, however, existing Particle libraries for the chip will typically work, even if not designed work with the Click.

For more information, see the Mikroe community page.

Creating a board

First SoM board tutorial

The SoM first board tutorial shows how to get started with the M.2 SoM boards by making the simplest possible design. It's an introduction to working with surface mount components you will need in order to make your own SoM base board.

Basic SoM design

This design is a bit more complicated, and includes the PMIC and Fuel Gauge chips that are present on the E-Series:

• RGB LED
• bq24195 PMIC
• MAX17043 Fuel Gauge
• USB Connector
• LiPo Connector (JST-PH)
• M.2 SoM Connector

This is the basic set of features you'll probably want to include in a LiPo battery-powered design. The Evaluation Board is also a good reference to use. This design, however, is simple enough that it can be hand-assembled, though you still need a reflow oven and some of the parts (in particular the fuel gauge and PMIC) are tiny and there are a lot of them.

This board a two-layer circuit board so it can be manufactured inexpensively and edited using the free version of Eagle CAD.

As this board doesn't really do much, you'll unlikely use it as-is, but you can use it as a tutorial for how to hook up the PMIC and fuel gauge.

Software differences

User firmware binary size

One major advantage of Gen 3 devices is that user firmware binaries in Device OS 3.1.0 and later can be up to 256 Kbytes, instead of 128 Kbytes in earlier version of Device OS and on Gen 2 devices. The larger firmware binary support will not be added to Gen 2 in the future, and will only be available on Gen 3 devices.

Flash file system

There is a flash file system (2 MB except on the Tracker which is 4 MB) for storing user data, on Gen 3 devices only.

Combined and resumable OTA

On Gen 3 devices, over-the-air (OTA) updates have two features that can improve the speed and reliability of OTA updates:

• Combined OTA can combine Device OS and user firmware updates into a single binary that requires only one download and one reboot to install.
• Resumable OTA allows an update to resume from the point it stopped, instead of starting over from the beginning if interrupted.

Asset OTA

Asset OTA (available in Device OS 5.5.0 and later), makes it possible to include bundled assets in an OTA software update that can be delivered to other processors and components in your product.

Increased API field limits

The maximum size of a variable, function parameter, or publish is 1024 bytes on the B-Series SoM vs. 864 bytes on the E-Series.

Hardware differences

MCU

• Not all RAM is available to user applications. The Device OS firmware uses a portion of it.

BLE (Bluetooth LE)

• Bluetooth LE (BLE 5.0) is supported on B-Series SoM but not the E-Series.

NFC tag

• NFC tag mode is supported on the B-Series SoM but not the E-Series.

GPIO

There are fewer available GPIO pins on the B-Series SoM than the E-Series. If you need a large number of GPIO pins, an external GPIO expander connected by I2C or SPI is a good option.

The MCP23008 is an 8-port GPIO expander that connects to I2C and works well with Gen 3 devices. You can connect up to 8 of them to a single I2C interface. the MCP23017 has 16-ports, and you can also connect 8 of them, for a total of 128 GPIO ports.

The application note AN013 Tracker GPIO shows how you can add additional GPIO to your Tracker One using the external M8 connector, however the same technique can also be used with the B-Series SoM. It includes both 3.3V and 5V design options.

5V tolerance

The other difference in the GPIO between Gen 2 and Gen 3 is with 5V tolerance. While both devices are 3.3V devices and only will drive 3.3V, the I/O pins on Gen 2 devices (with the exception of A3 and A6) are 5V tolerant. This allows a Gen 2 device to connect to some 5V peripherals directly.

You must not connect 5V peripherals to a Gen 3 device. This includes GPIO, ports (serial, I2C, SPI), and ADC.

Interfacing with 5V peripherals can be done with a level shifter, a MOSFET, or a 5V GPIO expander.

Beware of leakage current

If you have circuitry that can disconnect the nRF52840 MCU 3V3 power, beware of situations where current can leak into GPIO pins from an external supply.

For example, if you have 3V3 disconnect circuitry but have pull-ups to non-disconnected power, when MCU 3V3 is powered down current can flow into the GPIO causing the MCU to not fully power down. This can prevent the MCU from resetting when power is reapplied. It will also cause excess power consumption when powered down.

SPI

• The B-Series SoM and E-Series both have two SPI ports.
• In most cases, you can share a single SPI bus with many peripherals.
• On the E-Series, SPI1 and SPI2 share the same MCU SPI interface but have different pin locations. You can only use one or the other.

Serial (UART)

There are more UART ports on the Gen 2 devices than Gen 3. If you need more hardware serial ports, the best option is to use the SC16IS740 or its relatives like the SC16IS750. These devices connect by I2C or SPI, and you can add multiple ports this way.

Serial baud rates

Serial configurations

• Using an I2C or SPI UART like the SC16IS750 is also a good way to add support for other bit length, parity, and stop bit options on Gen 3 devices.

Analog input (ADC)

The B-Series SoM does not have an many ADC ports as the E-Series. You can add additional ADC ports using a SPI or I2C ADC.

PWM (Pulse-width modulation)

These are differences in pins that support PWM between the E-Series and B-Series SoM.

PWM - Gen 3

On Gen 3 devices, the PWM frequency is from 5 Hz to analogWriteMaxFrequency(pin) (default is 500 Hz).

On the B-Series SoM, pins D4, D5, D7, A0, A1, A6, and A7 can be used for PWM. Pins are assigned a PWM group. Each group must share the same frequency and resolution, but individual pins in the group can have a different duty cycle.

• Group 2: Pins A0, A1, A6, and A7.
• Group 1: Pins D4, D5, and D6.
• Group 0: Pin D7 and the RGB LED. This must use the default resolution of 8 bits (0-255) and frequency of 500 Hz.

It is also possible to add an external PWM driver such as the PCA9685 which adds 16 outputs via I2C. You can add 62 of these to a single I2C bus for 992 PWM outputs! The Adafruit_PWMServoDriver library supports this chip on all Particle devices.

PWM - Gen 2

On the Electron and E-Series, this function works on pins D0, D1, D2, D3, A4, A5, WKP, RX, TX, B0, B1, B2, B3, C4, and C5 with a caveat: PWM timer peripheral is duplicated on two pins (A5/D2) and (A4/D3) for 7 total independent PWM outputs. For example: PWM may be used on A5 while D2 is used as a GPIO, or D2 as a PWM while A5 is used as an analog input. However A5 and D2 cannot be used as independently controlled PWM outputs at the same time.

Internal pull-up or pull-down

Internal (MCU) pull-up and pull-down can be enabled using the pinMode() function and INPUT_PULLUP or INPUT_PULLDOWN.

On both the B-Series SoM (Gen 3), the internal pull is approximately 16K. On the E-Series it is approximately 40K.

Retained memory

Retained memory, also referred to as Backup RAM or SRAM, that is preserved across device reset.

On both the Boron and B-Series SoM, retained memory is 3068 bytes, same as the E-Series.

The flash file system on Gen 3 devices can also be used for data storage, however care must be taken to avoid excessive wear of the flash for frequently changing data.

Interrupts

Interrupts - Gen 2

Not supported on the Electron/E series (you can't use attachInterrupt on these pins):

• D0, A5 (shared with MODE button)
• D7 (shared with BATT_INT_PC13)
• C1 (shared with RXD_UC)
• C2 (shared with RI_UC)

No restrictions on the Electron/E-Series (all of these can be used at the same time):

• D5, D6

Shared on the Electron/E-Series (only one pin for each bullet item can be used at the same time):

• D1, A4, B1
• D2, A0, A3
• D3, DAC
• D4, A1
• A2, C0
• A7 (WKP), B2, B4
• B0, C5
• B3, B5
• C3, TX
• C4, RX

Interrupts - Gen 3

There is a limit of 8 pins with interrupt handlers, however the selection of pins is not restricted.

DAC

• Gen 2 devices have two DAC (digital-to-analog converter), on pins A3 and A6.

• Gen 3 devices do not have built-in DAC, however they can easily be added by I2C or SPI to your base board.

CAN bus

• Gen 3 devices do not support CAN on the MCU.
• The Tracker SoM includes CAN via a MCP25625 CAN interface with integrated transceiver.
• Both the MCP2515 and MCP25625 work with the library used on the Tracker and can be used to add CAN to other Gen 3 devices.

I2S (Sound)

• The E-Series theoretically had I2S sound available on pins D1 and D2, however there has never been support for it in Device OS.
• I2S is available on Gen 3 devices including the B-Series SoM on any GPIO pins using a 3rd-party library.

Sleep modes

• In general, Gen 3 devices use less power in all modes.
• In HIBERNATE mode, the RTC (real time clock) does not run on Gen 3 devices, so you cannot wake by time from HIBERNATE mode (formerly known as SLEEP_MODE_DEEP).
• However, you can wake by time from ULTRA_LOW_POWER mode, and it uses less power than the Gen 2 HIBERNATE mode.
• On Gen 2 devices, you can only wake from HIBERNATE with a rising signal on WKP (A7). Gen 3 devices can wake from HIBERNATE on any pin, rising or falling.
• On Gen 2 (STM32F205) devices, if you try to go into HIBERNATE mode with WKP already high, the device will go into sleep and will not wake up by time or pin change, essentially rendering it unable to wake until reset manually. This problem does not occur on Gen 3 devices.

RTC (Real-time clock)

• The E-Series module has the ability to use an external lithium coin cell or supercap to power the RTC when the MCU is unpowered. This feature is difficult to access on the Electron (requires removing a resistor on the module) and does not exist on Gen 3 devices.
• The RTC on Gen 3 devices is not really a real-time clock. It's basically just a counter, and some advanced wakeup features are not possible on Gen 3 devices. These features were not enabled by Device OS on Gen 2 devices, either, so this is generally not an issue.
• On Gen 3 devices, in HIBERNATE sleep mode the RTC does not run, so it is not possible to wake by time, and the system clock will not be set until you connect to the cloud again. ULTRA_LOW_POWER is recommended instead.
• The Tracker SoM has a separate real-time clock and watchdog (AM1805) chip allowing it to wake from HIBERNATE based on time.

SWD/JTAG

• Gen 2 devices support SWD on D6 and D7, and full JTAG on D3, D4, D5, D6, and D7.
• Gen 3 devices only support SWD, and do so via a dedicated debug connector.
• The Boron has the debug connector on top of the module.
• The B-Series SoM has SWD on pads on the bottom of the SoM. The evaluation board connects to these with pogo pins and breaks out to the same 2x5 connector that is on the Boron.

JTAG pin warning - Gen 2

On Gen 2 devices, beware when using pins D3, D5, D6, and D7 as OUTPUT controlling external devices. After reset, these pins will be briefly taken over for JTAG/SWD, before being restored to the default high-impedance INPUT state during boot.

• D3, D5, and D7 are pulled high with a pull-up
• D6 is pulled low with a pull-down
• D4 is left floating

The brief change in state (especially when connected to a MOSFET that can be triggered by the pull-up or pull-down) may cause issues when using these pins in certain circuits. Using STARTUP will not prevent this!

This is not an issue with Gen 3 devices that have dedicated SWD pins.

If you are relying on this behavior for external circuits, you should instead use a hardware pull-up or pull-down on Gen 3 devices. The pins default to high-impedance state, and this means they will stay in this state when in the bootloader, DFU mode, and safe mode.

PMIC and Fuel gauge

The E-Series, E-Series, Boron, and Tracker SoM all include the PMIC (bq24195) and battery fuel gauge (MAX17043) on the module itself.

On the B-Series SoM, the PMIC and fuel gauge are optional. For example, if you are powering by an external power supply and not using a battery, you can omit the components entirely.

USB

• Both the E-Series and B-Series SoM assume the USB connector will be mounted on your base board. It is recommended that you add one to your base board for programming and troubleshooting.
• Gen 2 devices can emulate a USB mouse or keyboard over the USB port. This feature is not available on Gen 3.
• Gen 2 devices can support two separate USB serial emulation streams over the USB port. Gen 3 devices only support the normal Serial interface.

NFC tag

The B-Series SoM has NFC Tag support, however you must add a U.FL antenna connector to your base board to use it.

Note that this only supports emulating an NFC tag that can be read by an another reader or smartphone. It does not allow the B-Series SoM to detect other tags!

PMIC Notes

When using the B-Series SoM with a bq24195 PMIC, note the following:

By default, the bq24195 sets the input current limit, which affects powering by VIN and VUSB, to 100 mA. This affects the VSYS output of the PMIC, which powers both the cellular modem and 3V3 supply, and is not enough to power the B-Series SoM in normal operation.

If your device has the default firmware (Tinker), it will attempt to connect to the cloud, brown out due to insufficient current, then the device will reset. This may result in what appears to be the status LED blinking white, but is actually rolling reboot caused by brownout.

A factory new B-Series SoM does not enable the PMIC setup. To enable the use of the bq21415, you must enable the system power feature PMIC_DETECTION in your code. This defaults to off because the B-Series SoM can be used without a PMIC, or with a different PMIC, and also requires I2C on D0/D1, and some base boards may use those pins as GPIO.

Because the input current limit does not affect the battery input (Li+), for troubleshooting purposes it can be helpful to attach a battery to help rule out input current limit issues. It's also possible to supply 3.7V via a bench power supply to the battery input, instead of VIN.

The input current limit can result in a situation where you can't bring up a B-Series SoM because it browns out continuously, but also cannot flash code to it to stop if from browning out. There are two general solutions:

• Attach a battery or supply by Li+ when bringing up a board.
• Use SWD/JTAG and reset halt the MCU. This will prevent it from connecting to the cloud, so you can flash Device OS and firmware to it by SWD.

The input current limit is actually controlled by three factors:

• The power source max current setting in the PMIC. The default is 900 mA. It can be set to 100, 150, 500, 900, 1200, 1500, 2000, or 3000 mA.
• It is also limited by the hardware ILIM resistor. On Particle devices with a built-in PMIC, this is set to 1590 mA, but if you are implementing your own PMIC hardware, you can adjust this higher.
• When connected by USB, it will use DPDM, current negotiation via the USB DP (D+) and DM (D-) lines.

Note that some 2A tablet chargers and multi-port USB power supplies supply 2A but do not implement DPDM; these will be treated as if VIN was used, and you must set the power source current, otherwise the input current will be limited to 900 mA, which is not enough to power a 2G/3G cellular modem without an attached battery.

Antennas

The B-Series SoM has U.FL antenna connectors for BLE and cellular antennas. A connector for NFC can be added from your base board.

The E-Series has a U.FL connector for the cellular antenna, and does not have BLE or NFC tag capabilities.

Both require an external cellular antenna.

²This device originally shipped with one antenna (ANTELEC or ANT-FLXU) however the ANTCW2EA is listed as an alternative. The ANTCW2EA (or ANTCW2TY) is recommended as most new designs will use this antenna and using this antenna will reduce the number of SKUs you need to stock when building a product at tray quantities.

PARANTC41EA/PARANTC41TY are slightly longer than ANTCW2EA/ANTCW2TY. The antenna can be bent when being placed inside an enclosure. There are a couple restrictions to ensure good performance:

• Do not bend more the 90 degrees. Right angle turns are acceptable, but do not fold the antenna over on itself.
• The antenna should not be creased when it is bent into position. A crease can damage the internal structure of the antenna.
• The antenna should always be affixed along its entire length. Do not affix a portion of the antenna and leave a portion free floating.
• All portions of the antenna should maintain proper spacing from electronics, grounded metal, or active metal.
  • Recommended: 12mm
  • Minimum: 8mm
• Ideally when placing the antenna it should not have a bend in it, but following the above guidelines, there should be minimal performance degradation.

Full module pin comparison

3V3

A0

A1

A2

A3

A4

A5

AGND

B0

B1

B2

B3

B4

B5

C0

C1

C2

C3

C4

C5

CELL USBD-

CELL USBD+

CELL VBUS

D0

D1

D2

D22

D23

D3

D4

D5

D6

D7

D8

DAC

GND

LIPO

MISO

MODE

MOSI

NC

NC

NFC1

NFC2

PMID

RESET

RGBB

RGBG

RGBR

RX

SCK

SIM_CLK

SIM_DATA

SIM_RST

SIM_VCC

STAT

TX

USBDATA-

USBDATA+

VBAT

VBUS

VCC

VDDA

VIN

VUSB

WKP

Country compatibility

Software

Platform ID

If you have a product based on the Electron/E-Series, you will need to create a separate product (or two) for devices using the B-Series SoM. While you may be able to use the same source code to build your application, the firmware binaries uploaded to the console will be different, so they need to be separate products. This generally does not affect billing as only the number of devices, not the number of products, is counted toward your plan limits.

The reason there are separate platforms for the B4xx and B5xx SoM is that they have different cellular modem manufacturers, u-blox and Quectel, respectively. All Boron models have u-blox cellular modems and thus can share a single platform.

Third-party libraries

Most common third-party libraries work on both devices. The exceptions are libraries that depend on specific hardware in the STM32F205 processor. For example:

• SparkIntervalTimer depends on the STM32 hardware timers
• Libraries that use ADC DMA features of the STM32 directly
• Code that uses timing loops that depend on the MCU clock frequency

SKUs

• EMEAA: Selected countries in Europe, Middle East, Africa, and Asia, including Australia and New Zealand. See the cellular carrier list for more information.

Version history