1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/boards/sodaq-autonomo/include/arduino_iomap.h
Marian Buschsieweke 043e8cc88e
boards,sys/arduino: major clean up
- Rename all `arduino_pinmap.h` to `arduino_iomap.h`
    - An empty `arduino_pinmap.h` that just includes `arduino_iomap.h`
      is provided for backward compatibility
    - Move all info from `arduino_board.h` into the new file as trivial
      macros, so that they can also be used outside of sketches
    - The new name reflects the fact not just pin mappings, but also
      other I/O features such as PWMs are mapped
- Drop all `arduino_board.h`
    - `arduino_board.h` and `arduino_iomap.h` now provide the exact
      same information, just in a different format
    - a generic `arduino_board.h` is provided instead that just
      uses the info in `arduinio_iomap.h` and provides them in the
      format the code in `sys/arduino` expects it
- Add fine grained features to indicate for mappings
    - availability of mappings for analog pins, DAC pins, PWM pins,
      UART devices, SPI/I2C buses to the corresponding RIOT
      identification can now be expressed:
        - `arduino_pins`: `ARDUINO_PIN_0` etc. are available
        - `arduino_analog`: `ARDUINO_A0` etc. are available
        - `arduino_pwm`: `ARDUINO_PIN_13_PWM_DEV` etc. are available
        - `arduino_dac`: `ARDUINO_DAC0` etc. are available
        - `arduino_uart`: `ARDUINO_UART_D0D1` or similar are available
        - `arduino_spi`: `ARDUINO_SPI_ISP` or similar are available
        - `arduino_i2c`: `ARDUINO_I2C_UNO` or similar are available
    - mechanical/electrical compatibility with specific form factors
      can now be expressed as features:
        - `aruino_shield_nano`: Arduino NANO compatible headers
        - `aruino_shield_uno`: Arduino UNO compatible headers
        - `aruino_shield_mega`: Arduino MEGA compatible headers
        - `aruino_shield_isp`: ISP header is available

This provides the groundwork to implement shield support as modules
that can rely on the I/O mappings, rather than having to provide a
configuration per board.
2023-06-26 17:24:07 +02:00

198 lines
6.0 KiB
C

