How samirsalman/wiguana works
Project type and purpose
• This is a multi-module native Android application (no backend server), created as a university project.
• Two APK modules (“app” for data logging, “mapmonitor” for map visualization) plus a shared utility library (“testlib”).
• Purpose:
• “app” captures radio-signal strength and USB-serial messages from a Wiguana router device, logs the measurements.
• “mapmonitor” reads a JSON data asset and renders navigation UI.
• “testlib” supplies common utilities (e.g. ByteUtil).
File structure
• Top-level Gradle settings define three subprojects:
• app/ – the main WIGUANADataLogger Android app
• mapmonitor/ – a second Android app for map monitoring
• testlib/ – Android library module with shared code
• Each Android module follows the standard Android Studio layout:
src/main/java → Activities, Fragments, Services, Model classes
src/main/res → layouts, drawables, values
src/androidTest & src/test → instrumentation and unit tests
• Configuration files: build.gradle in each module, proguard rules, AndroidManifest.xml, gradle wrapper.
Key architecture insights from README
• No backend; the “system” is the phone + hardware device.
• USB/serial communication through UsbService.
• Radio-signal transmission to/from a router device, measuring range via received signal strength.
• Data is logged (CSVLine, ByteUtil) and stored locally.