mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_H743ZI/TOOLCHAIN_ARM_STD/PinNamesTypes.h@172:65be27845400, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
Parent:
TARGET_NUCLEO_L031K6/TOOLCHAIN_ARM_STD/PinNamesTypes.h@171:3a7713b1edbc 
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 157:e7ca05fa8600 1 /* mbed Microcontroller Library
AnnaBridge 157:e7ca05fa8600 2 *******************************************************************************
AnnaBridge 157:e7ca05fa8600 3 * Copyright (c) 2016, STMicroelectronics
AnnaBridge 157:e7ca05fa8600 4 * All rights reserved.
AnnaBridge 157:e7ca05fa8600 5 *
AnnaBridge 157:e7ca05fa8600 6 * Redistribution and use in source and binary forms, with or without
AnnaBridge 157:e7ca05fa8600 7 * modification, are permitted provided that the following conditions are met:
AnnaBridge 157:e7ca05fa8600 8 *
AnnaBridge 157:e7ca05fa8600 9 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 157:e7ca05fa8600 10 * this list of conditions and the following disclaimer.
AnnaBridge 157:e7ca05fa8600 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 157:e7ca05fa8600 12 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 157:e7ca05fa8600 13 * and/or other materials provided with the distribution.
AnnaBridge 157:e7ca05fa8600 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 157:e7ca05fa8600 15 * may be used to endorse or promote products derived from this software
AnnaBridge 157:e7ca05fa8600 16 * without specific prior written permission.
AnnaBridge 157:e7ca05fa8600 17 *
AnnaBridge 157:e7ca05fa8600 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 157:e7ca05fa8600 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 157:e7ca05fa8600 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 157:e7ca05fa8600 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 157:e7ca05fa8600 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 157:e7ca05fa8600 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 157:e7ca05fa8600 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 157:e7ca05fa8600 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 157:e7ca05fa8600 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 157:e7ca05fa8600 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 157:e7ca05fa8600 28 *******************************************************************************
AnnaBridge 157:e7ca05fa8600 29 */
AnnaBridge 157:e7ca05fa8600 30 #ifndef MBED_PINNAMESTYPES_H
AnnaBridge 157:e7ca05fa8600 31 #define MBED_PINNAMESTYPES_H
AnnaBridge 157:e7ca05fa8600 32
AnnaBridge 157:e7ca05fa8600 33 #include "cmsis.h"
AnnaBridge 157:e7ca05fa8600 34
AnnaBridge 157:e7ca05fa8600 35 #ifdef __cplusplus
AnnaBridge 157:e7ca05fa8600 36 extern "C" {
AnnaBridge 157:e7ca05fa8600 37 #endif
AnnaBridge 157:e7ca05fa8600 38
AnnaBridge 157:e7ca05fa8600 39 /* STM PIN data as used in pin_function is coded on 32 bits as below
AnnaBridge 170:e95d10626187 40 * [2:0] Function (like in MODER reg) : Input / Output / Alt / Analog
AnnaBridge 157:e7ca05fa8600 41 * [3] Output Push-Pull / Open Drain (as in OTYPER reg)
AnnaBridge 157:e7ca05fa8600 42 * [5:4] as in PUPDR reg: No Pull, Pull-up, Pull-Donc
AnnaBridge 157:e7ca05fa8600 43 * [7:6] Reserved for speed config (as in OSPEEDR), but not used yet
AnnaBridge 157:e7ca05fa8600 44 * [11:8] Alternate Num (as in AFRL/AFRG reg)
AnnaBridge 157:e7ca05fa8600 45 * [16:12] Channel (Analog/Timer specific)
AnnaBridge 157:e7ca05fa8600 46 * [17] Inverted (Analog/Timer specific)
AnnaBridge 157:e7ca05fa8600 47 * [18] Analog ADC control - Only valid for specific families
AnnaBridge 157:e7ca05fa8600 48 * [32:19] Reserved
AnnaBridge 157:e7ca05fa8600 49 */
AnnaBridge 157:e7ca05fa8600 50
AnnaBridge 157:e7ca05fa8600 51 #define STM_PIN_FUNCTION_MASK 0x07
AnnaBridge 157:e7ca05fa8600 52 #define STM_PIN_FUNCTION_SHIFT 0
AnnaBridge 157:e7ca05fa8600 53 #define STM_PIN_FUNCTION_BITS (STM_PIN_FUNCTION_MASK << STM_PIN_FUNCTION_SHIFT)
AnnaBridge 157:e7ca05fa8600 54
AnnaBridge 157:e7ca05fa8600 55 #define STM_PIN_OD_MASK 0x01
AnnaBridge 157:e7ca05fa8600 56 #define STM_PIN_OD_SHIFT 3
AnnaBridge 157:e7ca05fa8600 57 #define STM_PIN_OD_BITS (STM_PIN_OD_MASK << STM_PIN_OD_SHIFT)
AnnaBridge 157:e7ca05fa8600 58
AnnaBridge 157:e7ca05fa8600 59 #define STM_PIN_PUPD_MASK 0x03
AnnaBridge 157:e7ca05fa8600 60 #define STM_PIN_PUPD_SHIFT 4
AnnaBridge 157:e7ca05fa8600 61 #define STM_PIN_PUPD_BITS (STM_PIN_PUPD_MASK << STM_PIN_PUPD_SHIFT)
AnnaBridge 157:e7ca05fa8600 62
AnnaBridge 157:e7ca05fa8600 63 #define STM_PIN_SPEED_MASK 0x03
AnnaBridge 157:e7ca05fa8600 64 #define STM_PIN_SPEED_SHIFT 6
AnnaBridge 157:e7ca05fa8600 65 #define STM_PIN_SPEED_BITS (STM_PIN_SPEED_MASK << STM_PIN_SPEED_SHIFT)
AnnaBridge 157:e7ca05fa8600 66
AnnaBridge 157:e7ca05fa8600 67 #define STM_PIN_AFNUM_MASK 0x0F
AnnaBridge 157:e7ca05fa8600 68 #define STM_PIN_AFNUM_SHIFT 8
AnnaBridge 157:e7ca05fa8600 69 #define STM_PIN_AFNUM_BITS (STM_PIN_AFNUM_MASK << STM_PIN_AFNUM_SHIFT)
AnnaBridge 157:e7ca05fa8600 70
AnnaBridge 157:e7ca05fa8600 71 #define STM_PIN_CHAN_MASK 0x1F
AnnaBridge 157:e7ca05fa8600 72 #define STM_PIN_CHAN_SHIFT 12
AnnaBridge 157:e7ca05fa8600 73 #define STM_PIN_CHANNEL_BIT (STM_PIN_CHAN_MASK << STM_PIN_CHAN_SHIFT)
AnnaBridge 157:e7ca05fa8600 74
AnnaBridge 157:e7ca05fa8600 75 #define STM_PIN_INV_MASK 0x01
AnnaBridge 157:e7ca05fa8600 76 #define STM_PIN_INV_SHIFT 17
AnnaBridge 157:e7ca05fa8600 77 #define STM_PIN_INV_BIT (STM_PIN_INV_MASK << STM_PIN_INV_SHIFT)
AnnaBridge 157:e7ca05fa8600 78
AnnaBridge 157:e7ca05fa8600 79 #define STM_PIN_AN_CTRL_MASK 0x01
AnnaBridge 157:e7ca05fa8600 80 #define STM_PIN_AN_CTRL_SHIFT 18
AnnaBridge 157:e7ca05fa8600 81 #define STM_PIN_ANALOG_CONTROL_BIT (STM_PIN_AN_CTRL_MASK << STM_PIN_AN_CTRL_SHIFT)
AnnaBridge 157:e7ca05fa8600 82
AnnaBridge 157:e7ca05fa8600 83 #define STM_PIN_FUNCTION(X) (((X) >> STM_PIN_FUNCTION_SHIFT) & STM_PIN_FUNCTION_MASK)
AnnaBridge 157:e7ca05fa8600 84 #define STM_PIN_OD(X) (((X) >> STM_PIN_OD_SHIFT) & STM_PIN_OD_MASK)
AnnaBridge 157:e7ca05fa8600 85 #define STM_PIN_PUPD(X) (((X) >> STM_PIN_PUPD_SHIFT) & STM_PIN_PUPD_MASK)
AnnaBridge 157:e7ca05fa8600 86 #define STM_PIN_SPEED(X) (((X) >> STM_PIN_SPEED_SHIFT) & STM_PIN_SPEED_MASK)
AnnaBridge 157:e7ca05fa8600 87 #define STM_PIN_AFNUM(X) (((X) >> STM_PIN_AFNUM_SHIFT) & STM_PIN_AFNUM_MASK)
AnnaBridge 157:e7ca05fa8600 88 #define STM_PIN_CHANNEL(X) (((X) >> STM_PIN_CHAN_SHIFT) & STM_PIN_CHAN_MASK)
AnnaBridge 157:e7ca05fa8600 89 #define STM_PIN_INVERTED(X) (((X) >> STM_PIN_INV_SHIFT) & STM_PIN_INV_MASK)
AnnaBridge 157:e7ca05fa8600 90 #define STM_PIN_ANALOG_CONTROL(X) (((X) >> STM_PIN_AN_CTRL_SHIFT) & STM_PIN_AN_CTRL_MASK)
AnnaBridge 157:e7ca05fa8600 91
AnnaBridge 157:e7ca05fa8600 92 #define STM_PIN_DEFINE(FUNC_OD, PUPD, AFNUM) ((int)(FUNC_OD) |\
AnnaBridge 157:e7ca05fa8600 93 ((PUPD & STM_PIN_PUPD_MASK) << STM_PIN_PUPD_SHIFT) |\
AnnaBridge 157:e7ca05fa8600 94 ((AFNUM & STM_PIN_AFNUM_MASK) << STM_PIN_AFNUM_SHIFT))
AnnaBridge 157:e7ca05fa8600 95
AnnaBridge 157:e7ca05fa8600 96 #define STM_PIN_DEFINE_EXT(FUNC_OD, PUPD, AFNUM, CHAN, INV) \
AnnaBridge 157:e7ca05fa8600 97 ((int)(FUNC_OD) |\
AnnaBridge 157:e7ca05fa8600 98 ((PUPD & STM_PIN_PUPD_MASK) << STM_PIN_PUPD_SHIFT) |\
AnnaBridge 157:e7ca05fa8600 99 ((AFNUM & STM_PIN_AFNUM_MASK) << STM_PIN_AFNUM_SHIFT) |\
AnnaBridge 157:e7ca05fa8600 100 ((CHAN & STM_PIN_CHAN_MASK) << STM_PIN_CHAN_SHIFT) |\
AnnaBridge 157:e7ca05fa8600 101 ((INV & STM_PIN_INV_MASK) << STM_PIN_INV_SHIFT))
AnnaBridge 157:e7ca05fa8600 102
AnnaBridge 157:e7ca05fa8600 103 /*
AnnaBridge 157:e7ca05fa8600 104 * MACROS to support the legacy definition of PIN formats
AnnaBridge 157:e7ca05fa8600 105 * The STM_MODE_ defines contain the function and the Push-pull/OpenDrain
AnnaBridge 157:e7ca05fa8600 106 * configuration (legacy inheritance).
AnnaBridge 157:e7ca05fa8600 107 */
AnnaBridge 157:e7ca05fa8600 108 #define STM_PIN_DATA(FUNC_OD, PUPD, AFNUM) \
AnnaBridge 157:e7ca05fa8600 109 STM_PIN_DEFINE(FUNC_OD, PUPD, AFNUM)
AnnaBridge 157:e7ca05fa8600 110 #define STM_PIN_DATA_EXT(FUNC_OD, PUPD, AFNUM, CHANNEL, INVERTED) \
AnnaBridge 157:e7ca05fa8600 111 STM_PIN_DEFINE_EXT(FUNC_OD, PUPD, AFNUM, CHANNEL, INVERTED)
AnnaBridge 157:e7ca05fa8600 112
AnnaBridge 157:e7ca05fa8600 113 typedef enum {
AnnaBridge 157:e7ca05fa8600 114 STM_PIN_INPUT = 0,
AnnaBridge 157:e7ca05fa8600 115 STM_PIN_OUTPUT = 1,
AnnaBridge 157:e7ca05fa8600 116 STM_PIN_ALTERNATE = 2,
AnnaBridge 157:e7ca05fa8600 117 STM_PIN_ANALOG = 3,
AnnaBridge 157:e7ca05fa8600 118 } StmPinFunction;
AnnaBridge 157:e7ca05fa8600 119
AnnaBridge 157:e7ca05fa8600 120 #define STM_MODE_INPUT (STM_PIN_INPUT)
AnnaBridge 157:e7ca05fa8600 121 #define STM_MODE_OUTPUT_PP (STM_PIN_OUTPUT)
AnnaBridge 157:e7ca05fa8600 122 #define STM_MODE_OUTPUT_OD (STM_PIN_OUTPUT | STM_PIN_OD_BITS)
AnnaBridge 157:e7ca05fa8600 123 #define STM_MODE_AF_PP (STM_PIN_ALTERNATE)
AnnaBridge 157:e7ca05fa8600 124 #define STM_MODE_AF_OD (STM_PIN_ALTERNATE | STM_PIN_OD_BITS)
AnnaBridge 157:e7ca05fa8600 125 #define STM_MODE_ANALOG (STM_PIN_ANALOG)
AnnaBridge 157:e7ca05fa8600 126 #define STM_MODE_ANALOG_ADC_CONTROL (STM_PIN_ANALOG | STM_PIN_ANALOG_CONTROL_BIT)
AnnaBridge 157:e7ca05fa8600 127
AnnaBridge 157:e7ca05fa8600 128 // High nibble = port number (0=A, 1=B, 2=C, 3=D, 4=E, 5=F, 6=G, 7=H)
AnnaBridge 157:e7ca05fa8600 129 // Low nibble = pin number
AnnaBridge 157:e7ca05fa8600 130 #define STM_PORT(X) (((uint32_t)(X) >> 4) & 0xF)
AnnaBridge 157:e7ca05fa8600 131 #define STM_PIN(X) ((uint32_t)(X) & 0xF)
AnnaBridge 157:e7ca05fa8600 132
AnnaBridge 157:e7ca05fa8600 133 /* Defines to be used by application */
AnnaBridge 157:e7ca05fa8600 134 typedef enum {
AnnaBridge 157:e7ca05fa8600 135 PIN_INPUT = 0,
AnnaBridge 157:e7ca05fa8600 136 PIN_OUTPUT
AnnaBridge 157:e7ca05fa8600 137 } PinDirection;
AnnaBridge 157:e7ca05fa8600 138
AnnaBridge 157:e7ca05fa8600 139 typedef enum {
AnnaBridge 157:e7ca05fa8600 140 PullNone = 0,
AnnaBridge 157:e7ca05fa8600 141 PullUp = 1,
AnnaBridge 157:e7ca05fa8600 142 PullDown = 2,
AnnaBridge 157:e7ca05fa8600 143 OpenDrainPullUp = 3,
AnnaBridge 157:e7ca05fa8600 144 OpenDrainNoPull = 4,
AnnaBridge 157:e7ca05fa8600 145 OpenDrainPullDown = 5,
AnnaBridge 157:e7ca05fa8600 146 PushPullNoPull = PullNone,
AnnaBridge 157:e7ca05fa8600 147 PushPullPullUp = PullUp,
AnnaBridge 157:e7ca05fa8600 148 PushPullPullDown = PullDown,
AnnaBridge 157:e7ca05fa8600 149 OpenDrain = OpenDrainPullUp,
AnnaBridge 157:e7ca05fa8600 150 PullDefault = PullNone
AnnaBridge 157:e7ca05fa8600 151 } PinMode;
AnnaBridge 157:e7ca05fa8600 152
AnnaBridge 157:e7ca05fa8600 153 #ifdef __cplusplus
AnnaBridge 157:e7ca05fa8600 154 }
AnnaBridge 157:e7ca05fa8600 155 #endif
AnnaBridge 157:e7ca05fa8600 156
AnnaBridge 157:e7ca05fa8600 157 #endif
AnnaBridge 157:e7ca05fa8600 158