#include "fw_hal.h"

Macros
#define	DS18B20_DQ P35

#define	DS18B20_DQ_PULLUP() GPIO_SetPullUp(GPIO_Port_3, GPIO_Pin_5, HAL_State_ON)

#define	DS18B20_DQ_INPUT() GPIO_P3_SetMode(GPIO_Pin_5, GPIO_Mode_Input_HIP)

#define	DS18B20_DQ_OUTPUT() GPIO_P3_SetMode(GPIO_Pin_5, GPIO_Mode_InOut_OD)

#define	DS18B20_DQ_LOW() DS18B20_DQ=RESET

#define	DS18B20_DQ_HIGH() DS18B20_DQ=SET

#define	ONEWIRE_CMD_RSCRATCHPAD 0xBE

#define	ONEWIRE_CMD_WSCRATCHPAD 0x4E

#define	ONEWIRE_CMD_CPYSCRATCHPAD 0x48

#define	ONEWIRE_CMD_RECEEPROM 0xB8

#define	ONEWIRE_CMD_RPWRSUPPLY 0xB4

#define	ONEWIRE_CMD_SEARCHROM 0xF0

#define	ONEWIRE_CMD_READROM 0x33

#define	ONEWIRE_CMD_MATCHROM 0x55

#define	ONEWIRE_CMD_SKIPROM 0xCC

#define	DS18B20_FAMILY_CODE 0x28

#define	DS18B20_CMD_ALARMSEARCH 0xEC

#define	DS18B20_CMD_CONVERTTEMP 0x44 /* Convert temperature */

#define	DS18B20_DECIMAL_STEPS_12BIT 0.0625

#define	DS18B20_DECIMAL_STEPS_11BIT 0.125

#define	DS18B20_DECIMAL_STEPS_10BIT 0.25

#define	DS18B20_DECIMAL_STEPS_9BIT 0.5

#define	DS18B20_RESOLUTION_R1 6

#define	DS18B20_RESOLUTION_R0 5

Enumerations
enum	DS18B20_Resolution_t { DS18B20_Resolution_9bits = 9 , DS18B20_Resolution_10bits = 10 , DS18B20_Resolution_11bits = 11 , DS18B20_Resolution_12bits = 12 , DS18B20_Resolution_9bits = 9 , DS18B20_Resolution_10bits = 10 , DS18B20_Resolution_11bits = 11 , DS18B20_Resolution_12bits = 12 }

Functions
void	DS18B20_Init (void)
	Initialize DS18B20.

__BIT	DS18B20_Reset (void)
	Reset DS18B20.

__BIT	DS18B20_ReadBit (void)
	Read one bit from DS18B20.

uint8_t	DS18B20_ReadByte (void)
	Read one byte from DS18B20.

void	DS18B20_WriteBit (__BIT b)
	Write one bit to DS18B20.

void	DS18B20_WriteByte (uint8_t byte)
	Write one byte to DS18B20.

uint8_t	DS18B20_Crc (uint8_t *addr, uint8_t len)
	8-bit CRC calculation

void	DS18B20_ReadScratchpad (uint8_t *buf)
	Read SRAM scratchpad.

void	DS18B20_StartAll (void)
	Start conversion on all slaves.

__BIT	DS18B20_AllDone (void)
	If read bit is low, then device is not finished yet with calculation temperature.

void	DS18B20_ReadRom (uint8_t *buf)
	Read 64-bit ROM: 8-bit family code "0x28", unique 48-bit serial number, 8-bit CRC.

void	DS18B20_Select (const uint8_t *addr)
	Select a slave on the bus.

void	DS18B20_Start (const uint8_t *addr)
	Start conversion on selected slave.

void	DS18B20_ReadScratchpadFromAddr (const uint8_t addr, uint8_t buf)
	Read SRAM scratchpad from selected slave.

uint8_t	DS18B20_Search (uint8_t buff, uint8_t stack, uint8_t split_point)
	Perform one ROM search.

