1679 | | Commonly used Modules known to work on Gateworks products: |
1680 | | * MC8790/MC8790V UTMS/HSPA and quad-band GSM/GPRS/EDGE modem |
1681 | | * MC5728/MC5728V CDMA modem |
1682 | | * MC7700/MC77xx LTE/HSPA+ Gobi API modem with GPS |
1683 | | * MC8090/ HSPA+ and quad-band GSM/GPRS/EDGE modem |
1684 | | |
1685 | | '''General Notes:''' |
1686 | | * The 'V' version of the modules (ie MC8790V and MC5728V) support external audio in/out signals and interfaces (Handset/Headset/Car kit/Speakerphone/AUX/TTY) that the non-V modules do not. |
1687 | | * The 'V' version of the modules (ie MC8790V and MC5728V) use pin22 for an auxiliary voltage that must be between 0 and 2.6V. Pin22 however in the Mini-PCIe standard is PERST# (PCI reset) and thus depending on the board and socket will likely be driven or pulled up to 3.3V which will cause issues with these '-V' devices. See [#vaux1 below] |
1688 | | * The LED output (pin 42) indicates the module state according to the PCI-Express Mini Card specification: |
1689 | | * Off - module not powered |
1690 | | * On - module powered and connected but not transmitting or receiving |
1691 | | * slow blink - module powered and searching for a connection (250ms on at 0.2Hz) |
1692 | | * fast blink - module is transmitting or receiving (3Hz blink rate) |
1693 | | |
1694 | | The MC77xx Family provides: |
1695 | | * LTE,HSPA+,GSM/GPRS/EDGE,EV-DO Rev A (MC7750), 1xRTT (MC7750) |
1696 | | * 100mbps peak download rate |
1697 | | * 50mbps peek upload rate |
1698 | | * LTE: |
1699 | | * MC7700: 2100(B1), AWS(B4), 700(B17) |
1700 | | * MC7710: 2100(B1), 1800(B3), 2600(B7), 900(B8), 800(B20) |
1701 | | * MC7750: 700(B13) |
1702 | | * WCDMA: |
1703 | | * MC7700: 2100(B1), 1900(B2), 850(B5) |
1704 | | * MC7710: 2100(B1), 900(B8) |
1705 | | * CDMA 1xRTT/EV-DO Rev A: |
1706 | | * MC7750: 800(BC0), 1900(BC1) |
1707 | | * GSP/GPRS/EDGE: |
1708 | | * quad-band |
1709 | | * Refer to Sierra Wireless AirPrime MC Series documentation for more details |
1710 | | |
1711 | | |
1712 | | [=#mc8790] |
1713 | | ==== MC8790 / MC8790V ==== |
1714 | | Driver: |
1715 | | * sierra - USB_SERIAL_SIERRAWIRELESS |
1716 | | * OpenWrt package support: kmod-usb-sierra |
1717 | | * exposes 7 serial devices: |
1718 | | * {{{/dev/ttyUSB0}}} |
1719 | | * {{{/dev/ttyUSB1}}} |
1720 | | * {{{/dev/ttyUSB2}}} |
1721 | | * {{{/dev/ttyUSB3}}} - control/data |
1722 | | * {{{/dev/ttyUSB4}}} - control/data |
1723 | | * {{{/dev/ttyUSB5}}} - control/data |
1724 | | * {{{/dev/ttyUSB6}}} - control/data |
1725 | | * {{{/dev/ttyUSB7}}} |
1726 | | |
1727 | | Notes: |
1728 | | * power mode - The MC8970/MC8970V has a power-mode setting to put the card in 'low-power' (aka 'airplane') mode where the module is active but RF is disabled. These cards seem to ship configured for 'airplane' mode (CFUN=0). The setting is persistent and must be set via the AT+CFUN command at least once: |
1729 | | {{{#!bash |
1730 | | AT+CFUN? |
1731 | | +CFUN: 0 |
1732 | | |
1733 | | OK |
1734 | | AT+CFUN=1 |
1735 | | OK |
1736 | | }}} |
1737 | | * CFUN=0 is low power mode or 'airplane' mode where RF is disabled |
1738 | | * CFUN=1 is full power mode |
1739 | | * if {{{gcom -d /dev/ttyUSB3 info}}} reports 'Network locked: 1' then your module is locked to a network carrier's specific plan and can only be used with a SIM for that network carriers plan. Take care to use the right SIM plan or to purchase an unlocked or 'generic' module. |
1740 | | |
1741 | | * OpenWrt Sample Config: |
1742 | | {{{#!bash |
1743 | | config interface 'wan' |
1744 | | option proto '3g' |
1745 | | option apn 'internet' |
1746 | | option device '/dev/ttyUSB3' |
1747 | | option service 'utms' |
1748 | | }}} |
1749 | | |
1750 | | |
1751 | | [=#mc8090] |
1752 | | ==== MC8090 ==== |
1753 | | Driver: |
1754 | | * sierra - USB_SERIAL_SIERRAWIRELESS |
1755 | | * OpenWrt package support: kmod-usb-sierra |
1756 | | * exposes 6 serial devices: |
1757 | | * {{{/dev/ttyUSB0}}} |
1758 | | * {{{/dev/ttyUSB1}}} |
1759 | | * {{{/dev/ttyUSB2}}} |
1760 | | * {{{/dev/ttyUSB3}}} |
1761 | | * {{{/dev/ttyUSB4}}} - data (ppp) |
1762 | | * {{{/dev/ttyUSB5}}} - control (AT commands) |
1763 | | |
1764 | | |
1765 | | [=#mc7700] |
1766 | | ==== MC7700 / MC7710 ==== |
1767 | | AirPrime 3G/4G/LTE wireless module |
1768 | | |
1769 | | Carrier: |
1770 | | * MC7700 (US) |
1771 | | * AT&T |
1772 | | * NTT Docomo |
1773 | | * Bell |
1774 | | * Tellus |
1775 | | * Roger |
1776 | | * MC7710: |
1777 | | * T-Mobile |
1778 | | |
1779 | | Driver: |
1780 | | * sierra - USB_SERIAL_SIERRAWIRELESS |
1781 | | * OpenWrt package support: kmod-usb-sierra |
1782 | | * exposes 5 serial devices: |
1783 | | * {{{/dev/ttyUSB0}}} |
1784 | | * {{{/dev/ttyUSB1}}} |
1785 | | * {{{/dev/ttyUSB2}}} |
1786 | | * {{{/dev/ttyUSB3}}} - control (AT commands) |
1787 | | * {{{/dev/ttyUSB4}}} - control/data |
1788 | | |
1789 | | Known USB IDs: |
1790 | | * 1199:68a3 (Shows up as MC8700 Modem in {{{lsusb}}}, but this is an error in the usb id file and does not relate to drivers) |
1791 | | |
1792 | | References: |
1793 | | * [http://www.sierrawireless.com/en/productsandservices/AirPrime_Wireless_Modules/Essential_Modules/MC_Series.aspx Product Brief] |
1794 | | * [http://www.sierrawireless.com/en/productsandservices/AirPrime_Wireless_Modules/Essential_Modules/~/media/Data%20Sheet/AirPrime_datasheets/Sierra_Wireless_AirPrime_MC_Series_Intelligent_Embedded_Modules.ashx Datasheet] |
1795 | | |
1796 | | |
1797 | | [=#mc7750] |
1798 | | ==== MC7750 ==== |
1799 | | !AirPrime 3G/4G/LTE wireless module |
1800 | | |
1801 | | Carrier: |
1802 | | * MC7750 (US) |
1803 | | * Verizon |
1804 | | |
1805 | | Bands: |
1806 | | * LTE: 700MHz(B13) |
1807 | | * CDMA 1xRTT/EV-DO Rev A: 800MHz(BC0), 1900MHz(BC1) |
1808 | | |
1809 | | This card uses the QMI protocol (Qualcomm MSM Interface) for modem/connection - see [#uqmipackage uqmi] |
1810 | | |
1811 | | Drivers: |
1812 | | * qcserial (CONFIG_USB_SERIAL_QUALCOMM) exposes serial interfaces: |
1813 | | * {{{/dev/ttyUSB0}}} - management |
1814 | | * {{{/dev/ttyUSB1}}} - GPS (NMEA) |
1815 | | * {{{/dev/ttyUSB2}}} - modem |
1816 | | * qmi_wwan (USB_NET_QMI_WWAN) exposes network interface and QMI interface: |
1817 | | * {{{/dev/cdc-wdm0}}} - QMI - use with libqmi |
1818 | | * {{{/sys/class/net/wwan0}}} |
1819 | | |
1820 | | GPS: |
1821 | | * To enable NMEA messages on {{{/dev/ttyUSB1}}}: |
1822 | | {{{#!bash |
1823 | | stty raw -F /dev/ttyUSB1; echo \$GPS_START >/dev/ttyUSB1 |
1824 | | }}} |
1825 | | * To disable NMEA messages on {{{/dev/ttyUSB1}}}: |
1826 | | {{{#!bash |
1827 | | stty raw -F /dev/ttyUSB1; echo \$GPS_STOP >/dev/ttyUSB1 |
1828 | | }}} |
1829 | | |
1830 | | References: |
1831 | | * [http://www.sierrawireless.com/en/productsandservices/AirPrime_Wireless_Modules/Essential_Modules/MC_Series.aspx Product Brief] |
1832 | | * [http://www.sierrawireless.com/en/productsandservices/AirPrime_Wireless_Modules/Essential_Modules/~/media/Data%20Sheet/AirPrime_datasheets/Sierra_Wireless_AirPrime_MC_Series_Intelligent_Embedded_Modules.ashx Datasheet] |
1833 | | |
1834 | | |
1835 | | [=#mc7354] |
1836 | | ==== MC7354 ==== |
1837 | | !AirPrime 3G/4G/LTE wireless module - One design for global markets - Multi-carrier support |
1838 | | |
1839 | | Details: |
1840 | | * LTE,HSPA+,GSM/GPRS/EDGE,EV-DO Rev A, 1xRTT |
1841 | | * 100mbps peak download rate |
1842 | | * 50mbps peak upload rate |
1843 | | * USB 2.0 High Speed |
1844 | | * -40C to +85C |
1845 | | |
1846 | | Carriers: |
1847 | | * Verizon (CDMA/LTE) |
1848 | | * AT&T (UMTS) |
1849 | | * Sprint |
1850 | | |
1851 | | Bands: |
1852 | | * LTE: 1900(B2), AWS(B4), 850(B5), 700(B13), 700(B17), 1900(B25) |
1853 | | * WCDMA: 2100(B1), 1900(B2), AWS(B4), 850(B5), 900(B8) |
1854 | | * CDMA 1xRTT/EV-DO Rev A: 800MHz(BC0), 1900MHz(BC1), 1700(BC10) |
1855 | | * GSM/GPRS/EDGE: Quad-Band |
1856 | | |
1857 | | This modem uses the QMI protocol (Qualcomm MSM Interface) for modem/connection: |
1858 | | * see [wiki:wireless/modem#uqmi uqmi] for OpenWrt |
1859 | | * see [wiki:wireless/modem#libqmi libqmi] for Ubuntu |
1860 | | |
1861 | | This modem has been found to work well for: |
1862 | | * Ubuntu: Verizon/ATT/Fi |
1863 | | * LEDE/OpenWrt 16.02: Verizon/ATT/Fi |
1864 | | |
1865 | | Drivers: |
1866 | | * qcserial (CONFIG_USB_SERIAL_QUALCOMM) exposes serial interfaces: |
1867 | | * {{{/dev/ttyUSB0}}} - management (QMI) |
1868 | | * {{{/dev/ttyUSB1}}} - GPS (NMEA) |
1869 | | * {{{/dev/ttyUSB2}}} - modem data |
1870 | | * qmi_wwan (USB_NET_QMI_WWAN) exposes network interface and QMI interface: |
1871 | | * {{{/dev/cdc-wdm0}}} - control (QMI) |
1872 | | * {{{/dev/cdc-wdm1}}} - control (QMI) |
1873 | | * {{{/sys/class/net/wwan0}}} |
1874 | | * {{{/sys/class/net/wwan1}}} |
1875 | | |
1876 | | OpenWrt configuration: |
1877 | | {{{#!bash |
1878 | | uci set network.wan=interface |
1879 | | uci set network.wan.ifname=wwan0 |
1880 | | uci set network.wan.proto=qmi |
1881 | | uci set network.wan.apn=vzwinternet |
1882 | | uci set network.wan.device=/dev/cdc-wdm0 |
1883 | | uci set network.wan.autoconnect=0 |
1884 | | uci commit network |
1885 | | }}} |
1886 | | - '''it is important to configure autoconnect=0 as shown above for OpenWrt otherwise qmi.sh will not connect''' |
1887 | | |
1888 | | GPS: |
1889 | | * To enable NMEA messages on {{{/dev/ttyUSB1}}}: |
1890 | | {{{#!bash |
1891 | | stty raw -F /dev/ttyUSB1; echo \$GPS_START >/dev/ttyUSB1 |
1892 | | }}} |
1893 | | * To disable NMEA messages on {{{/dev/ttyUSB1}}}: |
1894 | | {{{#!bash |
1895 | | stty raw -F /dev/ttyUSB1; echo \$GPS_STOP >/dev/ttyUSB1 |
1896 | | }}} |
1897 | | |
1898 | | References: |
1899 | | * [http://www.sierrawireless.com/en/productsandservices/AirPrime_Wireless_Modules/Essential_Modules/MC_Series.aspx Product Brief] |
1900 | | * [http://www.sierrawireless.com/en/productsandservices/AirPrime_Wireless_Modules/Essential_Modules/~/media/Data%20Sheet/AirPrime_datasheets/Sierra_Wireless_AirPrime_MC_Series_Intelligent_Embedded_Modules.ashx Datasheet] |
1901 | | |
1902 | | |
1903 | | [=#mc7455] |
1904 | | ==== MC7455 ==== |
1905 | | |
1906 | | ** WARNING: This modem is ** NOT ** well supported ** |
1907 | | |
1908 | | !AirPrime MC 4G LTE Cat-6, Cat-3 / 3G Fallback wireless module - One design for America/EMEA - Multi-carrier support |
1909 | | |
1910 | | Bands: |
1911 | | * LTE-A: B1-B5, B7, B8, B12, B13, B20, B25, B26, B29, B30, B41 |
1912 | | * LTE-FDD, LTE-TDD HSPA+ |
1913 | | |
1914 | | * This modem is ** NOT ** well supported |
1915 | | * Different firmware on the modem either puts the modem into QMI or MBIM mode, determined [#troubleshooting here] |
1916 | | * Depending on firmware, modem may not be supported on Gateworks OpenWrt 16.02 with 4.4 kernel |
1917 | | * This modem supports USB 3.0 which is **NOT** available on the Ventana Mini-PCIe pins |
1918 | | * Read more in discussion forum regarding pinout here: https://forum.sierrawireless.com/viewtopic.php?f=117&t=9636&p=38401#p38401 |
1919 | | * USB 3.0 pins 23, 25, 31 and 33 are for USB 3.0 and are sometimes masked on the modem |
1920 | | * USB ID: 1199:9071 & 1199:9070 |
1921 | | * The second SIM pins on the modem, (11 & 13) are not supported by Gateworks boards |
1922 | | * Customer provided commands if USB ID is missing: |
1923 | | {{{ |
1924 | | echo '1199 9071' > /sys/bus/usb-serial/drivers/option1/new_id (for generic USB driver) |
1925 | | echo '1199 9071' > /sys/bus/usb-serial/drivers/sierra/new_id (for sierra usb-serial) |
1926 | | echo '1199 9071' > /sys/bus/usb/drivers/qmi_wwan/new_id (for Qualcomm qmi) |
1927 | | }}} |
1928 | | |
1929 | | * Software Drivers: |
1930 | | * qcserial |
1931 | | * qmi_wwan |
1932 | | * cdc_mbim * Depending on firmware |
1933 | | * usbserial |
1934 | | * usbcore |
1935 | | |
1936 | | |
1937 | | Software Drivers: |
1938 | | * qcserial (CONFIG_USB_SERIAL_QUALCOMM) exposes serial interfaces: |
1939 | | * {{{/dev/ttyUSB0}}} |
1940 | | * {{{/dev/ttyUSB1}}} |
1941 | | * {{{/dev/ttyUSB2}}} |
1942 | | * qmi_wwan (USB_NET_QMI_WWAN) exposes network interface and QMI interface: |
1943 | | * {{{/dev/cdc-wdm0}}} |
1944 | | * {{{/dev/cdc-wdm1}}} |
1945 | | * {{{/sys/class/net/wwan0}}} |
1946 | | * {{{/sys/class/net/wwan1}}} |
1947 | | |
1948 | | |
1949 | | Software utilties: |
1950 | | * libqmi-1.17.901 or newer |
1951 | | * libmbim 1.15.0 (1.14.0+ required) * Depending on firmware |
1952 | | |
1953 | | Kernel version: |
1954 | | * Typically requires 4.10 or higher |
1955 | | |
1956 | | References: |
1957 | | * [https://source.sierrawireless.com/devices/mc-series/mc7455/ Sierra Wireless] |
1958 | | |
1959 | | |
1960 | | |
1961 | | [=#mc5828] |
1962 | | ==== MC5828 / MC5728V ==== |
1963 | | Driver: |
1964 | | * exposes 4 serial devices: |
1965 | | * {{{/dev/ttyUSB0}}} - control/data |
1966 | | * {{{/dev/ttyUSB1}}} - |
1967 | | * {{{/dev/ttyUSB2}}} - |
1968 | | * {{{/dev/ttyUSB3}}} - |
1969 | | |
1970 | | ==== HL7588 ==== |
1971 | | |
1972 | | The Sierra Wireless HL7588 modem is not recommended for Gateworks SBCs. Please contact support@gateworks.com for more information. |
1973 | | |
1974 | | |
1975 | | [=#gtm671wfs] |
1976 | | === (EOL) Option Globetrotter Multi-function Modules (GSM/CDMA/WiFi/GPS/uSD) GTM671WFS EOL === |
1977 | | This module is EOL - End of life. |
1978 | | |
1979 | | The [http://www.option.com/en/products/products/ Option Globetrotter modules] provide multi-function capability including GSM, CDMA, WiFi (ath9k 11abgn 1x1), GPS, uSD, and local SIM carrier all in one module. |
1980 | | |
1981 | | Driver: |
1982 | | * hso (CONFIG_USB_HSO) exposes 6 serial ports: |
1983 | | * {{{/dev/ttyHS0}}} - Diagnostic (proprietary Option) |
1984 | | * {{{/dev/ttyHS1}}} - GPS (ie for {{{gpsd}}}) |
1985 | | * {{{/dev/ttyHS2}}} - GPS Control |
1986 | | * {{{/dev/ttyHS3}}} - Application (proprietary Option) |
1987 | | * {{{/dev/ttyHS4}}} - control (ie for {{{gcom}}}) |
1988 | | * {{{/dev/ttyHS5}}} - control/data (ie for ppp) |
1989 | | * OpenWrt package: usb-net-hso |
1990 | | |
1991 | | USB ID: |
1992 | | * 0af0:9200 |
1993 | | |
1994 | | GPS: |
1995 | | * For GPS you need to use some AT commands (over {{{/dev/ttyHS2}}}) to enable NMEA messages (over {{{/dev/ttyHS1}}}). The following shell commands will accomplish this: |
1996 | | {{{#!bash |
1997 | | echo -e -n "AT_OGPSMODE=1\015" > /dev/ttyHS2 |
1998 | | echo -e -n "AT_OGPS=2\015" > /dev/ttyHS2 |
1999 | | }}} |
2000 | | * You should then be able to see the GPS on {{{/dev/ttyHS1}}}: |
2001 | | {{{#!bash |
2002 | | stty -F /dev/ttyHS1 9600 |
2003 | | cat /dev/ttyHS1 |
2004 | | }}} |
2005 | | * or use screen: |
2006 | | {{{#!bash |
2007 | | screen /dev/ttyHS1 9600,cs8 |
2008 | | }}} |
2009 | | |
2010 | | The Option GTM671WFS contains 4 U.FL antenna connections for cellular, wifi and GPS. |
2011 | | |
2012 | | Here is the location for these (looking at top of card with PCIe edge fingers to right) |
2013 | | |
2014 | | {{{ |
2015 | | |-------------------------| |
2016 | | | o Cellular Main |= |
2017 | | | |= |
2018 | | | o 802.11 aux |= |
2019 | | | |= |
2020 | | | o Cellular Aux/GPS |= |
2021 | | | |= |
2022 | | | o 802.11 main |= |
2023 | | |-------------------------| |
2024 | | }}} |
2025 | | |
2026 | | To insert the SIM card in the Option's SIM carrier, you slide the top to lock/unlock the metal top cover (see picture). |
2027 | | |
2028 | | [[Image(Option_SIM.jpg,100px)]] |
2029 | | |
2030 | | Troubleshooting: |
2031 | | * If the SIM is not registered, configured correctly or the data plan has expired/run out of data, the console output will show the following error message indicating that a connection has not been established with the carrier. |
2032 | | {{{#!bash |
2033 | | root@OpenWrt:/# [62.860000] usb 1-1: hso received invalid serial state notification |
2034 | | }}} |
2035 | | |
2036 | | |
2037 | | [=#mu609] |
2038 | | === Huawei MU609 === |
2039 | | Driver: |
2040 | | * option.ko (CONFIG_USB_SERIAL_OPTION) exposes 6 serial ports: |
2041 | | * {{{/dev/ttyUSB0}}} - modem (ie for qcom) |
2042 | | * {{{/dev/ttyUSB1}}} - |
2043 | | * {{{/dev/ttyUSB2}}} - AT Commands |
2044 | | * {{{/dev/ttyUSB3}}} - |
2045 | | * pinout concerns: |
2046 | | - Pin 20 (W_DISABLE#) is W_DISABLE_E active-low input on 1.8V domain with a max of 2.1V (violated when we drive this high) (not supported by current firmware accoring to MiniPCIe hardware guide) |
2047 | | - Pin 22 (PERST#) is RESIN_N active-low input on 1.8V domain with max of 2.1V (violated when we drive this high) |
2048 | | * OpenWrt package: usb-serial-option |
2049 | | * USB2.0: 12d1:1573: Huawei Technologies:HUAWEI Mobile |
2050 | | * Testing: |
2051 | | {{{#!bash |
2052 | | 12d1:1573 Huawei Technologies Co., Ltd. |
2053 | | |
2054 | | usb 2-1: New USB device found, idVendor=12d1, idProduct=1573 |
2055 | | usb 2-1: New USB device strings: Mfr=5, Product=4, SerialNumber=0 |
2056 | | usb 2-1: Product: HUAWEI Mobile |
2057 | | usb 2-1: Manufacturer: Huawei Technologies |
2058 | | }}} |
2059 | | |
2060 | | OpenWrt {{{/etc/config/network}}}: |
2061 | | {{{#!bash |
2062 | | config interface 'wan' |
2063 | | option proto '3g' |
2064 | | option service 'umts' |
2065 | | option apn 'ISP.CINGULAR' |
2066 | | option device '/dev/ttyUSB0' |
2067 | | }}} |
2068 | | |
2069 | | Link [http://consumer.huawei.com/en/solutions/m2m-solutions/products/tech-specs/mu609mini-pcie-en.htm] |
2070 | | |
2071 | | |
2072 | | [=#sim5360] |
2073 | | === Simcom SIM5360E === |
2074 | | ***Evaluation*** |
2075 | | |
2076 | | * ID 05c6:9000 Qualcomm, Inc. |
2077 | | * SIMCom SIM5218 modem |
2078 | | * {{{/dev/ttyUSB0}}} - |
2079 | | * {{{/dev/ttyUSB1}}} - |
2080 | | * {{{/dev/ttyUSB2}}} - AT Commands |
2081 | | * {{{/dev/ttyUSB3}}} - AT Commands |
2082 | | * {{{/dev/cdc-wdm0}}} |
2083 | | |
2084 | | * USB ID [http://lxr.free-electrons.com/source/drivers/usb/serial/option.c?v=3.14#L1036] |
| 1647 | |