ra8-firmware 0.1.0
Bare-metal firmware for the Renesas RA8 family (RA8D2 / RA8P1)
Loading...
Searching...
No Matches
tz_secure_only_usb_hs_steps.h File Reference

examples/ek_ra8d2/hw_validated/manual/tz_secure_only_usb_hs/inc/tz_secure_only_usb_hs_steps.h More...

#include <stdint.h>
#include "tx_api.h"
#include "ux_api.h"
Include dependency graph for tz_secure_only_usb_hs_steps.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Enumerations

enum  tz_secure_only_usb_hs_descriptor_len_t : uint16_t {
  k_tz_secure_only_usb_hs_device_framework_fs_len = 93U ,
  k_tz_secure_only_usb_hs_device_framework_hs_len = 103U ,
  k_tz_secure_only_usb_hs_string_framework_len = 60U ,
  k_tz_secure_only_usb_hs_language_id_framework_len = 2U
}
 Byte lengths of the four USBX descriptor frameworks. More...

Variables

UCHAR s_tz_secure_only_usb_hs_device_framework_fs [k_tz_secure_only_usb_hs_device_framework_fs_len]
 Full-Speed CDC-ACM composite device framework (64-byte bulk MPS).
UCHAR s_tz_secure_only_usb_hs_device_framework_hs [k_tz_secure_only_usb_hs_device_framework_hs_len]
 High-Speed CDC-ACM composite device framework (512-byte bulk MPS).
UCHAR s_tz_secure_only_usb_hs_string_framework [k_tz_secure_only_usb_hs_string_framework_len]
 USBX string descriptor table (vendor / product / serial).
UCHAR s_tz_secure_only_usb_hs_language_id_framework [k_tz_secure_only_usb_hs_language_id_framework_len]
 USBX language-id table – US English (LANGID 0x0409).

Detailed Description

examples/ek_ra8d2/hw_validated/manual/tz_secure_only_usb_hs/inc/tz_secure_only_usb_hs_steps.h

ThreadX + USBX worker machinery for the secure-only USB-HS echo app.

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

Companion sibling header for examples/ek_ra8d2/hw_validated/manual/tz_secure_only_usb_hs/src/main.c. The CDC-ACM activate/deactivate callbacks, the USBX bring-up step routines, the INTENB0 re-arm watchdog and the ThreadX tx_application_define kernel hook were factored out of main.c verbatim into tz_secure_only_usb_hs_steps.c, and the four USBX descriptor byte arrays into tz_secure_only_usb_hs_descriptors.c, to keep every translation unit under the 1000-line check_file_size.py cap. main.c retains main(), demo_pins_init and demo_panic_halt; it reaches the worker side only through ThreadX's tx_kernel_enter -> tx_application_define linkage. ThreadX's tx_api.h declares that kernel hook, so this header exposes only the descriptor arrays shared between the two sibling implementation units.

This split is a pure, behaviour-preserving code move: no logic was altered.

Author
Brighton Sikarskie
Date
2026-05-03
Since
0.1.0

Definition in file tz_secure_only_usb_hs_steps.h.

Enumeration Type Documentation

◆ tz_secure_only_usb_hs_descriptor_len_t

Byte lengths of the four USBX descriptor frameworks.

The descriptor byte arrays are defined in the sibling translation unit tz_secure_only_usb_hs_descriptors.c and consumed by demo_worker_usbx_init in tz_secure_only_usb_hs_steps.c. Because an extern UCHAR foo[] declaration alone is incomplete in the consuming TU (sizeof would not compile), each array is declared with its explicit dimension below; these enum members name those dimensions so the declarations stay magic-number-free. The defining TU static_asserts each value against the real initializer length, so any drift is caught at compile time.

Invariant
Each value equals sizeof of the matching array.
Since
0.1.0
Enumerator
k_tz_secure_only_usb_hs_device_framework_fs_len 

FS framework bytes.

k_tz_secure_only_usb_hs_device_framework_hs_len 

HS framework bytes.

k_tz_secure_only_usb_hs_string_framework_len 

String table bytes.

k_tz_secure_only_usb_hs_language_id_framework_len 

LANGID table bytes.

Definition at line 60 of file tz_secure_only_usb_hs_steps.h.

Variable Documentation

◆ s_tz_secure_only_usb_hs_device_framework_fs

UCHAR s_tz_secure_only_usb_hs_device_framework_fs[k_tz_secure_only_usb_hs_device_framework_fs_len]
extern

Full-Speed CDC-ACM composite device framework (64-byte bulk MPS).

Defined in tz_secure_only_usb_hs_descriptors.c.

Since
0.1.0

Definition at line 51 of file tz_secure_only_usb_hs_descriptors.c.

Referenced by demo_worker_usbx_init().

◆ s_tz_secure_only_usb_hs_device_framework_hs

UCHAR s_tz_secure_only_usb_hs_device_framework_hs[k_tz_secure_only_usb_hs_device_framework_hs_len]
extern

High-Speed CDC-ACM composite device framework (512-byte bulk MPS).

Defined in tz_secure_only_usb_hs_descriptors.c.

Since
0.1.0

Definition at line 171 of file tz_secure_only_usb_hs_descriptors.c.

Referenced by demo_worker_usbx_init().

◆ s_tz_secure_only_usb_hs_language_id_framework

UCHAR s_tz_secure_only_usb_hs_language_id_framework[k_tz_secure_only_usb_hs_language_id_framework_len]
extern

USBX language-id table – US English (LANGID 0x0409).

USBX language-id table – US English.

Defined in tz_secure_only_usb_hs_descriptors.c.

Since
0.1.0
0.1.0

Definition at line 384 of file tz_secure_only_usb_hs_descriptors.c.

Referenced by demo_worker_usbx_init().

◆ s_tz_secure_only_usb_hs_string_framework

UCHAR s_tz_secure_only_usb_hs_string_framework[k_tz_secure_only_usb_hs_string_framework_len]
extern

USBX string descriptor table (vendor / product / serial).

Defined in tz_secure_only_usb_hs_descriptors.c.

Since
0.1.0
0.1.0

Definition at line 303 of file tz_secure_only_usb_hs_descriptors.c.

Referenced by demo_worker_usbx_init().