2021-01-29 06:31:58 -05:00
|
|
|
|
|
|
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
2021-10-26 08:02:32 -04:00
|
|
|
[](https://github.com/RobTillaart/DS28CM00/actions/workflows/arduino-lint.yml)
|
|
|
|
|
[](https://github.com/RobTillaart/DS28CM00/actions/workflows/jsoncheck.yml)
|
2021-01-29 06:31:58 -05:00
|
|
|
[](https://github.com/RobTillaart/DS28CM00/blob/master/LICENSE)
|
|
|
|
|
[](https://github.com/RobTillaart/DS28CM00/releases)
|
|
|
|
|
|
|
|
|
|
|
2020-11-27 05:10:47 -05:00
|
|
|
# DS28CM00
|
2021-01-29 06:31:58 -05:00
|
|
|
|
2020-11-27 05:10:47 -05:00
|
|
|
Arduino library for I2C DS28CM00 unique identification chip. \[48 bit\]
|
|
|
|
|
|
2021-10-26 08:02:32 -04:00
|
|
|
|
2020-11-27 05:10:47 -05:00
|
|
|
## Description
|
2021-01-29 06:31:58 -05:00
|
|
|
|
2020-11-27 05:10:47 -05:00
|
|
|
THe DS28CM00 IC has a 64 bit address consisting of one type byte, 0x50, 6 bytes unique serial and a CRC
|
|
|
|
|
over the previous 7 bytes. This results in an 48 bits unique ID giving 281.474.976.710.656 combinations.
|
|
|
|
|
If that number is not unique enough, you could use 2 or more of them with an I2C multiplexer.
|
|
|
|
|
|
|
|
|
|
The DS28CM00 IC has the same addressing scheme as the better known DS18B20, except for the type byte.
|
2021-10-26 08:02:32 -04:00
|
|
|
Therefore one could use an DS18B20 as an unique ID chip in a similar way and getting a temperature sensor
|
2020-11-27 05:10:47 -05:00
|
|
|
as bonus.
|
|
|
|
|
|
2021-10-26 08:02:32 -04:00
|
|
|
The DS28CM00 can work in 2 modes, I2C and SMBus mode. Check datasheet for details.
|
|
|
|
|
|
2020-11-27 05:10:47 -05:00
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
## Interface
|
|
|
|
|
|
2021-10-26 08:02:32 -04:00
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
### Constructor
|
|
|
|
|
|
2021-10-26 08:02:32 -04:00
|
|
|
- **DS28CM00(TwoWire \*wire = &Wire)** Constructor, with default Wire as I2C bus.
|
|
|
|
|
- **DS28CM00(uint8_t dataPin, uint8_t clockPin)** Constructor for ESP32, ESP8266 et al.
|
|
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
|
|
|
|
|
### public
|
2021-10-26 08:02:32 -04:00
|
|
|
|
|
|
|
|
- **void begin()** initializes I2C bus, sets default DS28CM00_I2C_MODE.
|
2021-01-29 06:31:58 -05:00
|
|
|
- **bool getUID(uint8_t \*serial)** get unique 8 bytes serial number or error.
|
2021-10-26 08:02:32 -04:00
|
|
|
Returns false if action failed.
|
|
|
|
|
- **bool setI2CMode()** set DS28CM00_I2C_MODE (0x00). Returns false if action failed.
|
|
|
|
|
- **bool setSMBusMode()** set DS28CM00_SMBUS_MODE (0x01). Returns false if action failed.
|
|
|
|
|
- **bool getMode(uint8_t &mode)** returns mode set above. Returns false if action failed.
|
|
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
|
2020-11-27 05:10:47 -05:00
|
|
|
## Operation
|
|
|
|
|
|
|
|
|
|
See examples.
|
|
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
The class is not tested extensively e.g. with ESP32 / ESP8266.
|
2021-10-26 08:02:32 -04:00
|
|
|
An example sketch for ESP32 exist and compiles. Feedback welcome.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Future
|
|
|
|
|
|
2022-11-02 06:55:17 -04:00
|
|
|
#### should
|
2021-12-17 07:06:20 -05:00
|
|
|
- only extend on request / bugs
|
2021-10-26 08:02:32 -04:00
|
|
|
- measure performance I2C 400 500 600 kHz ...
|
2022-11-02 06:55:17 -04:00
|
|
|
|
|
|
|
|
#### could
|
2021-10-26 08:02:32 -04:00
|
|
|
- cache the serial? (costs 8 bytes)
|
2021-12-17 07:06:20 -05:00
|
|
|
- If (defined DS28_CACHE) ...
|
|
|
|
|
|
2022-11-02 06:55:17 -04:00
|
|
|
#### wont
|
2021-12-17 07:06:20 -05:00
|
|
|
- **bool getUID4()** to read only 4 bytes to improve performance. Possible?
|
|
|
|
|
- **bool getUID(4)** number of bytes as parameter?
|
|
|
|
|
- **uint8_t getError()** add error handling? - I2C; #bytes; mode; ...(too much for simple device)
|
2021-01-29 06:31:58 -05:00
|
|
|
|