Macro Definition Documentation

◆ DS18B20_CMD_ALARMSEARCH

#define DS18B20_CMD_ALARMSEARCH 0xEC

Definition at line 47 of file ds18b20.h.

◆ DS18B20_CMD_CONVERTTEMP

#define DS18B20_CMD_CONVERTTEMP 0x44 /* Convert temperature */

Definition at line 50 of file ds18b20.h.

◆ DS18B20_DECIMAL_STEPS_10BIT

#define DS18B20_DECIMAL_STEPS_10BIT 0.25

Definition at line 53 of file ds18b20.h.

◆ DS18B20_DECIMAL_STEPS_11BIT

#define DS18B20_DECIMAL_STEPS_11BIT 0.125

Definition at line 52 of file ds18b20.h.

◆ DS18B20_DECIMAL_STEPS_12BIT

#define DS18B20_DECIMAL_STEPS_12BIT 0.0625

Definition at line 51 of file ds18b20.h.

◆ DS18B20_DECIMAL_STEPS_9BIT

#define DS18B20_DECIMAL_STEPS_9BIT 0.5

Definition at line 54 of file ds18b20.h.

◆ DS18B20_DQ

#define DS18B20_DQ P35

DS18B20 - Programmable Resolution 1-Wire Digital Thermometer

To-92 Pins: With the flat side facing you and with the leads pointing down, they are GND, DQ and Vdd

Definition at line 28 of file ds18b20.h.

◆ DS18B20_DQ_HIGH

#define DS18B20_DQ_HIGH ( ) DS18B20_DQ=SET

Definition at line 33 of file ds18b20.h.

◆ DS18B20_DQ_INPUT

#define DS18B20_DQ_INPUT ( ) GPIO_P3_SetMode(GPIO_Pin_5, GPIO_Mode_Input_HIP)

Definition at line 30 of file ds18b20.h.

◆ DS18B20_DQ_LOW

#define DS18B20_DQ_LOW ( ) DS18B20_DQ=RESET

Definition at line 32 of file ds18b20.h.

◆ DS18B20_DQ_OUTPUT

#define DS18B20_DQ_OUTPUT ( ) GPIO_P3_SetMode(GPIO_Pin_5, GPIO_Mode_InOut_OD)

Definition at line 31 of file ds18b20.h.

◆ DS18B20_DQ_PULLUP

#define DS18B20_DQ_PULLUP ( ) GPIO_SetPullUp(GPIO_Port_3, GPIO_Pin_5, HAL_State_ON)

Definition at line 29 of file ds18b20.h.

◆ DS18B20_FAMILY_CODE

#define DS18B20_FAMILY_CODE 0x28

Definition at line 46 of file ds18b20.h.

◆ DS18B20_RESOLUTION_R0

#define DS18B20_RESOLUTION_R0 5

Definition at line 58 of file ds18b20.h.

◆ DS18B20_RESOLUTION_R1

#define DS18B20_RESOLUTION_R1 6

Definition at line 57 of file ds18b20.h.

◆ ONEWIRE_CMD_CPYSCRATCHPAD

#define ONEWIRE_CMD_CPYSCRATCHPAD 0x48

Definition at line 38 of file ds18b20.h.

◆ ONEWIRE_CMD_MATCHROM

#define ONEWIRE_CMD_MATCHROM 0x55

Definition at line 43 of file ds18b20.h.

◆ ONEWIRE_CMD_READROM

#define ONEWIRE_CMD_READROM 0x33

Definition at line 42 of file ds18b20.h.

◆ ONEWIRE_CMD_RECEEPROM

#define ONEWIRE_CMD_RECEEPROM 0xB8

Definition at line 39 of file ds18b20.h.

◆ ONEWIRE_CMD_RPWRSUPPLY

#define ONEWIRE_CMD_RPWRSUPPLY 0xB4

Definition at line 40 of file ds18b20.h.

◆ ONEWIRE_CMD_RSCRATCHPAD

