Skip to the content
2 layers30.1 × 50.8 mmCc2538-mpcie card, the printed circuit board in 3D

CC2538 Zigbee mPCIe card

Size
30.1 × 50.8 mm
Copper layers
2
Thickness
1.6 mm
Parts
27
Nets
26
Pads
174
Tracks, vias
243, 79
Pours
4
Routed
Yes
KiCad
KiCad 5 (file 20171130)
Created
24 Aug 2021
Updated
24 Aug 2021

Overview

Cc2538-mpcie card is an open-source printed circuit board by geekman, from the geekman/zigbee-mpcie-card repository on GitHub. It is a 2-layer board of 30.1 × 50.8 mm with 27 parts on 26 nets, routed with 243 tracks and 79 vias.

It is built around the CP2102N-A01-GQFN24 and MUN5214DW1. Its parts include 8 capacitors, 4 resistors, 2 ICs, 2 transistors and 2 connectors. It belongs with the radio and wireless boards of this library.

Main components

2

README

README.md

photo of the assembled CC2538 Zigbee mPCIe card

CC2538 Zigbee mPCIe Adapter

For use with zigbee2mqtt.

This card is basically a USB-to-serial adapter for the CC2538 + CC2592 PA Zigbee module. It is intended for use in host devices that accept mPCIe cards, instead of having a Zigbee dongle sticking out of the USB port. The antenna connection is also brought out to an external SMA connector via a U.FL pigtail.

As with most of my boards, this was designed to be flexible. The TX and RX pins from the module are clearly marked, so that the card can be repurposed as a generic serial device mPCIe card. There are also various test points for I²C, as well as control for the WLAN/WWAN LEDs that are on the host machine.

This project is authored in KiCad EDA. You can find schematics and the BOM under the Releases section.

Assembly Instructions

Please be aware that there are a few variations of this CC2538 module with different pinouts and dimensions. The one I bought, and used in this mPCIe card, is available on AliExpress here. Also note that the presence of an on-board antenna; the module needs to be physically configured to use the U.FL connector instead of the on-board antenna. You will need to indicate this to the seller, or you can modify it yourself by moving a capacitor (or resistor, not sure what that part is).

The card has support for native USB connectivity to the CC2538, but it is not used. As such, the component on the back side should not be populated, as well as R2 on the front side. The BOM file has these parts marked as DNP.

Additionally, Q2 was added for an ESP8266-style auto reset, but since the cc2538-bsl does not support this style of bootloader invocation, the pins of Q2 need to be manually bridged. The new revision of PCB has these connections marked out on the silkscreen.

Testing

When inserted, the card should be detected as a CP2102N USB device on the host.

You need the cc2538-bsl Python tool, which only depends on pyserial. Note that the tool will try to reconnect to the port with an increased baud rate for faster transfer speeds, but this was causing problems for me. Use -b to set a fixed baud rate, and choose a lower value for stability.

You can test that the mPCIe card is properly detected by reading from the CC2538 with -r:

text
$ python3 cc2538-bsl.py -b 500000 -r test.bin
Opening port /dev/ttyUSB0, baud 500000
Connecting to target...
CC2538 PG2.0: 512KB Flash, 32KB SRAM, CCFG at 0x0027FFD4
Primary IEEE Address: 00:12:4B:00:19:4A:F1:CE
Reading 524288 bytes starting at address 0x200000
 0x200xxx: 0xffffffff

If you do specify the -V verbose flag, you see that chip ID for the CC2538 has been correctly detected:

text
$ python3 cc2538-bsl.py -V -r test.bin
Opening port /dev/ttyUSB0, baud 500000
Connecting to target...
*** sending synch sequence
Got 0 additional bytes before ACK/NACK
*** GetChipId command (0x28)
Got 0 additional bytes before ACK/NACK
*** received 6 bytes
*** GetStatus command (0x23)
Got 0 additional bytes before ACK/NACK
*** received 3 bytes
Command Successful
    Version 0x0000B964
    Target id 0xb964, CC2538
  .
  .
  .

Firmware Flashing

You can download a zigbee2mqtt-compatible firmware here:

Here are some other firmware for reference:

You can choose either one; I went with the JetHome one.

Use the cc2538-bsl.py tool with -w -v to write and verify the firmware file. Both the .bin and .hex contain the same firmware, just in a different format.

text
$ python3 cc2538-bsl.py -b 115200 -w -v JH_2538_2592_ZNP_UART_20201010.bin
Opening port /dev/ttyUSB0, baud 115200
Reading data from JH_2538_2592_ZNP_UART_20201010.bin
Cannot auto-detect firmware filetype: Assuming .bin
Connecting to target...
CC2538 PG2.0: 512KB Flash, 32KB SRAM, CCFG at 0x0027FFD4
Primary IEEE Address: 00:12:4B:00:19:4A:F1:CE
Writing 524256 bytes starting at address 0x00200000
Write 232 bytes at 0x0027FEF88
    Write done
Verifying by comparing CRC32 calculations.
    Verified (match: 0x6273805e)

You should now see the power LED on the mPCIe card light up.

Bootloader "Backdoor"

Note that while the serial bootloader is a convenient way to program the CC2538, it may also be disabled by the firmware developer for security reasons.

The firmware images provided above all have this "bootloader backdoor" enabled, so that newer firmware can be flashed via the serial port. This is done by setting some bits in the Customer Configuration Area (CCA) to enable the backdoor, and allowing for activation via pin PA7. For more information, see the SWRA466 document here: https://www.ti.com/lit/pdf/swra466

