2019-08-16 15:40:59 +02:00
|
|
|
/****************************************************************************
|
|
|
|
* boards/arm/tiva/dk-tm4c129x/include/board.h
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2021-03-17 18:14:12 +01:00
|
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
|
|
* this work for additional information regarding copyright ownership. The
|
|
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
|
|
* "License"); you may not use this file except in compliance with the
|
|
|
|
* License. You may obtain a copy of the License at
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2021-03-17 18:14:12 +01:00
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2021-03-17 18:14:12 +01:00
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
* License for the specific language governing permissions and limitations
|
|
|
|
* under the License.
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2019-08-16 15:40:59 +02:00
|
|
|
****************************************************************************/
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
#ifndef __BOARDS_ARM_TIVA_DK_TM4C129X_INCLUDE_BOARD_H
|
|
|
|
#define __BOARDS_ARM_TIVA_DK_TM4C129X_INCLUDE_BOARD_H
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/****************************************************************************
|
2014-12-16 22:27:36 +01:00
|
|
|
* Included Files
|
2019-08-16 15:40:59 +02:00
|
|
|
****************************************************************************/
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2014-12-18 17:20:34 +01:00
|
|
|
#ifndef __ASSEMBLY__
|
|
|
|
# include <stdbool.h>
|
|
|
|
#endif
|
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/****************************************************************************
|
2014-12-18 17:20:34 +01:00
|
|
|
* Pre-processor Definitions
|
2019-08-16 15:40:59 +02:00
|
|
|
****************************************************************************/
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/* Clocking *****************************************************************/
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2014-12-22 16:30:41 +01:00
|
|
|
/* Crystals on-board the DK-TM4C129X include:
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2019-08-16 15:40:59 +02:00
|
|
|
* 1. 25.0MHz (Y2) is connected to OSC0/1 pins and is used as the run mode
|
|
|
|
* input to the PLL.
|
2014-12-22 16:30:41 +01:00
|
|
|
* 2. 32.768kHz (Y3) connected to XOSC0/1 and clocks the hibernation module.
|
2014-12-16 22:27:36 +01:00
|
|
|
*/
|
|
|
|
|
2014-12-22 16:30:41 +01:00
|
|
|
#define SYSCON_RCC_XTAL SYSCON_RCC_XTAL16000KHZ /* On-board crystal is 25 MHz */
|
|
|
|
#define XTAL_FREQUENCY 25000000
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2015-01-09 21:10:31 +01:00
|
|
|
/* Frequencies of other clock sources */
|
|
|
|
|
|
|
|
#define PIOSC_FREQUENCY 16000000 /* Precision internal oscillator */
|
|
|
|
#define RTCOSC_FREQUENCY 32768 /* Hibernation Module RTC Oscillator */
|
|
|
|
#define LFIOSC_FREQUENCY 33000 /* Low frequency internal oscillator */
|
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/* The PLL generates Fvco according to the following formulae.
|
|
|
|
* The input clock to the PLL may be either the external crystal
|
|
|
|
* (Fxtal) or PIOSC (Fpiosc).
|
|
|
|
* This logic supports only the external crystal as the PLL source clock.
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2014-12-22 16:30:41 +01:00
|
|
|
* Fin = Fxtal / (Q + 1 )(N + 1) -OR- Fpiosc / (Q + 1)(N + 1)
|
|
|
|
* Mdiv = Mint + (MFrac / 1024)
|
|
|
|
* Fvco = Fin * Mdiv
|
|
|
|
*
|
2019-08-16 15:40:59 +02:00
|
|
|
* Where the register fields Q and N actually hold (Q-1) and (N-1).
|
|
|
|
* The following setup then generates Fvco = 480MHz:
|
2014-12-22 16:30:41 +01:00
|
|
|
*
|
|
|
|
* Fin = 25 MHz / 1 / 5 = 5 MHz
|
|
|
|
* Mdiv = 96
|
|
|
|
* Fvco = 480
|
2014-12-16 22:27:36 +01:00
|
|
|
*/
|
|
|
|
|
2014-12-22 16:30:41 +01:00
|
|
|
#define BOARD_PLL_MINT 96 /* Integer part of PLL M value */
|
|
|
|
#define BOARD_PLL_MFRAC 0 /* Fractional part of PLL M value */
|
|
|
|
#define BOARD_PLL_N 5 /* PLL N value */
|
|
|
|
#define BOARD_PLL_Q 1 /* PLL Q value */
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2014-12-22 16:30:41 +01:00
|
|
|
#define BOARD_FVCO_FREQUENCY 480000000 /* Resulting Fvco */
|
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/* When the PLL is active, the system clock frequency (SysClk) is
|
|
|
|
* calculated using the following equation:
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2018-12-05 00:20:25 +01:00
|
|
|
* SysClk = Fvco / (sysdiv + 1)
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2014-12-22 16:30:41 +01:00
|
|
|
* The following setup generates Sysclk = 120MHz:
|
2014-12-16 22:27:36 +01:00
|
|
|
*/
|
|
|
|
|
2014-12-22 16:30:41 +01:00
|
|
|
#define BOARD_PLL_SYSDIV 4 /* Sysclk = Fvco / 4 = 120MHz */
|
|
|
|
#define SYSCLK_FREQUENCY 120000000 /* Resulting SysClk frequency */
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2018-12-09 20:35:42 +01:00
|
|
|
/* Peripheral Clock (PCLK)
|
|
|
|
*
|
|
|
|
* Same frequency as the SYSCLK
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define PCLK_FREQUENCY SYSCLK_FREQUENCY
|
|
|
|
|
2015-01-09 21:10:31 +01:00
|
|
|
/* Alternate Clock (ALTCLK)
|
|
|
|
*
|
2019-08-16 15:40:59 +02:00
|
|
|
* The ALTCLK provides a clock source of numerous frequencies to the
|
|
|
|
* general-purpose timer, SSI, and UART modules.
|
|
|
|
* The default source for the ALTCLK is the Precision Internal Oscillator
|
|
|
|
* (PIOSC). The Hibernation Real-time Clock (RTCOSC) and Low Frequency
|
|
|
|
* Internal Oscillator (LFIOSC) are alternatives. If the RTCOSC Output is
|
2015-01-09 21:10:31 +01:00
|
|
|
* selected, the clock source must also be enabled in the Hibernation module.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define BOARD_ALTCLKCFG SYSCON_ALTCLKCFG_ALTCLK_PIOSC
|
|
|
|
#define ALTCLK_FREQUENCY PIOSC_FREQUENCY
|
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/* LED definitions **********************************************************/
|
|
|
|
|
2014-12-22 16:30:41 +01:00
|
|
|
/* The DK-TM4C129X has a single RGB LED. There is only one visible LED which
|
2019-08-16 15:40:59 +02:00
|
|
|
* will vary in color. But, from the standpoint of the firmware, this
|
|
|
|
* appears as three LEDs:
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2014-12-18 17:20:34 +01:00
|
|
|
* --- ------------ -----------------
|
|
|
|
* Pin Pin Function Jumper
|
|
|
|
* --- ------------ -----------------
|
|
|
|
* PN5 Red LED J36 pins 1 and 2
|
|
|
|
* PQ4 Blue LED J36 pins 3 and 4
|
|
|
|
* PQ7 Green LED J36 pins 5 and 6
|
|
|
|
* --- ------------ -----------------
|
2014-12-16 22:27:36 +01:00
|
|
|
*/
|
|
|
|
|
2015-11-01 17:53:34 +01:00
|
|
|
/* LED index values for use with board_userled() */
|
2014-12-16 22:27:36 +01:00
|
|
|
|
|
|
|
#define BOARD_LED_R 0
|
|
|
|
#define BOARD_LED_G 1
|
|
|
|
#define BOARD_LED_B 2
|
|
|
|
#define BOARD_NLEDS 3
|
|
|
|
|
2015-11-01 17:53:34 +01:00
|
|
|
/* LED bits for use with board_userled_all() */
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2014-12-18 17:20:34 +01:00
|
|
|
#define BOARD_LED_R_BIT (1 << BOARD_LED_R)
|
|
|
|
#define BOARD_LED_G_BIT (1 << BOARD_LED_G)
|
|
|
|
#define BOARD_LED_B_BIT (1 << BOARD_LED_B)
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/* If CONFIG_ARCH_LEDS is defined, then automated support for the DK-TM4C129X
|
|
|
|
* LED will be included in the build:
|
|
|
|
* RED GREEN BLUE
|
2014-12-16 22:27:36 +01:00
|
|
|
*/
|
2019-08-16 15:40:59 +02:00
|
|
|
|
2014-12-18 17:20:34 +01:00
|
|
|
#define LED_STARTED 0 /* OFF OFF ON */
|
|
|
|
#define LED_HEAPALLOCATE 1 /* NC NC NC */
|
|
|
|
#define LED_IRQSENABLED 1 /* NC NC NC */
|
|
|
|
#define LED_STACKCREATED 2 /* OFF ON OFF */
|
|
|
|
#define LED_INIRQ 1 /* NC NC NC */
|
|
|
|
#define LED_SIGNAL 1 /* NC NC NC */
|
|
|
|
#define LED_ASSERTION 1 /* NC NC NC */
|
|
|
|
#define LED_PANIC 3 /* ON OFF OFF (flashing 2Hz) */
|
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/* Button definitions *******************************************************/
|
|
|
|
|
2014-12-18 18:51:30 +01:00
|
|
|
/* There are three push buttons on the board.
|
2014-12-16 22:27:36 +01:00
|
|
|
*
|
2014-12-18 18:51:30 +01:00
|
|
|
* --- ------------ -----------------
|
|
|
|
* Pin Pin Function Jumper
|
|
|
|
* --- ------------ -----------------
|
|
|
|
* PP1 Select SW4 J37 pins 1 and 2
|
|
|
|
* PN3 Up SW2 J37 pins 3 and 4
|
|
|
|
* PE5 Down SW3 J37 pins 5 and 6
|
|
|
|
* --- ------------ -----------------
|
2014-12-16 22:27:36 +01:00
|
|
|
*/
|
|
|
|
|
2014-12-18 18:51:30 +01:00
|
|
|
#define BUTTON_SW2 0
|
|
|
|
#define BUTTON_SW3 1
|
|
|
|
#define BUTTON_SW4 2
|
|
|
|
#define NUM_BUTTONS 3
|
2014-12-16 22:27:36 +01:00
|
|
|
|
|
|
|
#define BUTTON_SW2_BIT (1 << BUTTON_SW2)
|
2014-12-18 18:51:30 +01:00
|
|
|
#define BUTTON_SW3_BIT (1 << BUTTON_SW3)
|
|
|
|
#define BUTTON_SW4_BIT (1 << BUTTON_SW4)
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/* Pin Multiplexing Disambiguation ******************************************/
|
|
|
|
|
2015-01-01 20:55:53 +01:00
|
|
|
/* UARTs
|
|
|
|
*
|
2015-01-01 21:16:05 +01:00
|
|
|
* UART0: PA0-1 (fixed configuration)
|
2019-08-16 15:40:59 +02:00
|
|
|
* UART3: PJ0-1 to EM_TX/EM_RX or BOOSTER_PACK2_RX/BOOSTER_PACK2_TX
|
|
|
|
* (Depending on J12/J13)
|
2015-01-01 21:16:05 +01:00
|
|
|
* UART5: PH6-7 to BOOSTER_PACK1_RX/BOOSTER_PACK1_TX
|
2015-01-01 20:55:53 +01:00
|
|
|
*/
|
|
|
|
|
2015-01-01 21:16:05 +01:00
|
|
|
#define GPIO_UART3_RX GPIO_UART3_RX_2
|
|
|
|
#define GPIO_UART3_TX GPIO_UART3_TX_2
|
|
|
|
|
|
|
|
#define GPIO_UART5_RX GPIO_UART5_RX_2
|
|
|
|
#define GPIO_UART5_TX GPIO_UART5_TX_2
|
|
|
|
|
2015-01-01 20:55:53 +01:00
|
|
|
/* SSI:
|
|
|
|
*
|
2019-08-16 15:40:59 +02:00
|
|
|
* SSI0: PA2-5 are used for SSI0 to the second booster pack
|
|
|
|
* (fixed configuration)
|
|
|
|
* SSI3: PF0/PF4-5/PH4/PQ0-2 are used for the SPI flash
|
|
|
|
* (on-board and SD card).
|
2015-01-01 20:55:53 +01:00
|
|
|
* PH4 selects the SD card and PQ1 selects the on-board SPI flash.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define GPIO_SSI3_CLK GPIO_SSI3_CLK_2
|
|
|
|
#define GPIO_SSI3_FSS GPIO_SSI3_FSS_2
|
|
|
|
#define GPIO_SSI3_XDAT0 GPIO_SSI3_XDAT0_2
|
|
|
|
#define GPIO_SSI3_XDAT1 GPIO_SSI3_XDAT1_1
|
|
|
|
#define GPIO_SSI3_XDAT2 GPIO_SSI3_XDAT2_1
|
|
|
|
#define GPIO_SSI3_XDAT3 GPIO_SSI3_XDAT3_1
|
|
|
|
|
|
|
|
/* I2C:
|
|
|
|
*
|
2015-01-05 20:40:55 +01:00
|
|
|
* I2C3: PG4-5 are provide to the BoostPack 1 interface
|
|
|
|
* I2C7: PA4-5 are provide to the BoostPack 2 interface
|
2015-01-01 20:55:53 +01:00
|
|
|
* I2C6: PB6-7 are used for I2C to the TMP100 and the EM connector.
|
2015-01-05 20:40:55 +01:00
|
|
|
* J18 and J20 must be closed to connect the TMP100.
|
|
|
|
* I2C address is 0x4A
|
2015-01-01 20:55:53 +01:00
|
|
|
*/
|
|
|
|
|
2015-01-05 20:40:55 +01:00
|
|
|
#define GPIO_I2C3_SCL GPIO_I2C3_SCL_1
|
|
|
|
#define GPIO_I2C3_SDA GPIO_I2C3_SDA_1
|
|
|
|
#define GPIO_I2C7_SCL GPIO_I2C7_SCL_1
|
|
|
|
#define GPIO_I2C7_SDA GPIO_I2C7_SDA_1
|
2015-01-01 20:55:53 +01:00
|
|
|
#define GPIO_I2C6_SCL GPIO_I2C6_SCL_2
|
|
|
|
#define GPIO_I2C6_SDA GPIO_I2C6_SDA_2
|
|
|
|
|
|
|
|
/* USB:
|
|
|
|
*
|
2019-08-16 15:40:59 +02:00
|
|
|
* PB0-1/PD6-7/PL6-7 are used for USB
|
|
|
|
* (Only PD6-7 are not fixed configuration)
|
2015-01-01 20:55:53 +01:00
|
|
|
*/
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2015-01-01 20:55:53 +01:00
|
|
|
#define GPIO_USB0_EPEN GPIO_USB0_EPEN_3
|
|
|
|
#define GPIO_USB0_PFLT GPIO_USB0_PFLT_2
|
2014-12-16 22:27:36 +01:00
|
|
|
|
2015-01-01 14:55:15 +01:00
|
|
|
/* Ethernet LEDs
|
|
|
|
*
|
2015-01-01 20:55:53 +01:00
|
|
|
* PF1/PK4/PK6 are used for Ethernet LEDs.
|
|
|
|
* PK4/EN0RXD3/LED0
|
|
|
|
* PK6/EN0TXD2/LED1
|
|
|
|
* PF1/LED2
|
2015-01-01 14:55:15 +01:00
|
|
|
*/
|
|
|
|
|
|
|
|
# define GPIO_EN0_LED0 GPIO_EN0_LED0_2
|
|
|
|
# define GPIO_EN0_LED1 GPIO_EN0_LED1_2
|
|
|
|
# define GPIO_EN0_LED2 GPIO_EN0_LED2_1
|
|
|
|
|
2015-01-01 20:55:53 +01:00
|
|
|
/* LCD
|
|
|
|
*
|
|
|
|
* PF6-7/PJ6/PS4-5/PR0-7 are used for the LCD (fixed configuration).
|
|
|
|
*/
|
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/****************************************************************************
|
2014-12-16 22:27:36 +01:00
|
|
|
* Public Function Prototypes
|
2019-08-16 15:40:59 +02:00
|
|
|
****************************************************************************/
|
2014-12-16 22:27:36 +01:00
|
|
|
|
|
|
|
#ifndef __ASSEMBLY__
|
|
|
|
|
2019-08-16 15:40:59 +02:00
|
|
|
/****************************************************************************
|
2015-01-06 18:50:56 +01:00
|
|
|
* Name: tiva_tmp100_initialize
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Initialize and register the TMP-100 Temperature Sensor driver.
|
|
|
|
*
|
2018-02-01 17:00:02 +01:00
|
|
|
* Input Parameters:
|
2015-01-06 18:50:56 +01:00
|
|
|
* devpath - The full path to the driver to register. E.g., "/dev/temp0"
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* Zero (OK) on success; a negated errno value on failure.
|
|
|
|
*
|
2019-08-16 15:40:59 +02:00
|
|
|
****************************************************************************/
|
2015-01-06 18:50:56 +01:00
|
|
|
|
2017-08-24 18:10:00 +02:00
|
|
|
#if defined(CONFIG_I2C) && defined(CONFIG_LM75_I2C) && defined(CONFIG_TIVA_I2C6)
|
2015-01-06 18:50:56 +01:00
|
|
|
int tiva_tmp100_initialize(FAR const char *devpath);
|
2014-12-16 22:27:36 +01:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif /* __ASSEMBLY__ */
|
2020-01-31 19:07:39 +01:00
|
|
|
#endif /* __BOARDS_ARM_TIVA_DK_TM4C129X_INCLUDE_BOARD_H */
|