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

Every value the ra8_emulator CLI parse produces for the setup phase. More...

#include <emu_args.h>

Data Fields

const char * elf_path
 Firmware ELF path (argv[1]).
bool want_view
 –view live window.
const char * ppm_path
 –ppm output path (NULL = off).
const char * record_dir
 –record directory (NULL = off).
uint32_t record_secs
 –record-secs bound (0 = unbounded).
uint32_t rotate_deg
 –rotate display rotation (0 default).
const char * panel_path
 –panel descriptor path (NULL = none).
const char * input_str
 –input console RX string.
const char * keys_str
 –keys window-key path string.
const char * touch_seq_str
 –touch-seq raw-point FIFO string.
const char * usb_in_str
 –usb-in CDC bulk OUT string.
const char * dump_sym_names [k_dump_sym_max]
 –dump-sym globals to read.
uint32_t dump_sym_n
 Count of –dump-sym entries.
const char * stop_sym_name
 –stop-sym watch global (NULL = off).
uint32_t stop_sym_thresh
 –stop-sym stop threshold.
const char * trace_sym_names [k_trace_sym_max]
 –trace-sym functions to log.
uint32_t trace_sym_n
 Count of –trace-sym entries.
const char * save_sd_path
 –save-sd dump path (NULL = off).
const char * ns_elf_path
 –ns second (NS) image path.
bool size_set
 –size given (wins over –panel).
bool want_click
 –click armed with valid coordinates.
bool want_trace
 –trace transition logging.
int click_x
 –click column (-1 = unset).
int click_y
 –click row (-1 = unset).
int button_press
 –button: 1=SW1, 2=SW2, 0=none.
int reboot_count
 –reboot N warm reboots.
int battery_soc
 –battery pct (-1 = model default).
bool battery_charging
 –charge given.
bool battery_opt
 Any battery flag given.
uint16_t view_w
 Panel width in pixels.
uint16_t view_h
 Panel height in pixels.
board_device_t emu_device
 –device selected part (RA8D2 default).
bool usbhs_loop
 –usbhs-loop chip-internal self-loop.

Detailed Description

Every value the ra8_emulator CLI parse produces for the setup phase.

One bundle of the decoded options, in the exact types the setup and run phases consume. Pointer fields alias argv strings, so the struct is valid for the lifetime of main(). Fields a later phase resolves from the ELF (the –dump-sym addresses, the –stop-sym address) intentionally stay OUT of this struct: only raw CLI products live here.

Invariant
String members alias argv and are never freed.
dump_sym_n <= k_dump_sym_max and trace_sym_n <= k_trace_sym_max.
See also
emu_args_parse() The producer.
Since
0.1.0

Definition at line 51 of file emu_args.h.

Field Documentation

◆ battery_charging

bool emu_args_t::battery_charging

–charge given.

Definition at line 79 of file emu_args.h.

Referenced by internal_args_try_control(), and internal_main_apply_button_battery().

◆ battery_opt

bool emu_args_t::battery_opt

Any battery flag given.

Definition at line 80 of file emu_args.h.

Referenced by internal_args_try_control(), and internal_main_apply_button_battery().

◆ battery_soc

int emu_args_t::battery_soc

–battery pct (-1 = model default).

Definition at line 78 of file emu_args.h.

Referenced by internal_args_defaults(), internal_args_try_control(), and internal_main_apply_button_battery().

◆ button_press

int emu_args_t::button_press

–button: 1=SW1, 2=SW2, 0=none.

Definition at line 76 of file emu_args.h.

Referenced by internal_args_try_control(), and internal_main_apply_button_battery().

◆ click_x

int emu_args_t::click_x

–click column (-1 = unset).

Definition at line 74 of file emu_args.h.

Referenced by internal_args_defaults(), internal_args_try_input(), and internal_main_build_run_cfg().

◆ click_y

int emu_args_t::click_y

–click row (-1 = unset).

Definition at line 75 of file emu_args.h.

Referenced by internal_args_defaults(), internal_args_try_input(), and internal_main_build_run_cfg().

◆ dump_sym_n

uint32_t emu_args_t::dump_sym_n

Count of –dump-sym entries.

Definition at line 64 of file emu_args.h.

Referenced by internal_args_try_sym(), internal_main_build_run_cfg(), and internal_main_resolve_symbols().

◆ dump_sym_names

const char* emu_args_t::dump_sym_names[k_dump_sym_max]

–dump-sym globals to read.

Definition at line 63 of file emu_args.h.

Referenced by internal_args_try_sym(), internal_main_build_run_cfg(), and internal_main_resolve_symbols().

◆ elf_path

const char* emu_args_t::elf_path

Firmware ELF path (argv[1]).

Definition at line 52 of file emu_args.h.

Referenced by internal_args_defaults(), and internal_main_load_images().

◆ emu_device

board_device_t emu_args_t::emu_device

–device selected part (RA8D2 default).

Definition at line 83 of file emu_args.h.

Referenced by internal_args_defaults(), internal_args_try_mode(), and internal_main_bringup_peripherals().

◆ input_str

const char* emu_args_t::input_str

–input console RX string.

Definition at line 59 of file emu_args.h.

