ds18b20.h

Go to the documentation of this file.

// Copyright 2021 IOsetting <iosetting(at)outlook.com>
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
 
#ifndef __FW_DS18B20__
#define __FW_DS18B20__
 
#include "fw_hal.h"
 
#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
 
/* OneWire commands */
#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
 
/* DS18B20 read temperature command */
#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
 
/* Bits locations for resolution */
#define DS18B20_RESOLUTION_R1               6
#define DS18B20_RESOLUTION_R0               5
 
typedef enum {
    DS18B20_Resolution_9bits = 9,   
    DS18B20_Resolution_10bits = 10, 
    DS18B20_Resolution_11bits = 11, 
    DS18B20_Resolution_12bits = 12  
} DS18B20_Resolution_t;
 
void DS18B20_Init(void);
 
__BIT DS18B20_Reset(void);
 
__BIT DS18B20_ReadBit(void);
 
uint8_t DS18B20_ReadByte(void);
 
void DS18B20_WriteBit(__BIT b);
 
void DS18B20_WriteByte(uint8_t byte);
 
uint8_t DS18B20_Crc(uint8_t *addr, uint8_t len);
 
void DS18B20_ReadScratchpad(uint8_t *buf);
 
void DS18B20_StartAll(void);
 
__BIT DS18B20_AllDone(void);
 
void DS18B20_ReadRom(uint8_t *buf);
 
void DS18B20_Select(const uint8_t* addr);
 
void DS18B20_Start(const uint8_t *addr);
 
void DS18B20_ReadScratchpadFromAddr(const uint8_t *addr, uint8_t *buf);
 
uint8_t DS18B20_Search(uint8_t *buff, uint8_t *stack, uint8_t split_point);
 
#endif // __DS18B20_H_