Summary

Synaccess Networks netBooter NP Series is a networked power distribution unit (PDU) with per-outlet switching and group control. Supports serial (RS-232/USB), Telnet (TCP port 23), and HTTP (cmd.cgi) control interfaces; HTTPS is documented only for DU models. This spec covers CLI and HTTP API commands documented in the user manual.

Transport

protocols:
  - serial
  - tcp
  - http
serial:
  baud_rate: 9600
  data_bits: 8
  parity: none
  stop_bits: 1
  flow_control: xon_xoff  # source states "Hardware Handshaking: None" and "Flow Control: XON/XOFF"
addressing:
  port: 23  # Telnet default stated in source
  base_url: "http://{device_ip}/cmd.cgi"  # HTTPS on DU models only
auth:
  type: null  # UNRESOLVED: source mentions login/logout CLI commands but no auth procedure or credential format

Traits

- powerable   # outlet on/off/reboot commands present
- queryable   # pshow, $A5 status query commands present

Actions

# CLI commands (serial/Telnet)
- id: pset
  command: "pset <n> <v>"
  wire_template: "pset {outlet} {state}"
  label: Set Outlet State
  kind: action
  params:
    - name: outlet
      type: integer
      description: Outlet number
    - name: state
      type: integer
      description: "0 = OFF, 1 = ON"

- id: ps
  command: "ps <v>"
  wire_template: "ps {state}"
  label: Set All Outlets
  kind: action
  params:
    - name: state
      type: integer
      description: "0 = OFF, 1 = ON"

- id: rb
  command: "rb <n>"
  wire_template: "rb {outlet}"
  label: Reboot Outlet
  kind: action
  params:
    - name: outlet
      type: integer
      description: Outlet number

- id: gpset
  command: "gpset <n> <v>"
  wire_template: "gpset {group} {state}"
  label: Set Outlet Group State
  kind: action
  params:
    - name: group
      type: integer
      description: Outlet group number
    - name: state
      type: integer
      description: "0 = OFF, 1 = ON"

- id: grb
  command: "grb <n>"
  wire_template: "grb {group}"
  label: Reboot Outlet Group
  kind: action
  params:
    - name: group
      type: integer
      description: Outlet group number

- id: nwshow
  command: "nwshow"
  label: Show Network Settings
  kind: action
  params: []

- id: nwset
  command: "nwset"
  label: Reset Network Interface
  kind: action
  params: []

- id: dhcp
  command: "dhcp <x>"
  wire_template: "dhcp {mode}"
  label: Set DHCP Mode
  kind: action
  params:
    - name: mode
      type: integer
      description: "1 = DHCP, 0 = Static"

- id: ip_set
  command: "ip <ip> <mask>"
  wire_template: "ip {ip} {mask}"
  label: Set Static IP
  kind: action
  params:
    - name: ip
      type: string
      description: IP address
    - name: mask
      type: string
      description: Subnet mask

- id: gw_set
  command: "gw <gw>"
  wire_template: "gw {gateway}"
  label: Set Gateway
  kind: action
  params:
    - name: gateway
      type: string
      description: Gateway IP address

- id: mac_show
  command: "mac"
  label: Show MAC Address
  kind: action
  params: []

- id: web_set
  command: "web <v>"
  wire_template: "web {enabled}"
  label: Enable/Disable Web Access
  kind: action
  params:
    - name: enabled
      type: integer
      description: "1 = On, 0 = Off"

- id: mask_set
  command: "mask <m>"
  wire_template: "mask {mask}"
  label: Set Subnet Mask
  kind: action
  params:
    - name: mask
      type: string
      description: Subnet mask

- id: emailsend
  command: "emailsend"
  label: Send Test Email
  kind: action
  params: []

- id: hp_set
  command: "hp <port>"
  wire_template: "hp {port}"
  label: Set HTTP Port
  kind: action
  params:
    - name: port
      type: integer
      description: HTTP port number

- id: tp_set
  command: "tp <port>"
  wire_template: "tp {port}"
  label: Set Telnet Port
  kind: action
  params:
    - name: port
      type: integer
      description: Telnet port number

- id: ipsrc_set
  command: "Ipsrc <ip>"
  wire_template: "Ipsrc {ip}"
  label: Set Allowed Source IP
  kind: action
  params:
    - name: ip
      type: string
      description: Only this IP may access the unit

- id: login
  command: "login"
  label: Login
  kind: action
  params: []

- id: logout
  command: "logout"
  label: Logout
  kind: action
  params: []

- id: sysshow
  command: "sysshow"
  label: Show System Info
  kind: action
  params: []

- id: ver
  command: "ver"
  label: Show Firmware Version
  kind: action
  params: []