#define ONEWIRE_CMD_RSCRATCHPAD 0xBE

Definition at line 36 of file ds18b20.h.

◆ ONEWIRE_CMD_SEARCHROM

#define ONEWIRE_CMD_SEARCHROM 0xF0

Definition at line 41 of file ds18b20.h.

◆ ONEWIRE_CMD_SKIPROM

#define ONEWIRE_CMD_SKIPROM 0xCC

Definition at line 44 of file ds18b20.h.

◆ ONEWIRE_CMD_WSCRATCHPAD

#define ONEWIRE_CMD_WSCRATCHPAD 0x4E

Definition at line 37 of file ds18b20.h.

Enumeration Type Documentation

◆ DS18B20_Resolution_t

enum DS18B20_Resolution_t

Enumerator
DS18B20_Resolution_9bits	DS18B20 9 bits resolution
DS18B20_Resolution_10bits	DS18B20 10 bits resolution
DS18B20_Resolution_11bits	DS18B20 11 bits resolution
DS18B20_Resolution_12bits	DS18B20 12 bits resolution
DS18B20_Resolution_9bits	DS18B20 9 bits resolution
DS18B20_Resolution_10bits	DS18B20 10 bits resolution
DS18B20_Resolution_11bits	DS18B20 11 bits resolution
DS18B20_Resolution_12bits	DS18B20 12 bits resolution

Definition at line 60 of file ds18b20.h.

             {
    DS18B20_Resolution_9bits = 9,   
    DS18B20_Resolution_10bits = 10, 
    DS18B20_Resolution_11bits = 11, 
    DS18B20_Resolution_12bits = 12  
} DS18B20_Resolution_t;

Function Documentation

◆ DS18B20_AllDone()

__BIT DS18B20_AllDone ( void )

If read bit is low, then device is not finished yet with calculation temperature.

Returns: bit value

Definition at line 183 of file ds18b20.c.

{
    /* If read bit is low, then device is not finished yet with calculation temperature */
    return DS18B20_ReadBit();
}

◆ DS18B20_Crc()

uint8_t DS18B20_Crc	(	uint8_t *	addr,
		uint8_t	len
	)

8-bit CRC calculation

Parameters

addr
len

Returns: crc result

Definition at line 151 of file ds18b20.c.

{
    uint8_t crc = 0, inbyte, i, mix;
 
    while (len--) 
    {
        inbyte = *addr++;
        for (i = 8; i; i--) 
        {
            mix = (crc ^ inbyte) & 0x01;
            crc >>= 1;
            if (mix) 
            {
                crc ^= 0x8C;
            }
            inbyte >>= 1;
        }
    }
    /* Return calculated CRC */
    return crc;
}

◆ DS18B20_Init()

void DS18B20_Init ( void )

Initialize DS18B20.

Definition at line 53 of file DS18B20_ATY.c.

{
    /*1.GPIOC口初始化*/
    RCC->APB2ENR |= 1 << 3;
    GPIOB->CRL &= 0x0FFFFFFF;
    GPIOB->CRL |= 0x30000000;
    GPIOB->ODR |= 1 << 7;
 
    /*2.检测DS18B20设备是否正常*/
    switch(DS18B20_CheckDevice())
    {
        case 0: printf("DS18B20_Init OK!\n"); break;
        case 1: printf("DS18B20设备响应复位信号失败！\n"); break;
        case 2: printf("DS18B20设备释放总线失败！\n"); break;
    }
}

◆ DS18B20_ReadBit()

__BIT DS18B20_ReadBit ( void )

Read one bit from DS18B20.

Returns: bit value

Definition at line 49 of file ds18b20.c.

{
    __BIT b = RESET;
 
    /* Line low */
    DS18B20_DQ = RESET;
    DS18B20_DQ_OUTPUT();
    SYS_DelayUs(2);
 
    /* Release line */
    DS18B20_DQ_INPUT();
    SYS_DelayUs(10);
 
    /* Read line value */
    if (DS18B20_DQ) {
        /* Bit is HIGH */
        b = SET;
    }
 
    /* Wait 50us to complete 60us period */
    SYS_DelayUs(50);
    
    /* Return bit value */
    return b;
}