Referenced by internal_args_try_input(), and internal_main_feed_inputs().

◆ keys_str

const char* emu_args_t::keys_str

–keys window-key path string.

Definition at line 60 of file emu_args.h.

Referenced by internal_args_try_input(), and internal_main_feed_inputs().

◆ ns_elf_path

const char* emu_args_t::ns_elf_path

–ns second (NS) image path.

Definition at line 70 of file emu_args.h.

Referenced by internal_args_try_input(), and internal_main_load_images().

◆ panel_path

const char* emu_args_t::panel_path

–panel descriptor path (NULL = none).

Definition at line 58 of file emu_args.h.

Referenced by internal_args_try_display(), and internal_main_apply_panel().

◆ ppm_path

const char* emu_args_t::ppm_path

–ppm output path (NULL = off).

Definition at line 54 of file emu_args.h.

Referenced by internal_args_try_display(), internal_main_build_run_cfg(), and internal_main_open_presentation().

◆ reboot_count

int emu_args_t::reboot_count

–reboot N warm reboots.

Definition at line 77 of file emu_args.h.

Referenced by internal_args_try_control(), and internal_main_build_run_cfg().

◆ record_dir

const char* emu_args_t::record_dir

–record directory (NULL = off).

Definition at line 55 of file emu_args.h.

Referenced by internal_args_try_display(), internal_main_build_run_cfg(), and internal_main_open_presentation().

◆ record_secs

uint32_t emu_args_t::record_secs

–record-secs bound (0 = unbounded).

Definition at line 56 of file emu_args.h.

Referenced by internal_args_try_display(), and internal_main_build_run_cfg().

◆ rotate_deg

uint32_t emu_args_t::rotate_deg

–rotate display rotation (0 default).

Definition at line 57 of file emu_args.h.

Referenced by internal_args_defaults(), internal_args_try_display(), internal_main_build_run_cfg(), and internal_main_open_presentation().

◆ save_sd_path

const char* emu_args_t::save_sd_path

–save-sd dump path (NULL = off).

Definition at line 69 of file emu_args.h.

Referenced by internal_args_try_sd(), and internal_main_build_run_cfg().

◆ size_set

bool emu_args_t::size_set

–size given (wins over –panel).

Definition at line 71 of file emu_args.h.

Referenced by internal_args_try_display(), and internal_main_apply_panel().

◆ stop_sym_name

const char* emu_args_t::stop_sym_name

–stop-sym watch global (NULL = off).

Definition at line 65 of file emu_args.h.

Referenced by internal_args_try_sym(), and internal_main_resolve_symbols().

◆ stop_sym_thresh

uint32_t emu_args_t::stop_sym_thresh

–stop-sym stop threshold.

Definition at line 66 of file emu_args.h.

Referenced by internal_args_try_sym(), and internal_main_build_run_cfg().

◆ touch_seq_str

const char* emu_args_t::touch_seq_str

–touch-seq raw-point FIFO string.

Definition at line 61 of file emu_args.h.

Referenced by internal_args_try_input(), and internal_main_bringup_peripherals().

◆ trace_sym_n

uint32_t emu_args_t::trace_sym_n

Count of –trace-sym entries.

Definition at line 68 of file emu_args.h.

Referenced by internal_args_try_sym(), and internal_main_install_run_seams().

◆ trace_sym_names

const char* emu_args_t::trace_sym_names[k_trace_sym_max]

–trace-sym functions to log.

Definition at line 67 of file emu_args.h.

Referenced by internal_args_try_sym(), and internal_main_install_run_seams().

◆ usb_in_str

const char* emu_args_t::usb_in_str

–usb-in CDC bulk OUT string.

Definition at line 62 of file emu_args.h.

Referenced by internal_args_try_input(), and internal_main_feed_inputs().

◆ usbhs_loop

bool emu_args_t::usbhs_loop

–usbhs-loop chip-internal self-loop.

Definition at line 84 of file emu_args.h.

Referenced by internal_args_try_mode(), internal_main_bringup_peripherals(), and internal_main_install_run_seams().

◆ view_h

uint16_t emu_args_t::view_h

Panel height in pixels.

Definition at line 82 of file emu_args.h.

Referenced by internal_args_defaults(), internal_args_try_display(), and main().

◆ view_w

uint16_t emu_args_t::view_w

Panel width in pixels.

Definition at line 81 of file emu_args.h.

Referenced by internal_args_defaults(), internal_args_try_display(), and main().

◆ want_click

bool emu_args_t::want_click

–click armed with valid coordinates.

Definition at line 72 of file emu_args.h.

Referenced by internal_args_try_input(), internal_main_build_run_cfg(), and internal_main_open_presentation().

◆ want_trace

bool emu_args_t::want_trace

–trace transition logging.

Definition at line 73 of file emu_args.h.

Referenced by internal_args_try_mode(), internal_main_bringup_peripherals(), and internal_main_build_run_cfg().

◆ want_view

bool emu_args_t::want_view

–view live window.

Definition at line 53 of file emu_args.h.

Referenced by internal_args_try_mode(), internal_main_build_run_cfg(), and internal_main_open_presentation().

The documentation for this struct was generated from the following file: