David Jung / DS7505_Low_Voltage_Temperature_Sensor

DS7505 C, C++ driver source code: The DS7505 low-voltage (1.7V to 3.7V) digital thermometer and thermostat provides 9 to 12-bit digital temperature readings over a -55°C to +125°C range with +-0.5°C accuracy in the 0°C (32°F) to +70°C (158°F) range.

Dependents:   DS7505_Temperature_Sensor_Low_Power

ds7505_cpp.cpp@25:93287f99d225, 2019-04-27 (annotated)

Committer:
phonemacro
Date:
Sat Apr 27 09:50:48 2019 +0000
Revision:
25:93287f99d225
Initial Commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
phonemacro 25:93287f99d225 1 /*******************************************************************************
phonemacro 25:93287f99d225 2 * Copyright (C) 2019 Maxim Integrated Products, Inc., All Rights Reserved.
phonemacro 25:93287f99d225 3 *
phonemacro 25:93287f99d225 4 * Permission is hereby granted, free of charge, to any person obtaining a
phonemacro 25:93287f99d225 5 * copy of this software and associated documentation files (the "Software"),
phonemacro 25:93287f99d225 6 * to deal in the Software without restriction, including without limitation
phonemacro 25:93287f99d225 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
phonemacro 25:93287f99d225 8 * and/or sell copies of the Software, and to permit persons to whom the
phonemacro 25:93287f99d225 9 * Software is furnished to do so, subject to the following conditions:
phonemacro 25:93287f99d225 10 *
phonemacro 25:93287f99d225 11 * The above copyright notice and this permission notice shall be included
phonemacro 25:93287f99d225 12 * in all copies or substantial portions of the Software.
phonemacro 25:93287f99d225 13 *
phonemacro 25:93287f99d225 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
phonemacro 25:93287f99d225 15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
phonemacro 25:93287f99d225 16 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
phonemacro 25:93287f99d225 17 * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
phonemacro 25:93287f99d225 18 * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
phonemacro 25:93287f99d225 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
phonemacro 25:93287f99d225 20 * OTHER DEALINGS IN THE SOFTWARE.
phonemacro 25:93287f99d225 21 *
phonemacro 25:93287f99d225 22 * Except as contained in this notice, the name of Maxim Integrated
phonemacro 25:93287f99d225 23 * Products, Inc. shall not be used except as stated in the Maxim Integrated
phonemacro 25:93287f99d225 24 * Products, Inc. Branding Policy.
phonemacro 25:93287f99d225 25 *
phonemacro 25:93287f99d225 26 * The mere transfer of this software does not imply any licenses
phonemacro 25:93287f99d225 27 * of trade secrets, proprietary technology, copyrights, patents,
phonemacro 25:93287f99d225 28 * trademarks, maskwork rights, or any other form of intellectual
phonemacro 25:93287f99d225 29 * property whatsoever. Maxim Integrated Products, Inc. retains all
phonemacro 25:93287f99d225 30 * ownership rights.
phonemacro 25:93287f99d225 31 *******************************************************************************
phonemacro 25:93287f99d225 32 */
phonemacro 25:93287f99d225 33 #include "ds7505.h"
phonemacro 25:93287f99d225 34 #include "ds7505_cpp.h"
phonemacro 25:93287f99d225 35 #include "mbed.h"
phonemacro 25:93287f99d225 36 // #include "USBSerial.h"
phonemacro 25:93287f99d225 37
phonemacro 25:93287f99d225 38 /******************************************************************************
phonemacro 25:93287f99d225 39 * C++ version for DS7505 driver *
phonemacro 25:93287f99d225 40 ******************************************************************************
phonemacro 25:93287f99d225 41 */
phonemacro 25:93287f99d225 42
phonemacro 25:93287f99d225 43 /******************************************************************************/
phonemacro 25:93287f99d225 44 DS7505::DS7505(I2C &i2c_bus, uint8_t slave_address):
phonemacro 25:93287f99d225 45 m_i2c(i2c_bus),
phonemacro 25:93287f99d225 46 m_write_address(slave_address <<1),
phonemacro 25:93287f99d225 47 m_read_address ((slave_address << 1) | 1)
phonemacro 25:93287f99d225 48 {
phonemacro 25:93287f99d225 49 }
phonemacro 25:93287f99d225 50
phonemacro 25:93287f99d225 51 /******************************************************************************/
phonemacro 25:93287f99d225 52 DS7505::~DS7505(void)
phonemacro 25:93287f99d225 53 {
phonemacro 25:93287f99d225 54 /** empty block */
phonemacro 25:93287f99d225 55 }
phonemacro 25:93287f99d225 56
phonemacro 25:93287f99d225 57 /******************************************************************************/
phonemacro 25:93287f99d225 58 int DS7505::read_cfg_reg(uint8_t *value)
phonemacro 25:93287f99d225 59 {
phonemacro 25:93287f99d225 60 int32_t ret;
phonemacro 25:93287f99d225 61 char data[1] = {0};
phonemacro 25:93287f99d225 62 char reg = DS7505_REG_CONFIGURATION;
phonemacro 25:93287f99d225 63
phonemacro 25:93287f99d225 64 /* write to the Register Select, true is for repeated start */
phonemacro 25:93287f99d225 65 ret = m_i2c.write(m_write_address, &reg, 1, true);
phonemacro 25:93287f99d225 66 if (ret == 0) {
phonemacro 25:93287f99d225 67 ret = m_i2c.read(m_read_address, data, 1, false);
phonemacro 25:93287f99d225 68 if (ret == 0) {
phonemacro 25:93287f99d225 69 *value = data[0];
phonemacro 25:93287f99d225 70 return DS7505_NO_ERROR;
phonemacro 25:93287f99d225 71 } else {
phonemacro 25:93287f99d225 72 printf(
phonemacro 25:93287f99d225 73 "%s: failed to read data: ret: %d\r\n", __func__, ret);
phonemacro 25:93287f99d225 74 }
phonemacro 25:93287f99d225 75 } else {
phonemacro 25:93287f99d225 76 printf("%s: failed to write to Register Select: ret: %d\r\n",
phonemacro 25:93287f99d225 77 __func__, ret);
phonemacro 25:93287f99d225 78 }
phonemacro 25:93287f99d225 79 return DS7505_ERROR;
phonemacro 25:93287f99d225 80 }
phonemacro 25:93287f99d225 81
phonemacro 25:93287f99d225 82 /******************************************************************************/
phonemacro 25:93287f99d225 83 int DS7505::read_reg16(int16_t *value, char reg)
phonemacro 25:93287f99d225 84 {
phonemacro 25:93287f99d225 85 int32_t ret;
phonemacro 25:93287f99d225 86 char data[2] = {0, 0};
phonemacro 25:93287f99d225 87 ds7505_raw_data tmp;
phonemacro 25:93287f99d225 88
phonemacro 25:93287f99d225 89 if (reg == DS7505_REG_TEMPERATURE ||
phonemacro 25:93287f99d225 90 reg == DS7505_REG_THYST_LOW_TRIP || reg == DS7505_REG_TOS_HIGH_TRIP) {
phonemacro 25:93287f99d225 91 /* write to the Register Select, true is for repeated start */
phonemacro 25:93287f99d225 92 ret = m_i2c.write(m_write_address, &reg, 1, true);
phonemacro 25:93287f99d225 93 /* read the two bytes of data */
phonemacro 25:93287f99d225 94 if (ret == 0) {
phonemacro 25:93287f99d225 95 ret = m_i2c.read(m_read_address, data, 2, false);
phonemacro 25:93287f99d225 96 if (ret == 0) {
phonemacro 25:93287f99d225 97 tmp.msb = data[0];
phonemacro 25:93287f99d225 98 tmp.lsb = data[1];
phonemacro 25:93287f99d225 99 *value = tmp.swrd;
phonemacro 25:93287f99d225 100 return DS7505_NO_ERROR;
phonemacro 25:93287f99d225 101 } else {
phonemacro 25:93287f99d225 102 printf(
phonemacro 25:93287f99d225 103 "%s: failed to read data: ret: %d\r\n", __func__, ret);
phonemacro 25:93287f99d225 104 }
phonemacro 25:93287f99d225 105 } else {
phonemacro 25:93287f99d225 106 printf("%s: failed to write to Register Select: ret: %d\r\n",
phonemacro 25:93287f99d225 107 __func__, ret);
phonemacro 25:93287f99d225 108 }
phonemacro 25:93287f99d225 109 } else {
phonemacro 25:93287f99d225 110 printf("%s: register address is not correct: register: %d\r\n",
phonemacro 25:93287f99d225 111 __func__, reg);
phonemacro 25:93287f99d225 112 }
phonemacro 25:93287f99d225 113 return DS7505_ERROR;
phonemacro 25:93287f99d225 114 }
phonemacro 25:93287f99d225 115
phonemacro 25:93287f99d225 116 /******************************************************************************/
phonemacro 25:93287f99d225 117 float DS7505::read_reg_as_temperature(uint8_t reg)
phonemacro 25:93287f99d225 118 {
phonemacro 25:93287f99d225 119 ds7505_raw_data tmp;
phonemacro 25:93287f99d225 120 float temperature;
phonemacro 25:93287f99d225 121 if (reg == DS7505_REG_TEMPERATURE ||
phonemacro 25:93287f99d225 122 reg == DS7505_REG_THYST_LOW_TRIP || reg == DS7505_REG_TOS_HIGH_TRIP) {
phonemacro 25:93287f99d225 123 read_reg16(&tmp.swrd, reg);
phonemacro 25:93287f99d225 124 temperature = (float)tmp.swrd; /* values are 2's complement */
phonemacro 25:93287f99d225 125 temperature *= DS7505_CF_LSB;
phonemacro 25:93287f99d225 126 return temperature;
phonemacro 25:93287f99d225 127 } else {
phonemacro 25:93287f99d225 128 printf("%s: register is invalid, %d r\n", __func__, reg);
phonemacro 25:93287f99d225 129 return 0;
phonemacro 25:93287f99d225 130 }
phonemacro 25:93287f99d225 131 }
phonemacro 25:93287f99d225 132
phonemacro 25:93287f99d225 133 /******************************************************************************/
phonemacro 25:93287f99d225 134 int DS7505::write_reg16(int16_t value, char reg)
phonemacro 25:93287f99d225 135 {
phonemacro 25:93287f99d225 136 int32_t ret;
phonemacro 25:93287f99d225 137 char cmd[3];
phonemacro 25:93287f99d225 138 ds7505_raw_data tmp;
phonemacro 25:93287f99d225 139
phonemacro 25:93287f99d225 140 if (reg >= DS7505_REG_THYST_LOW_TRIP && reg <= DS7505_REG_MAX) {
phonemacro 25:93287f99d225 141 cmd[0] = reg;
phonemacro 25:93287f99d225 142 tmp.swrd = value;
phonemacro 25:93287f99d225 143 cmd[1] = tmp.msb;
phonemacro 25:93287f99d225 144 cmd[2] = tmp.lsb;
phonemacro 25:93287f99d225 145 ret = m_i2c.write(m_write_address, cmd, 3, false);
phonemacro 25:93287f99d225 146 if (ret == 0) {
phonemacro 25:93287f99d225 147 return DS7505_NO_ERROR;
phonemacro 25:93287f99d225 148 } else {
phonemacro 25:93287f99d225 149 printf("%s: I2C write error %d\r\n",__func__, ret);
phonemacro 25:93287f99d225 150 return DS7505_ERROR;
phonemacro 25:93287f99d225 151 }
phonemacro 25:93287f99d225 152 } else {
phonemacro 25:93287f99d225 153 printf("%s: register value invalid %x\r\n",__func__, reg);
phonemacro 25:93287f99d225 154 return DS7505_ERROR;
phonemacro 25:93287f99d225 155 }
phonemacro 25:93287f99d225 156 }
phonemacro 25:93287f99d225 157
phonemacro 25:93287f99d225 158
phonemacro 25:93287f99d225 159 /******************************************************************************/
phonemacro 25:93287f99d225 160 int DS7505::write_cfg_reg(uint8_t cfg)
phonemacro 25:93287f99d225 161 {
phonemacro 25:93287f99d225 162 int32_t ret;
phonemacro 25:93287f99d225 163 char cmd[2];
phonemacro 25:93287f99d225 164
phonemacro 25:93287f99d225 165 cmd[0] = DS7505_REG_CONFIGURATION;
phonemacro 25:93287f99d225 166 cmd[1] = cfg;
phonemacro 25:93287f99d225 167 ret = m_i2c.write(m_write_address, cmd, 2, false);
phonemacro 25:93287f99d225 168 if (ret == 0) {
phonemacro 25:93287f99d225 169 return DS7505_NO_ERROR;
phonemacro 25:93287f99d225 170 } else {
phonemacro 25:93287f99d225 171 printf("%s: I2C write error %d\r\n",__func__, ret);
phonemacro 25:93287f99d225 172 return DS7505_ERROR;
phonemacro 25:93287f99d225 173 }
phonemacro 25:93287f99d225 174 }
phonemacro 25:93287f99d225 175
phonemacro 25:93287f99d225 176 /******************************************************************************/
phonemacro 25:93287f99d225 177 int DS7505::write_trip_low_thyst(float temperature)
phonemacro 25:93287f99d225 178 {
phonemacro 25:93287f99d225 179 ds7505_raw_data raw;
phonemacro 25:93287f99d225 180 temperature /= DS7505_CF_LSB;
phonemacro 25:93287f99d225 181 raw.swrd = int16_t(temperature);
phonemacro 25:93287f99d225 182 return write_reg16(raw.swrd, DS7505_REG_THYST_LOW_TRIP);
phonemacro 25:93287f99d225 183 }
phonemacro 25:93287f99d225 184
phonemacro 25:93287f99d225 185 /******************************************************************************/
phonemacro 25:93287f99d225 186 int DS7505::write_trip_high_tos(float temperature)
phonemacro 25:93287f99d225 187 {
phonemacro 25:93287f99d225 188 ds7505_raw_data raw;
phonemacro 25:93287f99d225 189 temperature /= DS7505_CF_LSB;
phonemacro 25:93287f99d225 190 raw.swrd = int16_t(temperature);
phonemacro 25:93287f99d225 191 return write_reg16(raw.uwrd, DS7505_REG_TOS_HIGH_TRIP);
phonemacro 25:93287f99d225 192 }
phonemacro 25:93287f99d225 193
phonemacro 25:93287f99d225 194 /******************************************************************************/
phonemacro 25:93287f99d225 195 float DS7505::celsius_to_fahrenheit(float temp_c)
phonemacro 25:93287f99d225 196 {
phonemacro 25:93287f99d225 197 float temp_f;
phonemacro 25:93287f99d225 198 temp_f = ((temp_c * 9)/5) + 32;
phonemacro 25:93287f99d225 199 return temp_f;
phonemacro 25:93287f99d225 200 }