openydt-device

CRITICAL — MUST use the Read tool to read
../openydt-shared/SKILL.md
before starting: It contains general conventions such as authentication / profile / signature / status code / rate limit / security. Do not execute any commands without reading the base specification.

When to Use This Skill

Use this skill when the user intends to "issue commands to or read the status of on-site parking lot devices", such as: remote gate opening/closing, switching the gate to always-open mode, pushing text to the display screen, enabling device voice broadcasting/announcement, capturing vehicle images, controlling cloud QR code scanners (start scanning/stop scanning/voice broadcasting/update configuration), querying device online status.

Intent Routing:

"Open gate / Close gate / Lift bar / Lower bar / Remote door opening" → Use
```
op-gate
```
for traditional/cloud parking lots; use
```
cloud-open-gate
```
for pure cloud parking lots to open/close by channel ID.
"Always open / Restore normal / Change gate mode" →
```
change-channel-mode
```
.
"Display screen / LED display / Voice broadcasting / Announcement" →
```
op-show-voice
```
; set default display image carousel →
```
set-default-screen
```
.
"Snapshot / Take photo" →
```
channel-snap
```
.
"QR code scanner / QR code payment device" → Scan with
```
cloud-scan-qr-code
```
, stop with
```
cloud-stop-scan-code
```
, voice broadcasting with
```
cloud-scan-voice
```
, update configuration with
```
cloud-scan-update-config
```
.
"Device status / Whether online" →
```
get-cloud-equip-status
```
.

For queries not involving on-site devices (vehicles on site, orders, monthly passes, coupons), please use corresponding business domain skills (
openydt parking
/
openydt trade
/
openydt ticket
/
openydt coupon
, etc.).

Available Commands

Chinese Name	Command	Read/Write	Key Parameters
Modify All-in-One Gate Mode	`openydt device change-channel-mode`	Write	parkCode, channelCode, mode(0=Always Open/1=Normal)
Manual Snapshot	`openydt device channel-snap`	Write	parkCode, channelCode, operator(optional)
Cloud Parking Lot Channel Open/Close	`openydt device cloud-open-gate`	Write	parkCode, channelId, opType(0=Open/1=Close)
Issue Scanning Command to QR Code Scanner	`openydt device cloud-scan-qr-code`	Write	parkCode, scanMachineId, deviceType, timeLength, voiceType
Update QR Code Scanner Configuration	`openydt device cloud-scan-update-config`	Write	scanMachineId, channelId
QR Code Scanner Voice Broadcasting	`openydt device cloud-scan-voice`	Write	parkCode, scanMachineId, voiceType, voiceNum, voiceInterval
Stop QR Code Scanner Scanning	`openydt device cloud-stop-scan-code`	Write	parkCode, scanMachineId, deviceType(optional)
Get Cloud Device Status	`openydt device get-cloud-equip-status`	Read	equipType(0=All-in-One/2=Card Machine/3=QR Code Scanner), clientId
Open/Close Gate	`openydt device op-gate`	Write	parkCode, channelCode, opType(0=Open/1=Close), operator, operateTime, carNo(optional)
Display Screen/Voice Broadcasting	`openydt device op-show-voice`	Write	parkCode, channelCode, show/voice(at least one), qrCode(optional), operator, operateTime
Set Default Display Content	`openydt device set-default-screen`	Write	parkCode, deviceType, channelCode, templateData.imageArray

Except for
get-cloud-equip-status
(read), all the above are write operations, and must be executed with
--yes
for confirmation.

Business Process

Device control is a high-risk operation that directly affects on-site hardware. Standard sequence:Locate the device first → Check the status before intervention → Preview with
--dry-run
→ Confirm and add
--yes
to actually issue the command. Be sure to pass the fields from the previous command response to the subsequent command parameters; do not fill in values by guesswork.

Locate Channel / Device: Obtain
```
parkCode
```
, channel
```
channelCode
```
or
```
channelId
```
, device
```
scanMachineId
```
/
```
clientId
```
in the parking lot domain (
```
openydt parking
```
/
```
openydt park
```
). These are the parameter sources for all subsequent device commands.
(Optional) Check Device Online Status First: For cloud devices, run
```
get-cloud-equip-status
```
(
```
equipType
```
+
```
clientId
```
) first, confirm the device is available through the online/status field in the response, then decide whether to issue the command.
```
clientId
```
is the
```
scanMachineId
```
of the QR code scanner.
Preview Write Command (High Risk, Must Use dry-run First): For commands such as
```
op-gate
```
,
```
cloud-open-gate
```
,
```
op-show-voice
```
,
```
change-channel-mode
```
,
```
set-default-screen
```
,
```
channel-snap
```
and QR code scanner series commands, use
```
--dry-run
```
first to view the request body and target to be sent, and verify that
```
parkCode
```
/
```
channelCode
```
/
```
channelId
```
/
```
opType
```
are correct.
Confirm Issuance: After reviewing the dry-run output, add
```
--yes
```
to the same set of parameters to officially execute.
- Gate opening/closing: Use
```
op-gate
```
  (
```
channelCode
```
  +
```
opType
```
  ) for traditional/cloud parking lots; use
```
cloud-open-gate
```
  for pure cloud parking lots by channel ID (use
```
channelId
```
  obtained in step 1 instead of channelCode).
- Gate always open:
```
change-channel-mode
```
  (
```
mode=0
```
  for Always Open /
```
mode=1
```
  for Normal).
- Display screen/announcement:
```
op-show-voice
```
  (at least one of
```
show
```
  and
```
voice
```
  is required); use
```
cloud-scan-voice
```
  for QR code scanner announcement (
```
scanMachineId
```
  obtained from step 1/2).
- Scanning process:
```
cloud-scan-qr-code
```
  to start scanning → (if needed)
```
cloud-scan-voice
```
  for prompt →
```
cloud-stop-scan-code
```
  to stop, all reuse the same
```
scanMachineId
```
  .
Verify Result: Check the return status code (refer to the base specification). For actions such as gate opening/closing, you can run
```
get-cloud-equip-status
```
again or review the on-site record in the parking lot domain to confirm effectiveness.

Examples

bash

# 1) Open gate (write, high risk): Preview first
openydt device op-gate \
  --park-code 2KNTYVWC --channel-code 001 --op-type 0 \
  --operator operator --operate-time "2017-09-11 14:04:04" --dry-run
# Execute after preview is correct
openydt device op-gate \
  --park-code 2KNTYVWC --channel-code 001 --op-type 0 \
  --operator operator --operate-time "2017-09-11 14:04:04" --yes

# 2) Display screen + Voice broadcasting (write, requires --yes; at least one of show/voice)
openydt device op-show-voice \
  --park-code 2KNTYVWC --channel-code 001 \
  --show show --voice voice \
  --operator operator --operate-time "2017-09-11 14:04:04" --yes

# 3) Query cloud QR code scanner status (read, no --yes required)
openydt device get-cloud-equip-status --equip-type 3 --client-id 3571F003

openydt-device

NPX Install

Tags

SKILL.md Content (Chinese)

When to Use This Skill

Available Commands

Business Process

Examples