gd32e2-hal 0.26.0

HAL for the GD32E23x series (Cortex-M23), currently the GD32E230
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! ADC: the internal reference and temperature sensor, plus one external pin.
//!
//! Needs no external wiring to be useful — `read_vref` and `read_temperature`
//! read on-chip sources. The external read is on PA0; leave it floating or tie
//! it to a known voltage. Results go over RTT.
//!
//! `adc_sel` must be set, or `constrain` panics. Covers: `AdcExt::constrain`,
//! `read`, `read_vref`, `read_temperature`, `SampTime`, and `into_analog` / the
//! `Channel` bound.

#![no_std]
#![no_main]

use cortex_m_rt::entry;
use defmt_rtt as _;
use panic_halt as _;

use gd32e2_hal::adc::SampTime;
use gd32e2_hal::pac;
use gd32e2_hal::prelude::*;
use gd32e2_hal::rcu::{AdcPsc, AdcSel, ClockConfig, Irc28mDiv, PllFreq, SysClk};

#[entry]
fn main() -> ! {
    let dp = pac::Peripherals::take().unwrap();
    let mut fmc = dp.fmc.constrain();
    let config = ClockConfig::default()
        .sysclk(SysClk::Pll(PllFreq::Mhz48))
        // CK_ADC = pclk2 / 8 = 6 MHz — slow enough for the temperature sensor.
        .adc_sel(AdcSel::Prescaled(AdcPsc::Apb2Div8));
    let mut rcu = dp.rcu.constrain().freeze(&mut fmc, config);
    let clocks = rcu.clocks();

    // The other ADC clock source is the dedicated 28 MHz oscillator, e.g.:
    let _alt_src = AdcSel::Irc28m(Irc28mDiv::Div2);

    let gpioa = dp.gpioa.split(&mut rcu);

    // A pin must go through into_analog() before it satisfies `Channel`.
    let ain = gpioa.pa0.into_analog();

    let mut adc = dp.adc.constrain(&mut rcu);

    defmt::info!("ADC test, CK_ADC = {} Hz", clocks.ck_adc().to_Hz());

    loop {
        let vdda = adc.read_vref();
        defmt::info!("VDDA = {} mV", vdda);

        match adc.read_temperature() {
            Some(tenths) => {
                defmt::info!("temp = {}.{} C", tenths / 10, (tenths % 10).abs());
            }
            None => {
                defmt::info!("temp unavailable (CK_ADC too fast)");
            }
        }

        let raw = adc.read(&ain, SampTime::Cycles239_5);
        defmt::info!("PA0 raw = {}", raw);

        // Crude spacing between reports.
        for _ in 0..1_000_000 {
            cortex_m::asm::nop();
        }
    }
}