Differences

This shows you the differences between two versions of the page.

Link to this comparison view

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] andrewzdocs:guide-user:network:wan:wwan:ltedongle [2024/11/27 18:05] – [LTE or 5G Modem Preparation] andrewz
Line 52: Line 52:
  
 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.
  
 \\ \\
Line 77: Line 79:
 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>
Line 93: Line 95:
 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.
Line 154: Line 158:
  
 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.
Line 344: Line 350:
 | **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:
Line 360: Line 364:
 ''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
Line 376: Line 408:
 } }
 </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.
  • Last modified: 2024/12/19 20:23
  • by andrewz