在Linux内核中，可用Thermal Sensor（如：RK3399 TS-ADC(Temperature-Sensor ADC)）获取温度。
本文介绍RK3399 TS-ADC控制器驱动和调试方法。
一、TSADC驱动
1、TS-ADC控制器
RK3399 TS-ADC(Temperature-Sensor ADC)控制器模块支持用户自定义模式和自动模式。
1）用户自定义模式
TS-ADC所有的控制信号完全由软件写入寄存器直接控制。
2）自动模式
模块自动轮询TS-ADC输出并检查结果。
如果在一段时间内发现温度过高，会产生一个停机措施的中断；如果温度超过一段时间高，生成TSHUT给CRU(Clock & Reset Unit)模块，让他复位整个芯片，或者通过GPIO给PMIC。
RK3399 TSADC控制器特性如下：
1）、支持用户自定义模式和自动模式。
2）、在用户自定义模式下，start_of_conversion可以完全由软件控制，也可以由硬件生成。
3）、在自动模式下，可配置报警（高温/低温）中断的温度。
4）、在自动模式下，可配置系统复位的温度。
5）、支持2通道TS-ADC，每个通道的温度标准可配置。
6）、在自动模式下，可配置温度检测的时间间隔。
7）、在自动模式下，当检测到高温时，可配置温度检测的时间间隔。
8）、可配置高温防抖。
9）、温度范围：-40 ~ 125°C，温度精度：5°C。
10）、10bit SARADC，采样率50KS/s。
注：1KS/s = 1KHz，即每秒采样1000个点。
RK3399 TS-ADC控制器框图如下：
2、TS-ADC配置
RK3399 TS-ADC配置文件：
1）arch/arm64/boot/dts/rockchip/rk3399.dtsi
TS-ADC属性配置如下：
tsadc: tsadc@ff260000 { compatible = "rockchip,rk3399-tsadc"; ## TS-ADC驱动加载的标志字符串 reg = <0x0 0xff260000 0x0 0x100>; ## TS-ADC寄存器基地址和寄存器地址长度 interrupts = <GIC_SPI 97 IRQ_TYPE_LEVEL_HIGH 0>; ## TS-ADC中断 assigned-clocks = <&cru SCLK_TSADC>; assigned-clock-rates = <750000>; ## TS-ADC工作时钟为750000 clocks = <&cru SCLK_TSADC>, <&cru PCLK_TSADC>; clock-names = "tsadc", "apb_pclk"; ## TS-ADC模块的两个时钟：工作时钟和配置时钟 resets = <&cru SRST_TSADC>; reset-names = "tsadc-apb"; rockchip,grf = <&grf>; ## TS-ADC引用grf模块 rockchip,hw-tshut-temp = <120000>; ## TS-ADC设置的关机温度120度 pinctrl-names = "init", "default", "sleep"; ## TS-ADC工作的GPIO配置，初始化init和休眠sleep时gpio，默认 ## default是输出功能。 pinctrl-0 = <&otp_gpio>; pinctrl-1 = <&otp_out>; pinctrl-2 = <&otp_gpio>; #thermal-sensor-cells = <1>; status = "disabled"; };
TS-ADC引脚配置如下：
tsadc { otp_gpio: otp-gpio { rockchip,pins = <1 6 RK_FUNC_GPIO &pcfg_pull_none>; }; otp_out: otp-out { rockchip,pins = <1 6 RK_FUNC_1 &pcfg_pull_none>; }; };
2）arch/arm64/boot/dts/rockchip/rk3399-rock-pi-4.dtsi
使能TS-ADC配置如下：
&tsadc { /* tshut mode 0:CRU 1:GPIO */ rockchip,hw-tshut-mode = <1>; ## 温度超过关机温度的复位方式：0：通过CRU模块复位；1：通过GPIO连接PMIC复位 ## 引脚进行复位。 /* tshut polarity 0:LOW 1:HIGH */ rockchip,hw-tshut-polarity = <1>; ## 关机极性：0：低；1：高 rockchip,hw-tshut-temp = <110000>; ## 关机温度：110度 status = "okay"; ## 使能TS-ADC驱动 };
3、TS-ADC驱动
RK3399 TS-ADC驱动文件：drivers/thermal/rockchip_thermal.c，主要关注：
static const struct rockchip_tsadc_chip rk3399_tsadc_data = { .chn_id[SENSOR_CPU] = 0, /* cpu sensor is channel 0 */ ## TS-ADC通道0监控CPU温度 .chn_id[SENSOR_GPU] = 1, /* gpu sensor is channel 1 */ ## TS-ADC通道1监控GPU温度 .chn_num = 2, /* two channels for tsadc */ ## TS-ADC通道个数 .tshut_mode = TSHUT_MODE_GPIO, /* default TSHUT via GPIO give PMIC */ ## TS-ADC关机模式（GPIO） .tshut_polarity = TSHUT_LOW_ACTIVE, /* default TSHUT LOW ACTIVE */ ## TS-ADC关机极性（低有效） .tshut_temp = 95000, ## TS-ADC关机温度（95） ## 如果dts中没有配置上面三个属性，则使用上面三个默认值，否则使用dts中的值。 .initialize = rk_tsadcv3_initialize, ## 初始化TS-ADC控制器 .irq_ack = rk_tsadcv3_irq_ack, .control = rk_tsadcv3_control, ## 使能和禁止TS-ADC控制器 .get_temp = rk_tsadcv2_get_temp, ## 获取温度 .set_alarm_temp = rk_tsadcv2_alarm_temp, ## 设置报警温度并使能对应中断 .set_tshut_temp = rk_tsadcv2_tshut_temp, ## 设置关机温度并使能对应中断 .set_tshut_mode = rk_tsadcv2_tshut_mode, ## 设置关机模式 .table = { .id = rk3399_code_table, .length = ARRAY_SIZE(rk3399_code_table), .data_mask = TSADCV3_DATA_MASK, .mode = ADC_INCREMENT, }, }; ##注册thermal sensor设备驱动实现函数 static const struct thermal_zone_of_device_ops rockchip_of_thermal_ops = { .get_temp = rockchip_thermal_get_temp, ## 获取温度，调用rk_tsadcv2_get_temp() .set_trips = rockchip_thermal_set_trips, ## 设置报警温度，调用rk_tsadcv2_alarm_temp() };
二、TS-ADC调试
下面基于RockPI 4A单板查看RK3399 CPU和GPU的温度，方法如下：
## CPU温度 root@xiaotianbsp:/# cat /sys/class/thermal/thermal_zone0/temp 36875 ## GPU温度 root@xiaotianbsp:/# cat /sys/class/thermal/thermal_zone1/temp 38750
可以使用watch命令，动态监控CPU或GPU温度，方法如下：
## 每隔1秒显示一次CPU温度 root@xiaotianbsp:/# watch -n 1 cat /sys/class/thermal/thermal_zone0/temp Every 1.0s: cat /sys/class/thermal/the... linaro-alip: Mon Aug 16 14:46:38 2021 36875 ## 每隔1秒显示一次GPU温度 root@xiaotianbsp:/# watch -n 1 cat /sys/class/thermal/thermal_zone1/temp Every 1.0s: cat /sys/class/thermal/the... linaro-alip: Mon Aug 16 14:48:41 2021 38750
注：转载请注明作者。