hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
/* SPDX-License-Identifier: GPL-2.0 */
/*
 * Console support for RTE - for host use only.
 *
 * Copyright (C) 1999-2017, Broadcom Corporation
 * 
 *      Unless you and Broadcom execute a separate written software license
 * agreement governing use of this software, this software is licensed to you
 * under the terms of the GNU General Public License version 2 (the "GPL"),
 * available at http://www.broadcom.com/licenses/GPLv2.php, with the
 * following added to such license:
 * 
 *      As a special exception, the copyright holders of this software give you
 * permission to link this software with independent modules, and to copy and
 * distribute the resulting executable under terms of your choice, provided that
 * you also meet, for each linked independent module, the terms and conditions of
 * the license of that module.  An independent module is a module which is not
 * derived from this software.  The special exception does not apply to any
 * modifications of the software.
 * 
 *      Notwithstanding the above, under no circumstances may you combine this
 * software in any way with any other Broadcom software provided under a license
 * other than the GPL, without Broadcom's express prior written consent.
 *
 *
 * <<Broadcom-WL-IPTag/Open:>>
 *
 * $Id: hnd_cons.h 568961 2015-07-06 18:14:49Z $
 */
#ifndef    _hnd_cons_h_
#define    _hnd_cons_h_
 
#include <typedefs.h>
#include <siutils.h>
 
#define CBUF_LEN    (128)
 
#if defined(BCM_BIG_LOG)
#define LOG_BUF_LEN    (16 * 1024)
#else
#define LOG_BUF_LEN    1024
#endif
 
#ifdef BOOTLOADER_CONSOLE_OUTPUT
#undef RWL_MAX_DATA_LEN
#undef CBUF_LEN
#undef LOG_BUF_LEN
#define RWL_MAX_DATA_LEN (4 * 1024 + 8)
#define CBUF_LEN    (RWL_MAX_DATA_LEN + 64)
#define LOG_BUF_LEN (16 * 1024)
#endif
 
typedef struct {
   uint32        buf;        /* Can't be pointer on (64-bit) hosts */
   uint        buf_size;
   uint        idx;
   uint        out_idx;    /* output index */
} hnd_log_t;
 
typedef struct {
   /* Virtual UART
    *   When there is no UART (e.g. Quickturn), the host should write a complete
    *   input line directly into cbuf and then write the length into vcons_in.
    *   This may also be used when there is a real UART (at risk of conflicting with
    *   the real UART).  vcons_out is currently unused.
    */
   volatile uint    vcons_in;
   volatile uint    vcons_out;
 
   /* Output (logging) buffer
    *   Console output is written to a ring buffer log_buf at index log_idx.
    *   The host may read the output when it sees log_idx advance.
    *   Output will be lost if the output wraps around faster than the host polls.
    */
   hnd_log_t    log;
 
   /* Console input line buffer
    *   Characters are read one at a time into cbuf until <CR> is received, then
    *   the buffer is processed as a command line.  Also used for virtual UART.
    */
   uint        cbuf_idx;
   char        cbuf[CBUF_LEN];
} hnd_cons_t;
 
#endif /* _hnd_cons_h_ */