Files
OpenCellular/driver/temp_sensor/tmp432.c
Ben Lok a572c882e4 driver/temp_sensor: Add power control API for TMP432
Some boards didn't define the CONFIG_TEMP_SENSOR_POWER_GPIO (such as: Oak),
Due to the hardware design, the power of temp sensor is always on.
But, we can enable/disable the temperature measurement circuitry of tmp432 by
setup the shutdown (SD) bit. Add a new API: tmp432_set_power() to let upper
layer to control the power of tmp432 by SW approach for power saving.

BRANCH=none
BUG=chrome-os-partner:44170
TEST=manual
1. make BOARD=oak -j
2. Turn off the TMP432:
   > tmp432 power off
3. check whether tmp432 is shutdown:
   > tmp432
   ERROR: Temp sensor not powered.
   Not Powered
4. Turn on the TMP432:
   > tmp432 power on
5. check whether tmp432 is running:
   > tmp432
   Local:
     Temp        29C
     Therm Trip  85C
     High Alarm  85C
     Low Alarm    0C
   Remote1:
     Temp        27C
     Therm Trip  85C
     High Alarm  85C
     Low Alarm    0C
   Remote2:
     Temp        27C
     Therm Trip  85C
     High Alarm  85C
     Low Alarm    0C

   STATUS:  10000000
   CONFIG1: 00000000
   CONFIG2: 00111100

Change-Id: Iab95c4c0b0130baf3bce380a8132e08ded8d159e
Signed-off-by: Ben Lok <ben.lok@mediatek.com>
Reviewed-on: https://chromium-review.googlesource.com/295058
Reviewed-by: Rong Chang <rongchang@chromium.org>
2015-09-03 04:24:33 -07:00

288 lines
6.5 KiB
C

