ppsspp_press_button
Simulate a single PSP button press for a specified duration to automate input in PPSSPP emulator sessions.
Instructions
PURPOSE: Simulate a single PSP button press for a duration.
USAGE: session_id + button required; duration optional (default 1 frame). Valid button names: cross / circle / triangle / square / up / down / left / right / start / select / ltrigger / rtrigger.
BEHAVIOR: STATE-CHANGE. Sends input events to PPSSPP. Button state returns to released after the duration elapses.
RETURNS: {button, duration}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>",
"button": "<button>"
},
"name": "ppsspp_press_button"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| button | Yes | Button name. Valid: cross / circle / triangle / square / up / down / left / right / start / select / ltrigger / rtrigger. | |
| duration | No | Press duration in frames (default 1; 60fps wall-clock, cap 18000 ≈ 300s — values above are rejected). duration=0 is accepted and is a no-op (the button is pressed and released in the same frame). The call blocks for the duration. | |
| session_id | Yes | Active session ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| button | Yes | Button name pressed. | |
| duration | Yes | Press duration in frames. |