summaryrefslogtreecommitdiff
path: root/FreeRTOS/Demo/RISC-V_RV32_SiFive_HiFive1_FreedomStudio/freedom-metal/metal/tty.h
blob: fe4c000dbdcc4606a562e69f29b67e5b3e6c179b (plain)
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
/* Copyright 2018 SiFive, Inc */
/* SPDX-License-Identifier: Apache-2.0 */

#ifndef METAL__TTY_H
#define METAL__TTY_H

/*!
 * @file tty.h
 * @brief API for emulated serial teriminals
 */

/*!
 * @brief Write a character to the default output device
 *
 * Write a character to the default output device, which for most
 * targets is the UART serial port.
 *
 * putc() does CR/LF mapping.
 * putc_raw() does not.
 *
 * @param c The character to write to the terminal
 * @return 0 on success, or -1 on failure.
 */
int metal_tty_putc(int c);

/*!
 * @brief Write a raw character to the default output device
 *
 * Write a character to the default output device, which for most
 * targets is the UART serial port.
 *
 * putc() does CR/LF mapping.
 * putc_raw() does not.
 *
 * @param c The character to write to the terminal
 * @return 0 on success, or -1 on failure.
 */
int metal_tty_putc_raw(int c);

/*!
 * @brief Get a byte from the default output device
 *
 * The default output device, is typically the UART serial port.
 *
 * This call is non-blocking, if nothing is ready c==-1
 * if something is ready, then c=[0x00 to 0xff] byte value.
 *
 * @return 0 on success, or -1 on failure.
 */
int metal_tty_getc(int *c);

#endif