diff options
| author | kutayboz <kutayboz@gmail.com> | 2023-08-03 18:01:20 +0300 |
|---|---|---|
| committer | kutayboz <kutayboz@gmail.com> | 2023-08-03 18:01:20 +0300 |
| commit | 80b89a9734f62fb833bfb9a0a1525ac82862897c (patch) | |
| tree | ff8d462fd064200310e2d04027c3a3ea3b244575 | |
| parent | 5d48f1280612b2f525c9a2d60f96434f1a217156 (diff) | |
| download | celnetmon-80b89a9734f62fb833bfb9a0a1525ac82862897c.tar.gz | |
| -rw-r--r-- | README.md (renamed from readme) | 27 |
1 files changed, 14 insertions, 13 deletions
@@ -1,27 +1,28 @@ -CelNetMon - Cellular Network Monitor +# CelNetMon - Cellular Network Monitor A cellular network signal quality monitoring utility. Written to be used during my thesis work. + Uses the BG96 chip with AT commands, connected through GPIO and serial pins of a Linux machine. Should be easy to adapt the code to other devices using AT commands. -Requires libgpiod. -Compiled and tested with Clang 11.0.1 aarch64. -Compiling -CMake is used in development. -For development, "celnetmon" target can be used to work in the build folder. -For release, "install" target creates and puts the executable in "./bin". +Requires `libgpiod`. Compiled and tested with Clang 11.0.1 aarch64. + +## Compiling +CMake is used in development. For development, `celnetmon` target can be used to work in the build folder. For release, `install` target creates and puts the executable in `./bin`. -Usage -Make sure to create a "celnetmon.cfg" config file in the same folder with the executable. An example "celnetmon.cfg.example" is included in the repo. +## Usage +Make sure to create a `celnetmon.cfg` config file in the same folder with the executable. An example `celnetmon.cfg.example` is included in the repo. -"celnetmon --init" +- `celnetmon --init` Powers the BG96 chip on, initiates the GNSS system, configures and connects to the network. -"celnetmon --publish" +- `celnetmon --publish` Collects network telemetry and GNSS location, publishes the data to the specified MQTT server in the config file. -"celnetmon --stop" +- `celnetmon --stop` Powers the chip down. -A-GPS technologies are not implemented. For that reason, GNSS takes some time to establish. +> [!NOTE] +> A-GPS technologies are not implemented. For that reason, GNSS takes some time to establish. + Telemetry data that is collected are: - Network operator name - Roaming status |