This commit adds support for the dual-analog-pads on STM32H7 parts. These
pads/pins are called PA0_C/PA1_C/PC2_C/PC3_C in the datasheet. They each
have an analog switch that can optionally connect them to their normal pin
(eg PA0). When the switch is open, the normal and _C pin are independent
pins/pads.
The approach taken in this commit to make these _C pins available to Python
is:
- put them in their own, independent row in the stm32h7_af.csv definition
file, with only the ADC column defined (they are separate machine.Pin
entities, and doing it this way keeps make-pins.py pretty clean)
- allow a board to reference these pins in the board's pins.csv file by the
name PA0_C etc (so a board can alias them, for example)
- these pins (when enabled in pins.csv) now become available like any other
machine.Pin through both machine.Pin.board and machine.Pin.cpu
- BUT these _C pins have a separate pin type which doesn't have any
methods, because they don't have any functionality
- these _C pins can be used with machine.ADC to construct the appropriate
ADC object, either by passing the string as machine.ADC("PA0_C") or by
passing the object as machine.ADC(machine.Pin.cpu.PA0_C)
- if a board defines both the normal and _C pin (eg both PA0 and PA0_C) in
pins.csv then it must not define the analog switch to be closed (this is
a sanity check for the build, because it doesn't make sense to close the
switch and have two separate pins)
Signed-off-by: Damien George <damien@micropython.org>
51 lines
1.5 KiB
C
51 lines
1.5 KiB
C
// stm32f4xx_prefix.c becomes the initial portion of the generated pins file.
|
|
|
|
#include <stdio.h>
|
|
|
|
#include "py/obj.h"
|
|
#include "py/mphal.h"
|
|
#include "pin.h"
|
|
|
|
#define AF(af_idx, af_fn, af_unit, af_type, af_ptr) \
|
|
{ \
|
|
{ &pin_af_type }, \
|
|
.name = MP_QSTR_AF##af_idx##_##af_fn##af_unit, \
|
|
.idx = (af_idx), \
|
|
.fn = AF_FN_##af_fn, \
|
|
.unit = (af_unit), \
|
|
.type = AF_PIN_TYPE_##af_fn##_##af_type, \
|
|
.reg = (af_ptr) \
|
|
}
|
|
|
|
#define PIN(p_port, p_pin, p_af, p_adc_num, p_adc_channel) \
|
|
{ \
|
|
{ &pin_type }, \
|
|
.name = MP_QSTR_##p_port##p_pin, \
|
|
.port = PORT_##p_port, \
|
|
.pin = (p_pin), \
|
|
.num_af = (sizeof(p_af) / sizeof(pin_af_obj_t)), \
|
|
.pin_mask = (1 << ((p_pin) & 0x0f)), \
|
|
.gpio = GPIO##p_port, \
|
|
.af = p_af, \
|
|
.adc_num = p_adc_num, \
|
|
.adc_channel = p_adc_channel, \
|
|
}
|
|
|
|
#if MICROPY_HW_ENABLE_ANALOG_ONLY_PINS
|
|
#define PIN_ANALOG(p_port, p_pin, p_af, p_adc_num, p_adc_channel) \
|
|
{ \
|
|
{ &pin_analog_type }, \
|
|
.name = MP_QSTR_##p_port##p_pin##_C, \
|
|
.port = PORT_##p_port, \
|
|
.pin = (p_pin), \
|
|
.num_af = (sizeof(p_af) / sizeof(pin_af_obj_t)), \
|
|
.pin_mask = (1 << ((p_pin) & 0x0f)), \
|
|
.gpio = GPIO##p_port, \
|
|
.af = p_af, \
|
|
.adc_num = p_adc_num, \
|
|
.adc_channel = p_adc_channel, \
|
|
}
|
|
#else
|
|
#define PIN_ANALOG DUAL_PAD_SUPPORT_NOT_ENABLED__CONFIGURE__MICROPY_HW_ANALOG_SWITCH_Pxy
|
|
#endif
|