PIN

Command: AT+CPIN?
Response: +CPIN: <code>
Description: Check PIN status.

<code> can have several values, these are the more common ones

READY

Not waiting for PIN (no PIN or PIN already entered)

SIM PIN

Waiting for SIM PIN code.

SIM PUK

Waiting for SIM PUK code.

Command: AT+CPIN=<pin>[,<newpin>]
Response: OK | +CME ERROR: <error>
Description: Enter/change PIN.

Example

>AT+CPIN?
+CPIN: SIM PIN
OK

>AT+CPIN=”1234″
OK

>AT+CPIN?
+CPIN: READY
OK

Network registration

Command: AT+CREG?, AT+CREG=? , AT+CREG=<n>
Response: +CREG: <n>,<stat>,[,<lac>,<ci>[,<AcT>]] | +CME ERROR
Description: Get network registration status and controls unsolicited status callback, which when turned on will send a +CREG message with the new network status when something changes.

<n>

0. Disable unsolicited status callback.
1. Enable unsolicited status callback, +CREG: <stat>
2. Enable unsolicited status callback, +CREG: <stat>,[,<lac>,<ci>[,<AcT>]]

<stat>

0. Not registered, not searching
1. Registered to home network
2. Not registered, searching for network
3. Registration denied
5. Registered, roaming

<lac> Location area code
<ci> UTRAN/GERAN cell ID

<AcT> Network access type

0. GSM
1. Compact GSM
2. UTRAN
3. GSM with EGPRS
4. UTRAN with HSDPA
5. UTRAN with HSUPA
6. UTRAN with HSDPA and HSUPA

UTRAN is a short for UMTS Terrestrial Radio Access Network

The following example shows that full unsolicited status callback is enabled, that the device is registered to its home network followed by an location area code followed by the UTRAN cell ID. Unfortunately this device does not show access type with this command.

Example:

>AT+CREG=2
OK
>AT+CREG?
+CREG: 2,1,”048A”,”58B2″

Command: AT+COPS?,
Response: +COPS: (<mode>,[<format>,<oper>[,<AcT>]]),…, (<modeN>,[<formatN>,<operN>[,<AcTN>]])

Command: AT+COPS=?
Response: +COPS: <stat>, long <oper>, short <oper>, numeric <oper>, <AcT>

Response: +CME ERROR:
Command: AT+COPS=<mode>,[<format>,<oper>[,<AcT>]]
Response: OK | +CME ERROR

Description: Get/set current GSM/UMTS network operator, list available operators. This can be used to change for example access type and switch network.

<mode>

0. Automatic network selection (<oper> ignored)
1. Manual network selection, <oper> must be present, <AcT> is optional.
2. Deregister from network.
3. Set <format only, no registration/deregistration.
4. Manual selection with automatic fall back (enters automatic mode if manual selection fails).

<format>

0. Long alphanumeric string
1. Short alphanumeric string
2. Numeric ID

<oper>
String (based on <format>) that identifies the operator.

<stat>

0. Unknown
1. Available
2. Current
3. Forbidden

<AcT> Network access type

0. GSM
1. Compact GSM
2. UTRAN
3. GSM with EGPRS
4. UTRAN with HSDPA
5. UTRAN with HSUPA
6. UTRAN with HSDPA and HSUPA

The following example shows that the devices is connected to the operator called “3″ using UTRAN (which is UMTS, also called 3G). Listing available networks shows the current network, an additional UTMS network called Sweden3G that is forbidden and a GSM network called “3″ that is available.

Example:

>AT+COPS?
+COPS: 0,0,”3″,2

AT+COPS=?
+COPS: (2,”3″,”3″,”24004″,2),(1,”3″,”3″,”24008″,0),(3,”Sweden 3G”,”Sweden3G”,”2)

Command: AT+COPN
Response: +COPN: <numeric1>,<alpha1>, …, +COPN: <numericN>,<alphaN>
Description: Read operator names stored in device memory.

Example:

+COPN: “20408″,”NL KPN”
+COPN: “20412″,”NL Telfort”
+COPN: “20416″,”T-Mobile NL”
+COPN: “20420″,”Orange NL”
…
+COPN: “24002″,”3 SE”
+COPN: “24004″,”SWEDEN”
+COPN: “24005″,”Sweden 3G”
+COPN: “24008″,”Telenor SE”
+COPN: “24010″,”S COMVIQ”

Define PDP (Packet Data Protocol) context

Command: AT+CGDCONT=<cid> [,<pdptype> [,<apn>[,<pdpaddr> [,<dcomp>[,<hcomp]]]]]
Response: OK | ERROR

