| Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision |
| docs:guide-user:network:wan:wwan:ltedongle [2024/11/04 12:38] – [MBIM Protocol support] andrewz | docs:guide-user:network:wan:wwan:ltedongle [2024/11/27 18:05] – [LTE or 5G Modem Preparation] andrewz |
|---|
| |
| Replace ''IP'' with ''IPV4V6'' or ''IPV6'' if necessary and use your APN instead of ''internet''. | Replace ''IP'' with ''IPV4V6'' or ''IPV6'' if necessary and use your APN instead of ''internet''. |
| | |
| | For an alternative method, see [[:docs:guide-user:network:wan:wwan:ltedongle]] section below. |
| |
| \\ | \\ |
| A //terminal// program like ''picocom'' will be needed to actually send AT commands. | A //terminal// program like ''picocom'' will be needed to actually send AT commands. |
| |
| 3. Install [[:packages:pkgdata:usb-modeswitch]] package only __if__ that is needed for switching the modem into a "working" state. More about: [[docs:guide-user:network:wan:wwan:usb-modeswitching|USB mode switch]] | 3. Install [[:packages:pkgdata:usb-modeswitch]] package __only if__ that is needed for switching the modem into a "working" state. More about: [[docs:guide-user:network:wan:wwan:usb-modeswitching|USB mode switch]] |
| |
| 4. Add support for the //storage// of your modem - refer to: [[docs:guide-user:storage:usb-drives|USB Storage]] | 4. Add support for the //storage// of your modem - refer to: [[docs:guide-user:storage:usb-drives|USB Storage]] |
| |
| ===== Sample installation ===== | ===== Sample installation ===== |
| 1. Install all the needed packages: | 1. Install all the needed packages either in Luci → System → Software or via command line: |
| * if the modem is in QMI mode: | * if the modem is in QMI mode: |
| <code> | <code> |
| root@OpenWrt:~# opkg install kmod-usb-net-cdc-mbim umbim luci-proto-mbim kmod-usb-serial-option picocom | root@OpenWrt:~# opkg install kmod-usb-net-cdc-mbim umbim luci-proto-mbim kmod-usb-serial-option picocom |
| </code> | </code> |
| | |
| | You can also add the necessary packages when building a new image with [[https://firmware-selector.openwrt.org/|Firmware Selector]]. |
| |
| :!: If your have not enough space on your device - think about upgrading your hardware or installing [[docs:guide-user:additional-software:extroot_configuration|Rootfs on External Storage (extroot)]]. Refer to your router wiki page or forum thread for possibility and instructions. | :!: If your have not enough space on your device - think about upgrading your hardware or installing [[docs:guide-user:additional-software:extroot_configuration|Rootfs on External Storage (extroot)]]. Refer to your router wiki page or forum thread for possibility and instructions. |
| |
| Enter your ''APN'' and select the ''IP type'' as instructed by the carrier, __don't set ''IP type'' to ''IPV4V6'' until you're 100% sure that provider supports IPv6__, that is critical in QMI mode. | Enter your ''APN'' and select the ''IP type'' as instructed by the carrier, __don't set ''IP type'' to ''IPV4V6'' until you're 100% sure that provider supports IPv6__, that is critical in QMI mode. |
| | |
| | Note: in IPv6-only mode it is recommended to enable ''dhcpv6'' option on in order to automatically start the 464XLAT interface (that requires [[:packages:pkgdata:464xlat]] package). |
| |
| Assign the firewall zone (wan) on 'Firewall Settings' tab. | Assign the firewall zone (wan) on 'Firewall Settings' tab. |
| | **allow_partner** | boolean | no | 0 | Allow connection if the modem is registered to a partner network | | | **allow_partner** | boolean | no | 0 | Allow connection if the modem is registered to a partner network | |
| | **mtu** | number | no | (none) | Interface MTU size | | | **mtu** | number | no | (none) | Interface MTU size | |
| |
| Note: in IPv6-only mode it is recommended setting ''dhcpv6'' option on in order to automatically start the 464XLAT interface (that requires [[:packages:pkgdata:464xlat]] package). | |
| |
| Here is a brief help about ''umbim'' command line: | Here is a brief help about ''umbim'' command line: |
| ''uqmi'' tool can talk to MBIM modems using ''--mbim'' or ''-m'' option on the command line. | ''uqmi'' tool can talk to MBIM modems using ''--mbim'' or ''-m'' option on the command line. |
| ==== Manual validation ===== | ==== Manual validation ===== |
| First check that everything works correctly: | Check the currently configured APN: |
| <code> | <code> |
| root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --get-data-status | root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --get-profile-settings 3gpp,1 |
| "disconnected" | { |
| | "apn": "internet", |
| | "pdp-type": "ipv4v6", |
| | "username": "", |
| | "password": "", |
| | "auth": "none", |
| | "no-roaming": false, |
| | "apn-disabled": false |
| | } |
| | </code> |
| | |
| | Change the APN and/or IP type (an alternative method to using AT commands mentioned above): |
| | <code> |
| | root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --set-device-operating-mode low_power |
| | root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --modify-profile 3gpp,1 --apn internet --pdp-type=ipv4 --username="" --password="" --auth=none |
| | root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --set-device-operating-mode online |
| | </code> |
| | where "internet" is the APN of your provider |
| | |
| | Check network registration and signal strength: |
| | <code> |
| | root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --get-serving-system |
| | { |
| | "registration": "registered", |
| | "plmn_mcc": 123, |
| | "plmn_mnc": 45, |
| | "plmn_description": "OperatorName", |
| | "roaming": false |
| | } |
| </code> | </code> |
| and | and |
| } | } |
| </code> | </code> |
| | |
| | Check the connection status: |
| | <code> |
| | root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --get-data-status |
| | "disconnected" |
| | </code> |
| | |
| To manually start the Internet connection issue a command: | To manually start the Internet connection issue a command: |
| <code> | <code> |
| root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --start-network internet --autoconnect | root@OpenWrt:~# uqmi -d /dev/cdc-wdm0 --start-network internet --autoconnect |
| </code> | </code> |
| Where "internet" is the APN of your provider. | where "internet" is the APN of your provider |
| |
| :!: Some providers will accept almost any APN, in this case using "internet" is fine. | :!: Some providers will accept almost any APN, in this case using "internet" is fine. |