diff options
author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2021-06-08 15:53:18 +0200 |
---|---|---|
committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2023-07-14 09:11:19 +0200 |
commit | 2d71cba033bcd11d9bf469a5c51b6fb79b26ade8 (patch) | |
tree | eea7e1565c0227991402f4abbc8e148580b27d34 /bsps/include/grlib/apbuart.h | |
parent | spec: Add QEMU test annotations (diff) | |
download | rtems-2d71cba033bcd11d9bf469a5c51b6fb79b26ade8.tar.bz2 |
bsps/grlib: Add generated headers
Close #4828.
Diffstat (limited to '')
-rw-r--r-- | bsps/include/grlib/apbuart.h | 108 |
1 files changed, 61 insertions, 47 deletions
diff --git a/bsps/include/grlib/apbuart.h b/bsps/include/grlib/apbuart.h index 3f6ae670e3..b53c338407 100644 --- a/bsps/include/grlib/apbuart.h +++ b/bsps/include/grlib/apbuart.h @@ -2,12 +2,14 @@ /** * @file - * @ingroup uart + * + * @ingroup RTEMSDeviceGRLIBAPBUART + * + * @brief This header file defines the APBUART interface. */ /* - * COPYRIGHT (c) 2007. - * Gaisler Research + * Copyright (C) 2021 embedded brains GmbH & Co. KG * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions @@ -29,68 +31,80 @@ * 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. - * */ -#ifndef __APBUART_H__ -#define __APBUART_H__ - -/** - * @defgroup uart UART +/* + * This file is part of the RTEMS quality process and was automatically + * generated. If you find something that needs to be fixed or + * worded better please post a report or patch to an RTEMS mailing list + * or raise a bug report: * - * @ingroup RTEMSBSPsSharedGRLIB + * https://www.rtems.org/bugs.html * - * @brief Driver interface for APBUART + * For information on updating and regenerating please refer to the How-To + * section in the Software Requirements Engineering chapter of the + * RTEMS Software Engineering manual. The manual is provided as a part of + * a release. For development sources please refer to the online + * documentation at: * - * @{ + * https://docs.rtems.org */ -#include "ambapp.h" -#include "grlib.h" +/* Generated from spec:/dev/grlib/if/apbuart-header-2 */ + +#ifndef _GRLIB_APBUART_H +#define _GRLIB_APBUART_H + +#include <grlib/apbuart-regs.h> #ifdef __cplusplus extern "C" { #endif -#define APBUART_CTRL_RE 0x1 -#define APBUART_CTRL_TE 0x2 -#define APBUART_CTRL_RI 0x4 -#define APBUART_CTRL_TI 0x8 -#define APBUART_CTRL_PS 0x10 -#define APBUART_CTRL_PE 0x20 -#define APBUART_CTRL_FL 0x40 -#define APBUART_CTRL_LB 0x80 -#define APBUART_CTRL_EC 0x100 -#define APBUART_CTRL_TF 0x200 -#define APBUART_CTRL_RF 0x400 -#define APBUART_CTRL_DB 0x800 -#define APBUART_CTRL_BI 0x1000 -#define APBUART_CTRL_DI 0x2000 -#define APBUART_CTRL_FA 0x80000000 +/* Generated from spec:/dev/grlib/if/apbuart-inbyte-nonblocking */ -#define APBUART_STATUS_DR 0x1 -#define APBUART_STATUS_TS 0x2 -#define APBUART_STATUS_TE 0x4 -#define APBUART_STATUS_BR 0x8 -#define APBUART_STATUS_OV 0x10 -#define APBUART_STATUS_PE 0x20 -#define APBUART_STATUS_FE 0x40 -#define APBUART_STATUS_ERR 0x78 -#define APBUART_STATUS_TH 0x80 -#define APBUART_STATUS_RH 0x100 -#define APBUART_STATUS_TF 0x200 -#define APBUART_STATUS_RF 0x400 +/** + * @ingroup RTEMSDeviceGRLIBAPBUART + * + * @brief Clears all errors and tries to get one character from the receiver + * FIFO. + * + * @param regs is the pointer to the APBUART register block. + * + * @retval -1 The receiver FIFO was empty. + * + * @return Returns the first character of the receiver FIFO if it was + * non-empty. + */ +int apbuart_inbyte_nonblocking( apbuart *regs ); + +/* Generated from spec:/dev/grlib/if/apbuart-outbyte-polled */ -void apbuart_outbyte_wait(const struct apbuart_regs *regs); +/** + * @ingroup RTEMSDeviceGRLIBAPBUART + * + * @brief Waits until an empty transmitter FIFO was observed and then stores + * the character to the data register. + * + * @param regs is the pointer to the APBUART register block. + * + * @param ch is the character to output. + */ +void apbuart_outbyte_polled( apbuart *regs, char ch ); -void apbuart_outbyte_polled(struct apbuart_regs *regs, char ch); +/* Generated from spec:/dev/grlib/if/apbuart-outbyte-wait */ -int apbuart_inbyte_nonblocking(struct apbuart_regs *regs); +/** + * @ingroup RTEMSDeviceGRLIBAPBUART + * + * @brief Ensures that at least once an empty transmitter FIFO was observed. + * + * @param regs is the pointer to the APBUART register block. + */ +void apbuart_outbyte_wait( const apbuart *regs ); #ifdef __cplusplus } #endif -/** @} */ - -#endif /* __APBUART_H__ */ +#endif /* _GRLIB_APBUART_H */ |