How nullc0rp/bluempos works
Main Components
• Mobile Device / Android App Container – This is the runtime environment where the mobile application is deployed.
• User Interface Layer – Represented by components like MainActivity, the UI packages (e.g., com.example.bluempos.ui and its themes), and Android layout files (activity_main.xml). This is where the user interacts with the simulated POS.
• BLE Module – The core component that handles Bluetooth Low Energy communication. Highlight the vulnerable GATT service where players can read the characteristic that initially returns “LOCKED” and then write the custom command (“SEND_FLAG_2”) to receive the flag.
• NFC Module – Although it’s a work-in-progress (flag for NFC APDU is “optional” in the README), include it as a planned component that can respond to ISO-DEP card interactions.
• Build and Configuration Tools – Represent the use of Gradle (with build.gradle.kts, gradle wrapper, etc.) and configuration files (e.g., AndroidManifest.xml) that manage dependencies and app settings.
Relationships and Interactions
• The Mobile Device contains the Android Application, which is composed of layered components: the UI layer interacts with the BLE and NFC modules.
• The BLE Module serves as an interface received commands from external clients (via tools like gatttool or nRF Connect) – representing an external connection entry.
• The UI layer communicates with (or displays outputs from) the BLE Module after processing commands.
• The NFC Module (future component) is depicted as an alternate input channel triggering its own flow.
• Optionally, indicate a testing path where the test suites (unit and instrumentation tests) target specific application modules.
Architectural Patterns and Technologies
• Separation of Concerns: Where UI, BLE/NFC modules, and business logic are clearly separated.
• Use of Gradle as the build automation tool.
• Android’s resource system (layouts, values, drawable, etc.) that define the app’s appearance and behavior.
• Call out specific technologies:
• Android SDK for the mobile platform
• BLE GATT profile to manage Bluetooth communications
• (Planned) NFC using IsoDep technology
• Testing frameworks supported by Android (JUnit, Espresso, etc.)