OneWire + DS18X20 Library
Basic functions for OneWire operations + specific DS18x20 operations
 All Functions Groups Pages
Macros | Functions
DS18X20 FUNCTIONS

Macros

#define ds18B20_convert_t(x)   ds18x20_convert_t(x)
 
#define ds18S20_convert_t(x)   ds18x20_convert_t(x)
 
#define ds18B20_read_scratchpad(x)   ds18x20_read_scratchpad(x)
 
#define ds18S20_read_scratchpad(x)   ds18x20_read_scratchpad(x)
 
#define ds18B20_copy_scratchpad(x)   ds18x20_copy_scratchpad(x);
 
#define ds18S20_copy_scratchpad(x)   ds18x20_copy_scratchpad(x);
 
#define ds18B20_recall_E2(x)   ds18x20_recall_E2(x)
 
#define ds18S20_recall_E2(x)   ds18x20_recall_E2(x)
 
#define ds18B20_read_power_supply(x)   ds18x20_read_power_supply(x)
 
#define ds18S20_read_power_supply(x)   ds18x20_read_power_supply(x)
 

Functions

uint8_t ds18x20_convert_t (uint8_t parasitic_power)
 start temperature conversion More...
 
int16_t ds18x20_read_temp (void)
 Read temperature from DS18x20. More...
 
int16_t ds18B20_read_temp (void)
 Read temperature from DS18B20 (12 bit resolution) More...
 
int16_t ds18S20_read_temp (void)
 Read temperature from DS18S20 (9 bit resolution) More...
 
void ds18x20_read_scratchpad (uint8_t *buffer)
 Read complete scratchpad of DS18x20 (9 bytes) More...
 
void ds18S20_write_scratchpad (int8_t th, int8_t tl)
 write th and tl of DS18S20 More...
 
void ds18B20_write_scratchpad (uint8_t th, uint8_t tl, uint8_t config)
 write th, tl and configuration of DS18B20 More...
 
void ds18x20_copy_scratchpad (uint8_t parasitic_power)
 copy scratchpad to EEPROM, busy waiting (10ms), More...
 
void ds18x20_recall_E2 (void)
 copy EEPROM to scratchpad, busy waiting (1ms) More...
 
uint8_t ds18x20_read_power_supply (void)
 read power supply More...
 

Detailed Description

standard functions

Function Documentation

uint8_t ds18x20_convert_t ( uint8_t  parasitic_power)

start temperature conversion

Parameters
parasitic_powerset true if device has parasitic power supply
Returns
error code
0: no error
1: no presence pulse detected

Definition at line 32 of file ds18x20.c.

int16_t ds18x20_read_temp ( void  )

Read temperature from DS18x20.

Parameters
none
Returns
temperature as 16 bit signed data (plain)

Definition at line 52 of file ds18x20.c.

int16_t ds18B20_read_temp ( void  )

Read temperature from DS18B20 (12 bit resolution)

Parameters
none
Returns
temperature in 1/10 C (fixed point)

Definition at line 66 of file ds18x20.c.

int16_t ds18S20_read_temp ( void  )

Read temperature from DS18S20 (9 bit resolution)

Parameters
none
Returns
temperature in 1/10 C (fixed point)

Definition at line 82 of file ds18x20.c.

void ds18x20_read_scratchpad ( uint8_t *  buffer)

Read complete scratchpad of DS18x20 (9 bytes)

Parameters
*bufferpointer to data array
Returns
none

Definition at line 95 of file ds18x20.c.

void ds18S20_write_scratchpad ( int8_t  th,
int8_t  tl 
)

write th and tl of DS18S20

Parameters
thupper temperature limit (1 C resolution)
tllower temperature limit (1 C resolution)
Returns
none

Definition at line 104 of file ds18x20.c.

void ds18B20_write_scratchpad ( uint8_t  th,
uint8_t  tl,
uint8_t  config 
)

write th, tl and configuration of DS18B20

Parameters
thupper temperature limit (1 C resolution)
tllower temperature limit (1 C resolution)
configconfiguration byte
Returns
none

Definition at line 111 of file ds18x20.c.

void ds18x20_copy_scratchpad ( uint8_t  parasitic_power)

copy scratchpad to EEPROM, busy waiting (10ms),

parasitic power switching is completely handled inside the function, no need for further user action

Parameters
parasitic_powerset true if device has parasitic power supply
Returns
none

Definition at line 119 of file ds18x20.c.

void ds18x20_recall_E2 ( void  )

copy EEPROM to scratchpad, busy waiting (1ms)

Parameters
none
Returns
none

Definition at line 135 of file ds18x20.c.

uint8_t ds18x20_read_power_supply ( void  )

read power supply

Parameters
none
Returns
power mode
0: normal power
1: parasitic power

Definition at line 140 of file ds18x20.c.