circuitpython/stmhal/mphalport.h

// We use the ST Cube HAL library for most hardware peripherals
#include STM32_HAL_H
#include "pin.h"

// The unique id address differs per MCU.  Ideally this define should
// go in some MCU-specific header, but for now it lives here.
#if defined(MCU_SERIES_F4)
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1fff7a10)
#elif defined(MCU_SERIES_F7)
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1ff0f420)
#else
#error mphalport.h: Unrecognized MCU_SERIES
#endif

// Basic GPIO functions
#define GPIO_read_pin(gpio, pin)        (((gpio)->IDR >> (pin)) & 1)
#if defined(MCU_SERIES_F7)
#define GPIO_set_pin(gpio, pin_mask)    (((gpio)->BSRR) = (pin_mask))
#define GPIO_clear_pin(gpio, pin_mask)  (((gpio)->BSRR) = ((pin_mask) << 16))
#else
#define GPIO_set_pin(gpio, pin_mask)    (((gpio)->BSRRL) = (pin_mask))
#define GPIO_clear_pin(gpio, pin_mask)  (((gpio)->BSRRH) = (pin_mask))
#endif
#define GPIO_read_output_pin(gpio, pin) (((gpio)->ODR >> (pin)) & 1)

void mp_hal_gpio_clock_enable(GPIO_TypeDef *gpio);
bool mp_hal_gpio_set_af(const pin_obj_t *pin, GPIO_InitTypeDef *init, uint8_t fn, uint8_t unit);

extern const unsigned char mp_hal_status_to_errno_table[4];

NORETURN void mp_hal_raise(HAL_StatusTypeDef status);
void mp_hal_set_interrupt_char(int c); // -1 to disable

#define mp_hal_delay_ms HAL_Delay
#define mp_hal_ticks_ms HAL_GetTick
Merge branch 'teensy-new' of github.com:dhylands/micropython into dhylands-teensy-new Conflicts: stmhal/pin_named_pins.c stmhal/readline.c Renamed HAL_H to MICROPY_HAL_H. Made stmhal/mphal.h which intends to define the generic Micro Python HAL, which in stmhal sits above the ST HAL. 2014-07-02 08:42:37 -04:00			`// We use the ST Cube HAL library for most hardware peripherals`
stmhal: Replace #include "stm32f4xx_hal.h" with #include STM32_HAL_H. 2015-07-28 11:36:26 -04:00			`#include STM32_HAL_H`
stmhal: Add a function for setting the pin alternate function mp_hal_gpio_set_af will search for a given function and unit and set the alternate function to the alternate function index found. 2016-02-11 00:20:14 -05:00			`#include "pin.h"`
Merge branch 'teensy-new' of github.com:dhylands/micropython into dhylands-teensy-new Conflicts: stmhal/pin_named_pins.c stmhal/readline.c Renamed HAL_H to MICROPY_HAL_H. Made stmhal/mphal.h which intends to define the generic Micro Python HAL, which in stmhal sits above the ST HAL. 2014-07-02 08:42:37 -04:00
stmhal: Add define for UNIQUE_ID address (differs per MCU) 2015-10-29 12:03:10 -04:00			`// The unique id address differs per MCU. Ideally this define should`
			`// go in some MCU-specific header, but for now it lives here.`
			`#if defined(MCU_SERIES_F4)`
			`#define MP_HAL_UNIQUE_ID_ADDRESS (0x1fff7a10)`
			`#elif defined(MCU_SERIES_F7)`
			`#define MP_HAL_UNIQUE_ID_ADDRESS (0x1ff0f420)`
			`#else`
all: Add py/mphal.h and use it in all ports. py/mphal.h contains declarations for generic mp_hal_XXX functions, such as stdio and delay/ticks, which ports should provide definitions for. A port will also provide mphalport.h with further HAL declarations. 2015-10-30 19:03:58 -04:00			`#error mphalport.h: Unrecognized MCU_SERIES`
stmhal: Add define for UNIQUE_ID address (differs per MCU) 2015-10-29 12:03:10 -04:00			`#endif`

Merge branch 'teensy-new' of github.com:dhylands/micropython into dhylands-teensy-new Conflicts: stmhal/pin_named_pins.c stmhal/readline.c Renamed HAL_H to MICROPY_HAL_H. Made stmhal/mphal.h which intends to define the generic Micro Python HAL, which in stmhal sits above the ST HAL. 2014-07-02 08:42:37 -04:00			`// Basic GPIO functions`
			`#define GPIO_read_pin(gpio, pin) (((gpio)->IDR >> (pin)) & 1)`
