Skip to content

Arduino Library to gets the Manufacture Serial Number from the Atmel AVR, SAM, SAMD, STM32, and ESP Microcontroller.

License

Notifications You must be signed in to change notification settings

ArduinoMinas/ArduinoUniqueID

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ArduinoUniqueID

This Library gets the Unique ID / Manufacture Serial Number from the Atmel AVR, SAM, SAMD, STM32, and ESP Microcontroller.

Atmel AVR Microcontroller

Unique Serial ID - Hidden Serial Number

The datasheet of the Atmega328pb chip has a section 'Serial Number' how explain every chip have a unique device ID with 10 bytes.

The datasheet of the Atmega328p chip does not say anything about the serial number, but I tested using the same Z-pointer Address on the datasheet of the Atmega328pb.

Apparently, the chip Atmega328p have a hidden serial number with 9 bytes, and others AVR Microcontroller maybe too, like the table below.

Z-pointer Address Atmega328pb Atmega328p
0x000E Byte 0 Byte 0
0x000F Byte 1 Byte 1
0x0010 Byte 2 Byte 2
0x0011 Byte 3 Byte 3
0x0012 Byte 4 Byte 4
0x0013 Byte 5 Byte 5
0x0014 Byte 6 -
0x0015 Byte 7 Byte 6
0x0016 Byte 8 Byte 7
0x0017 Byte 9 Byte 8

Tested Microcontroller

  • Atmega328pb - 10 bytes
  • Atmega328p - 9 bytes
  • Atmega2560 - 9 bytes
  • Attiny85 - 9 bytes

Atmel SAM ARM Microcontroller

Atmel SAM3X8E is used in Arduino Due.

The Unique Identifier is located in the first 128 bits of the Flash memory mapping. So, at the address 0x400000-0x400003.

"Each device integrates its own 128-bit unique identifier. These bits are factory configured and cannot be changed by the user. The ERASE pin has no effect on the unique identifier." Datasheet Section 7.2.3.7

Tested Microcontroller

  • Atmel SAM3X8E ARM Cortex-M3 - 16 bytes

Atmel SAMD ARM Microcontroller

Atmel SAMD21 is used in Arduino Zero / Arduino M0.

Each device has a unique 128-bit serial number which is a concatenation of four 32-bit words contained at the following addresses:

  • Word 0: 0x0080A00C
  • Word 1: 0x0080A040
  • Word 2: 0x0080A044
  • Word 3: 0x0080A048

The uniqueness of the serial number is guaranteed only when using all 128 bits. Datasheet Section 9.3.3

Tested Microcontroller

  • Atmel SAMD21 ARM Cortex-M0 - 16 bytes

STM32 Microcontroller

STM32 32-bit Arm Cortex MCUs has a unique 96-bit serial number which is a concatenation of three 32-bit words, the address is different depending on the microcontroller.

The Arduino Core STM32 has the functions HAL_GetUIDw0(), HAL_GetUIDw1() and HAL_GetUIDw2() for 96-bit UID.

Tested Microcontroller

  • STM32F103C8 (BluePill Board) - 12 bytes
  • STM32L073RZ (Nucleo L073RZ) - 12 bytes

Espressif ESP Microcontroller

ESP microcontroller has basically two versions, ESP8266 and ESP32, each one has a specific function to request the chip id.

  • ESP8266 - ESP.getChipId() - 4 bytes
  • ESP32 - ESP.getEfuseMac() - 6 bytes
UniqueID ESP8266 ESP32
Byte 0 Byte 0 Byte 5
Byte 1 Byte 1 Byte 4
Byte 2 Byte 2 Byte 3
Byte 3 Byte 3 Byte 2
Byte 4 - Byte 1
Byte 5 - Byte 0

To make the variable UniqueID8 to work propably the library uses the default bytes to 0x00.

UniqueID8 ESP8266 ESP32
Byte 0 0x00 0x00
Byte 1 0x00 0x00
Byte 2 0x00 Byte 5
Byte 3 0x00 Byte 4
Byte 4 Byte 0 Byte 3
Byte 5 Byte 1 Byte 2
Byte 6 Byte 2 Byte 1
Byte 7 Byte 3 Byte 0

Tested Microcontroller

  • ESP8266 - 4 bytes
  • ESP32 - 6 bytes

Installation

Examples

The library comes with examples. After installing the library you need to restart the Arduino IDE before they can be found under File > Examples > ArduinoUniqueID.


Reference

Include Library

#include <ArduinoUniqueID.h>

Variable: UniqueID & UniqueIDsize

UniqueID has UniqueIDsize bytes array of the Unique Serial ID.

for(size_t i = 0; i < UniqueIDsize; i++)
  Serial.println(UniqueID[i], HEX);

Method: UniqueIDdump

Print the hexadecimal bytes of the Unique Serial ID on the Stream.

void UniqueIDdump(Stream);

Variable: UniqueID8

UniqueID8 has the last 8 bytes array of the Unique Serial ID.

for(size_t i = 0; i < 8; i++)
  Serial.println(UniqueID8[i], HEX);

Method: UniqueID8dump

Print the last eight hexadecimal bytes of the Unique Serial ID on the Stream.

void UniqueID8dump(Stream);

Do you like this library? Please star this project on GitHub!

About

Arduino Library to gets the Manufacture Serial Number from the Atmel AVR, SAM, SAMD, STM32, and ESP Microcontroller.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 100.0%