/*
* Copyright (C) 2019 Kees Bakker
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_sodaq-autonomo
* @{
*
* @file
* @brief Mapping from MCU pins to Arduino pins for the sodaq-autonomo
*
* @author Kees Bakker <kees@ijzerbout.nl>
*/
#ifndef ARDUINO_IOMAP_H
#define ARDUINO_IOMAP_H
#include "periph/adc.h"
#include "periph/gpio.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief The builtin LED
*/
#define ARDUINO_LED (13)
/**
* @name Mapping of MCU pins to digital Arduino pins
* @{
*/
/* D0..D1 - SERCOM/UART (Serial) */
#define ARDUINO_PIN_0 GPIO_PIN(PA, 9)
#define ARDUINO_PIN_1 GPIO_PIN(PA, 10)
/* D2..D15 - Digital */
#define ARDUINO_PIN_2 GPIO_PIN(PA, 11)
#define ARDUINO_PIN_3 GPIO_PIN(PB, 10)
#define ARDUINO_PIN_4 GPIO_PIN(PB, 11)
#define ARDUINO_PIN_5 GPIO_PIN(PB, 12)
#define ARDUINO_PIN_6 GPIO_PIN(PB, 13)
#define ARDUINO_PIN_7 GPIO_PIN(PB, 14)
#define ARDUINO_PIN_8 GPIO_PIN(PB, 15)
#define ARDUINO_PIN_9 GPIO_PIN(PA, 14)
#define ARDUINO_PIN_10 GPIO_PIN(PA, 15)
#define ARDUINO_PIN_11 GPIO_PIN(PA, 16)
#define ARDUINO_PIN_12 GPIO_PIN(PA, 17)
#define ARDUINO_PIN_13 GPIO_PIN(PA, 18)
#define ARDUINO_PIN_14 GPIO_PIN(PA, 19)
#define ARDUINO_PIN_15 GPIO_PIN(PB, 16)
/* D16..D18 - Other Digital */
#define ARDUINO_PIN_16 GPIO_PIN(PA, 8)
#define ARDUINO_PIN_17 GPIO_PIN(PA, 28)
#define ARDUINO_PIN_18 GPIO_PIN(PB, 17)
/* D19..D32 - A0..A13 */
#define ARDUINO_PIN_19 GPIO_PIN(PA, 2)
#define ARDUINO_PIN_20 GPIO_PIN(PA, 6)
#define ARDUINO_PIN_21 GPIO_PIN(PA, 5)
#define ARDUINO_PIN_22 GPIO_PIN(PA, 4)
#define ARDUINO_PIN_23 GPIO_PIN(PB, 9)
#define ARDUINO_PIN_24 GPIO_PIN(PB, 8)
#define ARDUINO_PIN_25 GPIO_PIN(PB, 7)
#define ARDUINO_PIN_26 GPIO_PIN(PB, 6)
#define ARDUINO_PIN_27 GPIO_PIN(PB, 5)
#define ARDUINO_PIN_28 GPIO_PIN(PB, 4)
#define ARDUINO_PIN_29 GPIO_PIN(PA, 7)
#define ARDUINO_PIN_30 GPIO_PIN(PB, 3)
#define ARDUINO_PIN_31 GPIO_PIN(PB, 2)
#define ARDUINO_PIN_32 GPIO_PIN(PB, 1)
/* D33..D35 - Other Analog + DAC */
#define ARDUINO_PIN_33 GPIO_PIN(PB, 0)
#define ARDUINO_PIN_34 GPIO_PIN(PA, 3)
#define ARDUINO_PIN_35 GPIO_PIN(PA, 2)
/* D36..D39 - SERCOM/UART (Serial1) */
#define ARDUINO_PIN_36 GPIO_PIN(PB, 30)
#define ARDUINO_PIN_37 GPIO_PIN(PB, 31)
#define ARDUINO_PIN_38 GPIO_PIN(PB, 22)
#define ARDUINO_PIN_39 GPIO_PIN(PB, 23)
/* D40..D41 - I2C pins (SDA/SCL) */
#define ARDUINO_PIN_40 GPIO_PIN(PA, 12)
#define ARDUINO_PIN_41 GPIO_PIN(PA, 13)
/* D42..D45 - SPI pins (ICSP: MISO, SS, MOSI, SCK) */
#define ARDUINO_PIN_42 GPIO_PIN(PA, 22)
#define ARDUINO_PIN_43 GPIO_PIN(PA, 23)
#define ARDUINO_PIN_44 GPIO_PIN(PA, 20)
#define ARDUINO_PIN_45 GPIO_PIN(PA, 21)
/* D46 - SD CARD CS */
#define ARDUINO_PIN_46 GPIO_PIN(PA, 27)
/* D47..D48 - USB */
#define ARDUINO_PIN_47 GPIO_PIN(PA, 24)
#define ARDUINO_PIN_48 GPIO_PIN(PA, 25)
/* D49..D50 - Serial2 (alternative use for D6/D7) */
#define ARDUINO_PIN_49 GPIO_PIN(PB, 13)
#define ARDUINO_PIN_50 GPIO_PIN(PB, 14)
/* D51..D52 - Serial3 (alternative use for D12/D13) */
#define ARDUINO_PIN_51 GPIO_PIN(PA, 17)
#define ARDUINO_PIN_52 GPIO_PIN(PA, 18)
/* D53..D56 - SPI1 (alternative use for D5..D8) */
#define ARDUINO_PIN_53 GPIO_PIN(PB, 12)
#define ARDUINO_PIN_54 GPIO_PIN(PB, 13)
#define ARDUINO_PIN_55 GPIO_PIN(PB, 14)
#define ARDUINO_PIN_56 GPIO_PIN(PB, 15)
#define ARDUINO_PIN_LAST 56
/** @} */
/**
* @name Aliases for analog pins
* @{
*/
#define ARDUINO_PIN_A0 ARDUINO_PIN_19
#define ARDUINO_PIN_A1 ARDUINO_PIN_20
#define ARDUINO_PIN_A2 ARDUINO_PIN_21
#define ARDUINO_PIN_A3 ARDUINO_PIN_22
#define ARDUINO_PIN_A4 ARDUINO_PIN_23
#define ARDUINO_PIN_A5 ARDUINO_PIN_24
#define ARDUINO_PIN_A6 ARDUINO_PIN_25
#define ARDUINO_PIN_A7 ARDUINO_PIN_26
#define ARDUINO_PIN_A8 ARDUINO_PIN_27
#define ARDUINO_PIN_A9 ARDUINO_PIN_28
#define ARDUINO_PIN_A10 ARDUINO_PIN_29
#define ARDUINO_PIN_A11 ARDUINO_PIN_30
#define ARDUINO_PIN_A12 ARDUINO_PIN_31
#define ARDUINO_PIN_A13 ARDUINO_PIN_32
/** @} */
/**
* @name Analog pin to adc line mapping
* @{
*/
#define ARDUINO_A0 ADC_LINE(0)
#define ARDUINO_A1 ADC_LINE(1)
#define ARDUINO_A2 ADC_LINE(2)
#define ARDUINO_A3 ADC_LINE(3)
#define ARDUINO_A4 ADC_LINE(4)
#define ARDUINO_A5 ADC_LINE(5)
#define ARDUINO_A6 ADC_LINE(6)
#define ARDUINO_A7 ADC_LINE(7)
#define ARDUINO_A8 ADC_LINE(8)
#define ARDUINO_A9 ADC_LINE(9)
#define ARDUINO_A10 ADC_LINE(10)
#define ARDUINO_A11 ADC_LINE(11)
#define ARDUINO_A12 ADC_LINE(12)
#define ARDUINO_A13 ADC_LINE(13)
#define ARDUINO_A14 ADC_LINE(14)
#define ARDUINO_ANALOG_PIN_LAST 14
/** @} */
/**
* @name Mapping of Arduino pins to RIOT PWM dev and channel pairs
* @{
*/
/**
* @brief PWM frequency
*/
#define ARDUINO_PWM_FREQU (732U)
#define ARDUINO_PIN_20_PWM_DEV PWM_DEV(0)
#define ARDUINO_PIN_20_PWM_CHAN 0
#define ARDUINO_PIN_29_PWM_DEV PWM_DEV(0)
#define ARDUINO_PIN_29_PWM_CHAN 1
#define ARDUINO_PIN_11_PWM_DEV PWM_DEV(1)
#define ARDUINO_PIN_11_PWM_CHAN 0
#define ARDUINO_PIN_13_PWM_DEV PWM_DEV(1)
#define ARDUINO_PIN_13_PWM_CHAN 1
#define ARDUINO_PIN_14_PWM_DEV PWM_DEV(1)
#define ARDUINO_PIN_14_PWM_CHAN 2
/** @} */
#ifdef __cplusplus
}
#endif
#endif /* ARDUINO_IOMAP_H */
/** @} */