Projekt "3ginfo"
Ostatnia zmiana: 2024-03-24 11:54
Celem projektu jest graficzna wizualizacja statusu modemu komórkowego 3G/4G/5G przez stronę www. Poniżej zaprezentowano przykładowy zrzut ekranu:
Sam projekt w całości napisany został jako skrypty shella i wykorzystuje komponenty standardowo dostępne w normalnej instalacji OpenWrt. Nie jest zależny od konkretnej platformy sprzętowej więc powinien działać na każdym urządzeniu wspieranym przez OpenWrt, zależy za to od kilku zewnętrznych pakietów.
Działa z większością modemów 3G/4G/5G na USB, modułami na złączu minipcie oraz telefonami/smartfonami podłączonymi przez kabel USB, wykorzystując interfejs szeregowy. Działa także z modemami Huawei typu HiLink (działającymi jako karta sieciowa).
Domyślnym językiem projektu jest język Angielski; jeżeli przeglądarka wspiera język Polski to nastąpi automatycznie przetłumaczenie interfejsu.
Ten opis dotyczy nowej wersji projektu. Stary opis znajduje się pod tym adresem: 3ginfo-old.
Wymagania
Program wymaga do działania urządzenia potrafiącego zwracać informacje przy pomocy komend AT. Zwykle musi to być inny interfejs niż ten na którym odbywa się połączenie. Nie wszystkie urządzenia mogą zwracać użyteczne informacje, w związku z tym część parametrów może nie być dostępna.Instalacja
Należy zainstalować pakiet 3ginfo:
# opkg update
# opkg install 3ginfo
# /etc/init.d/3ginfo enable
# /etc/init.d/3ginfo start
# opkg update
# opkg install 3ginfo-text
Do poprawnego działania niezbędne są też odpowiednie sterowniki do modemu. W ogólnym przypadku wystarczy
# opkg install kmod-usb-serial kmod-usb-serial-option
Konfiguracja
Plik konfiguracyjny zawarty jest w /etc/config/3ginfo. Możliwe opcje do ustawienia:- device - wymagany, interfejs diagnostyczny modemu USB. Ale może mieć wartość pustą, która powoduje automatycznie wykrycie i przypisane pierwszego znalezionego portu (UWAGA: automat nie zawsze znajduje poprawny port). Dla modemów typu HiLink powinien tu zostać wpisany adres IP modemu (np. 192.168.8.1) i ustawiona odpowiednia sekcja sieci - patrz poniżej.
- network - opcjonalny, możliwość wyboru sekcji logicznej sieci z której będą odczytywane dane o połączeniu. Jeżeli nie jest ta opcja ustawiona to skrypt stara się wykryć na podstawie interfejsu określonego w device do jakiej sekcji w pliku /etc/config/network ma się odwołać
- pincode - opcjonalny, kod PIN do karty SIM
- http_port - opcjonalny, port na którym będzie nasłuchiwał demon www (domyślnie 81)
Interfejs komunikacyjny
Jeżeli opcja device jest pusta (lub jej nie ma) program automatycznie wykryje pierwszy port na którym jest możliwa komunikacja z modemem i zapisze go w pliku konfiguracyjnym. Nie zawsze może to być właściwy port, w przypadku złego wykrycia lub w przypadku podłączenia większej ilości modemów właściwy port można ustawić poleceniami
# uci set 3ginfo.@3ginfo[0].device=/dev/ttyUSB1
# uci commit 3ginfo
Jeżeli używamy modemu Huawei typu HiLink można wskazać adres IP modemu:
# uci set 3ginfo.@3ginfo[0].device=192.168.8.1
# uci commit 3ginfo
oraz koniecznie instalujemy pełną wersję programu wget np.
# opkg install wget-ssl
Jeżeli chcemy włączyć obsługę wielu modemów, należy utworzyć kolejne sekcje konfiguracyjne, np.
# uci add 3ginfo 3ginfo
# uci set 3ginfo.@3ginfo[-1].device='/dev/ttyUSB2'
# uci set 3ginfo.@3ginfo[-1].network='wanb'
# uci commit 3ginfo
Kod PIN
Aby program poprawnie działał, modem MUSI być zarejestrowany w sieci operatora. W przypadku kart posiadających kod PIN należy albo zdefiniować sekcję w pliku network i podać prawidłowy kod PIN, lub zdefiniować opcję pincode w pliku 3ginfo.Ustawienie kodu pin:
# uci set 3ginfo.@3ginfo[0].pincode=1234
# uci commit 3ginfo
Sekcja konfiguracyjna sieci
Jeżeli modem nie jest w sekcji wan, można dodatkowo wskazać nazwę logiczną sieci, aby odczytywać np. status połączenia:
# uci set 3ginfo.@3ginfo[0].network=wan2
# uci commit 3ginfo
Testy
Informacja tekstowa
Wystarczy uruchomić program
# 3ginfo
Device: Sierra Wireless, Incorporated EM7455B
Revision: SWI9X30C_02.24.05.06 r7040 CARMD-EV-FRMWR2 2017/05/19 06:23:09
IMEI: 3-------------7
ICCID: 8------------------4
Connected time: 0d, 00:28:01
TX: 126.3 KiB
RX: 7.1 MiB
Signal: 100 %
Mode: LTE B7 (2600 MHz)
Operator: PLAY (260 06)
Registration: registered, home network
Temperature: 29 °C
CellID: 1765423 (1AF02F)
LAC: 65534 (FFFE)
TAC: 119 (0077)
Primary band: B7 (2600 MHz) @20 MHz
EARFCN DL: 3350
EARFCN UL: 21350
RSSI: -48/-51 dBm
RSRP: -81/-82 dBm
RSRQ: -11.1 dB
SINR: 9.0 dB
Jeżeli chcemy uzyskać wynik w formacie json wystarczy wywołać polecenie z odpowiednim argumentem:
{"res":[
[{
"vendor":"Sierra Wireless, Incorporated",
"product":"EM7455B",
"revision":"SWI9X30C_02.24.05.06 r7040 CARMD-EV-FRMWR2 2017/05/19 06:23:09",
"imei":"3-------------7",
"iccid":"8-----------------1"
},{
"status": "CONNECTED",
"conn_time": "0d, 00:25:14",
"conn_time_sec": "1514",
"conn_time_since": "20240311200744",
"rx": "5.8 MiB",
"tx": "173.7 KiB"
},{
"csq":"31",
"signal":"100",
"operator_name":"Plus",
"operator_mcc":"260",
"operator_mnc":"01",
"mode":"LTE_A B3 (1800 MHz) / B7 (2600 MHz)",
"registration":"1",
"lac_dec":"65534",
"lac_hex":"FFFE",
"cid_dec":"2742786",
"cid_hex":"29DA02",
"addon":[{"idx":10,"key":"Temperature","value":"34 °C"},{"idx":23,"key":"TAC","value":"11041 (2B21)"},{"idx":35,"key":"RSSI","value":"-49/-50 dBm"},{"idx":36,"key":"RSRP","value":"-78/-83 dBm"},{"idx":37,"key":"RSRQ","value":"-8.0 dB"},{"idx":38,"key":"SINR","value":"9.0 dB"},{"idx":30,"key":"Primary band","value":"B3 (1800 MHz) @20 MHz"},{"idx":34,"key":"EARFCN DL","value":"1300"},{"idx":34,"key":"EARFCN UL","value":"19300"},{"idx":50,"key":"(S1) band","value":"B7 (2600 MHz) @20 MHz"},{"idx":54,"key":"(S1) EARFCN","value":"2850"},{"idx":55,"key":"(S1) RSSI","value":"-70/-68 dBm"},{"idx":56,"key":"(S1) RSRP","value":"-87/-84 dBm"}]
}
]]}
Strona WWW
Program dynamicznie generuje stronę www przy pomocy której można odczytać parametry połączenia. Strona obsługiwana jest przez osobny proces serwera www nasłuchującego na porcie 81, czyli można odwołać się do niej wpisują w przeglądarkę adres routera z podanym portem, np. http://192.168.1.1:81.
Wyświetlane informacje:
- sekcja "Urządzenie"
Informacje o urządzeniu - producent, model, wersja, numer IMEI oraz numer karty SIM (ICCID).
- sekcja "Parametry"
Różne parametry pracy modemu - tryb pracy, poziom sygnału, operator i inne, w zależności od typu modemu.
- sekcja "Połączenie z internetem"
Informacja o czasie połączenie bieżącej sesji z internetem oraz ilość danych wysłanych i ilość danych pobranych.
Plugin dla Gargoyle
Jeżeli używamy Gargoyle i wystarczy nam podstawowy zestaw informacji to zamiast w/w poleceń należy zainstalować sam dodatek:
# opkg install plugin-gargoyle-3ginfo-extended
Siła sygnału
Jeżeli używany jest modem z protokołem qmi, możliwe jest wyświetlenie parametrów korzystając z tego protokołu:
# opkg update
# opkg install 3ginfo-qmisignal
3ginfo-qmisignal do działania wymaga połączenia z internetem, ponieważ korzysta z komponentów dostępnych on-line. Nie należy w trakcie działania 3ginfo-qmisignal uruchamiać uqmi gdyż może dojść do zawieszenia się uqmi. 3ginfo-qmisignal nie wymaga do działania pakietów 3ginfo czy 3ginfo-text.
Problemy
- brak wyświetlania danych - same kreski
- wyświetlana jest tylko część informacji
Historia zmian
- 2024-03-14
- 2019-04-18
- aktualizacja frameworka bootstrap dla 3ginfo-qmisignal
- 2017-12-27
- 2017-12-26
- 2017-06-15
- 2017-05-24
- 2017-04-22
- 2017-01-06
- 2016-12-10
- 2016-11-12
- 2016-10-07
- 2016-10-01
- dodanie wyświetlania SINR
- 2016-09-27
- 2016-09-26
- 2016-09-23
- 2016-09-16
- dodanie skryptu dla modemów Alcatel (typu HiLink)
- zmiana polecenia 3ginfo-test na 3ginfo test
- zmiana nazwy stron z "3G/LTE" na "3G/4G"
- 2016-09-02
- 2016-04-10
- 2016-02-23
- możliwość wyłączenie na stronie www przycisku połączenia
- 2016-02-18
- 2016-02-09
- 2016-01-13
- 2015-12-13
- 2015-10-25
- 2015-10-17
- 2015-07-25
- 2015-05-05
- 2015-04-30
- 2015-04-21
- 2015-04-17
- 2015-04-16
- 2015-02-07
- możliwość odczytu operatora przy ręcznym wyborze sieci
- 2015-02-05
- 2014-11-22
- dodanie obsługi plików clf spakowanych gzip
- 2014-06-08
- 2013-12-19/20
- 2013-10-20
- 2013-09-08
- dodano tworzenie dowiązań dynamicznych podczas instalacji pakietu
- usunięto zbędne pliki z wersji text
- 2013-08-19
- 2013-08-16
- 2013-08-15
- 2013-08-14
- 2013-06-06
- 2013-04-30
- dodano możliwość inne sposobu odczytu czasu połączenia
- 2013-04-06
- mała modyfikacja skryptu limitu dla Orange Free na Kartę
- 2013-02-14
- 2013-01-06
- zmiany w kodzie obsługi modemów ZTE
- 2012-12-09
- 2012-11-24
- 2012-10-09
- 2012-09-14
- modyfikacje przy odczycie profilu QoS
- 2012-09-12
- 2012-09-11
- 2012-09-02
- 2012-08-11
- 2012-08-05
- lekka poprawa skryptów sprawdzających limit dla Play Fresh
- 2012-07-30
- dodanie obsługi kodów USSD
- 2012-07-24
- 2012-06-23
- 2012-04-22
- 2012-02-23
- 2012-02-19
- 2011-10-06
- 2011-09-16
- 2011-09-15
- dodatkowy skrypt dla Orange Free na Kartę - PDU
- zmiana nazwy pluginu na 3ginfo-plugin-pdu
- 2011-09-03
- ujednolicenie wyglądu linków zewnętrznych
- nowa podstrona reprezentująca dynamicznie siłę sygnału
- 2011-08-28
- 2011-08-13
- 2011-08-11
- dodatkowy skrypt sprawdzający limit dla Play Fresh
- dodatkowy plugin sprawdzający limit dla Play Fresh dla modemów odpowiadających w formacie PDU
- obsługiwany modem ZTE MF100
- 2011-08-09
- dodano możliwość dekodowania wiadomości PDU
- drobne zmiany związane z Aero2
- 2011-08-06
- 2011-08-04
- 2011-08-03
- 2011-07-16
- 2011-05-20
- 2011-05-14
- 2011-02-01
- 2010-12-27
- 2010-11-25
- wyświetlanie używanej technologii dla modemów Novatel, np. Ovation MC990D
- sprawdzenie limitu dla Cyfrowego Polsatu
- 2010-11-19
- 2010-11-13
- 2010-11-04
- 2010-10-27
- 2010-10-19
- 2010-10-18
- 2010-10-12
- 2010-10-05
- 2010-09-19
- 2010-09-01
- dodano szukanie lokalizacji wg krótkiego CID i operatora na portalu btsearch.pl
- 2010-08-30
- 2010-08-29
- zmiany w skryptach: oczyszczenie kodu, sprawdzenie istnienia urządzenia oraz poprawności zwracanych parametrów
- kolorowanie wskaźnika siły sygnału
- 2010-08-28