179 lines
6.8 KiB
C
179 lines
6.8 KiB
C
/**************************************************************************/
|
|
/*!
|
|
@file board.h
|
|
@author hathach (tinyusb.org)
|
|
|
|
@section LICENSE
|
|
|
|
Software License Agreement (BSD License)
|
|
|
|
Copyright (c) 2013, hathach (tinyusb.org)
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
1. Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
2. Redistributions in binary form must reproduce the above copyright
|
|
notice, this list of conditions and the following disclaimer in the
|
|
documentation and/or other materials provided with the distribution.
|
|
3. Neither the name of the copyright holders nor the
|
|
names of its contributors may be used to endorse or promote products
|
|
derived from this software without specific prior written permission.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY
|
|
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER 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.
|
|
|
|
This file is part of the tinyusb stack.
|
|
*/
|
|
/**************************************************************************/
|
|
|
|
/** \ingroup group_demo
|
|
* \defgroup group_board Boards Abstraction Layer
|
|
* @{ */
|
|
|
|
#ifndef _TUSB_BOARD_H_
|
|
#define _TUSB_BOARD_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
|
|
#include "ansi_escape.h"
|
|
#include "tusb.h"
|
|
|
|
//--------------------------------------------------------------------+
|
|
// BOARD DEFINE
|
|
//--------------------------------------------------------------------+
|
|
/** \defgroup group_supported_board Supported Boards
|
|
* @{ */
|
|
#define BOARD_LPCXPRESSO11U14 1114 ///< LPCXpresso 11u14, some APIs requires the base board
|
|
#define BOARD_LPCXPRESSO11U68 1168 ///< LPC11U37 from microbuilder http://www.microbuilder.eu/Blog/13-03-14/LPC1xxx_1GHZ_Wireless_Board_Preview.aspx
|
|
#define BOARD_LPCXPRESSO1347 1347 ///< LPCXpresso 1347, some APIs requires the base board
|
|
#define BOARD_LPCXPRESSO1769 1769 ///< LPCXpresso 1769, some APIs requires the base board
|
|
|
|
#define BOARD_NGX4330 4330 ///< NGX 4330 Xplorer
|
|
#define BOARD_EA4357 4357 ///< Embedded Artists LPC4357 developer kit
|
|
#define BOARD_MCB4300 4300 ///< Keil MCB4300
|
|
#define BOARD_HITEX4350 4350 ///< Hitex 4350
|
|
|
|
#define BOARD_LPC4357USB 4304 ///< microbuilder.eu
|
|
|
|
#define BOARD_LPCLINK2 4370 ///< LPClink2 uses as LPC4370 development board
|
|
/** @} */
|
|
|
|
//--------------------------------------------------------------------+
|
|
// PRINTF TARGET DEFINE
|
|
//--------------------------------------------------------------------+
|
|
/** \defgroup group_printf Printf Retarget
|
|
* \brief Retarget the standard stdio printf/getchar to other IOs
|
|
* @{ */
|
|
#define PRINTF_TARGET_SEMIHOST 1 ///< Using the semihost support from toolchain, requires no hardware but is the slowest
|
|
#define PRINTF_TARGET_UART 2 ///< Using UART as stdio, this is the default for most of the board
|
|
#define PRINTF_TARGET_SWO 3 ///< Using non-instructive serial wire output (SWO), is the best option since it does not slow down MCU but requires supported from debugger and IDE
|
|
#define PRINTF_TARGET_NONE 4 ///< Using none at all.
|
|
/** @} */
|
|
|
|
#define PRINTF(...) printf(__VA_ARGS__)
|
|
|
|
//--------------------------------------------------------------------+
|
|
// BOARD INCLUDE
|
|
//--------------------------------------------------------------------+
|
|
#if BOARD == BOARD_LPCXPRESSO11U14
|
|
#include "lpcxpresso11u14/board_lpcxpresso11u14.h"
|
|
#elif BOARD == BOARD_LPCXPRESSO11U68
|
|
#include "lpcxpresso11u68/board_lpcxpresso11u68.h"
|
|
#elif BOARD == BOARD_LPCXPRESSO1347
|
|
#include "lpcxpresso1347/board_lpcxpresso1347.h"
|
|
#elif BOARD == BOARD_LPCXPRESSO1769
|
|
#include "lpcxpresso1769/board_lpcxpresso1769.h"
|
|
#elif BOARD == BOARD_NGX4330
|
|
#include "ngx/board_ngx4330.h"
|
|
#elif BOARD == BOARD_EA4357
|
|
#include "ea4357/board_ea4357.h"
|
|
#elif BOARD == BOARD_MCB4300
|
|
#include "keil/board_mcb4300.h"
|
|
#elif BOARD == BOARD_HITEX4350
|
|
#include "hitex/board_hitex4350.h"
|
|
#elif BOARD == BOARD_LPC4357USB
|
|
#include "microbuilder/board_lpc4357usb.h"
|
|
#elif BOARD == BOARD_LPCLINK2
|
|
#include "lpcxpresso/board_lpclink2.h"
|
|
#elif defined BOARD_PCA10056
|
|
#include "pca10056/board_pca10056.h"
|
|
#else
|
|
#error BOARD is not defined or supported yet
|
|
#endif
|
|
|
|
//--------------------------------------------------------------------+
|
|
// Common Configuration
|
|
//--------------------------------------------------------------------+
|
|
#define CFG_UART_BAUDRATE 115200 ///< Baudrate for UART
|
|
|
|
//--------------------------------------------------------------------+
|
|
// Board Common API
|
|
//--------------------------------------------------------------------+
|
|
/** \defgroup group_board_api Board API
|
|
* \brief All the board must support these APIs.
|
|
* @{ */
|
|
|
|
/// Initialize all required peripherals on board including uart, led, buttons etc ...
|
|
void board_init(void);
|
|
|
|
/** \brief Turns on and off leds on the board
|
|
* \param[in] on_mask Bitmask for LED's numbers is turning ON
|
|
* \param[out] off_mask Bitmask for LED's numbers is turning OFF
|
|
* \note the \a on_mask is more priority then \a off_mask, if an led's number is present on both.
|
|
* It will be turned ON.
|
|
*/
|
|
void board_leds(uint32_t on_mask, uint32_t off_mask);
|
|
|
|
/** \brief Get the current state of the buttons on the board
|
|
* \return Bitmask where a '1' means active (pressed), a '0' means inactive.
|
|
*/
|
|
uint32_t board_buttons(void);
|
|
|
|
/** \brief Get a character input from UART
|
|
* \return ASCII code of the input character or zero if none.
|
|
*/
|
|
uint8_t board_uart_getchar(void);
|
|
|
|
/** \brief Send a character to UART
|
|
* \param[in] c the character to be sent
|
|
*/
|
|
void board_uart_putchar(uint8_t c);
|
|
|
|
/** @} */
|
|
|
|
#if 0
|
|
//------------- Board Application -------------//
|
|
void led_blinking_task(void* param);
|
|
|
|
/// Initialize the LED blinking task application. The initial blinking rate is 1 Hert (1 per second)
|
|
void led_blinking_init(void);
|
|
|
|
/** \brief Change the blinking rate.
|
|
* \param[in] ms The interval between on and off.
|
|
*/
|
|
void led_blinking_set_interval(uint32_t ms);
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _TUSB_BOARD_H_ */
|
|
|
|
/** @} */
|