Manual:USB Features: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
(→‎USB feature table: added new RouterBoards)
(updated and reorganized)
 
(31 intermediate revisions by 5 users not shown)
Line 2: Line 2:


<p id="shbox"><b>Sub-menu:</b> <code>/system routerboard usb</code><br />
<p id="shbox"><b>Sub-menu:</b> <code>/system routerboard usb</code><br />
<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:
* <var>duration</var>  (<em>time</em>; Default: "3s") - Time interval how long power is turned off.
* <var>duration</var>  (<em>time</em>; Default: "3s") - Time interval how long power is turned off.


For example, "/system routerboard usb power-reset duration=10s" will turn off USB port power for 10 seconds.
For example, turn off USB port power for 10 seconds:
<pre>
/system routerboard usb power-reset duration=10s
</pre>


==USB port mode==
RouterBoards with multiple USB buses also require bus specified in order to do USB power reset.<br />
Available properties:
* <var>duration</var>  (<em>time</em>; Default: "3s") - Time interval how long power is turned off.
* <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 | '''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.


RB2011 series 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.
<pre>
[admin@MikroTik] > /system routerboard usb set type=
USB-type-A  mini-PCIe
</pre>


Available properties:
Available properties:
* <var>mode</var> (<em>automatic | force-host</em>; Default: "automatic") - Defines USB port mode.
* <var>type</var> (<em>USB-type-A | mini-PCIe</em>; 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 | 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==


==USB feature table==
Information about RouterBoard USB features.
Information about RouterBoard USB features.


{| class="wikitable collapsible sortable"
Some RouterBoard devices have notable USB port limitations.
|width="200px" style="background:#cccccc; border-bottom:1px solid gray;"  | RouterBOARD
 
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| USB ports
* RB mAP 2n - does not support USB Power Reset
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| Power Reset
* RB750UP - does not support USB Power Reset
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| USB powering
* RB751U-2HnD - does not support USB Power Reset
|-
* RB751G-2HnD - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|CCR1016-12G
* RB411U - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|1
* 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"|yes
* RB433UAH - does not support USB Power Reset
|style="border-bottom:1px solid gray;" valign="top"|yes
* RB435G - does not support USB Power Reset
|-
* 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"|CCR1036-12G-4S
|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"|RB OmniTik U-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"|RB OmniTik UPA-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"|RB SXT
|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"|RB2011UAS
|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"|RB2011UAS-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"|RB411GL
|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"|RB411U
|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"|RB411UAHL
|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"|RB411UAHR
|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"|no*
|-
|style="border-bottom:1px solid gray;" valign="top"|RB433GL
|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"|RB433UAH
|style="border-bottom:1px solid gray;" valign="top"|2
|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"|RB433UAHL
|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"|RB435G
|style="border-bottom:1px solid gray;" valign="top"|2
|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"|RB493G
|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"|no*
|-
|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
|-
|style="border-bottom:1px solid gray;" valign="top"|RB951G-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
|}


* * use of [http://routerboard.com/5VUSB USB power injector] is required in these models
{{ Note | RouterOS does not support memory slot from USB modems. }}




[[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.