◆ DS18B20_ReadByte()

uint8_t DS18B20_ReadByte ( void )

Read one byte from DS18B20.

Returns: byte value

Definition at line 143 of file DS18B20_ATY.c.

{
    u8 i, data = 0;
    for(i = 0; i < 8; i++)
    {
        DS18B20_OutPut_Mode();//初始化为输出模式
        DS18B20_OUT = 0;
        DelayUs(2);  //主机拉低总线读数据时间隙2us
        DS18B20_OUT = 1; //释放总线，准备读取位数据
        DS18B20_InPut_Mode(); //初始化为输入模式
        DelayUs(10); //等待DS18B20的数据输出
        data >>= 1;  //高位补0，默认以0为准
        if(DS18B20_IN) data |= 0x80;
        DelayUs(60); //延时确保DS18B20采样周期已经过去（非常重要）
        DS18B20_OUT = 1;  //释放总线准备读取下一位位数据
    }
    return data;
}

◆ DS18B20_ReadRom()

void DS18B20_ReadRom ( uint8_t * buf )

Read 64-bit ROM: 8-bit family code "0x28", unique 48-bit serial number, 8-bit CRC.

Note: This command can only be used if there is a single DS18B20 on the bus. If multiple slaves are present, a data collision will occur(a wired AND result).

Parameters

buf	a 8-byte buffer

Definition at line 189 of file ds18b20.c.

{
    uint8_t i = 0;
    /* Reset pulse */
    DS18B20_Reset();
    /* Read rom */
    DS18B20_WriteByte(ONEWIRE_CMD_READROM);
    /* Get data */
    for (i = 0; i < 8; i++) 
    {
        /* Read byte by byte */
        *buf++ = DS18B20_ReadByte();
    }
}

◆ DS18B20_ReadScratchpad()

void DS18B20_ReadScratchpad ( uint8_t * buf )

Read SRAM scratchpad.

Parameters

buf	a 9-byte buffer, Byte 8 contains the CRC code for bytes 0 through 7

Definition at line 133 of file ds18b20.c.

{
    uint8_t i = 0;
    /* Reset line */
    DS18B20_Reset();
    /* Skip ROM */
    DS18B20_WriteByte(ONEWIRE_CMD_SKIPROM);
    /* Read scratchpad command by onewire protocol */
    DS18B20_WriteByte(ONEWIRE_CMD_RSCRATCHPAD);
 
    /* Get data */
    for (i = 0; i < 9; i++) 
    {
        /* Read byte by byte */
        *buf++ = DS18B20_ReadByte();
    }
}

◆ DS18B20_ReadScratchpadFromAddr()

void DS18B20_ReadScratchpadFromAddr	(	const uint8_t *	addr,
		uint8_t *	buf
	)

Read SRAM scratchpad from selected slave.

Parameters

addr	64-bit ROM code
buf	a 9-byte buffer, Byte 8 contains the CRC code for bytes 0 through 7

Definition at line 224 of file ds18b20.c.

{
    uint8_t i = 0;
    /* Reset line */
    DS18B20_Reset();
    /* Select ROM number */
    DS18B20_Select(addr);
    /* Read scratchpad command by onewire protocol */
    DS18B20_WriteByte(ONEWIRE_CMD_RSCRATCHPAD);
 
    /* Get data */
    for (i = 0; i < 9; i++) 
    {
        /* Read byte by byte */
        *buf++ = DS18B20_ReadByte();
    }
}

◆ DS18B20_Reset()

__BIT DS18B20_Reset ( void )

Reset DS18B20.

Returns: bit value

Definition at line 30 of file ds18b20.c.

