Manual:USB Features: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
updated and reorganized
 
(13 intermediate revisions by 4 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:
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.}}
==USB port mode==


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


Available properties:
Available properties:
* <var>usb-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.}}


{{ Note | In RouterOS v5 this setting was called "mode".  }}
==USB Port 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.
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:
Available properties:
* <var>type</var> (<em>USB-type-A | mini-PCIe</em>; Default: "USB-type-A") - Type of enabled port.
* <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.}}


{{ Note | In RouterOS v5 this setting was called "use".  }}
==RouterBoard USB Port Limitations==
{{ 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.}}


==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.
|width="200px" style="background:#cccccc; border-bottom:1px solid gray;"  | RouterBOARD
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| USB ports
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| Power Reset
|width="100px" style="background:#cccccc; border-bottom:1px solid gray;"| USB powering
|-
|style="border-bottom:1px solid gray;" valign="top"|Cloud Core Router series
|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"|CRS109-8G-1S-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"|CRS125-24G-1S
|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 series
(excluding SXT Lite)
|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 G series
|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 mAP 2n
|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"|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"|RB2011UiAS
|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"|RB433UL
|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"|RB912UAG-2HPnD
|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"|RB912UAG-5HPnD
|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"|RB921UAGS/RB922UAGS series
|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"|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
|-
|style="border-bottom:1px solid gray;" valign="top"|RB951Ui-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"|RB953GS-5HnT
|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"|RB951Ui-2nD (hAP)
|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
|}


{{ Note | RouterOS does not support memory slot like SD for USB modems. Use USB hub with USB modem and USB flash instead!". }}
* 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 ([https://mikrotik.com/product/5VUSB 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 ([https://mikrotik.com/product/5VUSB USB power injector] is required)


* * 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 11: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.

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.