Getting started
a. General information
The app generates for each eNB or gNB received an antenna location hypothesis based on the MLS data and the geolocated cells that you have captured. This hypothesis will be automatically recalculated as soon as there is new data: new cell captured, update of the position of a cell already received or MLS database updated.
b. Permissions
The application requires permissions Exact location and Phone call.
Regarding the latter, it is actually permission READ_PHONE_STATE which is used to detect the number of SIM cards and their operator but also to detect 5G-NSA. This does not in any way give the possibility of making phone calls.
Starting with Android 13, permission for Notifications is also requested. It is highly recommended to accept it, because otherwise the notification will not appear while the app continues to run in the background and you risk forgetting about it!
c. Supported providers
■ France : Bouygues Telecom, Free, Orange, SFR, Manu'ia (SPT), Dauphin Télécom, Digicel, Free Caraïbe, GlobalTel, OPT Mobilis, Maoré Mobile, Vini (ONATI), Orange Caraïbes, Orange Réunion, Only (Outremer Télécom), PMT Vodafone, SPM Telecom, SRR, Telco OI, Viti, Zeop.
■ Monaco : Monaco Télécom.
■ Spain : Vodafone, Orange, Yoigo, Movistar.
■ Portugal : Vodafone, DIGI, NOS, MEO.
■ Others : can work in other countries if you produce and install the required databases yourself.
d. Databases
The application requires 3 different databases that can be generated by yourself in a specific format, making the application functional in your country/region for the provider(s) of your choice.
MLS and/or OpenCellId (optional)
The file should be named "MLS_MCC_‹MCC›.csv" where ‹MCC› represents the Mobile Country Code of your country which is 3-digit numbered. eg. 214 for Spain.
Each line must follow the format of an MLS/OCID export (comma-separated CSV). It must be generated using the grep command to limit the number of cells, otherwise the app will be significantly slowed down and will only contain LTE and NR cells.
Rule: one line per cell.
radio,MCC,MNC,TAC,Cell_ID,PCI,Longitude,Latitude,range,samples,1,created,updated,
Example of one line:
LTE,208,15,5909,104534845,375,2.8717006,50.1191406,15467,3844,1,1476514136,1703966408,
Cell Towers (required)
The file should be named "Towers_MCC_‹MCC›.csv" where ‹MCC› represents the Mobile Country Code of your country which is 3-digit numbered.
It must be a semicolon-separated CSV which must contain only one tower per line and per provider must respect the following format:
| Sup_ID |
Adresse |
LAT |
LON |
Act |
Syst. 4G |
Activations 4G |
Syst. 5G |
Activations 5G |
PLMN |
Azimuths |
| 443954 |
Cote de Delme 57590 XOCOURT |
48.9119 |
6.36 |
1 |
1800,2600,2100 |
2018-07-17,2015-06-11, |
3500 |
|
20815 |
0,120,240 |
| 99146 |
Casino Lisboa |
38.7651 |
-9.1234 |
1 |
|
|
|
|
26803 |
|
Sup_ID : Unique support reference - Format INTEGER,
Address : tower name or address - Format TEXT UTF-8, without semicolon (;) and without double quote ("),
LAT : Latitude - Format REAL (-90.0 ... 90.0),
LON : Longitude - Format REAL (-180.0 ... 180.0),
Act : 0 if tower is inactive, 1 if emits minimally in LTE - Format INTEGER,
Syst. 4G : LTE system(s) (in MHz) on the tower - Format TEXT - [optional],
Activations 4G : LTE frequency activation dates - Format TEXT YYYY-MM-DD - [optional],
Syst. 5G : NR system(s) (in MHz) on the tower - Format TEXT - [optional],
Activations 5G : NR frequency activation dates - Format TEXT YYYY-MM-DD - [optional],
PLMN : MCC+MNC of the provider - Format INTEGER,
Azimuths : directions of the support antennas (in whole degrees and comma-separated) - Format TEXT - [optional]
Example of one line:
9587276;Rua Nova Lisboa, 2900-405;38.5374;-8.8927;1;;;;;26801;0,120,240
Existing database (optional but recommended)
If a database already exists, you can provide it to the application so that it can display the already identified eNBs (which will not prevent the application from doing its own analysis).
The file should be named "NmEa_MCC_‹MCC›.ntm" where ‹MCC› represents the
Mobile Country Code. The file essentially follows the NetMonster format (semicolon-separated CSV) but must contain only one row per eNB or gNB. The 4th column (CID) is not used and the 6th column must contain the eNB or gNB.
xG;MCC;MNC;‹unused›;TAC;eNB or gNB;PCI;Latitude;Longitude;tower name/address;
Example of one line:
4G;208;10;-1;46503;619608;28;48.8669;2.3501;215 R ST DENIS 75002 PARIS;
This database files must be put in the following directory (The directory tree is automatically created by the app on first launch; do not modify it!) :
/Android/data/fr.enb_analytics.enb4g/files/Databases/