freebsd-skq/sys/dev/iicbus/adt746x.c
Oleksandr Tymoshenko 217d17bcd3 Clean up OF_getprop_alloc API
OF_getprop_alloc takes element size argument and returns number of
elements in the property. There are valid use cases for such behavior
but mostly API consumers pass 1 as element size to get string
properties. What API users would expect from OF_getprop_alloc is to be
a combination of malloc + OF_getprop with the same semantic of return
value. This patch modifies API signature to match these expectations.

For the valid use cases with element size != 1 and to reduce
modification scope new OF_getprop_alloc_multi function has been
introduced that behaves the same way OF_getprop_alloc behaved prior to
this patch.

Reviewed by:	ian, manu
Differential Revision:	https://reviews.freebsd.org/D14850
2018-04-08 22:59:34 +00:00

668 lines
17 KiB
C

/*-
* SPDX-License-Identifier: BSD-2-Clause-FreeBSD
*
* Copyright (c) 2012 Andreas Tobler
* Copyright (c) 2014 Justin Hibbits
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
#include <sys/cdefs.h>
__FBSDID("$FreeBSD$");
#include <sys/param.h>
#include <sys/bus.h>
#include <sys/systm.h>
#include <sys/module.h>
#include <sys/callout.h>
#include <sys/conf.h>
#include <sys/cpu.h>
#include <sys/ctype.h>
#include <sys/kernel.h>
#include <sys/reboot.h>
#include <sys/rman.h>
#include <sys/sysctl.h>
#include <sys/limits.h>
#include <machine/bus.h>
#include <machine/md_var.h>
#include <dev/iicbus/iicbus.h>
#include <dev/iicbus/iiconf.h>
#include <dev/ofw/openfirm.h>
#include <dev/ofw/ofw_bus.h>
#include <powerpc/powermac/powermac_thermal.h>
/* ADT746X registers. */
#define ADT746X_TACH1LOW 0x28
#define ADT746X_TACH1HIGH 0x29
#define ADT746X_TACH2LOW 0x2a
#define ADT746X_TACH2HIGH 0x2b
#define ADT746X_PWM1 0x30
#define ADT746X_PWM2 0x31
#define ADT746X_DEVICE_ID 0x3d
#define ADT746X_COMPANY_ID 0x3e
#define ADT746X_REV_ID 0x3f
#define ADT746X_CONFIG 0x40
#define ADT746X_PWM1_CONF 0x5c
#define ADT746X_PWM2_CONF 0x5d
#define ADT746X_MANUAL_MASK 0xe0
#define ADT7460_DEV_ID 0x27
#define ADT7467_DEV_ID 0x68
struct adt746x_fan {
struct pmac_fan fan;
device_t dev;
int id;
int setpoint;
int pwm_reg;
int conf_reg;
};
struct adt746x_sensor {
struct pmac_therm therm;
device_t dev;
int id;
cell_t reg;
enum {
ADT746X_SENSOR_TEMP,
ADT746X_SENSOR_VOLT,
ADT746X_SENSOR_SPEED
} type;
};
struct adt746x_softc {
device_t sc_dev;
struct intr_config_hook enum_hook;
uint32_t sc_addr;
/* The 7467 supports up to 4 fans, 2 voltage and 3 temperature sensors. */
struct adt746x_fan sc_fans[4];
int sc_nfans;
struct adt746x_sensor sc_sensors[9];
int sc_nsensors;
int device_id;
};
/* Regular bus attachment functions */
static int adt746x_probe(device_t);
static int adt746x_attach(device_t);
/* Utility functions */
static void adt746x_attach_fans(device_t dev);
static void adt746x_attach_sensors(device_t dev);
static int adt746x_fill_fan_prop(device_t dev);
static int adt746x_fill_sensor_prop(device_t dev);
static int adt746x_fan_set_pwm(struct adt746x_fan *fan, int pwm);
static int adt746x_fan_get_pwm(struct adt746x_fan *fan);
static int adt746x_sensor_read(struct adt746x_sensor *sens);
static void adt746x_start(void *xdev);
/* i2c read/write functions. */
static int adt746x_write(device_t dev, uint32_t addr, uint8_t reg,
uint8_t *buf);
static int adt746x_read(device_t dev, uint32_t addr, uint8_t reg,
uint8_t *data);
static device_method_t adt746x_methods[] = {
/* Device interface */
DEVMETHOD(device_probe, adt746x_probe),
DEVMETHOD(device_attach, adt746x_attach),
{ 0, 0 },
};
static driver_t adt746x_driver = {
"adt746x",
adt746x_methods,
sizeof(struct adt746x_softc)
};
static devclass_t adt746x_devclass;
DRIVER_MODULE(adt746x, iicbus, adt746x_driver, adt746x_devclass, 0, 0);
static MALLOC_DEFINE(M_ADT746X, "adt746x", "ADT Sensor Information");
/* i2c read/write functions. */
static int
adt746x_write(device_t dev, uint32_t addr, uint8_t reg, uint8_t *buff)
{
uint8_t buf[4];
int try = 0;
struct iic_msg msg[] = {
{addr, IIC_M_WR, 2, buf }
};
/* Prepare the write msg. */
buf[0] = reg;
memcpy(buf + 1, buff, 1);
for (;;)
{
if (iicbus_transfer(dev, msg, 1) == 0)
return (0);
if (++try > 5) {
device_printf(dev, "iicbus write failed\n");
return (-1);
}
pause("adt746x_write", hz);
}
return (0);
}
static int
adt746x_read(device_t dev, uint32_t addr, uint8_t reg, uint8_t *data)
{
uint8_t buf[4];
int err, try = 0;
struct iic_msg msg[2] = {
{addr, IIC_M_WR | IIC_M_NOSTOP, 1, &reg},
{addr, IIC_M_RD, 1, buf},
};
for (;;)
{
err = iicbus_transfer(dev, msg, 2);
if (err != 0)
goto retry;
*data = *((uint8_t*)buf);
return (0);
retry:
if (++try > 5) {
device_printf(dev, "iicbus read failed\n");
return (-1);
}
pause("adt746x_read", hz);
}
}
static int
adt746x_probe(device_t dev)
{
const char *name, *compatible;
struct adt746x_softc *sc;
name = ofw_bus_get_name(dev);
compatible = ofw_bus_get_compat(dev);
if (!name)
return (ENXIO);
if (strcmp(name, "fan") != 0 ||
(strcmp(compatible, "adt7460") != 0 &&
strcmp(compatible, "adt7467") != 0))
return (ENXIO);
sc = device_get_softc(dev);
sc->sc_dev = dev;
sc->sc_addr = iicbus_get_addr(dev);
device_set_desc(dev, "Apple Thermostat Unit ADT746X");
return (0);
}
static int
adt746x_attach(device_t dev)
{
struct adt746x_softc *sc;
sc = device_get_softc(dev);
sc->enum_hook.ich_func = adt746x_start;
sc->enum_hook.ich_arg = dev;
/* We have to wait until interrupts are enabled. I2C read and write
* only works if the interrupts are available.
* The unin/i2c is controlled by the htpic on unin. But this is not
* the master. The openpic on mac-io is controlling the htpic.
* This one gets attached after the mac-io probing and then the
* interrupts will be available.
*/
if (config_intrhook_establish(&sc->enum_hook) != 0)
return (ENOMEM);
return (0);
}
static void
adt746x_start(void *xdev)
{
uint8_t did, cid, rev, conf;
struct adt746x_softc *sc;
device_t dev = (device_t)xdev;
sc = device_get_softc(dev);
adt746x_read(sc->sc_dev, sc->sc_addr, ADT746X_DEVICE_ID, &did);
adt746x_read(sc->sc_dev, sc->sc_addr, ADT746X_COMPANY_ID, &cid);
adt746x_read(sc->sc_dev, sc->sc_addr, ADT746X_REV_ID, &rev);
adt746x_read(sc->sc_dev, sc->sc_addr, ADT746X_CONFIG, &conf);
device_printf(dev, "Dev ID %#x, Company ID %#x, Rev ID %#x CNF: %#x\n",
did, cid, rev, conf);
/* We can get the device id either from 'of' properties or from the chip
itself. This method makes sure we can read the chip, otherwise
we return. */
sc->device_id = did;
conf = 1;
/* Start the ADT7460. */
if (sc->device_id == ADT7460_DEV_ID)
adt746x_write(sc->sc_dev, sc->sc_addr, ADT746X_CONFIG, &conf);
/* Detect and attach child devices. */
adt746x_attach_fans(dev);
adt746x_attach_sensors(dev);
config_intrhook_disestablish(&sc->enum_hook);
}
/*
* Sensor and fan management
*/
static int
adt746x_fan_set_pwm(struct adt746x_fan *fan, int pwm)
{
uint8_t reg = 0, manual, mode = 0;
struct adt746x_softc *sc;
uint8_t buf;
sc = device_get_softc(fan->dev);
/* Clamp to allowed range */
pwm = max(fan->fan.min_rpm, pwm);
pwm = min(fan->fan.max_rpm, pwm);
reg = fan->pwm_reg;
mode = fan->conf_reg;
/* From the 7460 datasheet:
PWM dutycycle can be programmed from 0% (0x00) to 100% (0xFF)
in steps of 0.39% (256 steps).
*/
buf = (pwm * 100 / 39) - (pwm ? 1 : 0);
fan->setpoint = buf;
/* Manual mode. */
adt746x_read(sc->sc_dev, sc->sc_addr, mode, &manual);
manual |= ADT746X_MANUAL_MASK;
adt746x_write(sc->sc_dev, sc->sc_addr, mode, &manual);
/* Write speed. */
adt746x_write(sc->sc_dev, sc->sc_addr, reg, &buf);
return (0);
}
static int
adt746x_fan_get_pwm(struct adt746x_fan *fan)
{
uint8_t buf, reg;
uint16_t pwm;
struct adt746x_softc *sc;
sc = device_get_softc(fan->dev);
reg = fan->pwm_reg;
adt746x_read(sc->sc_dev, sc->sc_addr, reg, &buf);
pwm = (buf * 39 / 100) + (buf ? 1 : 0);
return (pwm);
}
static int
adt746x_fill_fan_prop(device_t dev)
{
phandle_t child;
struct adt746x_softc *sc;
u_int *id;
char *location;
int i, id_len, len = 0, location_len, prev_len = 0;
sc = device_get_softc(dev);
child = ofw_bus_get_node(dev);
/* Fill the fan location property. */
location_len = OF_getprop_alloc(child, "hwctrl-location", (void **)&location);
id_len = OF_getprop_alloc_multi(child, "hwctrl-id", sizeof(cell_t), (void **)&id);
if (location_len == -1 || id_len == -1) {
OF_prop_free(location);
OF_prop_free(id);
return 0;
}
/* Fill in all the properties for each fan. */
for (i = 0; i < id_len; i++) {
strlcpy(sc->sc_fans[i].fan.name, location + len, 32);
prev_len = strlen(location + len) + 1;
len += prev_len;
sc->sc_fans[i].id = id[i];
if (id[i] == 6) {
sc->sc_fans[i].pwm_reg = ADT746X_PWM1;
sc->sc_fans[i].conf_reg = ADT746X_PWM1_CONF;
} else if (id[i] == 7) {
sc->sc_fans[i].pwm_reg = ADT746X_PWM2;
sc->sc_fans[i].conf_reg = ADT746X_PWM2_CONF;
} else {
sc->sc_fans[i].pwm_reg = ADT746X_PWM1 + i;
sc->sc_fans[i].conf_reg = ADT746X_PWM1_CONF + i;
}
sc->sc_fans[i].dev = sc->sc_dev;
sc->sc_fans[i].fan.min_rpm = 5; /* Percent */
sc->sc_fans[i].fan.max_rpm = 100;
sc->sc_fans[i].fan.read = NULL;
sc->sc_fans[i].fan.set =
(int (*)(struct pmac_fan *, int))(adt746x_fan_set_pwm);
sc->sc_fans[i].fan.default_rpm = sc->sc_fans[i].fan.max_rpm;
}
OF_prop_free(location);
OF_prop_free(id);
return (i);
}
static int
adt746x_fill_sensor_prop(device_t dev)
{
phandle_t child, node;
struct adt746x_softc *sc;
char sens_type[32];
int i = 0, reg, sensid;
sc = device_get_softc(dev);
child = ofw_bus_get_node(dev);
/* Fill in the sensor properties for each child. */
for (node = OF_child(child); node != 0; node = OF_peer(node)) {
if (OF_getprop(node, "sensor-id", &sensid, sizeof(sensid)) == -1)
continue;
OF_getprop(node, "location", sc->sc_sensors[i].therm.name, 32);
OF_getprop(node, "device_type", sens_type, sizeof(sens_type));
if (strcmp(sens_type, "temperature") == 0)
sc->sc_sensors[i].type = ADT746X_SENSOR_TEMP;
else if (strcmp(sens_type, "voltage") == 0)
sc->sc_sensors[i].type = ADT746X_SENSOR_VOLT;
else
sc->sc_sensors[i].type = ADT746X_SENSOR_SPEED;
OF_getprop(node, "reg", &reg, sizeof(reg));
OF_getprop(node, "sensor-id", &sensid,
sizeof(sensid));
/* This is the i2c register of the sensor. */
sc->sc_sensors[i].reg = reg;
sc->sc_sensors[i].id = sensid;
OF_getprop(node, "zone", &sc->sc_sensors[i].therm.zone,
sizeof(sc->sc_sensors[i].therm.zone));
sc->sc_sensors[i].dev = dev;
sc->sc_sensors[i].therm.read =
(int (*)(struct pmac_therm *))adt746x_sensor_read;
if (sc->sc_sensors[i].type == ADT746X_SENSOR_TEMP) {
/* Make up some ranges */
sc->sc_sensors[i].therm.target_temp = 500 + ZERO_C_TO_K;
sc->sc_sensors[i].therm.max_temp = 800 + ZERO_C_TO_K;
pmac_thermal_sensor_register(&sc->sc_sensors[i].therm);
}
i++;
}
return (i);
}
static int
adt746x_fanrpm_sysctl(SYSCTL_HANDLER_ARGS)
{
device_t adt;
struct adt746x_softc *sc;
struct adt746x_fan *fan;
int pwm = 0, error;
adt = arg1;
sc = device_get_softc(adt);
fan = &sc->sc_fans[arg2];
pwm = adt746x_fan_get_pwm(fan);
error = sysctl_handle_int(oidp, &pwm, 0, req);
if (error || !req->newptr)
return (error);
return (adt746x_fan_set_pwm(fan, pwm));
}
static void
adt746x_attach_fans(device_t dev)
{
struct adt746x_softc *sc;
struct sysctl_oid *oid, *fanroot_oid;
struct sysctl_ctx_list *ctx;
phandle_t child;
char sysctl_name[32];
int i, j;
sc = device_get_softc(dev);
sc->sc_nfans = 0;
child = ofw_bus_get_node(dev);
/* Count the actual number of fans. */
sc->sc_nfans = adt746x_fill_fan_prop(dev);
device_printf(dev, "%d fans detected!\n", sc->sc_nfans);
if (sc->sc_nfans == 0) {
device_printf(dev, "WARNING: No fans detected!\n");
return;
}
ctx = device_get_sysctl_ctx(dev);
fanroot_oid = SYSCTL_ADD_NODE(ctx,
SYSCTL_CHILDREN(device_get_sysctl_tree(dev)), OID_AUTO, "fans",
CTLFLAG_RD, 0, "ADT Fan Information");
/* Now we can fill the properties into the allocated struct. */
sc->sc_nfans = adt746x_fill_fan_prop(dev);
/* Register fans with pmac_thermal */
for (i = 0; i < sc->sc_nfans; i++)
pmac_thermal_fan_register(&sc->sc_fans[i].fan);
/* Add sysctls for the fans. */
for (i = 0; i < sc->sc_nfans; i++) {
for (j = 0; j < strlen(sc->sc_fans[i].fan.name); j++) {
sysctl_name[j] = tolower(sc->sc_fans[i].fan.name[j]);
if (isspace(sysctl_name[j]))
sysctl_name[j] = '_';
}
sysctl_name[j] = 0;
sc->sc_fans[i].setpoint =
adt746x_fan_get_pwm(&sc->sc_fans[i]);
oid = SYSCTL_ADD_NODE(ctx, SYSCTL_CHILDREN(fanroot_oid),
OID_AUTO, sysctl_name, CTLFLAG_RD, 0, "Fan Information");
/* I use i to pass the fan id. */
SYSCTL_ADD_PROC(ctx, SYSCTL_CHILDREN(oid), OID_AUTO,
"pwm", CTLTYPE_INT | CTLFLAG_RW, dev, i,
adt746x_fanrpm_sysctl, "I", "Fan PWM in %");
}
/* Dump fan location & type. */
if (bootverbose) {
for (i = 0; i < sc->sc_nfans; i++) {
device_printf(dev, "Fan location: %s",
sc->sc_fans[i].fan.name);
device_printf(dev, " id: %d RPM: %d\n",
sc->sc_fans[i].id,
sc->sc_fans[i].setpoint);
}
}
}
static int
adt746x_sensor_read(struct adt746x_sensor *sens)
{
struct adt746x_softc *sc;
int tmp = 0;
uint16_t val;
uint8_t data[1], data1[1];
int8_t temp;
sc = device_get_softc(sens->dev);
if (sens->type != ADT746X_SENSOR_SPEED) {
if (adt746x_read(sc->sc_dev, sc->sc_addr, sens->reg,
&temp) < 0)
return (-1);
if (sens->type == ADT746X_SENSOR_TEMP)
tmp = 10 * temp + ZERO_C_TO_K;
else
tmp = temp;
} else {
if (adt746x_read(sc->sc_dev, sc->sc_addr, sens->reg,
data) < 0)
return (-1);
if (adt746x_read(sc->sc_dev, sc->sc_addr, sens->reg + 1,
data1) < 0)
return (-1);
val = data[0] + (data1[0] << 8);
/* A value of 0xffff means the fan is stopped. */
if (val == 0 || val == 0xffff)
tmp = 0;
else
tmp = (90000 * 60) / val;
}
return (tmp);
}
static int
adt746x_sensor_sysctl(SYSCTL_HANDLER_ARGS)
{
device_t dev;
struct adt746x_softc *sc;
struct adt746x_sensor *sens;
int value, error;
dev = arg1;
sc = device_get_softc(dev);
sens = &sc->sc_sensors[arg2];
value = sens->therm.read(&sens->therm);
if (value < 0)
return (ENXIO);
error = sysctl_handle_int(oidp, &value, 0, req);
return (error);
}
static void
adt746x_attach_sensors(device_t dev)
{
struct adt746x_softc *sc;
struct sysctl_oid *oid, *sensroot_oid;
struct sysctl_ctx_list *ctx;
phandle_t child;
char sysctl_name[40];
const char *unit;
const char *desc;
int i, j;
sc = device_get_softc(dev);
sc->sc_nsensors = 0;
child = ofw_bus_get_node(dev);
/* Count the actual number of sensors. */
sc->sc_nsensors = adt746x_fill_sensor_prop(dev);
device_printf(dev, "%d sensors detected!\n", sc->sc_nsensors);
if (sc->sc_nsensors == 0) {
device_printf(dev, "WARNING: No sensors detected!\n");
return;
}
ctx = device_get_sysctl_ctx(dev);
sensroot_oid = SYSCTL_ADD_NODE(ctx,
SYSCTL_CHILDREN(device_get_sysctl_tree(dev)), OID_AUTO, "sensors",
CTLFLAG_RD, 0, "ADT Sensor Information");
/* Add the sysctl for the sensors. */
for (i = 0; i < sc->sc_nsensors; i++) {
for (j = 0; j < strlen(sc->sc_sensors[i].therm.name); j++) {
sysctl_name[j] = tolower(sc->sc_sensors[i].therm.name[j]);
if (isspace(sysctl_name[j]))
sysctl_name[j] = '_';
}
sysctl_name[j] = 0;
oid = SYSCTL_ADD_NODE(ctx, SYSCTL_CHILDREN(sensroot_oid),
OID_AUTO,
sysctl_name, CTLFLAG_RD, 0,
"Sensor Information");
if (sc->sc_sensors[i].type == ADT746X_SENSOR_TEMP) {
unit = "temp";
desc = "sensor unit (C)";
} else if (sc->sc_sensors[i].type == ADT746X_SENSOR_VOLT) {
unit = "volt";
desc = "sensor unit (mV)";
} else {
unit = "rpm";
desc = "sensor unit (RPM)";
}
/* I use i to pass the sensor id. */
SYSCTL_ADD_PROC(ctx, SYSCTL_CHILDREN(oid), OID_AUTO,
unit, CTLTYPE_INT | CTLFLAG_RD, dev, i,
adt746x_sensor_sysctl,
sc->sc_sensors[i].type == ADT746X_SENSOR_TEMP ?
"IK" : "I", desc);
}
/* Dump sensor location & type. */
if (bootverbose) {
for (i = 0; i < sc->sc_nsensors; i++) {
device_printf(dev, "Sensor location: %s",
sc->sc_sensors[i].therm.name);
device_printf(dev, " type: %d id: %d reg: 0x%x\n",
sc->sc_sensors[i].type,
sc->sc_sensors[i].id,
sc->sc_sensors[i].reg);
}
}
}