An arduino library to communicate using the Dallas one-wire protocol, where the Arduino takes the role of a slave. Implementation of a DS2413 on Arduino UNO and ATTINY85
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Youen Toupin 3e251a82f6 integrated Timer1 library (instead of custom code) ; but for an unknown reason it breaks the 1-wire communication (timer code doesn't work at all, or timings are wrong, or both) ; search algorithm is broken, and probably everything else as well 7 years ago
config Timer1 library from https://github.com/PaulStoffregen/TimerOne aaeb4a36f5f23e99e6011bea77cf76abb912e13a 7 years ago
.gitattributes - removed the OWSlave library (that just doesn't work, at least on Arduino Uno when talking to a DS9490 master) 9 years ago
.gitignore updated sample code with new function names 8 years ago
LICENSE Update LICENSE 9 years ago
LowLevel.h integrated Timer1 library (instead of custom code) ; but for an unknown reason it breaks the 1-wire communication (timer code doesn't work at all, or timings are wrong, or both) ; search algorithm is broken, and probably everything else as well 7 years ago
OneWireIO.ino updated sample code with new function names 8 years ago
OneWireIO.sln cleaned up project for public distribution (removed debug and unrelated stuff) 9 years ago
OneWireIO.vcxproj integrated Timer1 library (instead of custom code) ; but for an unknown reason it breaks the 1-wire communication (timer code doesn't work at all, or timings are wrong, or both) ; search algorithm is broken, and probably everything else as well 7 years ago
OneWireIO.vcxproj.filters integrated Timer1 library (instead of custom code) ; but for an unknown reason it breaks the 1-wire communication (timer code doesn't work at all, or timings are wrong, or both) ; search algorithm is broken, and probably everything else as well 7 years ago
OneWireSlave.cpp integrated Timer1 library (instead of custom code) ; but for an unknown reason it breaks the 1-wire communication (timer code doesn't work at all, or timings are wrong, or both) ; search algorithm is broken, and probably everything else as well 7 years ago
OneWireSlave.h Merge remote-tracking branch 'remotes/github_ntruchsess/attiny' 7 years ago
README.md Update README.md 9 years ago
TimerOne.cpp Timer1 library from https://github.com/PaulStoffregen/TimerOne aaeb4a36f5f23e99e6011bea77cf76abb912e13a 7 years ago
TimerOne.h Timer1 library from https://github.com/PaulStoffregen/TimerOne aaeb4a36f5f23e99e6011bea77cf76abb912e13a 7 years ago

README.md

OneWireArduinoSlave

An arduino library to communicate using the Dallas one-wire protocol, where the Arduino takes the role of a slave. Entirely implemented using interrupts, you can perform other tasks while communication is handled in background.

1-wire introduction

1-wire allows communication over long distances (100m and more, see Dallas documentation for details) with a single wire (plus a ground wire). You can put as much devices as you want on the same wire (they communicate one at a time). 1-wire also allows to send power over the data wire (parasitic power), but, though I haven't tried, I don't believe it would work with an Arduino. You'll need a separate 5V power source, which, if it comes next to your data wire, means you need 3 wires (5V, data, and ground). You'll also need a master controller, for example the USB adapter DS9490R, to connect to a computer, that will control communication with all 1-wire devices.

How to use this library

This library allows you to emulate existing 1-wire devices with an Arduino, or to create your own protocol. All low-level details are handled by the library, such as reset detection, ROM matching, byte sending and receiving. Look at the demo sketch to see an example.

There are only 3 important functions:

  • void setReceiveCallback(void(*callback)(ReceiveEvent evt, byte data)) sets the function that will be called back when an event occurs, such as when a byte is received
  • void begin(byte* rom, byte pinNumber) starts the library, which will respond to the provided ROM (must be unique on your network) on the specified Arduino pin. The ROM is cloned by the library, so you can discard your buffer immediately if you want.
  • void write(byte* bytes, short numBytes, void(*complete)(bool error)) starts writing one or more bytes, and will call the provided callback (optional) when it's done. The buffer you provide here must stay available until the end of the write operation, which happens in background. Do not use local variables.

Notes about the interrupt-based implementation

Since the library is implemented using interrupts, none of its functions will block: you can continue execute your code immediately.

This also means callbacks are called from interrupt handlers, so you must make them very short to not block further communication.

You must also be careful when you explicitely block interrupts, as the 1-wire protocol has very tight timings, especially when writing bytes (which also happens when searching for device ROMs): a delay of 3 microseconds (yes, microseconds, not milliseconds) can be enough for some (quite intolerant) masters to miss a bit.

But if your code only blocks interrupts for reasonably short time, the probability to block exactly at the bad moment is low, so you can easily mitigate the issue by adding CRC checks in your high-level communication protocol, and retrying when an error is detected. This is an important thing to do anyway because 1-wire does not natively perform any error checking (excepted for ROM operations which already contain a CRC byte). Standard 1-wire devices also include CRC checks in their specific protocols.