Category:FireBrick USB Dongles: Difference between revisions

=== Configuration and testing ===

When you plug a usb dongle into the Firebrick, to test if it is working you can use the CLI ‘<code>show dongle</code>’ command in a [https://en.wikipedia.org/wiki/Telnet Telnet] session. However, unfortunately this command fails to detect the dongle if <usb> and <dongle> elements have not been added to the XML configuration file. You can at first just add the following to the XML by using the web UI of the Firebrick, under Config >&nbsp;XML Edit:

<usb>

<dongle name="AA" />

</usb>

If you prefer not edit the XML, then you can make the change by using the web UI commands Config >&nbsp;Edit choose ‘Interface’ and then ‘USB and 3G/dongle settings’. Drill down until you see whole lot of options in a number of ‘3G/dongle config settings’ fields. Set the option fields appropriately, at a minimum fill in the ‘Name’ field, and then hit ‘Save’. This will add the <code><usb></code> and <code><dongle></code> elements for you in the XML configuration.

Following the application of either of these two alternative methods, the CLI ‘<code>show dongle</code>’ command will now work and will detect the presence of the dongle. You will need to fit an appropriate SIM into the dongle. The result will be something like the following:

With no SIM:

> show dongle

Attached USB devices

--------------------

Socket Vendor Product Name Functions

1 12d1 1003/1003 AA 3G(AT-ppp)

You do not have any 3G/ppp sessions

You do not have any 4G/eth sessions

And with a 3G SIM installed:

> show dongle

Attached USB devices

--------------------

Socket Vendor Product Name Functions

1 12d1 1003/1003 Dongle-AA Memory-stick 3G(AT-ppp)

3G/PPP Dongle Sessions

----------------------

Socket T Name MTU Status

1 0 Dongle-AA 1440 Up tcp-fix

You do not have any 4G/eth sessions