no-OS
xilinx_uart.h
Go to the documentation of this file.
1 /*******************************************************************************
2  * @file xilinx/xilinx_uart.h
3  * @brief Header containing types used in the uart driver.
4  * @author Cristian Pop (cristian.pop@analog.com)
5 ********************************************************************************
6  * Copyright 2019(c) Analog Devices, Inc.
7  *
8  * All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions are met:
12  * - Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  * - Redistributions in binary form must reproduce the above copyright
15  * notice, this list of conditions and the following disclaimer in
16  * the documentation and/or other materials provided with the
17  * distribution.
18  * - Neither the name of Analog Devices, Inc. nor the names of its
19  * contributors may be used to endorse or promote products derived
20  * from this software without specific prior written permission.
21  * - The use of this software may or may not infringe the patent rights
22  * of one or more patent holders. This license does not release you
23  * from the requirement that you obtain separate licenses from these
24  * patent holders to use this software.
25  * - Use of the software either in source or binary form, must be run
26  * on or directly connected to an Analog Devices Inc. component.
27  *
28  * THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR
29  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT,
30  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
31  * IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT,
32  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
33  * LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR
34  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
35  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
36  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
37  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 *******************************************************************************/
39 
40 #ifndef XILINX_UART_H_
41 #define XILINX_UART_H_
42 
43 /******************************************************************************/
44 /***************************** Include Files **********************************/
45 /******************************************************************************/
46 
47 /******************************************************************************/
48 /********************** Macros and Constants Definitions **********************/
49 /******************************************************************************/
50 
51 #define UART_BUFF_LENGTH 256
52 
53 /******************************************************************************/
54 /*************************** Types Declarations *******************************/
55 /******************************************************************************/
56 
66 };
67 
77  uint32_t irq_id;
80 };
81 
86 struct xil_uart_desc {
90  uint32_t irq_id;
96  uint32_t fifo_read_offset;
100  uint32_t bytes_received;
104  void *instance;
105 };
106 
110 extern const struct no_os_uart_platform_ops xil_uart_ops;
111 
112 #endif
UART_BUFF_LENGTH
#define UART_BUFF_LENGTH
Definition: xilinx_uart.h:51
xil_uart_desc::fifo
struct no_os_fifo_element * fifo
Definition: xilinx_uart.h:94
no_os_alloc.h
no_os_uart_platform_ops
Structure holding UART function pointers that point to the platform specific function.
Definition: no_os_uart.h:161
no_os_uart_init_param::extra
void * extra
Definition: no_os_uart.h:133
no_os_callback_desc
Structure describing a callback to be registered.
Definition: no_os_irq.h:148
xil_uart_desc::irq_desc
struct no_os_irq_ctrl_desc * irq_desc
Definition: xilinx_uart.h:92
UART_PL
@ UART_PL
Definition: xilinx_uart.h:63
no_os_irq.h
Header file of IRQ interface.
xil_uart_init_param::type
enum xil_uart_type type
Definition: xilinx_uart.h:75
no_os_irq_register_callback
int32_t no_os_irq_register_callback(struct no_os_irq_ctrl_desc *desc, uint32_t irq_id, struct no_os_callback_desc *callback_desc)
Register a callback to handle the irq events.
Definition: no_os_irq.c:98
xil_uart_desc::buff
char buff[UART_BUFF_LENGTH]
Definition: xilinx_uart.h:98
xilinx_uart.h
xil_uart_desc
Xilinx platform specific UART descriptor.
Definition: xilinx_uart.h:86
xil_uart_desc::bytes_received
uint32_t bytes_received
Definition: xilinx_uart.h:100
xil_irq_init_param::type
enum xil_irq_type type
Definition: xilinx_irq.h:72
no_os_uart_platform_ops::init
int32_t(* init)(struct no_os_uart_desc **, struct no_os_uart_init_param *)
Definition: no_os_uart.h:163
no_os_uart_desc::baud_rate
uint32_t baud_rate
Definition: no_os_uart.h:150
WRITE_SIZE
#define WRITE_SIZE
Definition: xilinx_uart.c:59
UART_PS
@ UART_PS
Definition: xilinx_uart.h:65
u8
unsigned char u8
Definition: wrapper.h:156
xil_uart_init_param::irq_id
uint32_t irq_id
Definition: xilinx_uart.h:77
xil_uart_type
xil_uart_type
Xilinx platform architecture sections.
Definition: xilinx_uart.h:61
xil_uart_desc::type
enum xil_uart_type type
Definition: xilinx_uart.h:88
no_os_calloc
void * no_os_calloc(size_t nitems, size_t size)
Allocate memory and return a pointer to it, set memory to 0.
Definition: chibios_alloc.c:60
no_os_uart_desc::device_id
uint8_t device_id
Definition: no_os_uart.h:144
no_os_fifo.h
Header file of fifo.
no_os_uart_desc
Stucture holding the UART descriptor.
Definition: no_os_uart.h:140
no_os_error.h
Error codes definition.
xil_uart_desc::total_error_count
uint32_t total_error_count
Definition: xilinx_uart.h:102
no_os_irq_global_enable
int32_t no_os_irq_global_enable(struct no_os_irq_ctrl_desc *desc)
Enable global interrupts.
Definition: no_os_irq.c:135
no_os_fifo_element::len
uint32_t len
Definition: no_os_fifo.h:62
xil_irq_ops
const struct no_os_irq_platform_ops xil_irq_ops
Xilinx platform specific IRQ platform ops structure.
Definition: xilinx_irq.c:379
no_os_uart_desc::extra
void * extra
Definition: no_os_uart.h:153
no_os_fifo_insert
int32_t no_os_fifo_insert(struct no_os_fifo_element **p_fifo, char *buff, uint32_t len)
no_os_irq_init_param::irq_ctrl_id
uint32_t irq_ctrl_id
Definition: no_os_irq.h:115
no_os_fifo_remove
struct no_os_fifo_element * no_os_fifo_remove(struct no_os_fifo_element *p_fifo)
no_os_irq_ctrl_init
int32_t no_os_irq_ctrl_init(struct no_os_irq_ctrl_desc **desc, const struct no_os_irq_init_param *param)
Initialize the IRQ interrupts.
Definition: no_os_irq.c:51
xil_uart_init_param
Structure holding the initialization parameters for Xilinx platform specific UART parameters.
Definition: xilinx_uart.h:73
IRQ_PS
@ IRQ_PS
Definition: xilinx_irq.h:62
xilinx_irq.h
xil_uart_init_param::irq_desc
struct no_os_irq_ctrl_desc * irq_desc
Definition: xilinx_uart.h:79
no_os_uart_init_param::baud_rate
uint32_t baud_rate
Definition: no_os_uart.h:124
irq_desc
Structure for Interrupt Request descriptor.
no_os_fifo_element
Structure holding the fifo element parameters.
Definition: no_os_fifo.h:56
xil_uart_desc::instance
void * instance
Definition: xilinx_uart.h:104
no_os_free
void no_os_free(void *ptr)
Deallocate memory previously allocated by a call to no_os_calloc or no_os_malloc.
Definition: chibios_alloc.c:75
xil_uart_ops
const struct no_os_uart_platform_ops xil_uart_ops
Xilinx platform specific UART platform ops structure.
Definition: xilinx_uart.c:520
NULL
#define NULL
Definition: wrapper.h:64
no_os_uart_init_param
Structure holding the parameters for UART initialization.
Definition: no_os_uart.h:116
xil_uart_ops
const struct no_os_uart_platform_ops xil_uart_ops
Xilinx platform specific UART platform ops structure.
Definition: xilinx_uart.c:520
no_os_irq_init_param
Structure holding the initial parameters for Interrupt Request.
Definition: no_os_irq.h:113
no_os_fifo_element::data
char * data
Definition: no_os_fifo.h:60
no_os_uart_init_param::device_id
uint8_t device_id
Definition: no_os_uart.h:118
xil_uart_desc::fifo_read_offset
uint32_t fifo_read_offset
Definition: xilinx_uart.h:96
no_os_irq_enable
int32_t no_os_irq_enable(struct no_os_irq_ctrl_desc *desc, uint32_t irq_id)
Enable specific interrupt.
Definition: no_os_irq.c:187
no_os_irq_platform_ops
Structure holding IRQ function pointers that point to the platform specific function.
Definition: no_os_irq.h:166
no_os_uart.h
Header file of UART interface.
xil_uart_desc::irq_id
uint32_t irq_id
Definition: xilinx_uart.h:90
no_os_irq_disable
int32_t no_os_irq_disable(struct no_os_irq_ctrl_desc *desc, uint32_t irq_id)
Disable specific interrupt.
Definition: no_os_irq.c:204
no_os_irq_ctrl_desc
Definition: no_os_irq.h:129
xil_irq_init_param
Structure holding the initialization parameters for Xilinx platform specific IRQ parameters.
Definition: xilinx_irq.h:70