OneWire + DS18X20 Library
Basic functions for OneWire operations + specific DS18x20 operations
 All Functions Groups Pages
onewire.h
1 /*****************************************************************************
2 
3  OneWire (tm) library
4 
5  Copyright (C) 2016 Falk Brunner
6 
7 *****************************************************************************/
8 
9 /*
10 * ----------------------------------------------------------------------------
11 * "THE BEER-WARE LICENSE" (Revision 42):
12 * <Falk.Brunner@gmx.de> wrote this file. As long as you retain this notice you
13 * can do whatever you want with this stuff. If we meet some day, and you think
14 * this stuff is worth it, you can buy me a beer in return. Falk Brunner
15 * ----------------------------------------------------------------------------
16 */
17 
51 #ifndef ONEWIRE_H_
52 #define ONEWIRE_H_
53 
54 #include <avr/io.h>
55 
60 #define ONEWIRE_BIT PA0
61 #define ONEWIRE_PIN PINA
62 #define ONEWIRE_PORT PORTA
63 #define ONEWIRE_DDR DDRA
64 
70 #define ONEWIRE_STRONG_PU_ON ONEWIRE_PORT |= ONEWIRE_MASK; ONEWIRE_DDR |= ONEWIRE_MASK;
71 #define ONEWIRE_STRONG_PU_OFF ONEWIRE_DDR &= ~ONEWIRE_MASK;
72 
78 #define ONEWIRE_MASK (1<<ONEWIRE_BIT) //
79 #define ONEWIRE_LOW ONEWIRE_PORT &= ~ONEWIRE_MASK; ONEWIRE_DDR |= ONEWIRE_MASK;
80 #define ONEWIRE_TRISTATE ONEWIRE_DDR &= ~ONEWIRE_MASK;
81 #define ONEWIRE_READ (ONEWIRE_PIN & ONEWIRE_MASK)
82 
89 #define ONEWIRE_MATCH_ROM 0x55
90 #define ONEWIRE_SEARCH_ROM 0xF0
91 #define ONEWIRE_SKIP_ROM 0xCC
92 #define ONEWIRE_READ_ROM 0x33
93 #define ONEWIRE_ALARM_SEARCH 0xEC
94 
100 #define ONEWIRE_OK 0 // no error
101 #define ONEWIRE_NO_PRESENCE 1 // no presence pulse detected during onewire reset
102 #define ONEWIRE_CRC_ERROR 2 // crc error in data reception
103 #define ONEWIRE_SCAN_ERROR 3 // scan error during ROM scan
104 #define ONEWIRE_LAST_CODE 4 // last rom code scaned (no error, just info)
105 #define ONEWIRE_GND_SHORT 5 // bus short circuit to GND
106 
112 
123 uint8_t onewire_reset(void);
124 
131 uint8_t onewire_read_byte(void);
132 
139 void onewire_write_byte(uint8_t data);
140 
147 void onewire_search_init(uint8_t buffer[8]);
148 
163 uint8_t onewire_alarm_search(uint8_t buffer[8]);
164 
179 uint8_t onewire_search_rom(uint8_t buffer[8]);
180 
190 uint8_t onewire_match_rom(const uint8_t rom[8]);
191 
203 uint8_t onewire_read_rom(uint8_t rom[8]);
204 
215 uint8_t onewire_skip_rom(void);
216 
229 uint8_t onewire_crc(const uint8_t *data, uint8_t cnt);
230 
243 uint8_t onewire_crc_serial(const uint8_t *data, uint8_t cnt);
244 
250 
257 void onewire_write_bit(uint8_t data);
258 
265 uint8_t onewire_read_bit(void);
266 
282 uint8_t onewire_search(uint8_t buffer[8], uint8_t cmd);
283 
284 #endif
uint8_t onewire_reset(void)
OneWire reset.
Definition: onewire.cpp:27
uint8_t onewire_match_rom(const uint8_t rom[8])
select device on bus
Definition: onewire.cpp:208
void onewire_write_byte(uint8_t data)
write one byte
Definition: onewire.cpp:96
uint8_t onewire_read_rom(uint8_t rom[8])
read ROM ID of device
Definition: onewire.cpp:235
void onewire_search_init(uint8_t buffer[8])
init rom search buffer and internal variables
Definition: onewire.cpp:107
uint8_t onewire_crc(const uint8_t *data, uint8_t cnt)
calculate CRC over data array, fast version, 0.3ms for 8 bytes @1MHz
Definition: onewire.cpp:286
uint8_t onewire_crc_serial(const uint8_t *data, uint8_t cnt)
calculate CRC over data array, serial version, 1ms for 8 bytes @1MHz
Definition: onewire.cpp:354
void onewire_write_bit(uint8_t data)
write one bit to bus
Definition: onewire.cpp:47
uint8_t onewire_search(uint8_t buffer[8], uint8_t cmd)
scan OneWire bus for normal ROM or alarm search
Definition: onewire.cpp:120
uint8_t onewire_skip_rom(void)
select device on bus
Definition: onewire.cpp:223
uint8_t onewire_read_bit(void)
read one bit from bus
Definition: onewire.cpp:64
uint8_t onewire_read_byte(void)
read one byte
Definition: onewire.cpp:83
uint8_t onewire_alarm_search(uint8_t buffer[8])
scan OneWire bus for devices with active alarm flag
Definition: onewire.cpp:116
uint8_t onewire_search_rom(uint8_t buffer[8])
scan OneWire bus for ROMs
Definition: onewire.cpp:112