Command: AT+CGDCONT?
Response: +CGDCONT: <cid1>,<pdptype1>,<apn1>,<pdpaddr1><dcomp1>,<hcomp1>, …, <cidN>,<pdptypeN>,<apnN>,<pdpaddrN><dcompN>

Command: AT+CGDCONT=?
Response: +CGDCONT: (<cid_range>),<pdptype>,,,(<dcomp_range>),(<hcomp_range>)
Description: Allows configuration of one or several packet data protocol context which forms the base of a data connection.

<cid> PDP context ID, minimum value is 1, maximum value depends on device and can be found with the =? command.

<pdptype> String parameter identifying the protocol type
IP – Internet Protocol
IPV6 – Internet Protocol, version 6
PPP – Point to Point Protocol

<apn> String that identifies the Access Point Name in the packet data network.

<pdpaddr> Requested address, if null (0.0.0.0) an address is requested dynamically.

<dcomp> PDP data compression control, off by default.

<hcomp> PDP header compression control, off by default.

Example:

> AT+CGDCONT=1,”IP”,”bredband.tre.se”
OK

>AT+CGDCONT?
+CGDCONT: 1,”IP”,”bredband.tre.se”,”0.0.0.0″,0,0

>AT+CGDCONT=?
+CGDCONT: (1-16),”IP”,,,(0-2),(0-4)
+CGDCONT: (1-16),”PPP”,,,(0-2),(0-4)
+CGDCONT: (1-16),”IPV6″,,,(0-2),(0-4)

PDP Authentication

Command: AT$QCPDPP=<cid>,<auth_type>,<auth_name>,<auth_pwd>
Response: OK | ERROR
Description: A Qualcomm command, defines authentication parameters for the PDP context id <cid>.

<auth_type>

0. None
1. PAP
2. CHAP

<auth_name> and <auth_pwd> are strings with the authentication information.

Signal quality

Command: AT+CSQ
Response: +CSQ: <rssi>,<ber>
Description: Returns signal quality.

<rssi> Received Signal Strength Indicator

0

-113 dBm or less

1

-111 dBm

2 to 30

-109 to -53 dBm

31

-51 dBm or greater

99

not known or not detectable

<ber> Bit Error Rate, in percent 0..7.
99 not known or not detectable

A note on the RSSI (received signal strength), dBm is a decibel (logarithmic) scale with a reference of 1 milliwatt thus 0 dBm equals a received signal of 1 mW.
Signal strength is usually lower than 1 mW and therefore below 0, so the larger (closer to 0) the better signal strength.
You can convert the RSSI to dBM with

Example

>AT+CSQ=?
+CSQ: (0-31,99),(99)
OK

>AT+CSQ
+CSQ: 14,99

Manufacturer/model/revision identification

Command: AT+GMI
Response: Manufacturer Identification string

Command: AT+GMM
Response: Model Identification string

Command: AT+GMR
Response: Revision Identification string

Example:

>AT+GMI
Option N.V.
OK

>AT+GMM
GTM378
OK

>AT+GMR
2.4.6Hd (Date: Oct 04 2007, Time: 11:59:08)

Option N.V. proprietary AT-style commands

Command: AT_OWANCALL=<pdp context>,<enabled>[,<callback enabled>]
Response: OK
Description: Used to initiate UMTS/HSDPA connections.

<pdp context> – Existing, valid, PDP context that specifies the intended APN to connect to.
<enabled> – 1 = Enable connection, 0 = Disable connection (disconnect)
<callback enabled> – 1 = Asynchronous callback when connection is established, 0 = silent

Example:

>AT_OWANCALL=1,1,1
OK
_OWANCALL: 1, 1

>AT_OWANCALL=1,0
OK
_OWANCALL: 1, 0

Command: AT_OWANDATA=<pdp context>
Response: _OWANDATA: <pdp context>, <ip address>, <route?>, <nameserver 1>, <nameserver 2>, <unknown>, <unknown>, <speed>
Description: Retrieve IP configuration from an established connection previously created with AT_OWANCALL

Example:

>AT_OWANDATA=1
_OWANDATA: 1, 79.138.181.171, 0.0.0.0, 80.251.192.244, 80.251.192.245, 0.0.0.0, 0.0.0.0, 72000

References