stamhal: Add definitions for MCU_SERIES_F4 and MCU_SERIES_F7 2015-08-03 18:07:20 -04:00			`#if defined(MCU_SERIES_F7)`
stmhal: Add STM32F7DISC and associated changes. 2015-07-28 14:13:33 -04:00			`#define GPIO_set_pin(gpio, pin_mask) (((gpio)->BSRR) = (pin_mask))`
			`#define GPIO_clear_pin(gpio, pin_mask) (((gpio)->BSRR) = ((pin_mask) << 16))`
			`#else`
Merge branch 'teensy-new' of github.com:dhylands/micropython into dhylands-teensy-new Conflicts: stmhal/pin_named_pins.c stmhal/readline.c Renamed HAL_H to MICROPY_HAL_H. Made stmhal/mphal.h which intends to define the generic Micro Python HAL, which in stmhal sits above the ST HAL. 2014-07-02 08:42:37 -04:00			`#define GPIO_set_pin(gpio, pin_mask) (((gpio)->BSRRL) = (pin_mask))`
			`#define GPIO_clear_pin(gpio, pin_mask) (((gpio)->BSRRH) = (pin_mask))`
stmhal: Add STM32F7DISC and associated changes. 2015-07-28 14:13:33 -04:00			`#endif`
Add support for selecting pin alternate functions from python. Converts generted pins to use qstrs instead of string pointers. This patch also adds the following functions: pyb.Pin.names() pyb.Pin.af_list() pyb.Pin.gpio() dir(pyb.Pin.board) and dir(pyb.Pin.cpu) also produce useful results. pyb.Pin now takes kw args. pyb.Pin.__str__ now prints more useful information about the pin configuration. I found the following functions in my boot.py to be useful: ```python def pins(): for pin_name in dir(pyb.Pin.board): pin = pyb.Pin(pin_name) print('{:10s} {:s}'.format(pin_name, str(pin))) def af(): for pin_name in dir(pyb.Pin.board): pin = pyb.Pin(pin_name) print('{:10s} {:s}'.format(pin_name, str(pin.af_list()))) ``` 2014-07-22 10:57:36 -04:00			`#define GPIO_read_output_pin(gpio, pin) (((gpio)->ODR >> (pin)) & 1)`
stmhal: Use OSError with POSIX error code for HAL errors. Addresses issue #921. 2014-10-23 09:25:32 -04:00
stmhal: Factor GPIO clock enable logic into mp_hal_gpio_clock_enable. Extracted GPIO clock enable logic into mp_hal_gpio_clock_enable and called from anyplace which might need to use GPIO functions on ports other than A-D. Thanks to Dave Hylands for the patch. 2015-08-02 19:05:16 -04:00			`void mp_hal_gpio_clock_enable(GPIO_TypeDef *gpio);`
stmhal: Add a function for setting the pin alternate function mp_hal_gpio_set_af will search for a given function and unit and set the alternate function to the alternate function index found. 2016-02-11 00:20:14 -05:00			`bool mp_hal_gpio_set_af(const pin_obj_t pin, GPIO_InitTypeDef init, uint8_t fn, uint8_t unit);`
stmhal: Factor GPIO clock enable logic into mp_hal_gpio_clock_enable. Extracted GPIO clock enable logic into mp_hal_gpio_clock_enable and called from anyplace which might need to use GPIO functions on ports other than A-D. Thanks to Dave Hylands for the patch. 2015-08-02 19:05:16 -04:00
all: Add py/mphal.h and use it in all ports. py/mphal.h contains declarations for generic mp_hal_XXX functions, such as stdio and delay/ticks, which ports should provide definitions for. A port will also provide mphalport.h with further HAL declarations. 2015-10-30 19:03:58 -04:00			`extern const unsigned char mp_hal_status_to_errno_table[4];`
stmhal: Use OSError with POSIX error code for HAL errors. Addresses issue #921. 2014-10-23 09:25:32 -04:00
			`NORETURN void mp_hal_raise(HAL_StatusTypeDef status);`
stmhal: Reduce coupling between USB driver and readline. This makes it easier to re-use readline.c and pyexec.c from stmhal in other ports. 2014-11-27 11:58:31 -05:00			`void mp_hal_set_interrupt_char(int c); // -1 to disable`
stmhal: Make pybstdio usable by other ports, and use it. Now all ports can use pybstdio.c to provide sys.stdin/stdout/stderr, so long as they implement mp_hal_stdin_* and mp_hal_stdout_* functions. 2015-02-13 10:04:53 -05:00
unix, stmhal: Introduce mp_hal_delay_ms(), mp_hal_ticks_ms(). These MPHAL functions are intended to replace previously used HAL_Delay(), HAL_GetTick() to provide better naming and MPHAL separation (they are fully equivalent otherwise). Also, refactor extmod/modlwip to use them. 2015-10-27 16:31:42 -04:00			`#define mp_hal_delay_ms HAL_Delay`
			`#define mp_hal_ticks_ms HAL_GetTick`