Input and outputUpdated 2026-07-24

Console output and trace channels

Identify the output console, write controller output, block a Zen output cycle, and observe values through TRACE channels.

Overview

Core console functions identify the connected console and control the report sent to it. set_val writes a controller entry; block_all_inputs blocks output for the current main cycle on Zen.

TRACE_1 through TRACE_6 are output identifiers that can be observed in the tooling by writing values with set_val. They are not a trace function, and printf belongs to the Zen OLED API.

Key facts

  • get_console is available on Zen and Plus.
  • set_val writes the output value sent to the console.
  • block_all_inputs is listed for Zen and blocks output for one main cycle.
  • Protocol and PS4 authentication helpers in the legacy table are Plus-only; do not assume they are Zen APIs.

GPC syntax examples

Examples are intentionally small. Replace identifiers only with values documented for your target.

Expose a value in a trace channelexample.gpc
main {
    set_val(TRACE_1, get_val(XB1_A));
}

Functions, commands, and terms

Names below are catalog entries, not guessed signatures. Open the official sources for current parameter and return-value details.

NameKindPurpose
get_consolefunction · Zen and Plus

Returns the connected console type.

set_valfunction · Zen and Plus

Overwrites a controller entry in the outgoing console report.

block_all_inputsfunction · Zen only

Blocks all output sent to the console for the current main cycle.

TRACE_1..TRACE_6constant family

Output identifiers used with set_val to expose six observable trace values.

ps4_authtimeoutfunction · Plus only

Legacy Plus helper for checking the PS4 authentication timeout.

output_reconnectionfunction · Plus only

Legacy Plus helper for output reconnection.

output_protocolfunction · Plus only

Legacy Plus helper for setting the output protocol.

Common mistakes

Calling a nonexistent trace function.

Using OLED printf as console logging.

Treating Plus-only protocol or authentication helpers as Zen APIs.

Forgetting that block_all_inputs affects only the current main cycle.

Official GPC sources

Use these first-party references to confirm exact syntax and runtime behavior for your installed firmware and Studio version.

Related GPC references