- id: help
  command: "help"
  label: Help Menu
  kind: action
  params: []

# HTTP API commands
- id: http_set_outlet
  command: "$A3"
  wire_template: "$A3 {outlet} {state}"
  label: Set Outlet ON/OFF (HTTP)
  kind: action
  params:
    - name: outlet
      type: integer
      description: Outlet number
    - name: state
      type: integer
      description: "0 = OFF, 1 = ON"
  transport_hint: "/cmd.cgi?$A3 {outlet} {state}"

- id: http_reboot
  command: "$A4"
  wire_template: "$A4 {outlet}"
  label: Reboot Outlet (HTTP)
  kind: action
  params:
    - name: outlet
      type: integer
      description: Outlet number
  transport_hint: "/cmd.cgi?$A4 {outlet}"

- id: http_set_all
  command: "$A7"
  wire_template: "$A7 {state}"
  label: Set All Outlets ON/OFF (HTTP)
  kind: action
  params:
    - name: state
      type: integer
      description: "1 = ON, 0 = OFF"
  transport_hint: "/cmd.cgi?$A7 {state}"

Feedbacks

- id: outlet_status_cli
  query_command: "pshow"
  type: string
  description: "CLI pshow command returns outlet status"

- id: outlet_status_http
  query_command: "$A5"
  transport_hint: "/cmd.cgi?$A5"
  type: string
  description: >
    HTTP $A5 returns: xxxx,cccc,cccc,tt or xxxx,cccc,tt
    x = outlet state (1=ON, 0=OFF), rightmost x = outlet 1
    c = AC current draw (amps)
    t = temperature (Celsius)

- id: http_return_code
  type: enum
  values:
    - $A0
    - $AF
  description: "$A0 = OK, $AF = Action failed or unknown"

- id: network_status
  type: string
  description: "nwshow returns IP, gateway, MAC, network settings"

- id: system_info
  type: string
  description: "sysshow returns system information"

- id: firmware_version
  type: string
  description: "ver returns firmware version string"

- id: mac_address
  type: string
  description: "mac returns Ethernet MAC address"

Variables

# UNRESOLVED: no settable continuous variables documented in source

Events

# UNRESOLVED: no unsolicited notification protocol documented in source

Macros

# UNRESOLVED: no multi-step sequences documented in source

Safety

confirmation_required_for: []
interlocks: []
# UNRESOLVED: source contains no safety warnings, interlock procedures, or power-on sequencing

Notes

  • CLI command format: CmdCode Arg1 Arg2 (space-delimited).
  • HTTP API mirrors CLI via /cmd.cgi?cmdCode Arg1 Arg2 URL pattern. The HTTP method is not stated in the source (UNRESOLVED).
  • HTTPS supported on DU models only (per source footnote).
  • Default static IP: 192.168.1.100, mask 255.255.0.0, gateway 192.168.1.1.
  • Outlet group configuration method is not documented in the source; gpset and grb control documented outlet groups.
  • Static ip and gw settings are effective when DHCP is disabled.
  • UNRESOLVED applicability: the source describes a generic netBooter PDU and does not enumerate NP model numbers; exact NP model applicability is not established.

Provenance

source_domains:
  - cdn.synaccess.com
  - synaccess.readme.io
  - github.com
source_urls:
  - https://cdn.synaccess.com/documents/1094_NPStartup_V20.pdf
  - https://synaccess.readme.io/docs/switching-an-outlet-on-or-off
  - https://synaccess.readme.io/docs/getting-started
  - https://synaccess.readme.io/reference/introduction-1
  - https://github.com/synaccess-networks/API-Examples/blob/master/examples.sh
retrieved_at: 2026-05-15T06:27:52.847Z
last_checked_at: 2026-09-28T05:21:52.287Z

Verification Summary

verdict: verified
checked_at: 2026-09-28T05:21:52.287Z
matched_actions: 27
action_count: 27
confidence: medium
summary: "All 27 CLI/HTTP units and transport values match the generic netBooter guide; exact NP applicability and HTTP method remain explicitly unresolved. (9 unresolved item(s) noted in Known Gaps.)"

Known Gaps

- "source mentions login/logout CLI commands but no auth procedure or credential format"
- "no settable continuous variables documented in source"
- "no unsolicited notification protocol documented in source"
- "no multi-step sequences documented in source"
- "source contains no safety warnings, interlock procedures, or power-on sequencing"
- "login/logout command credential flow not documented"
- "outlet group configuration method not documented"
- "HTTP API auth mechanism not documented"
- "email configuration method not documented"

From the AI4AV catalog (https://ai4av.net) · ODbL-1.0