/**************************************************************************** * arch/arm/src/sam34/sam_lowputc.c * * 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 * * http://www.apache.org/licenses/LICENSE-2.0 * * 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. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include "arm_internal.h" #include "arm_arch.h" #include "sam_gpio.h" #include "sam_periphclks.h" #include "sam_lowputc.h" #if defined(CONFIG_ARCH_CHIP_SAM3U) || defined(CONFIG_ARCH_CHIP_SAM3X) || \ defined(CONFIG_ARCH_CHIP_SAM3A) || defined(CONFIG_ARCH_CHIP_SAM4CM) || \ defined(CONFIG_ARCH_CHIP_SAM4S) || defined(CONFIG_ARCH_CHIP_SAM4E) # include "hardware/sam_uart.h" #elif defined(CONFIG_ARCH_CHIP_SAM4L) # include "hardware/sam4l_usart.h" #else # error Unknown UART #endif /* The board.h file may redefine pin configurations defined in sam_pinmap.h */ #include "hardware/sam_pinmap.h" #include /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ /* Configuration ************************************************************/ /* If the USART is not being used as a UART, then it really isn't enabled * for our purposes. */ #ifndef CONFIG_USART0_SERIALDRIVER # undef CONFIG_SAM34_USART0 #endif #ifndef CONFIG_USART1_SERIALDRIVER # undef CONFIG_SAM34_USART1 #endif #ifndef CONFIG_USART2_SERIALDRIVER # undef CONFIG_SAM34_USART2 #endif #ifndef CONFIG_USART3_SERIALDRIVER # undef CONFIG_SAM34_USART3 #endif /* Is there a serial console? It could be on UART0-1 or USART0-3 */ #if defined(CONFIG_UART0_SERIAL_CONSOLE) && defined(CONFIG_SAM34_UART0) # undef CONFIG_UART1_SERIAL_CONSOLE # undef CONFIG_USART0_SERIAL_CONSOLE # undef CONFIG_USART1_SERIAL_CONSOLE # undef CONFIG_USART2_SERIAL_CONSOLE # undef CONFIG_USART3_SERIAL_CONSOLE # define HAVE_CONSOLE 1 #elif defined(CONFIG_UART1_SERIAL_CONSOLE) && defined(CONFIG_SAM34_UART1) # undef CONFIG_UART0_SERIAL_CONSOLE # undef CONFIG_USART0_SERIAL_CONSOLE # undef CONFIG_USART1_SERIAL_CONSOLE # undef CONFIG_USART2_SERIAL_CONSOLE # undef CONFIG_USART3_SERIAL_CONSOLE # define HAVE_CONSOLE 1 #elif defined(CONFIG_USART0_SERIAL_CONSOLE) && defined(CONFIG_SAM34_USART0) # undef CONFIG_UART0_SERIAL_CONSOLE # undef CONFIG_UART1_SERIAL_CONSOLE # undef CONFIG_USART1_SERIAL_CONSOLE # undef CONFIG_USART2_SERIAL_CONSOLE # undef CONFIG_USART3_SERIAL_CONSOLE # define HAVE_CONSOLE 1 #elif defined(CONFIG_USART1_SERIAL_CONSOLE) && defined(CONFIG_SAM34_USART1) # undef CONFIG_UART0_SERIAL_CONSOLE # undef CONFIG_UART1_SERIAL_CONSOLE # undef CONFIG_USART0_SERIAL_CONSOLE # undef CONFIG_USART2_SERIAL_CONSOLE # undef CONFIG_USART3_SERIAL_CONSOLE # define HAVE_CONSOLE 1 #elif defined(CONFIG_USART2_SERIAL_CONSOLE) && defined(CONFIG_SAM34_USART2) # undef CONFIG_UART0_SERIAL_CONSOLE # undef CONFIG_UART1_SERIAL_CONSOLE # undef CONFIG_USART0_SERIAL_CONSOLE # undef CONFIG_USART1_SERIAL_CONSOLE # undef CONFIG_USART3_SERIAL_CONSOLE # define HAVE_CONSOLE 1 #elif defined(CONFIG_USART3_SERIAL_CONSOLE) && defined(CONFIG_SAM34_USART3) # undef CONFIG_UART0_SERIAL_CONSOLE # undef CONFIG_UART1_SERIAL_CONSOLE # undef CONFIG_USART0_SERIAL_CONSOLE # undef CONFIG_USART1_SERIAL_CONSOLE # undef CONFIG_USART2_SERIAL_CONSOLE # define HAVE_CONSOLE 1 #else # if !defined(CONFIG_NO_SERIAL_CONSOLE) # warning "No valid CONFIG_USARTn_SERIAL_CONSOLE Setting" # endif # undef CONFIG_UART0_SERIAL_CONSOLE # undef CONFIG_UART1_SERIAL_CONSOLE # undef CONFIG_USART0_SERIAL_CONSOLE # undef CONFIG_USART1_SERIAL_CONSOLE # undef CONFIG_USART2_SERIAL_CONSOLE # undef CONFIG_USART3_SERIAL_CONSOLE # undef HAVE_CONSOLE #endif #if defined(HAVE_CONSOLE) /* Select MCU-specific settings * * For the SAM3U, SAM3A, SAM3X, SAM4E and SAM4S the USARTs are driven by * the main clock. (This could also be the MCK/8 or an external clock * but those options have not yet been necessary). * For the SAM4L, the USARTs are driven by CLK_USART (undivided) which is * selected by the PBADIVMASK register. */ # if defined(CONFIG_ARCH_CHIP_SAM3U) || defined(CONFIG_ARCH_CHIP_SAM3X) || \ defined(CONFIG_ARCH_CHIP_SAM3A) || defined(CONFIG_ARCH_CHIP_SAM4CM) || \ defined(CONFIG_ARCH_CHIP_SAM4S) || defined(CONFIG_ARCH_CHIP_SAM4E) # define SAM_MR_USCLKS UART_MR_USCLKS_MCK /* Source = Main clock */ # define SAM_USART_CLOCK BOARD_MCK_FREQUENCY /* Frequency of the main clock */ # elif defined(CONFIG_ARCH_CHIP_SAM4L) # define SAM_MR_USCLKS UART_MR_USCLKS_USART /* Source = USART_CLK (undefined) */ # define SAM_USART_CLOCK BOARD_PBA_FREQUENCY /* PBA frequency is undivided */ # else # error Unrecognized SAM architecture # endif /* Select USART parameters for the selected console */ # if defined(CONFIG_UART0_SERIAL_CONSOLE) # define SAM_CONSOLE_BASE SAM_UART0_BASE # define SAM_CONSOLE_BAUD CONFIG_UART0_BAUD # define SAM_CONSOLE_BITS CONFIG_UART0_BITS # define SAM_CONSOLE_PARITY CONFIG_UART0_PARITY # define SAM_CONSOLE_2STOP CONFIG_UART0_2STOP # elif defined(CONFIG_UART1_SERIAL_CONSOLE) # define SAM_CONSOLE_BASE SAM_UART1_BASE # define SAM_CONSOLE_BAUD CONFIG_UART1_BAUD # define SAM_CONSOLE_BITS CONFIG_UART1_BITS # define SAM_CONSOLE_PARITY CONFIG_UART1_PARITY # define SAM_CONSOLE_2STOP CONFIG_UART1_2STOP # elif defined(CONFIG_USART0_SERIAL_CONSOLE) # define SAM_CONSOLE_BASE SAM_USART0_BASE # define SAM_CONSOLE_BAUD CONFIG_USART0_BAUD # define SAM_CONSOLE_BITS CONFIG_USART0_BITS # define SAM_CONSOLE_PARITY CONFIG_USART0_PARITY # define SAM_CONSOLE_2STOP CONFIG_USART0_2STOP # elif defined(CONFIG_USART1_SERIAL_CONSOLE) # define SAM_CONSOLE_BASE SAM_USART1_BASE # define SAM_CONSOLE_BAUD CONFIG_USART1_BAUD # define SAM_CONSOLE_BITS CONFIG_USART1_BITS # define SAM_CONSOLE_PARITY CONFIG_USART1_PARITY # define SAM_CONSOLE_2STOP CONFIG_USART1_2STOP # elif defined(CONFIG_USART2_SERIAL_CONSOLE) # define SAM_CONSOLE_BASE SAM_USART2_BASE # define SAM_CONSOLE_BAUD CONFIG_USART2_BAUD # define SAM_CONSOLE_BITS CONFIG_USART2_BITS # define SAM_CONSOLE_PARITY CONFIG_USART2_PARITY # define SAM_CONSOLE_2STOP CONFIG_USART2_2STOP # elif defined(CONFIG_USART3_SERIAL_CONSOLE) # define SAM_CONSOLE_BASE SAM_USART3_BASE # define SAM_CONSOLE_BAUD CONFIG_USART3_BAUD # define SAM_CONSOLE_BITS CONFIG_USART3_BITS # define SAM_CONSOLE_PARITY CONFIG_USART3_PARITY # define SAM_CONSOLE_2STOP CONFIG_USART3_2STOP # else # error "No CONFIG_U[S]ARTn_SERIAL_CONSOLE Setting" # endif /* Select the settings for the mode register */ # if SAM_CONSOLE_BITS == 5 # define MR_CHRL_VALUE UART_MR_CHRL_5BITS /* 5 bits */ # elif SAM_CONSOLE_BITS == 6 # define MR_CHRL_VALUE UART_MR_CHRL_6BITS /* 6 bits */ # elif SAM_CONSOLE_BITS == 7 # define MR_CHRL_VALUE UART_MR_CHRL_7BITS /* 7 bits */ # elif SAM_CONSOLE_BITS == 8 # define MR_CHRL_VALUE UART_MR_CHRL_8BITS /* 8 bits */ # elif SAM_CONSOLE_BITS == 9 && !defined(CONFIG_UART0_SERIAL_CONSOLE) && \ !defined(CONFIG_UART1_SERIAL_CONSOLE) # define MR_CHRL_VALUE UART_MR_MODE9 # else # error "Invalid number of bits" # endif # if SAM_CONSOLE_PARITY == 1 # define MR_PAR_VALUE UART_MR_PAR_ODD # elif SAM_CONSOLE_PARITY == 2 # define MR_PAR_VALUE UART_MR_PAR_EVEN # else # define MR_PAR_VALUE UART_MR_PAR_NONE # endif # if SAM_CONSOLE_2STOP != 0 # define MR_NBSTOP_VALUE UART_MR_NBSTOP_2 # else # define MR_NBSTOP_VALUE UART_MR_NBSTOP_1 # endif # define MR_VALUE (UART_MR_MODE_NORMAL | SAM_MR_USCLKS | \ MR_CHRL_VALUE | MR_PAR_VALUE | MR_NBSTOP_VALUE) #endif /* HAVE_CONSOLE */ /**************************************************************************** * Private Types ****************************************************************************/ /**************************************************************************** * Private Function Prototypes ****************************************************************************/ /**************************************************************************** * Public Data ****************************************************************************/ /**************************************************************************** * Private Data ****************************************************************************/ /**************************************************************************** * Private Functions ****************************************************************************/ /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Name: arm_lowputc * * Description: * Output one byte on the serial console * ****************************************************************************/ void arm_lowputc(char ch) { #ifdef HAVE_CONSOLE irqstate_t flags; for (; ; ) { /* Wait for the transmitter to be available */ while ((getreg32(SAM_CONSOLE_BASE + SAM_UART_SR_OFFSET) & UART_INT_TXEMPTY) == 0); /* Disable interrupts so that the test and the transmission are * atomic. */ flags = enter_critical_section(); if ((getreg32(SAM_CONSOLE_BASE + SAM_UART_SR_OFFSET) & UART_INT_TXEMPTY) != 0) { /* Send the character */ putreg32((uint32_t)ch, SAM_CONSOLE_BASE + SAM_UART_THR_OFFSET); leave_critical_section(flags); return; } leave_critical_section(flags); } #endif } /**************************************************************************** * Name: up_putc * * Description: * Provide priority, low-level access to support OS debug writes * ****************************************************************************/ int up_putc(int ch) { #ifdef HAVE_CONSOLE /* Check for LF */ if (ch == '\n') { /* Add CR */ arm_lowputc('\r'); } arm_lowputc(ch); #endif return ch; } /**************************************************************************** * Name: sam_lowsetup * * Description: * This performs basic initialization of the USART used for the serial * console. Its purpose is to get the console output available as soon * as possible. * ****************************************************************************/ void sam_lowsetup(void) { /* Enable clocking for all selected UART/USARTs */ #ifdef CONFIG_SAM34_UART0 sam_uart0_enableclk(); #endif #ifdef CONFIG_SAM34_UART1 sam_uart1_enableclk(); #endif #ifdef CONFIG_SAM34_USART0 sam_usart0_enableclk(); #endif #ifdef CONFIG_SAM34_USART1 sam_usart1_enableclk(); #endif #ifdef CONFIG_SAM34_USART2 sam_usart2_enableclk(); #endif #ifdef CONFIG_SAM34_USART3 sam_usart3_enableclk(); #endif /* Configure UART pins for all selected UART/USARTs */ #ifdef CONFIG_SAM34_UART0 sam_configgpio(GPIO_UART0_RXD); sam_configgpio(GPIO_UART0_TXD); #endif #ifdef CONFIG_SAM34_UART1 sam_configgpio(GPIO_UART1_RXD); sam_configgpio(GPIO_UART1_TXD); #endif #ifdef CONFIG_SAM34_USART0 sam_configgpio(GPIO_USART0_RXD); sam_configgpio(GPIO_USART0_TXD); #ifdef CONFIG_USART0_OFLOWCONTROL sam_configgpio(GPIO_USART0_CTS); #endif #ifdef CONFIG_USART0_IFLOWCONTROL sam_configgpio(GPIO_USART0_RTS); #endif #endif #ifdef CONFIG_SAM34_USART1 sam_configgpio(GPIO_USART1_RXD); sam_configgpio(GPIO_USART1_TXD); #ifdef CONFIG_USART1_OFLOWCONTROL sam_configgpio(GPIO_USART1_CTS); #endif #ifdef CONFIG_USART1_IFLOWCONTROL sam_configgpio(GPIO_USART1_RTS); #endif #endif #ifdef CONFIG_SAM34_USART2 sam_configgpio(GPIO_USART2_RXD); sam_configgpio(GPIO_USART2_TXD); #ifdef CONFIG_USART2_OFLOWCONTROL sam_configgpio(GPIO_USART2_CTS); #endif #ifdef CONFIG_USART2_IFLOWCONTROL sam_configgpio(GPIO_USART2_RTS); #endif #endif #ifdef CONFIG_SAM34_USART3 sam_configgpio(GPIO_USART3_RXD); sam_configgpio(GPIO_USART3_TXD); #ifdef CONFIG_USART3_OFLOWCONTROL sam_configgpio(GPIO_USART3_CTS); #endif #ifdef CONFIG_USART3_IFLOWCONTROL sam_configgpio(GPIO_USART3_RTS); #endif #endif /* Configure the console (only) */ #if defined(HAVE_CONSOLE) && !defined(CONFIG_SUPPRESS_UART_CONFIG) /* Reset and disable receiver and transmitter */ putreg32((UART_CR_RSTRX | UART_CR_RSTTX | UART_CR_RXDIS | UART_CR_TXDIS), SAM_CONSOLE_BASE + SAM_UART_CR_OFFSET); /* Disable all interrupts */ putreg32(0xffffffff, SAM_CONSOLE_BASE + SAM_UART_IDR_OFFSET); /* Set up the mode register */ putreg32(MR_VALUE, SAM_CONSOLE_BASE + SAM_UART_MR_OFFSET); /* Configure the console baud. NOTE: Oversampling by 8 is not supported. * This may limit BAUD rates for lower USART clocks. */ putreg32(((SAM_USART_CLOCK + (SAM_CONSOLE_BAUD << 3)) / (SAM_CONSOLE_BAUD << 4)), SAM_CONSOLE_BASE + SAM_UART_BRGR_OFFSET); /* Enable receiver & transmitter */ putreg32((UART_CR_RXEN | UART_CR_TXEN), SAM_CONSOLE_BASE + SAM_UART_CR_OFFSET); #endif }