{"schema_version":"1.0.0","title":"KV-TrimUI Rust Core Engine Knowledge Base","description":"Structured technical reference and guidelines for AI Agents building native software on TrimUI consoles.","handheld":{"device":"TrimUI Smart Pro & Brick Pro","chipset":"Allwinner A133plus Quad-Core ARM Cortex-A53 @ 1.8GHz","arch":"aarch64 (ARMv8-A 64-bit)","ram":"1GB LPDDR4","screen":{"width":1280,"height":720,"bpp":32,"stride_bytes":5120,"total_bytes":3686400,"refresh_rate_hz":60,"framebuffer_path":"/dev/fb0","pixel_format":"BGRA_8888 (Little-Endian 32-bit)"},"storage":{"sdcard_mount":"/mnt/SDCARD/","apps_dir":"/mnt/SDCARD/Apps/","roms_dir":"/mnt/SDCARD/Roms/"},"kernel":"Linux 4.9 LTS","display_server":"None (Direct Framebuffer mmap mandatory; no X11 or Wayland)"},"compiler_and_toolchain":{"mandatory_target":"aarch64-unknown-linux-musl","incompatible_targets":["aarch64-unknown-linux-gnu (fails due to legacy host GLIBC 2.28)"],"linker":"rust-lld","cargo_build_command":"RUSTFLAGS=\"-C linker=rust-lld\" cargo build --target aarch64-unknown-linux-musl --release","recommended_cargo_profile":{"opt_level":"z","lto":true,"codegen_units":1,"panic":"abort","strip":true}},"evdev_gamepad_mapping":{"input_device_glob":"/dev/input/event*","buttons":{"BTN_SOUTH_A":{"code":304,"label":"A Button","role":"Primary Confirm / Accept"},"BTN_EAST_B":{"code":305,"label":"B Button","role":"Cancel / Back"},"BTN_NORTH_X":{"code":307,"label":"X Button","role":"Action / Menu"},"BTN_WEST_Y":{"code":308,"label":"Y Button","role":"Context Action / Secondary"},"BTN_TL_L1":{"code":310,"label":"L1 Bumper","role":"Left Shoulder"},"BTN_TR_R1":{"code":311,"label":"R1 Bumper","role":"Right Shoulder"},"BTN_TL2_L2":{"code":312,"label":"L2 Trigger","role":"Left Trigger (or ABS_Z 2)"},"BTN_TR2_R2":{"code":313,"label":"R2 Trigger","role":"Right Trigger (or ABS_RZ 5)"},"BTN_SELECT":{"code":314,"label":"SELECT","role":"Select / Hotkeys"},"BTN_START":{"code":315,"label":"START","role":"Start / Pause Menu"},"BTN_THUMBL_L3":{"code":317,"label":"L3 Button","role":"Left Stick Click"},"BTN_THUMBR_R3":{"code":318,"label":"R3 Button","role":"Right Stick Click"},"DPAD_UP":{"code":103,"label":"D-Pad Up","alt_axis":"ABS_HAT0Y == -1"},"DPAD_DOWN":{"code":108,"label":"D-Pad Down","alt_axis":"ABS_HAT0Y == 1"},"DPAD_LEFT":{"code":105,"label":"D-Pad Left","alt_axis":"ABS_HAT0X == -1"},"DPAD_RIGHT":{"code":106,"label":"D-Pad Right","alt_axis":"ABS_HAT0X == 1"}},"analog_axes":{"LEFT_STICK_X":{"code":0,"axis":"ABS_X","range":"[-32768, 32767]"},"LEFT_STICK_Y":{"code":1,"axis":"ABS_Y","range":"[-32768, 32767]"},"RIGHT_STICK_X":{"code":3,"axis":"ABS_RX","range":"[-32768, 32767]"},"RIGHT_STICK_Y":{"code":4,"axis":"ABS_RY","range":"[-32768, 32767]"}}},"package_conventions":{"config_file":"config.json","config_schema":{"label":"App Display Name","icon":"icon.png","themecolor":"#hexcolor","description":"One line description of application"},"launch_script":"launch.sh","lifecycle_rule":"Must run `killall -STOP MainUI` before launching and `killall -CONT MainUI` upon exit."},"resources":{"llms_index":"https://trimui.vndns.net/llms.txt","full_handbook":"https://trimui.vndns.net/llms-full.txt","agent_skill_file":"https://trimui.vndns.net/skills/trimui-app-dev.md","starter_boilerplate_zip":"https://trimui.vndns.net/downloads/templates/trimui-rust-starter.zip","automated_publisher_script":"tools/publish_app.sh"}}