{
    __BIT b;
 
    /* Line low, and wait 480us */
    DS18B20_DQ = RESET;
    DS18B20_DQ_OUTPUT();
    SYS_DelayUs(500);
    /* Release line and wait for 70us */
    DS18B20_DQ_INPUT();
    SYS_DelayUs(70);
    /* Check bit value, success if low */
    b = DS18B20_DQ;
    /* Delay for 410 us */
    SYS_DelayUs(410);
    /* Return value of presence pulse, 0 = OK, 1 = ERROR */
    return b;
}

◆ DS18B20_Search()

uint8_t DS18B20_Search	(	uint8_t *	buff,
		uint8_t *	stack,
		uint8_t	split_point
	)

Perform one ROM search.

Parameters

buff	8-byte array for ROM bytes
stack	8-byte array for search stack
split_point	deepest split point of last search

Returns: new split point

Definition at line 242 of file ds18b20.c.

{
    uint8_t len = 64, pos = 0;
    /* Start from deepest point */
    split_point = (split_point == 0x00)? 0xFF : split_point;
    /* Reset line */
    DS18B20_Reset();
    /* Start searching */
    DS18B20_WriteByte(ONEWIRE_CMD_SEARCHROM);
 
    while (len--)
    {
        // Read the value and its complement value of this bit
        __BIT pb = DS18B20_ReadBit();
        __BIT cb = DS18B20_ReadBit();
        if (pb && cb) // no device
        {
            return 0;
        }
        else if (pb) // bit = 1
        {
            *(buff + pos / 8) |= 0x01 << (pos % 8);
            DS18B20_WriteBit(SET);
            // confirm: set this bit to 1
            *(stack + pos / 8) |= 0x01 << (pos % 8);
        }
        else if (cb) // bit = 0
        {
            *(buff + pos / 8) &= ~(0x01 << (pos % 8));
            DS18B20_WriteBit(RESET);
            // confirm: set this bit to 1
            *(stack + pos / 8) |= 0x01 << (pos % 8);
        }
        else // bit can be 0 or 1, possible split point
        {
            if (split_point == 0xFF || pos > split_point)
            {
                // new split point, try 0
                *(buff + pos / 8) &= ~(0x01 << (pos % 8));
                DS18B20_WriteBit(RESET);
                // unconfirm: set this bit to 0
                *(stack + pos / 8) &= ~(0x01 << (pos % 8));
                // record this new split point
                split_point = pos;
            }
            else if (pos == split_point)
            {
                // reach split point, try 1
                *(buff + pos / 8) |= 0x01 << (pos % 8);
                DS18B20_WriteBit(SET);
                // confirm: set this bit to 1
                *(stack + pos / 8) |= 0x01 << (pos % 8);
            }
            else // middle point, use existing bit
            {
                DS18B20_WriteBit(*(buff + pos / 8) >> (pos % 8) & 0x01);
            }
        }
        pos++;
    }
    // Relocate split point, move it to the last *unconfirmed* bit of stack
    while (split_point > 0 && *(stack + split_point / 8) >> (split_point % 8) & 0x01 == 0x01) split_point--;
    return split_point;
}

◆ DS18B20_Select()

void DS18B20_Select ( const uint8_t * addr )

Select a slave on the bus.

Note: Only the slave that exactly matches the 64-bit ROM code sequence will respond to the function command issued by the master; all other slaves on the bus will wait for a reset pulse.

Parameters

addr	64-bit ROM code

Definition at line 204 of file ds18b20.c.

{
    uint8_t len = 8;
    DS18B20_WriteByte(ONEWIRE_CMD_MATCHROM);
    while (len--)
    {
        DS18B20_WriteByte(*addr++);
    }
}

◆ DS18B20_Start()

void DS18B20_Start ( const uint8_t * addr )

Start conversion on selected slave.

Parameters

addr	64-bit ROM code

Definition at line 214 of file ds18b20.c.

{
    /* Reset pulse */
    DS18B20_Reset();
    /* Select ROM number */
    DS18B20_Select(addr);
    /* Start conversion on selected device */
    DS18B20_WriteByte(DS18B20_CMD_CONVERTTEMP);
}

