rp2040: add machine.ReadTemperature

Replace ADCChannel.ReadTemperature() with a simple ReadTemperature function. Not all chips will have a temperature sensor that is read by sampling an ADC channel. The replacement ReadTemperature is simpler and more generic to other chip families. This breaks chips that were relying on the previous ReadTemperature method. I hope it won't break a lot of existing code. If it does, a fallback can be added.

Author: aykevl

Makefile

@@ -611,7 +611,7 @@ endif
 @$(MD5SUM) test.hex
 $(TINYGO) build -size short -o test.hex -target=challenger-rp2040 examples/blinky1
 @$(MD5SUM) test.hex
-$(TINYGO) build -size short -o test.hex -target=trinkey-qt2040 examples/adc_rp2040
+$(TINYGO) build -size short -o test.hex -target=trinkey-qt2040 examples/temp
 @$(MD5SUM) test.hex
 # test pwm
 $(TINYGO) build -size short -o test.hex -target=itsybitsy-m0 examples/pwm

src/examples/adc_rp2040/adc.go

@@ -0,0 +1,23 @@
+// Read the internal temperature sensor of the chip.
+
+package main
+
+import (
+"fmt"
+"machine"
+"time"
+)
+
+type celsius float32
+
+func (c celsius) String() string {
+return fmt.Sprintf("%4.1f℃", c)
+}
+
+func main() {
+for {
+temp := celsius(float32(machine.ReadTemperature()) / 1000)
+println("temperature:", temp.String())
+time.Sleep(time.Second)
+}
+}

src/examples/temp/temp.go

@@ -17,8 +17,8 @@ const (
 adc0_CH ADCChannel = iota
 adc1_CH
 adc2_CH
-adc3_CH  // Note: GPIO29 not broken out on pico board
-ADC_TEMP_SENSOR // Internal temperature sensor channel
+adc3_CH // Note: GPIO29 not broken out on pico board
+adcTempSensor // Internal temperature sensor channel
 )
 
 // Used to serialise ADC sampling
@@ -75,19 +75,17 @@ func (a ADC) GetADCChannel() (c ADCChannel, err error) {
 return c, err
 }
 
-// Configure sets the channel's associated pin to analog input mode or powers on the temperature sensor for ADC_TEMP_SENSOR.
+// Configure sets the channel's associated pin to analog input mode.
 // The powered on temperature sensor increases ADC_AVDD current by approximately 40 μA.
 func (c ADCChannel) Configure(config ADCConfig) error {
 if config.Reference != 0 {
 adcAref = config.Reference
 }
-if p, err := c.Pin(); err == nil {
-p.Configure(PinConfig{Mode: PinAnalog})
-}
-if c == ADC_TEMP_SENSOR {
-// Enable temperature sensor bias source
-rp.ADC.CS.SetBits(rp.ADC_CS_TS_EN)
+p, err := c.Pin()
+if err != nil {
+return err
 }
+p.Configure(PinConfig{Mode: PinAnalog})
 return nil
 }
 
@@ -112,13 +110,16 @@ func (c ADCChannel) getVoltage() uint32 {
 }
 
 // ReadTemperature does a one-shot sample of the internal temperature sensor and returns a milli-celsius reading.
-// Only works on the ADC_TEMP_SENSOR channel. aka AINSEL=4. Other channels will return 0
-func (c ADCChannel) ReadTemperature() (millicelsius uint32) {
-if c != ADC_TEMP_SENSOR {
-return
+func ReadTemperature() (millicelsius int32) {
+if rp.ADC.CS.Get()&rp.ADC_CS_EN == 0 {
+InitADC()
 }
+
+// Enable temperature sensor bias source
+rp.ADC.CS.SetBits(rp.ADC_CS_TS_EN)
+
 // T = 27 - (ADC_voltage - 0.706)/0.001721
-return (27000<<16 - (c.getVoltage()-706<<16)*581) >> 16
+return (27000<<16 - (int32(adcTempSensor.getVoltage())-706<<16)*581) >> 16
 }
 
 // waitForReady spins waiting for the ADC peripheral to become ready.