driver ds18b20 source file More...

#include "driver_ds18b20.h"

Include dependency graph for driver_ds18b20.c:

Macros
#define	CHIP_NAME "Maxim Integrated DS18B20"
	chip information definition
#define	MANUFACTURER_NAME "Maxim Integrated"
#define	SUPPLY_VOLTAGE_MIN 3.0f
#define	SUPPLY_VOLTAGE_MAX 5.5f
#define	MAX_CURRENT 4.0f
#define	TEMPERATURE_MIN -55.0f
#define	TEMPERATURE_MAX 125.0f
#define	DRIVER_VERSION 2000
#define	DS18B20_CMD_SEARCH_ROM 0xF0
	chip command definition
#define	DS18B20_CMD_READ_ROM 0x33
#define	DS18B20_CMD_MATCH_ROM 0x55
#define	DS18B20_CMD_SKIP_ROM 0xCC
#define	DS18B20_CMD_ALARM_SEARCH 0xEC
#define	DS18B20_CMD_CONVERT_T 0x44
#define	DS18B20_CMD_WRITE_SCRATCHPAD 0x4E
#define	DS18B20_CMD_READ_SCRATCHPAD 0xBE
#define	DS18B20_CMD_COPY_SCRATCHPAD 0x48
#define	DS18B20_CMD_RECALL_EE 0xB8
#define	DS18B20_CMD_READ_POWER_SUPPLY 0xB4

Functions
uint8_t	ds18b20_set_mode (ds18b20_handle_t *handle, ds18b20_mode_t mode)
	set the chip mode
uint8_t	ds18b20_get_mode (ds18b20_handle_t handle, ds18b20_mode_t mode)
	get the chip mode
uint8_t	ds18b20_set_rom (ds18b20_handle_t *handle, uint8_t rom[8])
	set the handle rom
uint8_t	ds18b20_get_rom (ds18b20_handle_t *handle, uint8_t rom[8])
	get the chip rom
uint8_t	ds18b20_scratchpad_set_resolution (ds18b20_handle_t *handle, ds18b20_resolution_t resolution)
	set the resolution in the scratchpad
uint8_t	ds18b20_scratchpad_get_resolution (ds18b20_handle_t handle, ds18b20_resolution_t resolution)
	get the resolution in the scratchpad
uint8_t	ds18b20_scratchpad_set_alarm_threshold (ds18b20_handle_t *handle, int8_t threshold_high, int8_t threshold_low)
	set the alarm threshold in the scratchpad
uint8_t	ds18b20_scrachpad_get_alarm_threshold (ds18b20_handle_t handle, int8_t threshold_high, int8_t *threshold_low)
	get the alarm threshold in the scratchpad
uint8_t	ds18b20_copy_scratchpad_to_eeprom (ds18b20_handle_t *handle)
	copy the scratchpad content to the eeprom
uint8_t	ds18b20_copy_eeprom_to_scratchpad (ds18b20_handle_t *handle)
	copy the eeprom content to the scratchpad
uint8_t	ds18b20_alarm_convert_to_register (ds18b20_handle_t handle, float temp, int8_t reg)
	convert the alarm temperature to the register data
uint8_t	ds18b20_alarm_convert_to_data (ds18b20_handle_t handle, int8_t reg, float temp)
	convert the register data to the alarm temperature
uint8_t	ds18b20_init (ds18b20_handle_t *handle)
	initialize the chip
uint8_t	ds18b20_deinit (ds18b20_handle_t *handle)
	close the chip
uint8_t	ds18b20_read (ds18b20_handle_t handle, int16_t raw, float *temp)
	read data from the chip
uint8_t	ds18b20_search_rom (ds18b20_handle_t handle, uint8_t(rom)[8], uint8_t *num)
	search the ds18b20 rom
uint8_t	ds18b20_search_alarm (ds18b20_handle_t handle, uint8_t(rom)[8], uint8_t *num)
	search the ds18b20 alarm rom
uint8_t	ds18b20_get_power_mode (ds18b20_handle_t handle, ds18b20_power_mode_t power_mode)
	get the power mode
