VintageNetQMI View Source

Hex version API docs CircleCI Coverage Status

This library provides a VintageNet technology for cellular modems that support the Qualcomm MSM Interface. This includes most USB cellular modems. See VintageNetMobile if you have a modem that only supports an AT command interface.

To use this library, first add it to your project's dependency list:

def deps do
  [
    {:vintage_net_qmi, "~> 0.2.10"}
  ]
end

You will then need to configure VintageNet. The easiest way to configure a modem at runtime is by calling VintageNetQMI.quick_configure("the_apn"). For example:

iex> VintageNetQMI.quick_configure("the_apn")
:ok
# wait...
iex> VintageNet.info
Interface wwan0
  Type: VintageNetQMI
  Power: On (watchdog timeout in 51628 ms)
  Present: true
  State: :configured (0:41:09)
  Connection: :internet (0:40:28)
  Addresses: 100.79.205.206/30, fe80::723c:bdc9:10e4:d092/64
  Configuration:
    %{
      type: VintageNetQMI,
      vintage_net_qmi: %{service_providers: [%{apn: "the_apn"}]}
    }

You can't always call quick_configure/1 convenience function so here's the regular configuration. If you are moving code from vintage_net_mobile, you'll notice that this format is very similar except that Mobile is now QMI.

VintageNet.configure("wwan0", %{
      type: VintageNetQMI,
      vintage_net_qmi: %{
        service_providers: [%{apn: "the_apn"}]
      }
    })

The :service_providers key should be set to information provided by each of your service providers. It is common that this is a list of one item. Currently only one service provider is supported, so replace "fill_in" with the APN that they gave you.

VintageNet Properties

In addition to the common vintage_net properties for all interface types, this technology the following:

PropertyValuesDescription
signal_asu0-31,99Reported Arbitrary Strength Unit (ASU)
signal_4bars0-4The signal level in "bars"
signal_dbm-144 - -44The signal level in dBm. Interpretation depends on the connection technology.
mcc0-999Mobile Country Code for the network
mnc0-999Mobile Network Code for the network
iccidstringThe Integrated Circuit Card Identifier (ICCID)
esnstringThe Electronic Serial Number (ESN)
imeistringInternational Mobile Equipment Identity (IMEI)
meidstringThe Mobile Equipment Identifier (MEID)
imeisv_svnstringIMEI software version number
providerstringThe name of the service provider
lac0-65533The Location Area Code (lac) for the current cell
cid0-268435455The Cell ID (cid) for the current cell
network_datetimeNaiveDateTime.t()The reported datetime from the network
utc_offsetCalendar.utc_offset()The UTC offset in seconds
roamingboolean()If the network is roaming or not
std_offsetCalendar.std_offset()The standard offset in seconds
statisticsmapTransmit and receive statistics (see below for details)
access_technologyatomThe technology currently in use to connect to the network
bandstringThe frequency band in use
channelintegerAn integer that indicates the channel that's in use

The following properties are TBD:

PropertyValuesDescription
imsistringThe International Mobile Subscriber Identity (IMSI)

Transmit and receive statistics

The statistics value is a map with the fields:

  • :timestamp - the monotonic time for when these stats where last updated
  • :tx_bytes - total bytes transmitted
  • :rx_bytes - total bytes received
  • :tx_packets - total packets transmitted without error
  • :rx_packets - total packets received without error
  • :tx_errors - total outgoing packets with framing errors
  • :rx_errors - total incoming packets with framing errors
  • :tx_overflows - total outing packets dropped due to buffer overflows
  • :rx_overflows - total incoming packets dropped due to buffer overflows
  • :tx_drops - total outgoing packets dropped
  • :rx_drops - total incoming packets dropped

Types of radio access technologies

  • :amps - Advanced Mobile Phone System (legacy)
  • :gsm - Global System for Mobile Communication (3G & 2G)
  • :umts - Universal Mobile Telecommunications System (3G)
  • :lte - Long-Term Evolution (4G)
  • :cdma_1x - CDMA2000 1X (3G & 2G)
  • :cdma_1x_evdo - CDMA2000 1xEV-DO (3G & 2G)

If you migrating from VintageNetMobile you will need to update any code that uses this property to handle the above list of atoms.

System requirements

These requirements are believed to be the minimum needed to be added to the official Nerves systems.

Linux kernel

Enable QMI and drivers for your modem:

CONFIG_USB_NET_CDC_NCM=m
CONFIG_USB_NET_HUAWEI_CDC_NCM=m
CONFIG_USB_NET_QMI_WWAN=m
CONFIG_USB_SERIAL_OPTION=m