mirror of
https://gitea.osmocom.org/sim-card/simtrace2.git
synced 2026-03-16 21:28:33 +03:00
3f5e3ddffc
This way we can easily check with 'diff' for differences in our code and Atmel softpack. Also, this layout is more suitable for building various different firmware images (e.g. factory-test, dfu-loader, main application) for a variety of different boards (simtrace, owhw, qmod).
207 lines
6.5 KiB
C
207 lines
6.5 KiB
C
/* ----------------------------------------------------------------------------
|
|
* ATMEL Microcontroller Software Support
|
|
* ----------------------------------------------------------------------------
|
|
* Copyright (c) 2010, Atmel Corporation
|
|
*
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* - Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the disclaimer below.
|
|
*
|
|
* Atmel's name may not be used to endorse or promote products derived from
|
|
* this software without specific prior written permission.
|
|
*
|
|
* DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
|
|
* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
* ----------------------------------------------------------------------------
|
|
*/
|
|
|
|
/**
|
|
* \file
|
|
*
|
|
* \section Purpose
|
|
*
|
|
* This file provides a basic API for PIO configuration and usage of
|
|
* user-controlled pins. Please refer to the board.h file for a list of
|
|
* available pin definitions.
|
|
*
|
|
* \section Usage
|
|
*
|
|
* -# Define a constant pin description array such as the following one, using
|
|
* the existing definitions provided by the board.h file if possible:
|
|
* \code
|
|
* const Pin pPins[] = {PIN_USART0_TXD, PIN_USART0_RXD};
|
|
* \endcode
|
|
* Alternatively, it is possible to add new pins by provided the full Pin
|
|
* structure:
|
|
* \code
|
|
* // Pin instance to configure PA10 & PA11 as inputs with the internal
|
|
* // pull-up enabled.
|
|
* const Pin pPins = {
|
|
* (1 << 10) | (1 << 11),
|
|
* REG_PIOA,
|
|
* ID_PIOA,
|
|
* PIO_INPUT,
|
|
* PIO_PULLUP
|
|
* };
|
|
* \endcode
|
|
* -# Configure a pin array by calling PIO_Configure() with a pointer to the
|
|
* array and its size (which is computed using the PIO_LISTSIZE macro).
|
|
* -# Change and get the value of a user-controlled pin using the PIO_Set,
|
|
* PIO_Clear and PIO_Get methods.
|
|
* -# Get the level being currently output by a user-controlled pin configured
|
|
* as an output using PIO_GetOutputDataStatus().
|
|
*/
|
|
|
|
#ifndef _PIO_
|
|
#define _PIO_
|
|
|
|
/*
|
|
* Headers
|
|
*/
|
|
|
|
#include "chip.h"
|
|
|
|
#include <stdint.h>
|
|
|
|
/*
|
|
* Global Definitions
|
|
*/
|
|
|
|
/* The pin is controlled by the associated signal of peripheral A. */
|
|
#define PIO_PERIPH_A 0
|
|
/* The pin is controlled by the associated signal of peripheral B. */
|
|
#define PIO_PERIPH_B 1
|
|
/* The pin is controlled by the associated signal of peripheral C. */
|
|
#define PIO_PERIPH_C 2
|
|
/* The pin is controlled by the associated signal of peripheral D. */
|
|
#define PIO_PERIPH_D 3
|
|
/* The pin is an input. */
|
|
#define PIO_INPUT 4
|
|
/* The pin is an output and has a default level of 0. */
|
|
#define PIO_OUTPUT_0 5
|
|
/* The pin is an output and has a default level of 1. */
|
|
#define PIO_OUTPUT_1 6
|
|
|
|
/* Default pin configuration (no attribute). */
|
|
#define PIO_DEFAULT (0 << 0)
|
|
/* The internal pin pull-up is active. */
|
|
#define PIO_PULLUP (1 << 0)
|
|
/* The internal glitch filter is active. */
|
|
#define PIO_DEGLITCH (1 << 1)
|
|
/* The pin is open-drain. */
|
|
#define PIO_OPENDRAIN (1 << 2)
|
|
|
|
/* The internal debouncing filter is active. */
|
|
#define PIO_DEBOUNCE (1 << 3)
|
|
|
|
/* Enable additional interrupt modes. */
|
|
#define PIO_IT_AIME (1 << 4)
|
|
|
|
/* Interrupt High Level/Rising Edge detection is active. */
|
|
#define PIO_IT_RE_OR_HL (1 << 5)
|
|
/* Interrupt Edge detection is active. */
|
|
#define PIO_IT_EDGE (1 << 6)
|
|
|
|
/* Low level interrupt is active */
|
|
#define PIO_IT_LOW_LEVEL (0 | 0 | PIO_IT_AIME)
|
|
/* High level interrupt is active */
|
|
#define PIO_IT_HIGH_LEVEL (PIO_IT_RE_OR_HL | 0 | PIO_IT_AIME)
|
|
/* Falling edge interrupt is active */
|
|
#define PIO_IT_FALL_EDGE (0 | PIO_IT_EDGE | PIO_IT_AIME)
|
|
/* Rising edge interrupt is active */
|
|
#define PIO_IT_RISE_EDGE (PIO_IT_RE_OR_HL | PIO_IT_EDGE | PIO_IT_AIME)
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* Global Macros
|
|
*/
|
|
|
|
/**
|
|
* Calculates the size of an array of Pin instances. The array must be defined
|
|
* locally (i.e. not a pointer), otherwise the computation will not be correct.
|
|
* \param pPins Local array of Pin instances.
|
|
* \return Number of elements in array.
|
|
*/
|
|
#define PIO_LISTSIZE(pPins) (sizeof(pPins) / sizeof(Pin))
|
|
|
|
/*
|
|
* Global Types
|
|
*/
|
|
|
|
|
|
/*
|
|
* Describes the type and attribute of one PIO pin or a group of similar pins.
|
|
* The #type# field can have the following values:
|
|
* - PIO_PERIPH_A
|
|
* - PIO_PERIPH_B
|
|
* - PIO_OUTPUT_0
|
|
* - PIO_OUTPUT_1
|
|
* - PIO_INPUT
|
|
*
|
|
* The #attribute# field is a bitmask that can either be set to PIO_DEFAULt,
|
|
* or combine (using bitwise OR '|') any number of the following constants:
|
|
* - PIO_PULLUP
|
|
* - PIO_DEGLITCH
|
|
* - PIO_DEBOUNCE
|
|
* - PIO_OPENDRAIN
|
|
* - PIO_IT_LOW_LEVEL
|
|
* - PIO_IT_HIGH_LEVEL
|
|
* - PIO_IT_FALL_EDGE
|
|
* - PIO_IT_RISE_EDGE
|
|
*/
|
|
typedef struct _Pin
|
|
{
|
|
/* Bitmask indicating which pin(s) to configure. */
|
|
uint32_t mask;
|
|
/* Pointer to the PIO controller which has the pin(s). */
|
|
Pio *pio;
|
|
/* Peripheral ID of the PIO controller which has the pin(s). */
|
|
uint8_t id;
|
|
/* Pin type. */
|
|
uint8_t type;
|
|
/* Pin attribute. */
|
|
uint8_t attribute;
|
|
} Pin ;
|
|
|
|
/*
|
|
* Global Access Macros
|
|
*/
|
|
|
|
/*
|
|
* Global Functions
|
|
*/
|
|
|
|
extern uint8_t PIO_Configure( const Pin *list, uint32_t size ) ;
|
|
|
|
extern void PIO_Set( const Pin *pin ) ;
|
|
|
|
extern void PIO_Clear( const Pin *pin ) ;
|
|
|
|
extern uint8_t PIO_Get( const Pin *pin ) ;
|
|
|
|
extern uint8_t PIO_GetOutputDataStatus( const Pin *pin ) ;
|
|
|
|
extern void PIO_SetDebounceFilter( const Pin *pin, uint32_t cuttoff );
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* #ifndef _PIO_ */
|
|
|