aboutsummaryrefslogtreecommitdiff
path: root/libwmc/src/protocol.h
diff options
context:
space:
mode:
authorDan Williams <dcbw@redhat.com>2019-04-02 11:17:21 -0500
committerDan Williams <dcbw@redhat.com>2019-04-02 11:20:11 -0500
commit1c14ca7262403ef6dc30319e3dc2aaa3ba47a225 (patch)
treef0274e750829c32609fe431e3b7916154bf31a05 /libwmc/src/protocol.h
parent88fac7f14a8898a7856a6868bbd94d4cf576723a (diff)
libwmc: remove it
The WMC protocol was only present on older Panasonic/Verizon devices from the 2006 - 2011 timeframe. The last device to support WMC was the UML290 which also supported QMI (which is much more functional). ModemManager also never used WMC support and it was never significantly reverse engineered. So remove WMC code from git; it'll still be in the history if anyone cares in the future.
Diffstat (limited to 'libwmc/src/protocol.h')
-rw-r--r--libwmc/src/protocol.h462
1 files changed, 0 insertions, 462 deletions
diff --git a/libwmc/src/protocol.h b/libwmc/src/protocol.h
deleted file mode 100644
index 483edbcd..00000000
--- a/libwmc/src/protocol.h
+++ /dev/null
@@ -1,462 +0,0 @@
-/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
-/*
- * Copyright (C) 2011 Red Hat, Inc.
- *
- * This program is free software: you can redistribute it and/or
- * modify it under the terms of version 2 of the GNU General Public
- * License as published by the Free Software Foundation
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#ifndef LIBWMC_PROTOCOL_H
-#define LIBWMC_PROTOCOL_H
-
-#define WMC_CMD_MARKER ((uint8_t) 0xC8)
-
-enum {
- WMC_CMD_GET_GLOBAL_MODE = 0x03,
- WMC_CMD_SET_GLOBAL_MODE = 0x04,
- WMC_CMD_DEVICE_INFO = 0x06,
- WMC_CMD_CONNECTION_INFO = 0x0A,
- WMC_CMD_NET_INFO = 0x0B,
- WMC_CMD_INIT = 0x0D,
- WMC_CMD_FIELD_TEST = 0x0F,
- WMC_CMD_SET_OPERATOR = 0x33,
- WMC_CMD_GET_FIRST_OPERATOR = 0x34,
- WMC_CMD_GET_NEXT_OPERATOR = 0x35,
- WMC_CMD_GET_APN = 0x4D,
-};
-
-/* MCC/MNC representation
- *
- * Various commands accept or return an MCC/MNC. When sending, convert
- * the MCC/MNC into a number using eg. atoi() and store it as an LE 32-bit
- * value. 3-digit MNCs appear to be sent as 3-digit only if the firmware
- * reports them as 3-digit. For example:
- *
- * T-Mobile US: 310-260
- * mcc_mnc = 0x00007932 = 31026 (note the 2-digit-only MNC)
- *
- * AT&T: 310-410
- * mcc_mnc = 0x0004bc8a = 310410
- */
-
-
-/* Generic WMC command header */
-struct WmcCmdHeader {
- uint8_t marker; /* Always 0xC8 */
- uint8_t cmd;
-} __attribute__ ((packed));
-typedef struct WmcCmdHeader WmcCmdHeader;
-
-/* Used on newer devices like the UML190 and later */
-struct WmcCmdInit2 {
- WmcCmdHeader hdr;
- uint16_t year;
- uint8_t month;
- uint16_t day; /* big endian */
- uint16_t hours; /* big endian */
- uint16_t minutes; /* big endian */
- uint16_t seconds; /* big endian */
- uint8_t _unknown1[3];
-} __attribute__ ((packed));
-typedef struct WmcCmdInit2 WmcCmdInit2;
-
-struct WmcCmdInit2Rsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1[4];
-} __attribute__ ((packed));
-typedef struct WmcCmdInit2Rsp WmcCmdInit2Rsp;
-
-struct WmcCmdDeviceInfoRsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1[27];
- char manf[64];
- char model[64];
- char fwrev[64];
- char hwrev[64];
- uint8_t _unknown2[64];
- uint8_t _unknown3[64];
- char min[10]; /* CDMA2000/IS-95 MIN */
- uint8_t _unknown4[12];
- uint16_t home_sid;
- uint8_t _unknown5[2];
- uint16_t prlver;
- uint8_t _unknown6[2];
- uint16_t eriver;
- uint8_t _unknown7[4];
-} __attribute__ ((packed));
-typedef struct WmcCmdDeviceInfoRsp WmcCmdDeviceInfoRsp;
-
-struct WmcCmdDeviceInfo2Rsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1[27];
- char manf[64];
- char model[64];
- char fwrev[64];
- char hwrev[64];
- uint8_t _unknown2[64];
- uint8_t _unknown3[64];
- uint8_t min[10]; /* CDMA2000/IS-95 MIN */
- uint8_t _unknown4[12];
- uint16_t home_sid;
- uint8_t _unknown5[2];
- uint16_t prlver;
- uint8_t _unknown6[2];
- uint16_t eriver;
- uint8_t _unknown7[4];
- uint8_t _unknown8[64];
- uint8_t meid[14];
- uint8_t _unknown10[6]; /* always zero */
- uint8_t imei[16];
- uint8_t _unknown11[6]; /* always zero */
- uint8_t _unknown12[16];
- uint8_t iccid[20];
- uint8_t _unknown13[6];
-} __attribute__ ((packed));
-typedef struct WmcCmdDeviceInfo2Rsp WmcCmdDeviceInfo2Rsp;
-
-struct WmcCmdDeviceInfo3Rsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1[27];
- char manf[64];
- char model[64];
- char fwrev[64];
- char hwrev[64];
- uint8_t _unknown2[64];
- uint8_t _unknown3[64];
- uint8_t min[10]; /* CDMA2000/IS-95 MIN */
- uint8_t _unknown4[12];
- uint16_t home_sid;
- uint8_t _unknown5[2];
- uint16_t prlver;
- uint8_t _unknown6[2];
- uint16_t eri_ver;
- uint8_t _unknown7[4];
- uint8_t _unknown8[64];
- uint8_t meid[14];
- uint8_t _unknown10[6]; /* always zero */
- uint8_t imei[16];
- uint8_t _unknown11[6]; /* always zero */
- uint8_t _unknown12[16];
- uint8_t iccid[20];
- uint8_t _unknown13[6];
- uint8_t mcc[16];
- uint8_t mnc[16];
- uint8_t _unknown14[4];
- uint8_t _unknown15[4];
- uint8_t _unknown16[4];
-} __attribute__ ((packed));
-typedef struct WmcCmdDeviceInfo3Rsp WmcCmdDeviceInfo3Rsp;
-
-/*****************************************************/
-
-enum {
- WMC_SERVICE_NONE = 0,
- WMC_SERVICE_AMPS = 1,
- WMC_SERVICE_IS95A = 2,
- WMC_SERVICE_IS95B = 3,
- WMC_SERVICE_GSM = 4,
- WMC_SERVICE_GPRS = 5,
- WMC_SERVICE_1XRTT = 6,
- WMC_SERVICE_EVDO_0 = 7,
- WMC_SERVICE_UMTS = 8,
- WMC_SERVICE_EVDO_A = 9,
- WMC_SERVICE_EDGE = 10,
- WMC_SERVICE_HSDPA = 11,
- WMC_SERVICE_HSUPA = 12,
- WMC_SERVICE_HSPA = 13,
- WMC_SERVICE_LTE = 14,
- WMC_SERVICE_EVDO_A_EHRPD = 15,
-};
-
-/* PC5740 response */
-struct WmcCmdNetworkInfoRsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1;
- uint8_t _unknown2[3]; /* Always zero */
- uint8_t service; /* One of WMC_SERVICE_* */
- uint8_t _unknown3; /* Either 0x00 or 0x01 */
- uint16_t ts_year;
- uint8_t ts_month;
- uint16_t ts_day; /* BE */
- uint16_t ts_hours; /* BE */
- uint16_t ts_minutes; /* BE */
- uint16_t ts_seconds; /* BE */
- uint16_t counter1; /* A timestamp/counter? */
- uint16_t _unknown4;
- uint8_t _unknown5[3]; /* Always 0xFE 0xFF 0xFF */
- uint8_t two_g_dbm; /* 0x7D = no signal */
- uint8_t _unknown6[37]; /* Always zero */
-} __attribute__ ((packed));
-typedef struct WmcCmdNetworkInfoRsp WmcCmdNetworkInfoRsp;
-
-/* UML190 response */
-struct WmcCmdNetworkInfo2Rsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1; /* 0x00 on LTE, 0x07 or 0x1F on CDMA */
- uint8_t _unknown2[3]; /* Always zero */
- uint8_t service; /* One of WMC_SERVICE_* */
- uint8_t _unknown3;
- uint16_t ts_year;
- uint8_t ts_month;
- uint16_t ts_day; /* BE */
- uint16_t ts_hours; /* BE */
- uint16_t ts_minutes; /* BE */
- uint16_t ts_seconds; /* BE */
- uint8_t _unknown4; /* always zero */
- uint16_t uptime_secs;
- uint8_t _unknown5;
- uint8_t _unknown6[3]; /* always zero on LTE, 0xFE 0xFF 0xFF on CDMA */
- uint8_t two_g_dbm; /* 0x7D = no CDMA signal, 0x6a = no GSM signal */
- uint8_t _unknown7[3]; /* Always zero */
- uint8_t cdma_opname[16]; /* Zero terminated? */
- uint8_t _unknown8[18]; /* Always zero */
- uint8_t three_g_dbm; /* 0x7D = no signal */
- uint8_t _unknown9[3]; /* Always zero */
- uint8_t _unknown10; /* 0x01 on LTE, 0x40 on CDMA */
- uint8_t _unknown11[3]; /* Always zero */
- uint8_t _unknown12; /* Always 0x01 */
- uint8_t tgpp_opname[8]; /* 3GPP operator name (Zero terminated? Sometimes "MCC MNC" too */
- uint8_t _unknown13[4]; /* Always zero */
- uint32_t _unknown14; /* 43 75 3a 00 on GSM/WCDMA mode, zero on others */
- uint32_t _unknown15; /* 49 7d 3a 00 on GSM/WCDMA mode, zero on others */
- uint8_t _unknown16[44]; /* Always zero */
- uint32_t mcc_mnc; /* GSM/WCDMA only, see MCC/MNC format note */
-} __attribute__ ((packed));
-typedef struct WmcCmdNetworkInfo2Rsp WmcCmdNetworkInfo2Rsp;
-
-/* UML290 response */
-struct WmcCmdNetworkInfo3Rsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1; /* 0x00 on LTE, 0x07 or 0x1F on CDMA */
- uint8_t _unknown2[3]; /* Always zero */
- uint8_t service; /* One of WMC_SERVICE_* */
- uint8_t _unknown3;
- uint16_t ts_year;
- uint8_t ts_month;
- uint16_t ts_day; /* BE */
- uint16_t ts_hours; /* BE */
- uint16_t ts_minutes; /* BE */
- uint16_t ts_seconds; /* BE */
- uint8_t _unknown4; /* always zero */
- uint16_t uptime_secs;
- uint8_t _unknown5;
- uint8_t _unknown6[3]; /* always zero on LTE, 0xFE 0xFF 0xFF on CDMA */
- uint8_t two_g_dbm; /* 0x7D = no CDMA signal, 0x6a = no GSM signal */
- uint8_t _unknown7[3]; /* Always zero */
- uint8_t cdma_opname[16]; /* Zero terminated? */
- uint8_t _unknown8[18]; /* Always zero */
- uint8_t three_g_dbm; /* 0x7D = no signal */
- uint8_t _unknown9[3]; /* Always zero */
- uint8_t _unknown10; /* 0x01 on LTE, 0x40 on CDMA */
- uint8_t _unknown11[3]; /* Always zero */
- uint8_t _unknown12; /* Always 0x01 */
- uint8_t tgpp_opname[8]; /* Zero terminated? Sometimes "MCC MNC" too */
- uint8_t _unknown13[4]; /* Always zero */
- uint32_t _unknown14; /* 43 75 3a 00 on GSM/WCDMA mode, zero on others */
- uint32_t _unknown15; /* 49 7d 3a 00 on GSM/WCDMA mode, zero on others */
- uint8_t _unknown16[44]; /* Always zero */
- uint32_t mcc_mnc; /* GSM/WCDMA only, see MCC/MNC format note */
- uint8_t lte_dbm; /* 0x00 if not in LTE mode */
- uint8_t _unknown17[3]; /* Always zero */
- uint8_t _unknown18[4];
-} __attribute__ ((packed));
-typedef struct WmcCmdNetworkInfo3Rsp WmcCmdNetworkInfo3Rsp;
-
-/*****************************************************/
-
-enum {
- WMC_CONNECTION_STATE_UNKNOWN = 0,
- WMC_CONNECTION_STATE_IDLE = 1,
- WMC_CONNECTION_STATE_CONNECTING = 2,
- WMC_CONNECTION_STATE_AUTHENTICATING = 3,
- WMC_CONNECTION_STATE_CONNECTED = 4,
- WMC_CONNECTION_STATE_DORMANT = 5,
- WMC_CONNECTION_STATE_UPDATING_NAM = 6,
- WMC_CONNECTION_STATE_UPDATING_PRL = 7,
- WMC_CONNECTION_STATE_DISCONNECTING = 8,
- WMC_CONNECTION_STATE_ERROR = 9,
- WMC_CONNECTION_STATE_UPDATING_UICC = 10,
- WMC_CONNECTION_STATE_UPDATING_PLMN = 11
-};
-
-/* Used on UML190 */
-struct WmcCmdConnectionInfoRsp {
- WmcCmdHeader hdr;
- uint32_t rx_bytes;
- uint32_t tx_bytes;
- uint8_t _unknown1[8];
- uint8_t state; /* One of WMC_CONNECTION_STATE_* */
- uint8_t _unknown2[3]; /* Always 0xc0 0x0b 0x00 */
-} __attribute__ ((packed));
-typedef struct WmcCmdConnectionInfoRsp WmcCmdConnectionInfoRsp;
-
-/* Used on UML290 */
-struct WmcCmdConnectionInfo2Rsp {
- WmcCmdHeader hdr;
- uint32_t rx_bytes;
- uint32_t tx_bytes;
- uint8_t _unknown1[8];
- uint8_t state; /* One of WMC_CONNECTION_STATE_* */
- uint8_t _unknown2[3]; /* Always 0xc0 0x0b 0x00 */
- uint8_t _unknown3[4]; /* Always 0x01 0x00 0x00 0x00 */
- uint8_t ip4_address[16]; /* String format, ie "10.156.45.3" */
- uint8_t _unknown4[8]; /* Netmask? */
- uint8_t ip6_address[40]; /* String format */
-} __attribute__ ((packed));
-typedef struct WmcCmdConnection2InfoRsp WmcCmdConnection2InfoRsp;
-
-/*****************************************************/
-
-enum {
- WMC_GLOBAL_MODE_AUTO_CDMA = 0x00,
- WMC_GLOBAL_MODE_CDMA_ONLY = 0x01,
- WMC_GLOBAL_MODE_EVDO_ONLY = 0x02,
- WMC_GLOBAL_MODE_AUTO_GSM = 0x0A,
- WMC_GLOBAL_MODE_GPRS_ONLY = 0x0B,
- WMC_GLOBAL_MODE_UMTS_ONLY = 0x0C,
- WMC_GLOBAL_MODE_AUTO = 0x14,
- WMC_GLOBAL_MODE_LTE_ONLY = 0x1E,
-};
-
-struct WmcCmdGetGlobalMode {
- WmcCmdHeader hdr;
- uint8_t _unknown1; /* always 0 */
-} __attribute__ ((packed));
-typedef struct WmcCmdGetGlobalMode WmcCmdGetGlobalMode;
-
-struct WmcCmdGetGlobalModeRsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1; /* always 0x01 */
- uint8_t mode; /* one of WMC_GLOBAL_MODE_* */
- uint8_t _unknown2; /* always 0x05 */
- uint8_t _unknown3; /* always 0x00 */
-} __attribute__ ((packed));
-typedef struct WmcCmdGetGlobalModeRsp WmcCmdGetGlobalModeRsp;
-
-/*****************************************************/
-
-struct WmcCmdSetGlobalMode {
- WmcCmdHeader hdr;
- uint8_t _unknown1; /* always 0x01 */
- uint8_t mode; /* one of WMC_GLOBAL_MODE_* */
- uint8_t _unknown2; /* always 0x05 */
- uint8_t _unknown3; /* always 0x00 */
-} __attribute__ ((packed));
-typedef struct WmcCmdSetGlobalMode WmcCmdSetGlobalMode;
-
-struct WmcCmdSetGlobalModeRsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1; /* always 0x01 */
- uint32_t _unknown2; /* always zero */
-} __attribute__ ((packed));
-typedef struct WmcCmdSetGlobalModeRsp WmcCmdSetGlobalModeRsp;
-
-/*****************************************************/
-
-struct WmcCmdSetOperator {
- WmcCmdHeader hdr;
- uint8_t automatic; /* 0x00 = manual, 0x01 = auto */
- uint8_t _unknown1; /* always 0x50 */
- uint8_t _unknown2[3]; /* always zero */
- uint32_t mcc_mnc; /* MCC/MNC for manual reg (see format note), zero for auto */
- uint8_t _unknown3[56]; /* always zero */
-} __attribute__ ((packed));
-typedef struct WmcCmdSetOperator WmcCmdSetOperator;
-
-enum {
- WMC_SET_OPERATOR_STATUS_OK = 0,
- WMC_SET_OPERATOR_STATUS_REGISTERING = 0x63,
- WMC_SET_OPERATOR_STATUS_FAILED = 0x68,
-};
-
-struct WmcCmdSetOperatorRsp {
- WmcCmdHeader hdr;
- uint8_t status; /* one of WMC_SET_OPERATOR_STATUS_* */
- uint8_t _unknown1[3]; /* always zero */
-} __attribute__ ((packed));
-typedef struct WmcCmdSetOperatorRsp WmcCmdSetOperatorRsp;
-
-/*****************************************************/
-
-enum {
- WMC_OPERATOR_SERVICE_UNKNOWN = 0,
- WMC_OPERATOR_SERVICE_GSM = 1,
- WMC_OPERATOR_SERVICE_UMTS = 2,
-};
-
-/* Response for both GET_FIRST_OPERATOR and GET_NEXT_OPERATOR */
-struct WmcCmdGetOperatorRsp {
- WmcCmdHeader hdr;
- uint8_t _unknown1; /* Usually 0x50, sometimes 0x00 */
- uint8_t _unknown2[3]; /* always zero */
- uint32_t mcc_mnc; /* see format note */
- uint8_t opname[8];
- uint8_t _unknown3[56]; /* always zero */
- uint8_t stat; /* follows 3GPP TS27.007 +COPS <stat> ? */
- uint8_t _unknown4[3]; /* always zero */
- uint8_t service; /* one of WMC_OPERATOR_SERVICE_* */
- uint8_t _unknown5[3]; /* always zero */
- uint8_t _unknown6; /* 0x63 (GET_FIRST_OP) might mean "wait" */
- uint8_t _unknown7; /* 0x00 or 0x01 */
- uint8_t _unknown8[2]; /* always zero */
-} __attribute__ ((packed));
-typedef struct WmcCmdGetOperatorRsp WmcCmdGetOperatorRsp;
-
-/*****************************************************/
-
-enum {
- WMC_FIELD_TEST_MOBILE_IP_MODE_MIP_OFF = 0,
- WMC_FIELD_TEST_MOBILE_IP_MODE_MIP_PREF = 1,
- WMC_FIELD_TEST_MOBILE_IP_MODE_MIP_ONLY = 2
-};
-
-/* Later devices return all zeros for this command */
-struct WmcCmdFieldTestRsp {
- WmcCmdHeader hdr;
- uint8_t prl_requirements;
- uint8_t eri_support;
- char nam_name[7];
- uint8_t _unknown1; /* always zero */
- uint8_t _unknown2[3]; /* always 0x0A 0x0A 0x0A */
- uint8_t _unknown3[5]; /* always zero */
- uint8_t _unknown4[10]; /* all 0x0F */
- uint16_t home_sid;
- uint16_t home_nid;
- char min1[7];
- char min2[3];
- char mcc[3];
- char imsi_s[10];
- char mnc[2];
- uint16_t primary_cdma_chan_a;
- uint16_t secondary_cdma_chan_a;
- uint16_t primary_cdma_chan_b;
- uint16_t secondary_cdma_chan_b;
- uint8_t accolc;
- char sw_version[64];
- char hw_version[64];
- uint16_t prlver;
- uint16_t eriver;
- uint16_t nid;
- uint8_t last_call_end_reason; /* ? */
- uint8_t rssi;
- uint16_t channel;
- uint8_t prev;
- uint16_t pn_offset;
- uint8_t sys_select_pref;
- uint8_t mip_pref;
- uint8_t hybrid_pref;
-} __attribute__ ((packed));
-typedef struct WmcCmdFieldTestRsp WmcCmdFieldTestRsp;
-
-/*****************************************************/
-
-#endif /* LIBWMC_PROTOCOL_H */