◆ DS18B20_StartAll()

void DS18B20_StartAll ( void )

Start conversion on all slaves.

Definition at line 173 of file ds18b20.c.

{
    /* Reset pulse */
    DS18B20_Reset();
    /* Skip rom */
    DS18B20_WriteByte(ONEWIRE_CMD_SKIPROM);
    /* Start conversion on all connected devices */
    DS18B20_WriteByte(DS18B20_CMD_CONVERTTEMP);
}

◆ DS18B20_WriteBit()

void DS18B20_WriteBit ( __BIT b )

Write one bit to DS18B20.

Parameters

b bit value

Definition at line 89 of file ds18b20.c.

{
    if (b)
    {
        /* Set line low */
        DS18B20_DQ = RESET;
        DS18B20_DQ_OUTPUT();
        SYS_DelayUs(10);
 
        /* Bit high */
        DS18B20_DQ_INPUT();
        
        /* Wait for 55 us and release the line */
        SYS_DelayUs(55);
        DS18B20_DQ_INPUT();
    } 
    else 
    {
        /* Set line low */
        DS18B20_DQ = RESET;
        DS18B20_DQ_OUTPUT();
        SYS_DelayUs(65);
        
        /* Bit high */
        DS18B20_DQ_INPUT();
        
        /* Wait for 5 us and release the line */
        SYS_DelayUs(5);
        DS18B20_DQ_INPUT();
    }
}

◆ DS18B20_WriteByte()

void DS18B20_WriteByte ( uint8_t byte )

Write one byte to DS18B20.

Parameters

byte	byte value

Definition at line 121 of file ds18b20.c.

{
    uint8_t i = 8;
    /* Write 8 bits */
    while (i--) 
    {
        /* LSB bit is first */
        DS18B20_WriteBit(byte & 0x01);
        byte >>= 1;
    }
}

Macros

Enumerations

Functions

Macro Definition Documentation

◆ DS18B20_CMD_ALARMSEARCH

◆ DS18B20_CMD_CONVERTTEMP

◆ DS18B20_DECIMAL_STEPS_10BIT

◆ DS18B20_DECIMAL_STEPS_11BIT

◆ DS18B20_DECIMAL_STEPS_12BIT

◆ DS18B20_DECIMAL_STEPS_9BIT

◆ DS18B20_DQ

◆ DS18B20_DQ_HIGH

◆ DS18B20_DQ_INPUT

◆ DS18B20_DQ_LOW

◆ DS18B20_DQ_OUTPUT

◆ DS18B20_DQ_PULLUP

◆ DS18B20_FAMILY_CODE

◆ DS18B20_RESOLUTION_R0

◆ DS18B20_RESOLUTION_R1

◆ ONEWIRE_CMD_CPYSCRATCHPAD

◆ ONEWIRE_CMD_MATCHROM

◆ ONEWIRE_CMD_READROM

◆ ONEWIRE_CMD_RECEEPROM

◆ ONEWIRE_CMD_RPWRSUPPLY

◆ ONEWIRE_CMD_RSCRATCHPAD

◆ ONEWIRE_CMD_SEARCHROM

◆ ONEWIRE_CMD_SKIPROM

◆ ONEWIRE_CMD_WSCRATCHPAD

Enumeration Type Documentation

◆ DS18B20_Resolution_t

Function Documentation

◆ DS18B20_AllDone()

◆ DS18B20_Crc()

◆ DS18B20_Init()

◆ DS18B20_ReadBit()

◆ DS18B20_ReadByte()

◆ DS18B20_ReadRom()

◆ DS18B20_ReadScratchpad()

◆ DS18B20_ReadScratchpadFromAddr()

◆ DS18B20_Reset()

◆ DS18B20_Search()

◆ DS18B20_Select()

◆ DS18B20_Start()

◆ DS18B20_StartAll()

◆ DS18B20_WriteBit()

◆ DS18B20_WriteByte()