Hardware and System

Hardware and System Controls

XeCLI exposes a small set of hardware and session controls that are useful during daily RGH/JTAG work:

• sign-in state inspection
• ring-of-light LED control
• manual fan command dispatch
• SMC version probing
• direct SMC temperature reads
• disc tray open/close
• trainer-style message-box popups

This page explains what those commands do, how they are intended to be used, and what their current practical limits are.

Command Overview

rgh signin state
rgh led set --preset quadrant1
rgh led state
rgh fan set --speed 55 --channel both
rgh fan show
rgh smc version
rgh smc temps
rgh tray open
rgh popup show --title "XeCLI" --body "Connected"

Signed-In Session State

rgh signin state

Reads the active XAM sign-in slot and resolves:

• whether a user is signed in
• the sign-in state
• the current gamertag
• the current XUID
• the user slot

Examples:

rgh signin state
rgh signin state --json

Representative output:

Signed In   Yes
State       Signed in locally
Gamertag    ExampleUser
XUID        0x<xuid>
Slot        0

Sign-in state meanings:

Value	Meaning
0	Not signed in
1	Signed in locally
2	Signed in to Xbox Live

This command is the cleanest way to answer the common questions:

• is anyone signed in right now?
• which profile is active?
• what XUID is attached to the current session?

Ring-of-Light LED Control

rgh led set

Sets the four ring-of-light quadrants through the console’s RPC path.

You can use:

• a preset
• explicit per-quadrant colors
• optional success notification flags

Examples:

rgh led set --preset quadrant1
rgh led set --preset all-green
rgh led set --tl green --tr off --bl off --br off
rgh led set --preset all-orange --notify

Supported colors:

• off
• green
• red
• orange

Built-in presets:

• all-green
• all-red
• all-orange
• all-off
• quadrant1
• quadrant2
• quadrant3
• quadrant4
• player1
• player2
• player3
• player4

Representative output:

SUCCESS Ring light updated
TL=green, TR=off, BL=off, BR=off

rgh led state

Shows the last ring-light state requested through XeCLI.

Examples:

rgh led state
rgh led state --json

Representative output:

Source        Last XeCLI-applied ring-light state
Preset        quadrant1
Top Left      green
Top Right     off
Bottom Left   off
Bottom Right  off
Updated       08:45:30

Important note:

• led state is a local cache of the last XeCLI-applied state
• it is not a hardware readback from the SMC

That distinction matters after a reboot or if another tool changes the LEDs.

Fan Control

rgh fan set

Dispatches a fan-control command through the console's SMC RPC path.

Examples:

rgh fan set --speed 55 --channel both
rgh fan set --speed 45 --channel primary
rgh fan set --speed 60 --channel secondary --notify

Restore automatic SMC control for both fan channels:

rgh fan set --speed 10 --channel both

Channel values:

• primary
• secondary
• both

Representative output:

SUCCESS Fan command sent
55% requested for both

Practical notes:

• XeCLI clamps input to 10-100
• requests from 10 through 44 all send the same special SMC value, 0x7F, which returns the selected channel to automatic control; they are not distinct low-speed settings
• requests from 45 through 100 are encoded as distinct manual values with the SMC manual-control bit set
• current fan control is a command-dispatch workflow, not a tachometer readback workflow
• the success message echoes the normalized request, not a measured fan speed or RPM
• fan show reports the last XeCLI-requested value, not live SMC state

A manual setting is not temporary to the XeCLI process: closing XeCLI does not restore automatic control. It remains console-side until another SMC request changes that channel or a console lifecycle event resets it. Restore automatic control explicitly before ending a maintenance session; do not rely on cached state or an application restart. Automatic control is the recommended normal operating mode. Monitor temperatures while using manual control, never leave a console unattended with a forced setting, and treat abnormal temperatures or fan behavior as a cooling-system fault rather than compensating with software.

rgh fan show

Shows the last fan-control value requested through XeCLI.

Examples:

rgh fan show
rgh fan show --json

Representative output:

Source   Last XeCLI-applied manual setting
Speed    50%
Channel  both
Updated  09:12:04

This record is saved in XeCLI's configuration and can outlive both the application session and the console-side setting. It is informational only. If the saved request is between 10 and 44, interpret it as a request to restore automatic control, not as the displayed percentage being forced on the fan.

SMC Version

rgh smc version

Attempts to query the console’s SMC version.

Examples:

rgh smc version
rgh smc version --json

When the installed console-side plugin stack exposes the required SMC path cleanly, the command returns a simple version string.

Representative success output:

SUCCESS SMC version
2.3

Operational reality:

• SMC version probing is more plugin-stack-sensitive than normal JRPC title/temperature calls
• if the installed JRPC/XBDM stack does not expose a usable SMC reply path, XeCLI reports the failure instead of fabricating a value
• rgh status treats SMC version as optional and does not let an SMC failure poison the rest of the status output

SMC Temperatures

rgh smc temps

Reads the CPU, GPU, EDRAM, and motherboard sensors directly from SMC command 0x07. Values retain the SMC's native 8.8 fixed-point precision instead of being reduced to whole degrees.

Examples:

rgh smc temps
rgh smc temps --json

The command snapshots its temporary XBDM scratch buffers before the RPC and verifies both buffers after restoration. Invalid sentinels, incomplete replies, implausible values, or a failed restoration are reported as failures; XeCLI does not emit a successful temperature result in those cases.

rgh jrpc2 temps remains useful for broad plugin compatibility. Use rgh smc temps when you need direct, fractional readings or an independent cross-check of the JRPC2 path.

Disc Tray Control

rgh tray open

rgh tray close

Open or close the physical optical tray through the console-side XAM/JRPC path.

Examples:

rgh tray open
rgh tray close

Representative output:

SUCCESS Disc tray opened

SUCCESS Disc tray closed

Use this when you need quick hardware confirmation that the console is responding to control calls beyond plain XBDM connectivity.

Native Message Boxes

rgh popup show

Shows a native Xbox 360 popup. This is the same UI family trainers commonly use for full-screen prompts and instruction popups.

Examples:

rgh popup show --title "XeCLI" --body "Connected to console"
rgh popup show --title "Warning" --body "Reboot required" --preset warning
rgh popup show --title "Question" --body "Continue?" --preset question
rgh popup show --title "System Message" --body "Operation complete" --style 3

Preset values:

• none
• error
• warning
• question

Representative output:

SUCCESS Popup requested
Title="XeCLI" Preset=warning Buttons=1

Operational notes:

• popup show is different from rgh notify
• notify sends a toast in the XNotify queue
• popup show blocks the foreground UI until the user dismisses it
• use --preset none when you want the cleaner look without the red error icon
• XeCLI documents only the verified popup presets and the raw --style pass-through; bottom-placement or other layout claims are not advertised unless they are proven on hardware

Status Integration

rgh status and rgh status --json surface the session fields directly:

• Signed In
• Sign-In State
• Gamertag
• Signed In XUID
• SMC Version when available

That means you can use status for the dashboard-level snapshot and signin state when you want the session details isolated.

Recommended Operator Usage

Use the commands in this order:

rgh ping
rgh status --quick
rgh signin state
rgh led set --preset quadrant1
rgh notify "XeCLI connected" 14

Then move to the less routine controls:

rgh fan set --speed 55 --channel both
rgh smc version
rgh smc temps

That sequencing keeps the basic transport validation separate from the hardware/session controls.