SCI8 -> J-Link OB CDC console formatters for usb_host_keyboard. More...

#include <stdint.h>
#include "ra8_board_ek_ra8d2.h"
#include "ra8_err.h"
#include "usb_host_keyboard_steps.h"

Include dependency graph for usb_host_keyboard_console.c:

Functions
uint8_t	hid_nibble_to_hex (uint32_t nibble)
	Format one nibble (0..15) into an uppercase hex character.
uint32_t	hid_str_len (const char *text)
	Bounded ASCII string length (cap k_hid_print_cap).
ra8_err_t	hid_sci_write (const uint8_t *data, uint32_t len)
	Push a literal block over SCI8 polled.
ra8_err_t	hid_print (const char *text)
	Print a NUL-terminated ASCII string over the console.
ra8_err_t	hid_print_dec (uint32_t value)
	Print a uint32_t as ASCII decimal.
ra8_err_t	hid_print_hex (uint32_t value, uint8_t digits)
	Print a value as fixed-width uppercase hex.
ra8_err_t	hid_print_fail (const char *what, ra8_err_t err)
	Print "FAIL <what> err=0xNNNNNNNN" on its own line.

Detailed Description

SCI8 -> J-Link OB CDC console formatters for usb_host_keyboard.

Tag: [Ring 6 / APP] {World: S}

The text-formatting console cluster carved out of usb_host_keyboard/main.c so each translation unit stays under the 1000-line cap. These helpers push fixed strings, decimal counts, and fixed-width hex tokens over SCI8 (the J-Link OB CDC bridge, 115200) using polled TX. The host-side ladder in main.c calls them; the prototypes and the shared formatter enums live in usb_host_keyboard_steps.h. Pure code move – no logic change.

Author: Brighton Sikarskie

Date: 2026-06-13

Copyright: Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Since: 0.1.0

Definition in file usb_host_keyboard_console.c.

Function Documentation

◆ hid_nibble_to_hex()

uint8_t hid_nibble_to_hex ( uint32_t nibble )

Format one nibble (0..15) into an uppercase hex character.

Parameters

[in] nibble 4-bit value.

Returns: ASCII '0'..'9' or 'A'..'F'.

Return values

'0'	For a zero nibble.

Precondition: Caller has masked the value to 4 bits.; None beyond the mask contract.

Postcondition: Returned byte is printable hex.; No state changes.

Note: Pure function.

Since: 0.1.0

Definition at line 31 of file usb_host_keyboard_console.c.

References k_hid_hex_digit_split.

Referenced by hid_print_hex().

◆ hid_print()

ra8_err_t hid_print ( const char * text )

nodiscard

Print a NUL-terminated ASCII string over the console.

Parameters

[in] text String to print (CR/LF included by the caller).

Returns: ra8_err_t propagated from the SCI helper.

Return values

k_ra8_ok All bytes queued.

Precondition: SCI8 init already ran; text is non-NULL.; text is NUL-terminated within k_hid_print_cap bytes.

Postcondition: The string bytes are in the SCI8 TX FIFO.; No other state changes.

Note: Blocking polled TX.

Since: 0.1.0

Definition at line 56 of file usb_host_keyboard_console.c.

Referenced by hid_print_fail().

◆ hid_print_dec()

ra8_err_t hid_print_dec ( uint32_t value )

nodiscard

Print a uint32_t as ASCII decimal.

Parameters

[in] value Value to print.

Returns: ra8_err_t propagated from the SCI helper.

Return values

k_ra8_ok All bytes queued.

Precondition: SCI8 init already ran.; None beyond console readiness.

Postcondition: One ASCII decimal token is in the SCI8 TX FIFO.; No other state changes.

Note: Blocking polled TX.

Since: 0.1.0

Definition at line 61 of file usb_host_keyboard_console.c.

◆ hid_print_fail()

ra8_err_t hid_print_fail	(	const char *	what,
		ra8_err_t	err )

nodiscard

Print "FAIL <what> err=0xNNNNNNNN" on its own line.

Parameters

[in]	what	Short description of the failed step.
[in]	err	Error code returned by the step.

Returns: ra8_err_t propagated from the SCI helpers.

Return values

k_ra8_ok The diagnostic line is queued.

Precondition: SCI8 init already ran.; what is NUL-terminated within the print cap.

Postcondition: One diagnostic line is in the SCI8 TX FIFO.; No other state changes.

Note: Blocking polled TX.

Since: 0.1.0

Definition at line 99 of file usb_host_keyboard_console.c.

◆ hid_print_hex()

ra8_err_t hid_print_hex	(	uint32_t	value,
		uint8_t	digits )

nodiscard

Print a value as fixed-width uppercase hex.

Parameters

[in]	value	Value to print.
[in]	digits	Hex digit count (4 for u16, 8 for u32).

Returns: ra8_err_t propagated from the SCI helper.

Return values

k_ra8_ok All bytes queued.

Precondition: SCI8 init already ran.; digits is at most k_hid_hex_chars_u32.

Postcondition: One fixed-width hex token is in the SCI8 TX FIFO.; No other state changes.

Note: Blocking polled TX.

Since: 0.1.0

Definition at line 85 of file usb_host_keyboard_console.c.

Referenced by hid_print_fail().

◆ hid_sci_write()

ra8_err_t hid_sci_write	(	const uint8_t *	data,
		uint32_t	len )

nodiscard

Push a literal block over SCI8 polled.

Parameters

[in]	data	Buffer to send.
[in]	len	Byte count.

Returns: ra8_err_t passthrough from ra8_board_uart_console_write.

Return values

k_ra8_ok All bytes queued.

Precondition: data is non-NULL; SCI8 init already ran.; len excludes any NUL terminator.

Postcondition: Bytes are in the SCI8 TX FIFO.; No other state changes.

Note: Blocking polled TX.

Since: 0.1.0

Definition at line 51 of file usb_host_keyboard_console.c.

References ra8_board_uart_console_write().

Referenced by hid_print(), hid_print_dec(), and hid_print_hex().

◆ hid_str_len()

uint32_t hid_str_len ( const char * text )

Bounded ASCII string length (cap k_hid_print_cap).

Parameters

[in] text NUL-terminated string.

Returns: Number of bytes before the NUL, capped.

Return values

0	For an empty string.

Precondition: text is non-NULL.; text points to readable storage of at least the length.

Postcondition: No state changes.; Return value never exceeds k_hid_print_cap.

Note: Bounded scan.

Since: 0.1.0

Definition at line 39 of file usb_host_keyboard_console.c.

References k_hid_print_cap.

Referenced by hid_print().

Functions

Detailed Description

Function Documentation

◆ hid_nibble_to_hex()

◆ hid_print()

◆ hid_print_dec()

◆ hid_print_fail()

◆ hid_print_hex()

◆ hid_sci_write()

◆ hid_str_len()