uint8_t	ds18b20_info (ds18b20_info_t *info)
	get chip's information

Variables
const uint8_t	gc_ds18b20_crc_table [256]
	crc table

Detailed Description

driver ds18b20 source file

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Version: 2.0.0

Author: Shifeng Li

Date: 2021-04-06

history

Date	Version	Author	Description
2021/04/06	2.0	Shifeng Li	format the code
2020/12/20	1.0	Shifeng Li	first upload

Definition in file driver_ds18b20.c.

Macro Definition Documentation

◆ CHIP_NAME

#define CHIP_NAME "Maxim Integrated DS18B20"

chip information definition

chip name

Definition at line 43 of file driver_ds18b20.c.

◆ DRIVER_VERSION

#define DRIVER_VERSION 2000

driver version

Definition at line 50 of file driver_ds18b20.c.

◆ DS18B20_CMD_ALARM_SEARCH

#define DS18B20_CMD_ALARM_SEARCH 0xEC

alarm search command

Definition at line 59 of file driver_ds18b20.c.

◆ DS18B20_CMD_CONVERT_T

#define DS18B20_CMD_CONVERT_T 0x44

convert command

Definition at line 60 of file driver_ds18b20.c.

◆ DS18B20_CMD_COPY_SCRATCHPAD

#define DS18B20_CMD_COPY_SCRATCHPAD 0x48

copy scratchpad command

Definition at line 63 of file driver_ds18b20.c.

◆ DS18B20_CMD_MATCH_ROM

#define DS18B20_CMD_MATCH_ROM 0x55

match rom command

Definition at line 57 of file driver_ds18b20.c.

◆ DS18B20_CMD_READ_POWER_SUPPLY

#define DS18B20_CMD_READ_POWER_SUPPLY 0xB4

read power supply command

Definition at line 65 of file driver_ds18b20.c.

◆ DS18B20_CMD_READ_ROM

#define DS18B20_CMD_READ_ROM 0x33

read rom command

Definition at line 56 of file driver_ds18b20.c.

◆ DS18B20_CMD_READ_SCRATCHPAD

#define DS18B20_CMD_READ_SCRATCHPAD 0xBE

read scratchpad command

Definition at line 62 of file driver_ds18b20.c.

◆ DS18B20_CMD_RECALL_EE

#define DS18B20_CMD_RECALL_EE 0xB8

recall ee command

Definition at line 64 of file driver_ds18b20.c.

◆ DS18B20_CMD_SEARCH_ROM

#define DS18B20_CMD_SEARCH_ROM 0xF0

chip command definition

search rom command

Definition at line 55 of file driver_ds18b20.c.

◆ DS18B20_CMD_SKIP_ROM

#define DS18B20_CMD_SKIP_ROM 0xCC

skip rom command

Definition at line 58 of file driver_ds18b20.c.

◆ DS18B20_CMD_WRITE_SCRATCHPAD

#define DS18B20_CMD_WRITE_SCRATCHPAD 0x4E

write scratchpad command

Definition at line 61 of file driver_ds18b20.c.

◆ MANUFACTURER_NAME

#define MANUFACTURER_NAME "Maxim Integrated"

manufacturer name

Definition at line 44 of file driver_ds18b20.c.

◆ MAX_CURRENT

#define MAX_CURRENT 4.0f

chip max current

Definition at line 47 of file driver_ds18b20.c.

◆ SUPPLY_VOLTAGE_MAX

#define SUPPLY_VOLTAGE_MAX 5.5f

chip max supply voltage

Definition at line 46 of file driver_ds18b20.c.

◆ SUPPLY_VOLTAGE_MIN

#define SUPPLY_VOLTAGE_MIN 3.0f

chip min supply voltage

Definition at line 45 of file driver_ds18b20.c.

◆ TEMPERATURE_MAX

#define TEMPERATURE_MAX 125.0f

chip max operating temperature

Definition at line 49 of file driver_ds18b20.c.

◆ TEMPERATURE_MIN