You can verify this by opening the firmware HEX file and seeing the value 0xF7 set at 0x0027.FFD7. (Actually the write begins at 0x27FFD4 to write a 32-bit value FF FF FF F7)

If you do not flash these bytes into the CCA, the serial bootloader can no longer be accessed and you will need JTAG to program the device. The connector has been brought out to the back side of the card, in case this is needed.

License

cc2538-mpcie-card is licensed under the TAPR Open Hardware License (https://www.tapr.org/OHL).

Copyright (C) 2021 Darell Tan

The TAPR Open Hardware License ("OHL") agreement provides a legal framework for Open Hardware projects. The OHL addresses unique issues involved in the creation of tangible, physical things, but does not cover software, firmware, or code loaded into programmable devices.

Parts

27
QtyValueFootprintReferences
34K7Resistor_SMD:R_0603_1608MetricR1, R3, R5
20.1uFCapacitor_SMD:C_0603_1608MetricC3, C7
247pFCapacitor_SMD:C_0402_1005MetricC4, C5
247uFCapacitor_SMD:C_0805_2012MetricC1, C2
2MUN5214DW1Package_TO_SOT_SMD:SOT-363_SC-70-6Q1, Q2
2MountingHole_PadMountingHole:MountingHole_2.7mm_M2.5_ISO7380_PadH1, H2
110uFCapacitor_SMD:C_0603_1608MetricC8
11K5Resistor_SMD:R_0402_1005MetricR2
11nFCapacitor_SMD:C_0603_1608MetricC6
133RResistor_SMD:R_Array_Convex_2x0402RN3
1Bus_PCI_Express_Minicc2538-mpcie:mPCIe_Card_EdgeJ1
1CC2538_SZ12cc2538-mpcie:CC2538_SZ12_ModuleU1
1CP2102N-A01-GQFN24Package_DFN_QFN:QFN-24-1EP_4x4mm_P0.5mm_EP2.6x2.6mmU2
1Conn_ARM_JTAG_SWD_10Connector_PinHeader_1.27mm:PinHeader_2x05_P1.27mm_Vertical_SMDJ2
1LED_SmallLED_SMD:LED_0603_1608MetricD1
1LED_WLANTestPoint:TestPoint_Pad_D1.5mmTP3
1LED_WWANTestPoint:TestPoint_Pad_D1.5mmTP4
1SCLTestPoint:TestPoint_Pad_D1.5mmTP2
1SDATestPoint:TestPoint_Pad_D1.5mmTP1
1SolderJumper_2_OpenJumper:SolderJumper-2_P1.3mm_Open_RoundedPad1.0x1.5mmJP1

Similar boards

  • 2 layers34.6 × 30.4 mmNovaBridge V1, the printed circuit board in 3D

    NovaBridge V1

    MAHESH-THILAK-K/ADDITIONAL-PROJECT

    14 parts1Apache-2.0
  • 6 layers230 × 56 mmOvc, the printed circuit board in 3D

    Ovc

    osrf/ovc

    the Open Vision Computer

    379 parts207Apache-2.0
  • 4 layers100 × 100 mmESP32-Eurorack Audio, the printed circuit board in 3D

    ESP32-Eurorack Audio

    ctag-fh-kiel/esp32-eurorack-audio

    Open source eurorack audio module based on ESP32

    173 parts71
  • 4 layers160 × 73.2 mmMainPCB, the printed circuit board in 3D

    MainPCB

    doppelgrau/esp32-f9p-io-board

    An IO-PCB (two motor-driver/H-bridge, CAN, RS232, ADS1115, relay, ethernet, ardusimple f9p compatible connector) with an ESP32 for 12V power, three 15V tolerant analog inputs, three 5V tolerant inputs.

    162 parts39
  • 4 layers69.8 × 69.8 mmFreeEEG32, the printed circuit board in 3D

    FreeEEG32

    neuroidss/FreeEEG32-alpha1.0

    ALPHA1.0 TEST FAILED, USE NEW VERSION INSTEAD FreeEEG32 alpha1.0 32 channels mobile electroencephalography under GNU AGPL 24 bits, 4kSPS ADCs 4x AD7770 MCU STM32F427ZI WIFI ESP-12F (ESP8266) USB CP2102N Accel & hyro…

    217 parts39AGPL-3.0
  • 2 layers136 × 58 mmImxrt1020-board, the printed circuit board in 3D

    Imxrt1020-board

    martinribelotta/imxrt1020-module

    iMX RT 1020 CPU module

    141 parts37BSD-3-Clause
  • 2 layers35 × 18 mmTiny Hi3861, the printed circuit board in 3D

    Tiny Hi3861

    imliubo/Tiny-Hi3861

    Tiny-Hi3861是目前最小的一款支持鸿蒙OS的开发板(虽然目前芯片版本与主线支持的版本不一致)。

    40 parts21MIT
  • 2 layers100 × 99.2 mmUsb serial interface panelized, the printed circuit board in 3D

    Usb serial interface panelized

    willemcvu/midi-solenoid-driver

    A set of PCBs to drive solenoids using MIDI data, for use in automating musical instruments.

    114 parts21MIT

Questions

How big is the Cc2538-mpcie card PCB?

It measures 30.1 × 50.8 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Cc2538-mpcie card use?

27 parts, built around the CP2102N-A01-GQFN24 and MUN5214DW1. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Cc2538-mpcie card KiCad files?

From the geekman/zigbee-mpcie-card repository on GitHub, at the commit this page was made from: the board is cc2538-mpcie-card.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Cc2538-mpcie card design in my own project?

Its repository states no licence, so its author keeps all rights: ask geekman before reusing the design.