Skip to content

Port settings

Each port has its own settings. You can change them in the web interface’s Settings, in Home Assistant, over MQTT or with the HTTP API. Changes apply at once, even to a device that is already plugged in.

Give each port a name, such as pi-cluster-1 or Desk phone, up to 23 characters. The name shows in the web interface and in Home Assistant, where the entities are renamed to match: Port 3 power becomes Desk phone power. Renaming doesn’t change any entity IDs, so your automations keep working.

Leave the name blank to go back to Port 1, Port 2 and so on.

Choose what each port does when Power Manifold is switched on, for example after a power cut:

  • on (the default): the port powers up.
  • off: the port stays off until you switch it on.
  • last: the port comes back the way you last left it.

When the chassis powers up, the ports come on one at a time, a quarter of a second apart, in priority order. This stops six devices from starting all at once.

The voltage cap is the highest voltage a port offers. Choose 5, 9, 12, 15 or 20 V. The default is 20 V, which offers everything.

Each port is a USB Power Delivery 3.2 source. Besides the fixed voltages, it offers two ranges in which the device chooses its own voltage: PPS (Programmable Power Supply) and SPR AVS (Adjustable Voltage Supply). The cap applies to them as well:

Cap PPS SPR AVS
5 V or 9 V none none
12 V 5–11 V none
15 V 5–11 V 9–15 V
20 V 5–21 V 9–20 V

The 20 V cap is the one exception: it still offers the 5–21 V PPS range, which goes slightly above 20 V.

Use a lower cap to protect a device that shouldn’t get a high voltage. For example:

  • 5 V for a device with a USB-C® trigger board or adapter that you don’t fully trust.
  • 9 V to limit the charging power of a phone.

The power limit is the most power a port offers, from 5 to 100 W. The port offers that power at every voltage, up to 5 A. A 60 W limit means 5 A at 5, 9 and 12 V, 4 A at 15 V and 3 A at 20 V.

The limit only sets what the port offers. A device that requests more receives the limited amount and is not switched off. Devices without USB Power Delivery are held to the limit too, at 5 V and up to 3 A.

Try a cap, a limit and a cable to see what a port offers:

Voltage cap
Cable
5 V5.00 A · 25 Wset by the 5 A maximum
9 V5.00 A · 45 Wset by the 5 A maximum
12 V5.00 A · 60 Wset by the power limit
15 V4.00 A · 60 Wset by the power limit
20 V3.00 A · 60 Wset by the power limit
SPR AVS 9–20 V3.00 A · 60 Wset by the power limit
PPS 5–21 V2.86 A · 60 Wset by the power limit
Bars run from 0 to 100 W. SPR AVS and PPS are shown at the top of their range. A device picks one option, and power sharing can still turn the port down when the supply is short.

The controller decides a device has finished charging when it draws less than 500 mW for 10 minutes. The port light then turns white, as if nothing were plugged in, and the port shows charged. If the device starts drawing again for that long, it counts as charging again.

Both numbers can be changed in Settings, as Charged below and …for. To turn this off, set the power threshold to 0: no device is ever marked charged, and Switch off once charged never turns a port off.

The same threshold tells the controller that a device has been switched off, which lets a waiting blade firmware update run.

Two per-port options build on this:

  • Switch off once charged turns the port off as soon as the device is charged. Use it to stop phones and tablets from staying at 100 % overnight.
  • Sleep timer turns the port off a set number of minutes after you plug a device in, whether it has finished charging or not, up to 24 hours.

The phone charges, then draws next to nothing. Ten minutes under 0.5 W later the port shows charged and its light turns white. The port stays on, so the phone is kept topped up.

The same until the phone counts as charged. At that moment the port switches off, and it stays off until you switch it on again.

The timer counts from when the phone is plugged in. Two hours later the port switches off, whether the phone has finished charging or not.

20 W0.5 W10 minChargedGreenWhite10 minCharged, switched offGreenOffTimer ends, switched offGreenOffPlugged in1 h2 h3 h4 h
Power drawn by the phone, with the port light underneath.

When either one switches a port off, it stays off until you switch it on again. A port set to last at power-up remembers that it was off.

Each port also has a priority, which decides which ports are turned down first when devices ask for more power than the supply can give. A port with priority 0 is never turned down to make room for another port, which suits devices that could be harmed by potential power loss during renegotiation. See Sharing power between ports.

USB Type-C® and USB-C® are registered trademarks of USB Implementers Forum.