#define TEMPERATURE_MIN -55.0f

chip min operating temperature

Definition at line 48 of file driver_ds18b20.c.

Variable Documentation

◆ gc_ds18b20_crc_table

const uint8_t gc_ds18b20_crc_table[256]

Initial value:

=
{
    0X00, 0X5E, 0XBC, 0XE2, 0X61, 0X3F, 0XDD, 0X83, 0XC2, 0X9C, 0X7E, 0X20, 0XA3,
    0XFD, 0X1F, 0X41, 0X9D, 0XC3, 0X21, 0X7F, 0XFC, 0XA2, 0X40, 0X1E, 0X5F, 0X01,
    0XE3, 0XBD, 0X3E, 0X60, 0X82, 0XDC, 0X23, 0X7D, 0X9F, 0XC1, 0X42, 0X1C, 0XFE,
    0XA0, 0XE1, 0XBF, 0X5D, 0X03, 0X80, 0XDE, 0X3C, 0X62, 0XBE, 0XE0, 0X02, 0X5C,
    0XDF, 0X81, 0X63, 0X3D, 0X7C, 0X22, 0XC0, 0X9E, 0X1D, 0X43, 0XA1, 0XFF, 0X46,
    0X18, 0XFA, 0XA4, 0X27, 0X79, 0X9B, 0XC5, 0X84, 0XDA, 0X38, 0X66, 0XE5, 0XBB,
    0X59, 0X07, 0XDB, 0X85, 0X67, 0X39, 0XBA, 0XE4, 0X06, 0X58, 0X19, 0X47, 0XA5,
    0XFB, 0X78, 0X26, 0XC4, 0X9A, 0X65, 0X3B, 0XD9, 0X87, 0X04, 0X5A, 0XB8, 0XE6,
    0XA7, 0XF9, 0X1B, 0X45, 0XC6, 0X98, 0X7A, 0X24, 0XF8, 0XA6, 0X44, 0X1A, 0X99,
    0XC7, 0X25, 0X7B, 0X3A, 0X64, 0X86, 0XD8, 0X5B, 0X05, 0XE7, 0XB9, 0X8C, 0XD2,
    0X30, 0X6E, 0XED, 0XB3, 0X51, 0X0F, 0X4E, 0X10, 0XF2, 0XAC, 0X2F, 0X71, 0X93,
    0XCD, 0X11, 0X4F, 0XAD, 0XF3, 0X70, 0X2E, 0XCC, 0X92, 0XD3, 0X8D, 0X6F, 0X31,
    0XB2, 0XEC, 0X0E, 0X50, 0XAF, 0XF1, 0X13, 0X4D, 0XCE, 0X90, 0X72, 0X2C, 0X6D,
    0X33, 0XD1, 0X8F, 0X0C, 0X52, 0XB0, 0XEE, 0X32, 0X6C, 0X8E, 0XD0, 0X53, 0X0D,
    0XEF, 0XB1, 0XF0, 0XAE, 0X4C, 0X12, 0X91, 0XCF, 0X2D, 0X73, 0XCA, 0X94, 0X76,
    0X28, 0XAB, 0XF5, 0X17, 0X49, 0X08, 0X56, 0XB4, 0XEA, 0X69, 0X37, 0XD5, 0X8B,
    0X57, 0X09, 0XEB, 0XB5, 0X36, 0X68, 0X8A, 0XD4, 0X95, 0XCB, 0X29, 0X77, 0XF4,
    0XAA, 0X48, 0X16, 0XE9, 0XB7, 0X55, 0X0B, 0X88, 0XD6, 0X34, 0X6A, 0X2B, 0X75,
    0X97, 0XC9, 0X4A, 0X14, 0XF6, 0XA8, 0X74, 0X2A, 0XC8, 0X96, 0X15, 0X4B, 0XA9,
    0XF7, 0XB6, 0XE8, 0X0A, 0X54, 0XD7, 0X89, 0X6B, 0X35,
}

crc table

Definition at line 70 of file driver_ds18b20.c.

Macros

Functions

Variables