Manual:USB Features: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
(updated and reorganized)
 
(44 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==Summary==
==Summary==


Not all of the RouterBOARDS with USB ports have the same supported features. This article list all supported USB features by each RouterBOARD.
<p id="shbox"><b>Sub-menu:</b> <code>/system routerboard usb</code><br />
<b>Package:</b>  <code>routerboard (v5) / system (v6, v7)</code>
</p>


==USB feature table==
Gathered information on routers that have power reset feature


{| class="wikitable collapsible sortable"
This article describes RouterBoard device supported USB features.
|width="200px" style="background:#cccccc; border-bottom:1px solid gray;"  | RouterBOARD
 
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| USB ports
==USB Power Reset==
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| Power Reset
 
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| USB powering
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.
|-
 
|style="border-bottom:1px solid gray;" valign="top"|RB OmniTik U-5HnD
Available properties:
|style="border-bottom:1px solid gray;" valign="top"|1
* <var>duration</var>  (<em>time</em>; Default: "3s") - Time interval how long power is turned off.
|style="border-bottom:1px solid gray;" valign="top"|yes
 
|style="border-bottom:1px solid gray;" valign="top"|yes
For example, turn off USB port power for 10 seconds:
|-
<pre>
|style="border-bottom:1px solid gray;" valign="top"|RB OmniTik UPA-5HnD
/system routerboard usb power-reset duration=10s
|style="border-bottom:1px solid gray;" valign="top"|1
</pre>
|style="border-bottom:1px solid gray;" valign="top"|yes
 
|style="border-bottom:1px solid gray;" valign="top"|yes
RouterBoards with multiple USB buses also require bus specified in order to do USB power reset.<br />
|-
Available properties:
|style="border-bottom:1px solid gray;" valign="top"|RB SXT
* <var>duration</var>  (<em>time</em>; Default: "3s") - Time interval how long power is turned off.
|style="border-bottom:1px solid gray;" valign="top"|1
* <var>bus</var>  (<em>integer</em>; Default: 1) - USB bus where power reset is applied.
|style="border-bottom:1px solid gray;" valign="top"|yes
 
|style="border-bottom:1px solid gray;" valign="top"|yes
{{ 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.}}
|-
 
|style="border-bottom:1px solid gray;" valign="top"|RB411GL
{{ Note | '''RB922UAG''': The USB port has independent bus - 1. The miniPCIe slot has independent bus - 2.}}
|style="border-bottom:1px solid gray;" valign="top"|1
 
|style="border-bottom:1px solid gray;" valign="top"|yes
{{ Note | '''CCR1072-1G-8S+''': The micro USB port has independent bus - 0. The USB Type-A port has independent bus - 1.}}
|style="border-bottom:1px solid gray;" valign="top"|yes
 
|-
==USB Port Type==
|style="border-bottom:1px solid gray;" valign="top"|RB411U
 
|style="border-bottom:1px solid gray;" valign="top"|1
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.
|style="border-bottom:1px solid gray;" valign="top"|no
 
|style="border-bottom:1px solid gray;" valign="top"|yes
<pre>
|-
[admin@MikroTik] > /system routerboard usb set type=
|style="border-bottom:1px solid gray;" valign="top"|RB411UAHL
USB-type-A  mini-PCIe
|style="border-bottom:1px solid gray;" valign="top"|1
</pre>
|style="border-bottom:1px solid gray;" valign="top"|yes
 
|style="border-bottom:1px solid gray;" valign="top"|yes
Available properties:
|-
* <var>type</var> (<em>USB-type-A | mini-PCIe</em>; Default: "USB-type-A") - Type of enabled port.
|style="border-bottom:1px solid gray;" valign="top"|RB411UAHR
 
|style="border-bottom:1px solid gray;" valign="top"|1
{{ 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.}}
|style="border-bottom:1px solid gray;" valign="top"|no
 
|style="border-bottom:1px solid gray;" valign="top"|no*
==USB Port Mode==
|-
 
|style="border-bottom:1px solid gray;" valign="top"|RB433GL
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.
|style="border-bottom:1px solid gray;" valign="top"|1
 
|style="border-bottom:1px solid gray;" valign="top"|yes
Available properties:
|style="border-bottom:1px solid gray;" valign="top"|yes
* <var>usb-mode</var> (<em>automatic | force-host</em>; Default: "automatic") - Defines USB port mode.
|-
 
|style="border-bottom:1px solid gray;" valign="top"|RB433UAH
{{ Note | In RouterOS v5 this setting was called "mode".  }}
|style="border-bottom:1px solid gray;" valign="top"|2
{{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.}}
|style="border-bottom:1px solid gray;" valign="top"|no
 
|style="border-bottom:1px solid gray;" valign="top"|yes
==RouterBoard USB Port Limitations==
|-
 
|style="border-bottom:1px solid gray;" valign="top"|RB433UAHL
Information about RouterBoard USB features.
|style="border-bottom:1px solid gray;" valign="top"|1
 
|style="border-bottom:1px solid gray;" valign="top"|yes
Some RouterBoard devices have notable USB port limitations.
|style="border-bottom:1px solid gray;" valign="top"|yes
 
|-
* RB mAP 2n - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|RB435G
* RB750UP - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|2
* RB751U-2HnD - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|yes
* RB751G-2HnD - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|yes
* RB411U - does not support USB Power Reset
|-
* RB411UAHR - does not support USB Power Reset and USB Powering ([https://mikrotik.com/product/5VUSB USB power injector] is required)
|style="border-bottom:1px solid gray;" valign="top"|RB493G
* RB433UAH - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|1
* RB435G - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|no
* RB493G - does not support USB Power Reset and USB Powering ([https://mikrotik.com/product/5VUSB USB power injector] is required)
|style="border-bottom:1px solid gray;" valign="top"|no*
 
|-
{{ Note | RouterOS does not support memory slot from USB modems. }}
|style="border-bottom:1px solid gray;" valign="top"|RB711UA-2HnD
|style="border-bottom:1px solid gray;" valign="top"|1
|style="border-bottom:1px solid gray;" valign="top"|yes
|style="border-bottom:1px solid gray;" valign="top"|yes
|-
|style="border-bottom:1px solid gray;" valign="top"|RB711UA-5HnD
|style="border-bottom:1px solid gray;" valign="top"|1
|style="border-bottom:1px solid gray;" valign="top"|yes
|style="border-bottom:1px solid gray;" valign="top"|yes
|-
|style="border-bottom:1px solid gray;" valign="top"|RB750UP
|style="border-bottom:1px solid gray;" valign="top"|1
|style="border-bottom:1px solid gray;" valign="top"|no
|style="border-bottom:1px solid gray;" valign="top"|yes
|-
|style="border-bottom:1px solid gray;" valign="top"|RB751G-2HnD
|style="border-bottom:1px solid gray;" valign="top"|1
|style="border-bottom:1px solid gray;" valign="top"|no
|style="border-bottom:1px solid gray;" valign="top"|yes
|-
|style="border-bottom:1px solid gray;" valign="top"|RB751U-2HnD
|style="border-bottom:1px solid gray;" valign="top"|1
|style="border-bottom:1px solid gray;" valign="top"|no
|style="border-bottom:1px solid gray;" valign="top"|yes
|}


* - use of [http://routerboard.com/5VUSB USB power injector] is required in these models


[[Category:RouterBOARD]]
[[Category:RouterBOARD]]
[[Category:Hardware]]
[[Category:Hardware]]

Latest revision as of 09:11, 4 August 2022

Summary

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.
Icon-note.png

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.


Icon-note.png

Note: RB922UAG: The USB port has independent bus - 1. The miniPCIe slot has independent bus - 2.


Icon-note.png

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.
Icon-note.png

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.
Icon-note.png

Note: In RouterOS v5 this setting was called "mode".


Icon-warn.png

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)
Icon-note.png

Note: RouterOS does not support memory slot from USB modems.