mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
446 lines
14 KiB
C
446 lines
14 KiB
C
/*
|
|
* Copyright (C) 2015 Freie Universität Berlin
|
|
*
|
|
* 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 cpu_msp430fxyz
|
|
* @{
|
|
*
|
|
* @file
|
|
* @brief Cortex CMSIS style definition of MSP430 registers
|
|
*
|
|
* @todo This file is incomplete, not all registers are listed. Further
|
|
* There are probably some inconsistencies throughout the MSP430
|
|
* family which need to be addressed.
|
|
*
|
|
* @author Hauke Petersen <hauke.petersen@fu-berlin.de>
|
|
*/
|
|
|
|
#ifndef MSP430_REGS_H
|
|
#define MSP430_REGS_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Shortcut to specify 8-bit wide registers
|
|
*/
|
|
#define REG8 volatile uint8_t
|
|
|
|
/**
|
|
* @brief Shortcut to specify 16-bit wide registers
|
|
*/
|
|
#define REG16 volatile uint16_t
|
|
|
|
/**
|
|
* @brief Special function registers
|
|
*/
|
|
typedef struct {
|
|
REG8 IE1; /**< interrupt enable 1 */
|
|
REG8 IE2; /**< interrupt enable 2 */
|
|
REG8 IFG1; /**< interrupt flag 1 */
|
|
REG8 IFG2; /**< interrupt flag 2 */
|
|
REG8 ME1; /**< module enable 1 */
|
|
REG8 ME2; /**< module enable 2 */
|
|
} msp_sfr_t;
|
|
|
|
/**
|
|
* @brief Digital I/O Port w/o interrupt functionality (P3-P6)
|
|
*/
|
|
typedef struct {
|
|
REG8 IN; /**< input data */
|
|
REG8 OD; /**< output data */
|
|
REG8 DIR; /**< pin direction */
|
|
REG8 SEL; /**< alternative function select */
|
|
} msp_port_t;
|
|
|
|
/**
|
|
* @brief Digital I/O Port with interrupt functionality (P1 & P2)
|
|
*/
|
|
typedef struct {
|
|
REG8 IN; /**< input data */
|
|
REG8 OD; /**< output data */
|
|
REG8 DIR; /**< pin direction */
|
|
REG8 IFG; /**< interrupt flag */
|
|
REG8 IES; /**< interrupt edge select */
|
|
REG8 IE; /**< interrupt enable */
|
|
REG8 SEL; /**< alternative function select */
|
|
} msp_port_isr_t;
|
|
|
|
/**
|
|
* @brief USART (UART, SPI and I2C) registers
|
|
*/
|
|
typedef struct {
|
|
REG8 CTL; /**< USART control */
|
|
REG8 TCTL; /**< transmit control */
|
|
REG8 RCTL; /**< receive control */
|
|
REG8 MCTL; /**< modulation control */
|
|
REG8 BR0; /**< baud rate control 0 */
|
|
REG8 BR1; /**< baud rate control 1 */
|
|
REG8 RXBUF; /**< receive buffer */
|
|
REG8 TXBUF; /**< transmit buffer */
|
|
} msp_usart_t;
|
|
|
|
/**
|
|
* @brief USCI universal serial control interface registers
|
|
*/
|
|
typedef struct {
|
|
REG8 ABCTL; /**< auto baud rate control */
|
|
REG8 IRTCTL; /**< IrDA transmit control */
|
|
REG8 IRRCTL; /**< IrDA receive control */
|
|
REG8 ACTL0; /**< A control 0 */
|
|
REG8 ACTL1; /**< A control 1 */
|
|
REG8 ABR0; /**< A baud rate control 0 */
|
|
REG8 ABR1; /**< A baud rate control 1 */
|
|
REG8 AMCTL; /**< A modulation control */
|
|
REG8 ASTAT; /**< A status */
|
|
REG8 ARXBUF; /**< A receive buffer */
|
|
REG8 ATXBUF; /**< A transmit buffer */
|
|
REG8 BCTL0; /**< B control 0 */
|
|
REG8 BCTL1; /**< B control 1 */
|
|
REG8 BBR0; /**< B baud rate 0 */
|
|
REG8 BBR1; /**< B baud rate 1 */
|
|
REG8 BI2CIE; /**< I2C interrupt enable */
|
|
REG8 BSTAT; /**< B status */
|
|
REG8 BRXBUF; /**< B receive buffer */
|
|
REG8 BTXBUF; /**< B transmit buffer */
|
|
} msp_usci_t;
|
|
|
|
/**
|
|
* @brief USCI SPI specific registers
|
|
*/
|
|
typedef struct {
|
|
REG8 CTL0; /**< control 0 */
|
|
REG8 CTL1; /**< control 1 */
|
|
REG8 BR0; /**< baud rate 0 */
|
|
REG8 BR1; /**< baud rate 1 */
|
|
REG8 reserved; /**< reserved */
|
|
REG8 STAT; /**< status */
|
|
REG8 RXBUF; /**< receive buffer */
|
|
REG8 TXBUF; /**< transmit buffer */
|
|
} msp_usci_spi_t;
|
|
|
|
/**
|
|
* @brief Timer interrupt status registers
|
|
*/
|
|
typedef struct {
|
|
REG16 TBIV; /**< TIMER_A interrupt status */
|
|
REG16 reserved[7]; /**< reserved */
|
|
REG16 TAIV; /**< TIMER_B interrupt status */
|
|
} msp_timer_ivec_t;
|
|
|
|
/**
|
|
* @brief Timer module registers
|
|
*/
|
|
typedef struct {
|
|
REG16 CTL; /**< timer control */
|
|
REG16 CCTL[7]; /**< capture compare channel control */
|
|
REG16 R; /**< current counter value */
|
|
REG16 CCR[7]; /**< capture compare channel values */
|
|
} msp_timer_t;
|
|
|
|
/**
|
|
* @brief SFR interrupt enable 1 register bitmap
|
|
* @{
|
|
*/
|
|
#define SFR_IE1_OFIE (0x02)
|
|
#define SFR_IE1_URXIE0 (0x40)
|
|
#define SFR_IE1_UTXIE0 (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief SFR interrupt enable 2 register bitmap
|
|
* @{
|
|
*/
|
|
#define SFR_IE2_UCA0RXIE (0x01)
|
|
#define SFR_IE2_UCA0TXIE (0x02)
|
|
#define SFR_IE2_URXIE2 (0x10)
|
|
#define SFR_IE2_UTXIE2 (0x20)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief SFR interrupt flag 1 register bitmap
|
|
* @{
|
|
*/
|
|
#define SFR_IFG1_OFIFG (0x02)
|
|
#define SFR_IFG1_URXIFG0 (0x40)
|
|
#define SFR_IFG1_UTXIFG0 (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief SFR interrupt flag 2 register bitmap
|
|
* @{
|
|
*/
|
|
#define SFR_IFG2_UCA0RXIFG (0x01)
|
|
#define SFR_IFG2_UCA0TXIFG (0x02)
|
|
#define SFR_IFG2_URXIFG1 (0x10)
|
|
#define SFR_IFG2_UTXIFG1 (0x20)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief SFR module enable register 1
|
|
* @{
|
|
*/
|
|
#define SFR_ME1_USPIE0 (0x40)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief SFR module enable register 2
|
|
* @{
|
|
*/
|
|
#define SFR_ME2_USPIE1 (0x10)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USART control register bitmap
|
|
* @{
|
|
*/
|
|
#define USART_CTL_SWRST (0x01)
|
|
#define USART_CTL_MM (0x02)
|
|
#define USART_CTL_SYNC (0x04)
|
|
#define USART_CTL_LISTEN (0x08)
|
|
#define USART_CTL_CHAR (0x10)
|
|
#define USART_CTL_SPB (0x20)
|
|
#define USART_CTL_PEV (0x40)
|
|
#define USART_CTL_PENA (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USART transmit control register bitmap
|
|
* @{
|
|
*/
|
|
#define USART_TCTL_TXEPT (0x01)
|
|
#define USART_TCTL_STC (0x02)
|
|
#define USART_TCTL_TXWAKE (0x04)
|
|
#define USART_TCTL_URXSE (0x08)
|
|
#define USART_TCTL_SSEL_MASK (0x30)
|
|
#define USART_TCTL_SSEL_UCLKI (0x00)
|
|
#define USART_TCTL_SSEL_ACLK (0x10)
|
|
#define USART_TCTL_SSEL_SMCLK (0x20)
|
|
#define USART_TCTL_CKPL (0x40)
|
|
#define USART_TCTL_CKPH (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USART receive control register bitmap
|
|
* @{
|
|
*/
|
|
#define USART_RCTL_RXERR (0x01)
|
|
#define USART_RCTL_RXWAKE (0x02)
|
|
#define USART_RCTL_URXWIE (0x04)
|
|
#define USART_RCTL_URXEIE (0x08)
|
|
#define USART_RCTL_BRK (0x10)
|
|
#define USART_RCTL_OE (0x20)
|
|
#define USART_RCTL_PE (0x40)
|
|
#define USART_RCTL_FE (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USCI control A register 0 bitmap
|
|
* @{
|
|
*/
|
|
#define USCI_ACTL0_UCSYNC (0x01)
|
|
#define USCI_ACTL0_MODE_MASK (0x06)
|
|
#define USCI_ACTL0_MODE_UART (0x00)
|
|
#define USCI_ACTL0_MODE_ILMM (0x02)
|
|
#define USCI_ACTL0_MODE_ABMM (0x04)
|
|
#define USCI_ACTL0_MODE_UART_ABR (0x06)
|
|
#define USCI_ACTL0_SPB (0x08)
|
|
#define USCI_ACTL0_7BIT (0x10)
|
|
#define USCI_ACTL0_MSB (0x20)
|
|
#define USCI_ACTL0_PAR (0x40)
|
|
#define USCI_ACTL0_PEN (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USCI control register 0 bitmap SPI mode
|
|
* @{
|
|
*/
|
|
#define USCI_SPI_CTL0_UCSYNC (0x01)
|
|
#define USCI_SPI_CTL0_MODE_3 (0x06)
|
|
#define USCI_SPI_CTL0_MODE_0 (0x00)
|
|
#define USCI_SPI_CTL0_MODE_1 (0x02)
|
|
#define USCI_SPI_CTL0_MODE_2 (0x04)
|
|
#define USCI_SPI_CTL0_MST (0x08)
|
|
#define USCI_SPI_CTL0_7BIT (0x10)
|
|
#define USCI_SPI_CTL0_MSB (0x20)
|
|
#define USCI_SPI_CTL0_CKPL (0x40)
|
|
#define USCI_SPI_CTL0_CKPH (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USCI status register bitmap SPI mode
|
|
* @{
|
|
*/
|
|
#define USCI_SPI_STAT_UCBUSY (0x01)
|
|
#define USCI_SPI_STAT_UCOE (0x20)
|
|
#define USCI_SPI_STAT_UCFE (0x40)
|
|
#define USCI_SPI_STAT_UCLISTEN (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USCI control A register 1 bitmap
|
|
* @{
|
|
*/
|
|
#define USCI_ACTL1_SWRST (0x01)
|
|
#define USCI_ACTL1_TXBRK (0x02)
|
|
#define USCI_ACTL1_TXADDR (0x04)
|
|
#define USCI_ACTL1_DORM (0x08)
|
|
#define USCI_ACTL1_BRKIE (0x10)
|
|
#define USCI_ACTL1_RXEIE (0x20)
|
|
#define USCI_ACTL1_SSEL_MASK (0xc0)
|
|
#define USCI_ACTL1_SSEL_UCLK (0x00)
|
|
#define USCI_ACTL1_SSEL_ACLK (0x40)
|
|
#define USCI_ACTL1_SSEL_SMCLK (0xc0)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USCI control register 1 bitmap SPI mode
|
|
* @{
|
|
*/
|
|
#define USCI_SPI_CTL1_SWRST (0x01)
|
|
#define USCI_SPI_CTL1_SSEL_MASK (0xc0)
|
|
#define USCI_SPI_CTL1_SSEL_NA (0x00)
|
|
#define USCI_SPI_CTL1_SSEL_ACLK (0x40)
|
|
#define USCI_SPI_CTL1_SSEL_SMCLK (0xc0)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USCI modulation A control register
|
|
* @{
|
|
*/
|
|
#define USCI_AMCTL_OS16 (0x01)
|
|
#define USCI_AMCTL_BRS_MASK (0xe0)
|
|
#define USCI_AMCTL_BRS_SHIFT (1U)
|
|
#define USCI_AMCTL_BRF_MASK (0xf0)
|
|
#define USCI_AMCTL_BRF_SHIFT (4U)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief USCI status A register bitmap
|
|
* @{
|
|
*/
|
|
#define USCI_ASTAT_BUSY (0x01)
|
|
#define USCI_ASTAT_IDLE (0x02)
|
|
#define USCI_ASTAT_ADDR (0x02)
|
|
#define USCI_ASTAT_RXERR (0x04)
|
|
#define USCI_ASTAT_BRK (0x08)
|
|
#define USCI_ASTAT_PE (0x10)
|
|
#define USCI_ASTAT_OE (0x20)
|
|
#define USCI_ASTAT_FE (0x40)
|
|
#define USCI_ASTAT_LISTEN (0x80)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief Timer Control register bitmap
|
|
* @{
|
|
*/
|
|
#define TIMER_CTL_IFG (0x0001)
|
|
#define TIMER_CTL_IE (0x0002)
|
|
#define TIMER_CTL_CLR (0x0004)
|
|
#define TIMER_CTL_MC_MASK (0x0030)
|
|
#define TIMER_CTL_MC_STOP (0x0000)
|
|
#define TIMER_CTL_MC_UP (0x0010)
|
|
#define TIMER_CTL_MC_CONT (0x0020)
|
|
#define TIMER_CTL_MC_UPDOWN (0x0030)
|
|
#define TIMER_CTL_ID_MASK (0x00c0)
|
|
#define TIMER_CTL_ID_DIV1 (0x0000)
|
|
#define TIMER_CTL_ID_DIV2 (0x0040)
|
|
#define TIMER_CTL_ID_DIV4 (0x0080)
|
|
#define TIMER_CTL_ID_DIV8 (0x00c0)
|
|
#define TIMER_CTL_TASSEL_MASK (0x0300)
|
|
#define TIMER_CTL_TASSEL_TCLK (0x0000)
|
|
#define TIMER_CTL_TASSEL_ACLK (0x0100)
|
|
#define TIMER_CTL_TASSEL_SMCLK (0x0200)
|
|
#define TIMER_CTL_TASSEL_INV_TCLK (0x0300)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief Timer Channel Control register bitmap
|
|
* @{
|
|
*/
|
|
#define TIMER_CCTL_CCIFG (0x0001)
|
|
#define TIMER_CCTL_COV (0x0002)
|
|
#define TIMER_CCTL_OUT (0x0004)
|
|
#define TIMER_CCTL_CCI (0x0008)
|
|
#define TIMER_CCTL_CCIE (0x0010)
|
|
#define TIMER_CCTL_OUTMOD_MASK (0x00e0)
|
|
#define TIMER_CCTL_OUTMOD_OUTVAL (0x0000)
|
|
#define TIMER_CCTL_OUTMOD_SET (0x0020)
|
|
#define TIMER_CCTL_OUTMOD_TOG_RESET (0x0040)
|
|
#define TIMER_CCTL_OUTMOD_SET_RESET (0x0060)
|
|
#define TIMER_CCTL_OUTMOD_TOGGLE (0x0080)
|
|
#define TIMER_CCTL_OUTMOD_RESET (0x00a0)
|
|
#define TIMER_CCTL_OUTMOD_TOG_SET (0x00c0)
|
|
#define TIMER_CCTL_OUTMOD_RESET_SET (0x00e0)
|
|
#define TIMER_CCTL_CAP (0x0100)
|
|
#define TIMER_CCTL_CLLD_MASK (0x0600)
|
|
#define TIMER_CCTL_SCS (0x0800)
|
|
#define TIMER_CCTL_CCIS_MASK (0x3000)
|
|
#define TIMER_CCTL_CM_MASK (0xc000)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief Base register address definitions
|
|
* @{
|
|
*/
|
|
#define SFR_BASE ((uint16_t)0x0000)
|
|
#define PORT_1_BASE ((uint16_t)0x0020)
|
|
#define PORT_2_BASE ((uint16_t)0x0028)
|
|
#define PORT_3_BASE ((uint16_t)0x0018)
|
|
#define PORT_4_BASE ((uint16_t)0x001c)
|
|
#define PORT_5_BASE ((uint16_t)0x0030)
|
|
#define PORT_6_BASE ((uint16_t)0x0034)
|
|
#define CLK_BASE ((uint16_t)0x0053)
|
|
#define USART_0_BASE ((uint16_t)0x0070)
|
|
#define USART_1_BASE ((uint16_t)0x0078)
|
|
#define TIMER_IVEC_BASE ((uint16_t)0x011e)
|
|
#define TIMER_A_BASE ((uint16_t)0x0160)
|
|
#define TIMER_B_BASE ((uint16_t)0x0180)
|
|
#define WD_BASE ((uint16_t)0x0120)
|
|
#define USCI_0_BASE ((uint16_t)0x005d)
|
|
#define USCI_0_A_BASE ((uint16_t)0x0060)
|
|
#define USCI_0_B_BASE ((uint16_t)0x0068)
|
|
#define USCI_1_BASE ((uint16_t)0x00cd)
|
|
#define USCI_1_A_BASE ((uint16_t)0x00d0)
|
|
#define USCI_1_B_BASE ((uint16_t)0x00d8)
|
|
/** @} */
|
|
|
|
/**
|
|
* @brief Typing of base register objects
|
|
* @{
|
|
*/
|
|
#define SFR ((msp_sfr_t *)SFR_BASE)
|
|
#define PORT_1 ((msp_port_t *)PORT_1_BASE)
|
|
#define PORT_2 ((msp_port_t *)PORT_2_BASE)
|
|
#define PORT_3 ((msp_port_t *)PORT_3_BASE)
|
|
#define PORT_4 ((msp_port_t *)PORT_4_BASE)
|
|
#define PORT_5 ((msp_port_t *)PORT_5_BASE)
|
|
#define PORT_6 ((msp_port_t *)PORT_6_BASE)
|
|
#define CLK ((msp_clk_t *)CLK_BASE)
|
|
#define USART_0 ((msp_usart_t *)USART_0_BASE)
|
|
#define USART_1 ((msp_usart_t *)USART_1_BASE)
|
|
#define TIMER_IVEC ((msp_timer_ivec_t *)TIMER_IVEC_BASE)
|
|
#define TIMER_A ((msp_timer_t *)TIMER_A_BASE)
|
|
#define TIMER_B ((msp_timer_t *)TIMER_B_BASE)
|
|
#define WD ((msp_wd_t *)WD_BASE)
|
|
#define USCI_0 ((msp_usci_t *)USCI_0_BASE)
|
|
#define USCI_1 ((msp_usci_t *)USCI_1_BASE)
|
|
#define USCI_0_A_SPI ((msp_usci_spi_t *)USCI_0_A_BASE)
|
|
#define USCI_0_B_SPI ((msp_usci_spi_t *)USCI_0_B_BASE)
|
|
#define USCI_1_A ((msp_usci_t *)USCI_1_A_BASE)
|
|
#define USCI_1_B ((msp_usci_t *)USCI_1_B_BASE)
|
|
/** @} */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* MSP430_REGS_H */
|
|
/** @} */
|