wimax

Purpose

For Digi devices equipped with a WiMAX radio, wimax performs various WiMAX network actions, including:

Connect to a WiMAX network.
Disconnect from a WiMAX network.
Set debug options for testing and diagnostics.
Display detailed WiMAX radio information.
Perform a wide-area scan, an over-the-air discovery of networks that are available for connections. The radio automatically scans for networks in the subscription list. A wide-area scan looks for all networks that might be available. The scan takes a few minutes. The results of either automatic or wide-area scan are shown under the network list by issuing a display wimax command.

Required permissions

For Digi products with two or more users, permissions must be set to set permissions s-wimax=rw to execute this command. See set permissions for details on setting user permissions for commands.

Syntax

Connect to a WiMAX network

First enter display wimax to get the subindex from the subscription displayed, and the napid from the network list. Then, enter:

wimax connect [[subindex [napid]]

Disconnect from a WiMAX network

wimax disconnect

Set debug options

wimax debug {dm|eap}

Display detailed WiMAX radio information

wimax info

Reset the WiMAX radio

wimax reset

Perform a wide-area scan

wimax scan

Options

subindex

Subscription index. A subscription is the service and user account with a network service provider (NSP). This value can be obtained from the output of the display wimax command, under the Subscription List Index heading. The subindex defaults to using the nspid and name set by the set wimax command.

napid

Network access provider ID. This value provides the actual network connection and is usually the same as the network service provider (NSP). The default behavior WiMAX and NAP IDs is to try all networks found by the scan. Using the napid option allows for choosing specific network.

debug {dm|eap}

Turns on various debugging functions. Debugging is normally used for testing and diagnostics, not by a user.

dm

Diagnostic monitor protocol. This option is used with external tools to control and monitor the radio.

eap

Extensible Authentication Protocol. This option enables EAP debugging. It writes debug information to two files: dec.log and pcap.pcap.

Examples

#> wimax info

Connection Information:
  Radio Status: Connected
  Connection Duration: 1 day + 05:50:35
  Disconnect Reason: N/A
  Subscription Name: Clear
  Network Type: Home
  NAP-ID: 000002
  RSSI: -76 dBm
  CINR: 9 dB
  Signal Quality: 2 of 5 bars

Network Information:
  IP Address: 184.78.91.72
  Gateway: 184.78.0.1
  Primary DNS: 66.233.235.12
  Secondary DNS: 75.94.255.12

Radio Information:
  Manufacturer: GCT Semiconductor, Inc.
  Model: Quanta WM553
  MAC Address: 00:17:C4:9C:53:F9
  SW Version: 1.10.1.2
  FW Version: 2.0.0.4
  HW Version: 0.0.7.0

Subscription List:
  INDEX  OPERATOR      NAME          NSP-ID  ACTIVATED
      1  Clear         Clear         000002  yes
      2  Clear         Sprint 4G     000002  yes
      3  Clear         Sprint PCS    000002  yes

Network List:
  NAME         TYPE     NAP-ID  RSSI  CINR
  Clear        Home     000002   -88     6

Neighbor List:
  BSID           FREQUENCY  PREAMBLE  RSSI  CINR
  000002:264FA2    2657000        40   -89     3
  000002:264FA3    2667000        72  -123   -10
  000002:2628FB    2551500        79   -89     6
  000002:264BE1    2647000        25  -123   -10
  000002:264BE2    2657000        57   -93    -1
  000002:264EEB    2667000        66  -123   -10
  000002:264F23    2667000        69  -123   -10
  000002:264F22    2647000        37   -85   -10

RF Information:
  BSID: 000002:2628FB
  UL PermBase: 8
  DL PermBase: 8
  Current preamble index: 8
  Previous preamble index: 0
  HO count: 0
  HO fail count: 0
  Resync count: 0
  HO signal latency: 89
  Combined CINR: 9 dB
  CINR: 6 dB
  CINR2: 6 dB
  Combined RSSI: -76 dBm
  RSSI: -79 dBm
  RSSI2: -79 dBm
  PER: 0.000161 [1/6211]
  Power control mode: 1
  TX power: 18 dBm
  TX power maximum: 23 dBm
  TX power headroom: 9 dBm
  UL burst data FEC scheme: QPSK (CTC) 3/4
  DL burst data FEC scheme: QPSK (CTC) 1/2
  UL burst data UIUC: 02
  DL burst data DIUC: 00
  Frequency: 2647000 KHz
  Power mode: Idle

Statistics:
  Session TX Bytes:  2046
  Session TX Frames: 13
  Session RX Bytes:  80729
  Session RX Frames: 1088
  Total TX Bytes:    2046
  Total TX Frames:   13
  Total RX Bytes:    80729
  Total RX Frames:   1088
  Connections: 1
  Connection Failed: 0
  Authentication Failed: 0
  User Requested: 0
  Network Disconnect: 0
  Radio Reset: 0