<b>Package:</b> <code>routerboard (v5) / system (v6)</code>
<b>Package:</b> <code>routerboard (v5) / system (v6, v7)</code>
</p>
</p>
Not all of the RouterBoards with USB ports have the same supported features. This article list all supported USB features by each RouterBoard.
This article describes RouterBoard device supported USB features.
==USB power reset==
==USB Power Reset==
USB power reset turns off USB port power for specified time. It is useful when 3G modem needs to be restarted but there is no direct access to it (tower installation).
USB power reset turns off USB port power for specified time. It is useful when 3G/LTE modem needs to be restarted but there is no physical access to it.
Available properties:
Available properties:
Line 25:
Line 25:
* <var>bus</var> (<em>integer</em>; Default: 1) - USB bus where power reset is applied.
* <var>bus</var> (<em>integer</em>; Default: 1) - USB bus where power reset is applied.
{{ Note | '''RB953GS''': The miniPCIe slot closer to ethernet ports on the RB953GS board is the one which is shared with USB port and has configurable [[#USB_port_type | USB port type]], its USB bus number is 1. Depending on [[#USB_port_type | USB port type]] the power reset is done on USB port or miniPCIe slot. The other miniPCIe slot closer to SFP slots has independent bus - 2.}}
{{ Note | '''RB953GS''': The miniPCIe slot closer to Ethernet ports on the RB953GS board is the one which is shared with USB port and has configurable [[#USB_port_type | USB port type]], its USB bus number is 1. Depending on [[#USB_port_type | USB port type]] the power reset is done on USB port or miniPCIe slot. The other miniPCIe slot closer to SFP slots has independent bus - 2.}}
{{ Note | '''RB922UAG''': The USB port has independent bus - 1. The miniPCIe slot has independent bus - 2.}}
{{ Note | '''RB922UAG''': The USB port has independent bus - 1. The miniPCIe slot has independent bus - 2.}}
==USB port mode==
{{ Note | '''CCR1072-1G-8S+''': The micro USB port has independent bus - 0. The USB Type-A port has independent bus - 1.}}
RB2011 series, CRS series and mAP have micro USB port which operates in host mode when USB device is attached through USB OTG cable. Some vendor cables require forced host mode to recognize connected device.
==USB Port Type==
Available properties:
RB912UAG and RB953GS have partially shared USB port and miniPCIe slot. Due to hardware restrictions it is possible to use only one at the time for 3G/LTE modem.
* <var>usb-mode</var> (<em>automatic | force-host</em>; Default: "automatic") - Defines USB port mode.
{{ Note | In RouterOS v5 this setting was called "mode". }}
{{Warning | On '''RB2011''' and '''CRS''' series boards USB devices may not work first time they are plugged in. In such cases power cycle (not reboot) is required.}}
==USB port type==
RB912UAG and RB953GS have partially shared USB port and miniPCIe slot. Due to hardware restrictions it is possible to use only one at the time for 3G modem.
<pre>
<pre>
Line 50:
Line 43:
* <var>type</var> (<em>USB-type-A | mini-PCIe</em>; Default: "USB-type-A") - Type of enabled port.
* <var>type</var> (<em>USB-type-A | mini-PCIe</em>; Default: "USB-type-A") - Type of enabled port.
{{ Note | In RouterOS v5 this setting was called "use". }}
{{ Note | '''RB953GS''': The miniPCIe slot closer to Ethernet ports on the RB953GS board is the one which is shared with USB port and has configurable [[#USB_port_type | USB port type]], its USB bus number is 1. Depending on [[#USB_port_type | USB port type]] the power reset is done on USB port or miniPCIe slot. The other miniPCIe slot closer to SFP slots has independent bus - 2.}}
{{ Note | '''RB953GS''': The miniPCIe slot closer to ethernet ports on the RB953GS board is the one which is shared with USB port and has configurable [[#USB_port_type | USB port type]], its USB bus number is 1. Depending on [[#USB_port_type | USB port type]] the power reset is done on USB port or miniPCIe slot. The other miniPCIe slot closer to SFP slots has independent bus - 2.}}
==USB Port Mode==
RB2011 series, CRS1xx series and mAP have micro USB port which operates in host mode when USB device is attached through USB OTG cable. Some vendor cables require forced host mode to recognize connected device.
Available properties:
* <var>usb-mode</var> (<em>automatic | force-host</em>; Default: "automatic") - Defines USB port mode.
{{ Note | In RouterOS v5 this setting was called "mode". }}
{{Warning | On '''RB2011''' and '''CRS1xx''' series boards USB devices may not work first time they are plugged in. In such cases power cycle (not reboot) is required.}}
==RouterBoard USB Port Limitations==
==RouterBoard USB port table==
Information about RouterBoard USB features.
Information about RouterBoard USB features.
{| class="wikitable collapsible sortable"
Some RouterBoard devices have notable USB port limitations.
Sub-menu:/system routerboard usb Package:routerboard (v5) / system (v6, v7)
This article describes RouterBoard device supported USB features.
USB Power Reset
USB power reset turns off USB port power for specified time. It is useful when 3G/LTE modem needs to be restarted but there is no physical access to it.
Available properties:
duration (time; Default: "3s") - Time interval how long power is turned off.
For example, turn off USB port power for 10 seconds:
/system routerboard usb power-reset duration=10s
RouterBoards with multiple USB buses also require bus specified in order to do USB power reset.
Available properties:
duration (time; Default: "3s") - Time interval how long power is turned off.
bus (integer; Default: 1) - USB bus where power reset is applied.
Note:RB953GS: The miniPCIe slot closer to Ethernet ports on the RB953GS board is the one which is shared with USB port and has configurable USB port type, its USB bus number is 1. Depending on USB port type the power reset is done on USB port or miniPCIe slot. The other miniPCIe slot closer to SFP slots has independent bus - 2.
Note:RB922UAG: The USB port has independent bus - 1. The miniPCIe slot has independent bus - 2.
Note:CCR1072-1G-8S+: The micro USB port has independent bus - 0. The USB Type-A port has independent bus - 1.
USB Port Type
RB912UAG and RB953GS have partially shared USB port and miniPCIe slot. Due to hardware restrictions it is possible to use only one at the time for 3G/LTE modem.
[admin@MikroTik] > /system routerboard usb set type=
USB-type-A mini-PCIe
Available properties:
type (USB-type-A | mini-PCIe; Default: "USB-type-A") - Type of enabled port.
Note:RB953GS: The miniPCIe slot closer to Ethernet ports on the RB953GS board is the one which is shared with USB port and has configurable USB port type, its USB bus number is 1. Depending on USB port type the power reset is done on USB port or miniPCIe slot. The other miniPCIe slot closer to SFP slots has independent bus - 2.
USB Port Mode
RB2011 series, CRS1xx series and mAP have micro USB port which operates in host mode when USB device is attached through USB OTG cable. Some vendor cables require forced host mode to recognize connected device.
Available properties:
usb-mode (automatic | force-host; Default: "automatic") - Defines USB port mode.
Note: In RouterOS v5 this setting was called "mode".
Warning: On RB2011 and CRS1xx series boards USB devices may not work first time they are plugged in. In such cases power cycle (not reboot) is required.
RouterBoard USB Port Limitations
Information about RouterBoard USB features.
Some RouterBoard devices have notable USB port limitations.
RB mAP 2n - does not support USB Power Reset
RB750UP - does not support USB Power Reset
RB751U-2HnD - does not support USB Power Reset
RB751G-2HnD - does not support USB Power Reset
RB411U - does not support USB Power Reset
RB411UAHR - does not support USB Power Reset and USB Powering (USB power injector is required)
RB433UAH - does not support USB Power Reset
RB435G - does not support USB Power Reset
RB493G - does not support USB Power Reset and USB Powering (USB power injector is required)
Note: RouterOS does not support memory slot from USB modems.
