Command List for Ultimate Powerbox v3
Device exposes a USB to Serial COM port:
Manufacturer: PegasusAstro
Product: UPBv3
VID: 303a
PID: 9005
Connection Settings: 115200, 8N1 (DTR on)
(All commands should be terminated with a new line /n)
Send: P# or ##
Receive: UPBv3__
Explanation: Reports UPBv3 identifcation.
is a 8 char unique identificaion string followed by which is the PCB revision char e.g 35AC34FC_A
Receive: PA::::::::::::
Explanation: Outputs the status of power ports.
and can have values from 0 – 100 as they are PWM duty cycle % ports.
, and outputs are digital so they have 0 or 1 values.
Receive: UA: USB1:USB2:USB3:USB4:USB5:USB6:USB7:USB8
Explanation: Outputs the status of USB ports. USB ports are digital ports and have 0 or 1 value.
Receive: P[1-6]:[pwm_value]
Explanation: Set the power level of each power port. E.g. P2:100 or P2:0 or P2:34.
The pwm_value accepts a number from 0 to 100 and is a percentage of the power output (ports are PWM enabled).
PWM levels are reset, lost after a device reboot.
Receive: U[1-8]:[boolean]
Explanation: Set the USB status of each USB port. A boolean value of 0 or 1 sets the status of each USB port.
Receive: D[1-3]:[pwm_value]
Explanation: Set the power level of each dew heater output. E.g. D2:100 or D2:0 or D2:43.
The pwm_value accepts a number from 0 to 100 and is a percentage of the power output (dew ports are PWM enabled).
Receive: PN[1-6]:[accepted string name]
Explanation: Assign a name to a power port.
Receive: UN[1-8]:[accepted string name]
Explanation: Assign a name to each USB Port.
Receive: DN[1-3]:[accepted string name]
Explanation: Assign a name to each Dew Ouput.
Receive: PLN:, ,,,,
Explanation: Lists Power Ports names.
Send: UNL
Receive: ULN:,,,,,
Explanation: Lists USB Ports names.
Send: DNL
Receive: ULN:, ,
Explanation: Lists Dew Port names.
Receive: PS…
Explanation: Aggregate Report
Receive: US…
Explanation: Aggregate Report
Receive: DSTR:1
Explanation: Stores to internal memory all [1-3] dew heater output level. Values are retrieved on boot).
Receive: AJ:;::
E.g AJ:5:1:19:0
Explanation: Listing of adjustable outputs. Their status and configured voltage.
Receive: RL:[boolean]
Explanation: Control of Relay Switch. 0 = OFF, 1=ON
Send: PJ:[voltage_level]
Receive: PJ:[voltage_level]
Enable / Disable Port
Send: PJ:[boolean]Receive: PJ:[boolean]
Explanation: Sets voltage of adjustable buck output. Also sending 0 or 1 disables or enables the port.
Voltage level accepts values from 3 to 12V
Adjust Voltage
Send: PB:[voltage_level]
Receive: PB:[voltage_level]
Enable / Disable Port
Send: PB:[boolean]Receive: PB:[boolean]
Explanation: Sets voltage of adjustable boost output. Also sending 0 or 1 disables or enables the port.
accepts values from 12 to 24V.
Receive: ADW:
is each Dew Ouput number: 1,2,3
can accept: 0 = disabled, 1 = enabled
Explanation: Enable or disable autodew to each dew port.
Receive: PD:
Each represents a dew port number. 0 = disabled, 1 = enabled
E.g Autodew is enabled on Dew1 and Dew2 -> PDS:101
Explanation: Autodew port report.
Send: DA:
Receive: DA:
Read
Send: DA:
Receive: DA:
Explanation: Autodew Aggresiveness.
Accepts values of 0 – 10. The highest, the most aggresive.
Controls the autodew aggresiveness per port. Permitted values are 1-10.
Set
Send: DA:
Receive: DA:
E.g: DA1:5
Read
Send: DAP
Receive: DAP:::
Receive: AFREQ:
Explanation: Set PWM frequency. Applied on PWM ports: power and dew outputs.
Accepted values 1-30000 (in Hz)
Receive: PC::::
Explanation: Reports power consumption.
Receive: PV:[RELEASE_MAJOR].[RELEASE_MINOR]
Explanation: Reports firmware version.
Receive: PL:[boolean]
Explanation: Indication LED Control. 0 = OFF, 1=ON
Value is NOT stored in memory.
Receive: VR::
E.g VR:12.3:2.2
Explanation: Reports Input voltage (Volts) and total current (Amps).
Receive: IS::::::
Explanation: Reports if a powerport had an overcurrent event. 0 = normal = 1 = overcurrent.
After an overcurrent event port turns off. To clear the overcurrent flag, switch on the specific port.
Receive: PCUR:
Explanation: Set current limit in milliamps. After this limit the port will shut down and report overcurrent flag.
Accepts values from 1 to 6000.
Default mA value is 5800.
Receive: ES:
Explanation: Reports Environmental Sensor data.
flag is a boolean. 0 = data are from internal sensor , 1 = data are from external sensor.
Receive: TESP:
Explanation: Microcontroller's internal temperature
Receive: CT:
Explanation: Offset value for temperature sensor. is a double.
Send: CH:
Receive: CH:
Explanation: Offset value for relative humidity sensor. is a signed integer.
Send: CR
Receive: CR::
Explanation: Read temperature and humidity sensor offsets.
is a double, is a signed integer
Receive: EE:1
Explanation: Erase all preferences.
Receive: EF:1
Explanation: Erase (Fill with zeros) FRAM. (operatiom takes about 3-4 seconds).
Receive: XC:[command] (there is a different command set for that)
Explanation: Controls I2C eXternal Motor Controller.
Receive: CC:
Explanation: How many commands where exchanged with the device since boot. (unsigned int32)
Receive: RT:
Explanation: Reports device uptime in seconds
Receive: no output
Explanation: Reboot device
Send: SA
Receive: SA:::::
Explanation: Motor Controller Aggregate Status.
: Motor current position in steps
: If motor is running (0 or 1)
: motor direction. 0 = normal, 1 = reverse.
: motor maxspeed in steps/sec
: motor microstepping values (Can take values 1, 2, 4, 8, 16, 32)
: motor current in mA
: Apply motor hold torque when idle. 0 = no torque, 1 = apply hold torque.
motor controller status = 0 = Fail, 1 = OK
Send: SP
Receive: SP:
Explanation: Motor position in steps.
Send: SC
Receive: SC:
Explanation: Sync motor position in steps. (motor does not move. Only syncs its position)
Send: SH
Receive: SH:1
Explanation: Motor halt.
Send: SI
Receive: SI:
Explanation: Motor is moving or not. 0 = idle, 1 = is moving.
Send: SM:
Receive: SM:
Explanation: Move motor in an absolute position.
Send: SG:
Receive: SG:
Explanation: Move motor in a relative position.
Send: SR:
Receive: SR:
Explanation: Direction of motor. 0 = normal , 1 = reverse
Send: SS:
Receive: SS:
Explanation: Speed of motor.
is unsigned int16;
Send: MCUR:
Receive: MCUR:
Explanation: Max current of motor
can be from 50 to 1500. (in mA)
Send: MSTEP:
Receive: MSTEP:
Explanation: Microsteps drive of motor controller. Accepted values are 1,2,4,8,16,32. Default is 2.
This command is available on firmware >= 1.4
Send: MHLD:
Receive: MSTEP:
Explanation: Apply motor idle hold torque. 0 = freewheel , 1 = apply hold torque when motor idle.
Setting is stored in meory and retrieved on boot.
To retrieve the value check "Motor Controller Aggregate Report" command.
Send: WS
Receive: WS:,, : ,, : ….
Explanation: Lists top ten in signal strength available WiFI networks in the area.
Send: WN:
Receive: WN:
Explanation: Set Network Name of WIFi Client.
Send: WP:
Receive: WP:
Explanation: Set Client Password. Should be >=8 chars.
When device receives a client password , it uses the cliend SSID and tries to set the WiFi connection. If connection is not successful it will try every 10 seconds.
Send: AN:
Receive: AN:
Explanation: Set Access Point Name.
Receive: AP:
Explanation: Set Access Point Password. When device receives an AP password it uses AP Name and password to configure the Access Point (Hotspot).
Send: AL
Receive: AL:
Explanation: Display configured access point (hotspot) SSID name and password.
Send: AE:
Receive: AE:
Explanation: Enable or Disable Access Point (hotspot). 0 = disable, 1 = enable
Send: A?
Receive: A?:
Explanation: Reports if Access Point (hotspot) is enables or disabled. 0 = disabled , 1 = enabled
Get Channel:
Send: AC
Receive: AC:
Explanation: Reports configured access point channel.
Set Channel
Send: AC:
Receive: AC:
Explanation: Sets the access point channel. Can accept a from 1 to 11.
Send: WA
Receive: WA::::
Explanation: Reports WiFi information of client connected to WiFi SSID.
is the SSID network that the client is connected to
is the assigned DHCP ip that client has
is the encryption security of network. It is an interger and number 3 represents WPA2 security.
{signal_strengh) is the signal quality in percentage 0-100%.
Send: WZ
Receive: WZ
Explanation: Resets all WiFi settings back to factory default.
