USB 4G LTE-Advanced Modem Router Configuration Documentation (TPE-USB4GLTE)

Using our USB 4G LTE-Advanced Modem with ThinkPenguin routers under libreCMC and similar embedded distributions
(last tested under libreCMC 1.4.9 and 1.5)

1. Connect an Ethernet cable from the router's LAN port to your computer (disconnect your computer from any wifi networks while your at it)
2. Power the router on
3. Open a browser and go to https://192.168.10.1 (the IP address for a router with a default ThinkPenguin configuration, also you will need to add a security exception to actually bring up the routers login page)
4. Login (either there is no default password or the password is the word "none" without the quotes)
5. If no password is set go to System > Administration and set a password, hit save to save the password
6. Set a router IP address for the router that won't conflict with that of your modem by going to Network > Interfaces and click the Edit button that is next to LAN
7. Under where it says IPv4 enter 192.168.8.1 and click Save & Apply. You will need to wait till it says "Configuration has been rolled back!" and click the Apply anyway button. Once you get a error message saying "Device unreachable!" you can power off the router.
8. From your PC's network applet disconnect and then reconnect to obtain a new IP address from the router

9. You will need to temporarily connect and ethernet cable from the WAN port to a modem or upstream router and then power on the mini router in order to install the packages needed to connect a USB 4G modem.

Open a web browser and go to https://192.168.8.1. You may see a message like "Warning: Potential Security Risk Ahead", but it's ok. Click Advanced > Accept the Risk and Continue. Then login to the router.

Then go to: System > Software

Click the Update lists... button ... (and Dismiss button when finished, assuming no errors)

In the "Download and install package:" box enter the following packages and hit OK button to install each. When prompted "Really attempt to install package-name?" click the install button. Click Dismiss button when finished and repeat for each package.

Packages you need to install (if you copy and paste make sure there are no spaces in front of the package name or you will get an error messaging indicating the package does not exist):

usb-modeswitch
kmod-usb-wdm
uqmi
kmod-usb-net-qmi-wwan
luci-proto-qmi

Packages you may want to install (if you plan to use OpenVPN with the USB cellular modem):

openvpn-openssl

Our modems ship by default in MBIM for out-of-the-box support in most major desktop GNU/Linux distributions. However embedded distributions for routers such as libreCMC and other forks are currently best supported when in QMI mode. These directions thus require the modem to be set in QMI mode.

Follow the directions in the links below for setting your modem/chip in QMI mode.

Switching Between QMI & MBIM Modes with a USB 4G-LTE Advanced Modem (/w a LT4120 chip, TPE-USB4GLTE)

Switching Between QMI & MBIM Modes with a USB 4G-LTE Advanced Modem (/w a EM7455 chip, TPE-USB4GLTE)

For the LT4120 model there is one additional step required to configure the modem to work with libreCMC. We need to set the modem to a particular configuration on top of having the modem in QMI mode.

Open a terminal and run the follow command (the password requested upon entering the following command is that in which you set to login to your router, and the IP of the router):

ssh root@192.168.8.1

Notes: For those unfamiliar with the vi text editor you'll need to know a few things to actually edit the usb-mode.json file which is required to have the modem come up in the right mode. Once you've scrolled down and found the devices section you need to hit the "a" key on your computer. This puts you into an editing mode. Then you can scroll down and add the lines as directed below. When done you need to save this file. To save hit the escape key on your keyboard, then hit the ":" key on your keyboard. This will let you enter commands into the vi text editor. Type out "wq!" to save and quit. Keep in mind this is all without the quotes. Type exit and hit the enter key, do it twice to exit the ssh session and close out of your terminal window.

Run the command:

vi /etc/usb-mode.json

Then use your keypad to scroll down to the "devices" : { section and find the line with the following device ID "03f0:9d1d".

Replace "config" with "bConfigurationValue" and 0 with 3 so it looks like this:

"03f0:9d1d": {
"*": {
"msg": [ ],
"bConfigurationValue": 3
}
},

11. Reboot the router
12. Go to https://192.168.8.1 in your browser, then log back into the router
13. Go to Network > Interfaces and click the Add new interface... button
14. Enter a name for the interface, example WWAN0
15. Under the Protocol of the new interface drop down menu select QMI Cellular and hit the Submit button
16. In the APN box enter your cellular providers APN info (see info for some providers in our other provider specific documentation)
17. In the PIN box enter the PIN (if your cellular provider requires it) provided by your cellular provider
18. Enter any other user name/password information your cellular provider requires
19. The Modem device box should have /dev/cdc-wdm0 in it or you should be able to select /dev/cdc-wdm0 if you have the USB modem plugged into a USB port on the router
20. Click the Save & Apply button
21. Under Network > Interfaces click the Delete button that is next to WAN for both the WANs that say "Protocol: DHCPv6 client" and "Protocol: DHCP client"
22. Click Save & Apply
23. Go to System > Reboot and click Perform Reboot button
24. Log back into the router at https://192.168.8.1 and under Network > Interfaces and click the Edit button next to WWAN0
25. Click the Firewall Settings tab
26. Create / Assign firewall-zone select wan: (empty) (it will become wwan0)
27. Click the Save & Apply button
28. Unplug your WAN to modem/upstream router ethernet cable and connect the USB 4G modem
29. Go to System > Reboot and click Perform Reboot button (don't forget to unplug your WAN to modem/upstream router ethernet cable)

You should now be able to access the internet via your router's USB connected cellular modem.

Troubleshooting notes:

You may need to power off the router and power it back on, but if the modem does not come back up then re-connect the modem, login to the router and go to Network > Interfaces and click the connect or restart button under where it says WWAN0

You may need to click on your computers network applet and disconnect/reconnect from the wired connection

If everything was working for you and things have stopped working you may need to unplug the modem, plug it back in, login to the router, and go to the Network > Interfaces tab and click reconnect / connect button (the cellular provider may have timed you out after so many hours)