Browse Source

Add README.

main
David Antliff 8 years ago
parent
commit
772c0c6a87
  1. 44
      README.md

44
README.md

@ -1,5 +1,43 @@
# Hello World Example # DS18B20 1-Wire
Starts a FreeRTOS task to print "Hello World" ## Introduction
This is a ESP32-compatible C library for the Maxim Integrated DS18B20 Programmable Resolution 1-Wire Digital Thermometer device.
It supports multiple devices on the same 1-Wire bus.
## Supported Features
* External power supply mode (parasitic mode not yet supported).
* Static (stack-based) or dynamic (malloc-based) memory model.
* 1-Wire device detection and validation, including search for multiple devices on a single bus.
* 1-Wire bus operations including multi-byte read and write operations.
* CRC checks on ROM code and temperature data.
* Temperature convertion and retrieval.
## Roadmap
* Simultaneous temperature conversion from multiple devices.
* Device configuration including resolution.
* Alarm support.
* Single device optimisations - avoid ROM addressing when only one device exists.
* Parasitic power support.
* EEPROM support.
## License
The code in this project is licensed under the MIT license - see LICENSE for details.
## Links
* [DS18B20 Datasheet](http://datasheets.maximintegrated.com/en/ds/DS18B20.pdf)
* [1-Wire Communication Through Software](https://www.maximintegrated.com/en/app-notes/index.mvp/id/126)
* [1-Wire Search Algorithm](https://www.maximintegrated.com/en/app-notes/index.mvp/id/187)
* [Espressif IoT Development Framework for ESP32](https://github.com/espressif/esp-idf)
## Acknowledgements
Parts of this code are based on references provided to the public domain by Maxim Integrated.
"1-Wire" is a registered trademark of Maxim Integrated.
See the README.md file in the upper level 'examples' directory for more information about examples.

Loading…
Cancel
Save