3GPP TS 27.007 V8.3.0 (2008-03) – AT command set for User Equipment (UE)
Specification details at 3gpp.org

]]> http://www.shapeshifter.se/2008/04/30/list-of-at-commands/feed/ 53 http://www.shapeshifter.se/2008/04/22/first-release-of-freebsd-driver-for-option-hsdpa-devices/ http://www.shapeshifter.se/2008/04/22/first-release-of-freebsd-driver-for-option-hsdpa-devices/#comments Tue, 22 Apr 2008 21:12:00 +0000 fli http://www.shapeshifter.se/?p=48 I’ve published the first public beta of my FreeBSD driver for Option HSDPA modems. The driver is still beta but have been successfully tested (and used) with a Option GlobeSurfer iCON 7.2 S device (using a Turbo 3G account from Tre/Hi3G Access Sweden).

The driver is available for download together with instructions at the hso page. Please report successes and failures.

]]> http://www.shapeshifter.se/2008/04/22/first-release-of-freebsd-driver-for-option-hsdpa-devices/feed/ 10 http://www.shapeshifter.se/2008/04/16/mode-switching-of-option-hsdpa-cards/ http://www.shapeshifter.se/2008/04/16/mode-switching-of-option-hsdpa-cards/#comments Wed, 16 Apr 2008 19:45:50 +0000 fli http://www.shapeshifter.se/?p=44 The newer WWAN (HSDPA/UMTS/3G/whatever) USB devices from Option does not come bundled with CD that carries the drivers, instead they are accessible from a mass storage device, this is marketed as by Option as “ZeroCD”. This also means that the device needs to be “switched” from the storage device to the modem/network interface before it’s usable.

There is a utility called usb_modeswitch based around libusb that allows one to switch both Option devices as well as Huwei devices. Unfortunately Option devices require a write to a bulk endpoint to a device that already is attached to a driver (umass), this is not possible with libusb in FreeBSD (it only allows such things on ugen devices). It’s possible to work around this by unloading umass, attaching the device, and then do the switching. This is quite annoying, especially if one needs to use any kind of umass devices at the same time.

The magic byte sequence usb_modeswitch is sending to the device is actually a SCSI REZERO (0×01) command (quite suitable for the name ZeroCD ). Sending such command is possible with the standard camcontrol utility.

> camcontrol devlist
<Optiarc DVD RW AD-7173A 1-01>     at scbus3 target 0 lun 0 (cd0,pass0)
<ZCOPTION HSDPA Modem 3.00>        at scbus8 target 0 lun 0 (pass1,cd1)

The WWAN device is at cd1 (ZCOPTION, ZeroCd Option)

> camcontrol cmd cd1 -c "01 00 00 00 00 00" -i 1 i1
camcontrol: error sending command

Even though camcontrol reports an error the device is switched properly. I don’t know why it reports an error, but my best guess is that the device “switches” instantaneously and the response gets lost.

umass0: <Option N.V. Globetrotter HSDPA Modem, class 0/0, rev 1.10/0.00,
addr 2> on uhub0
cd1 at umass-sim0 bus 0 target 0 lun 0
cd1: <ZCOPTION HSDPA Modem 3.00> Removable CD-ROM SCSI-2 device
cd1: 1.000MB/s transfers
cd1: Attempt to query device size failed: NOT READY, Medium not present
umass0: BBB reset failed, STALLED
umass0: BBB bulk-in clear stall failed, STALLED
umass0: BBB bulk-out clear stall failed, STALLED
umass0: at uhub0 port 1 (addr 2) disconnected
(cd1:umass-sim0:0:0:0): lost device
(cd1:umass-sim0:0:0:0): removing device entry
umass0: detached
ugen0: <Option N.V. Globetrotter HSDPA Modem, class 255/255, rev 1.10/0.00,
addr 2> on uhub0

Glue for devd

To get automatic switching, put the following in a file called option.conf and place it in /etc/devd/ (create the directory if it doesn’t exists). Replace product with the correct value for your device, usbdevs -v should report it.

attach 100 {
    match "device-name" "umass[0-9]+";
    match "vendor"  "0x0af0";
    match "product" "0x6911";
    match "devclass" "0x00";
    action "sleep 1; /sbin/camcontrol cmd 
`/sbin/camcontrol devlist | /usr/bin/grep ZCOPTION | 
/usr/bin/awk '{match($11, /pass[0-9]+/); print substr($11, RSTART, RLENGTH) }'`
-c '01 00 00 00 00 00' -i 1 i1 > /dev/null";
};

Restart devd with /etc/rc.d/devd restart

]]> http://www.shapeshifter.se/2008/04/16/mode-switching-of-option-hsdpa-cards/feed/ 0