/* Copyright (c) 2013 The Chromium OS Authors. All rights reserved.
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
/* TMP432 temperature sensor module for Chrome EC */
#include "common.h"
#include "console.h"
#include "tmp432.h"
#include "gpio.h"
#include "i2c.h"
#include "hooks.h"
#include "util.h"
static int temp_val_local;
static int temp_val_remote1;
static int temp_val_remote2;
static uint8_t is_sensor_shutdown;
/**
* Determine whether the sensor is powered.
*
* @return non-zero the tmp432 sensor is powered.
*/
static int has_power(void)
{
#ifdef CONFIG_TEMP_SENSOR_POWER_GPIO
return gpio_get_level(CONFIG_TEMP_SENSOR_POWER_GPIO);
#else
return !is_sensor_shutdown;
#endif
}
static int raw_read8(const int offset, int *data_ptr)
{
return i2c_read8(I2C_PORT_THERMAL, TMP432_I2C_ADDR, offset, data_ptr);
}
static int raw_write8(const int offset, int data)
{
return i2c_write8(I2C_PORT_THERMAL, TMP432_I2C_ADDR, offset, data);
}
static int get_temp(const int offset, int *temp_ptr)
{
int rv;
int temp_raw = 0;
rv = raw_read8(offset, &temp_raw);
if (rv < 0)
return rv;
*temp_ptr = (int)(int8_t)temp_raw;
return EC_SUCCESS;
}
#ifdef CONFIG_CMD_TEMP_SENSOR
static int tmp432_set_temp(const int offset, int temp)
{
if (temp < -127 || temp > 127)
return EC_ERROR_INVAL;
return raw_write8(offset, (uint8_t)temp);
}
#endif
int tmp432_get_val(int idx, int *temp_ptr)
{
if (!has_power())
return EC_ERROR_NOT_POWERED;
switch (idx) {
case TMP432_IDX_LOCAL:
*temp_ptr = temp_val_local;
break;
case TMP432_IDX_REMOTE1:
*temp_ptr = temp_val_remote1;
break;
case TMP432_IDX_REMOTE2:
*temp_ptr = temp_val_remote2;
break;
default:
return EC_ERROR_UNKNOWN;
}
return EC_SUCCESS;
}
static int tmp432_shutdown(uint8_t want_shutdown)
{
int ret, value;
if (want_shutdown == is_sensor_shutdown)
return EC_SUCCESS;
ret = raw_read8(TMP432_CONFIGURATION1_R, &value);
if (ret < 0) {
ccprintf("ERROR: Temp sensor I2C read8 error.\n");
return ret;
}
if (want_shutdown && !(value & TMP432_CONFIG1_RUN_L)) {
/* tmp432 is running, and want it to shutdown */
/* CONFIG REG1 BIT6: 0=Run, 1=Shutdown */
/* shut it down */
value |= TMP432_CONFIG1_RUN_L;
ret = raw_write8(TMP432_CONFIGURATION1_R, value);
} else if (!want_shutdown && (value & TMP432_CONFIG1_RUN_L)) {
/* tmp432 is shutdown, and want turn it on */
value &= ~TMP432_CONFIG1_RUN_L;
ret = raw_write8(TMP432_CONFIGURATION1_R, value);
}
/* else, the current setting is exactly what you want */
is_sensor_shutdown = want_shutdown;
return ret;
}
static void temp_sensor_poll(void)
{
int temp_c;
if (!has_power())
return;
if (get_temp(TMP432_LOCAL, &temp_c) == EC_SUCCESS)
temp_val_local = C_TO_K(temp_c);
if (get_temp(TMP432_REMOTE1, &temp_c) == EC_SUCCESS)
temp_val_remote1 = C_TO_K(temp_c);
if (get_temp(TMP432_REMOTE2, &temp_c) == EC_SUCCESS)
temp_val_remote2 = C_TO_K(temp_c);
}
DECLARE_HOOK(HOOK_SECOND, temp_sensor_poll, HOOK_PRIO_TEMP_SENSOR);
#ifdef CONFIG_CMD_TEMP_SENSOR
static void print_temps(
const char *name,
const int tmp432_temp_reg,
const int tmp432_therm_limit_reg,
const int tmp432_high_limit_reg,
const int tmp432_low_limit_reg)
{
int value;
if (!has_power()) {
ccprintf(" TMP432 is shutdown\n");
return;
}
ccprintf("%s:\n", name);
if (get_temp(tmp432_temp_reg, &value) == EC_SUCCESS)
ccprintf(" Temp %3dC\n", value);
if (get_temp(tmp432_therm_limit_reg, &value) == EC_SUCCESS)
ccprintf(" Therm Trip %3dC\n", value);
if (get_temp(tmp432_high_limit_reg, &value) == EC_SUCCESS)
ccprintf(" High Alarm %3dC\n", value);
if (get_temp(tmp432_low_limit_reg, &value) == EC_SUCCESS)
ccprintf(" Low Alarm %3dC\n", value);
}
static int print_status(void)
{
int value;
print_temps("Local", TMP432_LOCAL,
TMP432_LOCAL_THERM_LIMIT,
TMP432_LOCAL_HIGH_LIMIT_R,
TMP432_LOCAL_LOW_LIMIT_R);
print_temps("Remote1", TMP432_REMOTE1,
TMP432_REMOTE1_THERM_LIMIT,
TMP432_REMOTE1_HIGH_LIMIT_R,
TMP432_REMOTE1_LOW_LIMIT_R);
print_temps("Remote2", TMP432_REMOTE2,
TMP432_REMOTE2_THERM_LIMIT,
TMP432_REMOTE2_HIGH_LIMIT_R,
TMP432_REMOTE2_LOW_LIMIT_R);
ccprintf("\n");
if (raw_read8(TMP432_STATUS, &value) == EC_SUCCESS)
ccprintf("STATUS: %08b\n", value);
if (raw_read8(TMP432_CONFIGURATION1_R, &value) == EC_SUCCESS)
ccprintf("CONFIG1: %08b\n", value);
if (raw_read8(TMP432_CONFIGURATION2_R, &value) == EC_SUCCESS)
ccprintf("CONFIG2: %08b\n", value);
return EC_SUCCESS;
}
static int command_tmp432(int argc, char **argv)
{
char *command;
char *e;
char *power;
int data;
int offset;
int rv;
/* handle "power" command before checking the power status. */
if ((argc == 3) && !strcasecmp(argv[1], "power")) {
power = argv[2];
if (!strncasecmp(power, "on", sizeof("on"))) {
rv = tmp432_set_power(TMP432_POWER_ON);
if (!rv)
print_status();
}
else if (!strncasecmp(power, "off", sizeof("off")))
rv = tmp432_set_power(TMP432_POWER_OFF);
else
return EC_ERROR_PARAM2;
ccprintf("Set TMP432 %s\n", power);
return rv;
}
if (!has_power()) {
ccprintf("ERROR: Temp sensor not powered.\n");
return EC_ERROR_NOT_POWERED;
}
/* If no args just print status */
if (argc == 1)
return print_status();
if (argc < 3)
return EC_ERROR_PARAM_COUNT;
command = argv[1];
offset = strtoi(argv[2], &e, 0);
if (*e || offset < 0 || offset > 255)
return EC_ERROR_PARAM2;
if (!strcasecmp(command, "getbyte")) {
rv = raw_read8(offset, &data);
if (rv < 0)
return rv;
ccprintf("Byte at offset 0x%02x is %08b\n", offset, data);
return rv;
}
/* Remaining commands are "tmp432 set-command offset data" */
if (argc != 4)
return EC_ERROR_PARAM_COUNT;
data = strtoi(argv[3], &e, 0);
if (*e)
return EC_ERROR_PARAM3;
if (!strcasecmp(command, "settemp")) {
ccprintf("Setting 0x%02x to %dC\n", offset, data);
rv = tmp432_set_temp(offset, data);
} else if (!strcasecmp(command, "setbyte")) {
ccprintf("Setting 0x%02x to 0x%02x\n", offset, data);
rv = raw_write8(offset, data);
} else
return EC_ERROR_PARAM1;
return rv;
}
DECLARE_CONSOLE_COMMAND(tmp432, command_tmp432,
"[settemp|setbyte <offset> <value>] or [getbyte <offset>] or"
"[power <on|off>]. "
"Temps in Celsius.",
"Print tmp432 temp sensor status or set parameters.", NULL);
#endif
int tmp432_set_power(enum tmp432_power_state power_on)
{
#ifndef CONFIG_TEMP_SENSOR_POWER_GPIO
uint8_t shutdown = (power_on == TMP432_POWER_OFF) ? 1 : 0;
return tmp432_shutdown(shutdown);
#else
gpio_set_level(CONFIG_TEMP_SENSOR_POWER_GPIO, power_on);
return EC_SUCCESS;
#endif
}