Chapter 1: Quickstart & User Interface¶
In this chapter, you will learn how to set up the Stromnetz Pro, configure required permissions, and optimize the user interface for harsh field conditions.
📱 System Requirements & Installation¶
- Operating System: Android 10.0 (API Level 29) or higher (recommended: Android 12+).
- Hardware: Smartphone or rugged outdoor tablet with Wi-Fi, Bluetooth LE, and camera (for QR scanner).
- Storage Space: approx. 50 MB for the app plus optional offline maps (MBTiles, approx. 200–800 MB depending on the region).
Versioning & Build Number¶
The versioning follows the 4-part schema MAJOR.MINOR.PATCH.BUILD (e.g. 1.0.0.0186). The 4-digit build number is derived from the Git commit count. It guarantees full traceability of the software release in field operations and ensures that all devices connected in the operational network run on compatible builds.
🔒 Initial Setup & PIN Protection¶
On first launch, the app prompts you to set a 4- to 6-digit security PIN:
flowchart LR
Start["First App Launch"] --> Pin["Set PIN<br>(4-6 digits)"]
Pin --> Perm["Grant Permissions<br>(Bluetooth, Location, Camera)"]
Perm --> Ready["Ready for Action!"]
style Start fill:#f1f5f9,stroke:#64748b;
style Pin fill:#dbeafe,stroke:#003399,stroke-width:2px;
style Ready fill:#dcfce7,stroke:#10b981,stroke-width:2px;
Scope of PIN Protection
In field operations, devices are often placed on vehicle tables or handed between crew members. The security PIN protects app launch and specifically prevents:
- Modifying grid structure and topology,
- Deleting or shutting down power generators and feed points,
- Accessing safety-critical system settings (e.g. P2P sharing, RF security).
🛡️ Required Permissions¶
The app requires the following Android runtime permissions to function fully offline:
| Permission (Android API) | Operational Purpose | Required For |
|---|---|---|
NEARBY_WIFI_DEVICES &BLUETOOTH_CONNECT / SCAN |
Local device discovery & P2P mesh (Android 12+) without location prompts | Offline P2P synchronization between machinists and command without Wi-Fi routers |
ACCESS_FINE_LOCATION |
Exact GPS positioning | Tactical map, tile centering & distance measurement tools |
CAMERA |
Barcode & QR code scanning | Quick onboarding of generators, distributors, and cables via camera scan |
CAMERA |
Barcode & QR code scanning | Quick onboarding of generators, distributors, and cables via camera scan |
RECORD_AUDIO |
Hands-free voice control in the field | Capturing spoken voice commands (missions, fuel levels, equipment connection) |
POST_NOTIFICATIONS |
Visual & acoustic alerts (Android 13+) | Immediate alarms for phase unbalance (> 30%), voltage drop (> 3.0%), and fuel reserve (< 20%) |
🧤 Gloves Mode¶
During operations in cold, rain, or debris fields, rescue personnel wear heavy protective gloves. In Settings (gear icon), you can enable Gloves Mode:
- Enlarged Touch Targets: All switches, menu items, and controls offer a touch target of at least 64 dp for precise tapping.
- Generous Spacing: Increased gaps prevent accidental taps on neighboring buttons.
- High-Contrast Highlighting: Active states and warnings are rendered with enhanced color contrast.
- For a detailed overview of all configuration options and the quick search feature, see Chapter 11: Settings & System Configuration.
🎙️ Hands-Free Voice Control & Wake-Words ("Hey Stromapp")¶
For harsh field conditions (working at noisy generators, wearing heavy protective gloves, or having dirty hands), the app includes a 100% offline-capable voice control engine with integrated wake-word detection. This allows full hands-free interaction without ever needing to touch the screen or remove work gloves.
🗣️ Contactless Wake-Word Activation ("Hey Stromapp" & Co.)¶
When Hands-Free Voice Control is enabled in Settings and microphone permission is granted, the app actively listens in the foreground for designated wake phrases.
Supported Wake Phrases (Wake-Words)¶
Recognition is forgiving of natural speech variations, accents, and casing:
| Category | Supported Wake Phrases |
|---|---|
| App Call Sign | "Hey Stromapp" • "Hallo Stromapp" • "Stromapp" |
| Voice Call Sign | "Hey Stromnetz" • "Hallo Stromnetz" • "Sprachbefehl starten" • "Befehl starten" |
| Standard Commands | "Sprachbefehl starten" • "Sprachbefehle starten" • "Starte Sprachbefehl" • "Sprachbefehl" |
| Voice Control | "Sprachsteuerung starten" • "Starte Sprachsteuerung" • "Sprachsteuerung" |
| Start Command | "Startbefehl starten" • "Startbefehle starten" • "Startbefehl" • "Befehl starten" • "Starte Befehl" |
Acoustic & Haptic Feedback¶
When a wake phrase is matched, the app acknowledges immediately:
1. Audio Cue (Beep): A distinct tone confirms the engine is ready to receive commands, even above generator engine roar.
2. Haptic Vibration: A short vibration pulse alerts operators wearing hearing protection or when the device is mounted in a vehicle cradle.
Three Flexible Operation Modes¶
- One-Shot Direct Command (Trailing Command in Single Utterance):
Speak the wake phrase and your operational command in a single fluid sentence: - "Hey Stromapp, generator 1 fuel level 70%"
- "Hallo Stromapp: note cable damaged"
-
"Sprachbefehl starten switch pump 1 to phase 2"
The app strips the wake-word prefix and immediately executes the trailing command without intermediate prompts or confirmation taps! -
Two-Step Voice Dialog (Wake-Word + Prompt):
Speak just the wake phrase (e.g. "Hey Stromapp" or "Sprachbefehl starten"). The app beeps, vibrates, and opens the animated voice input dialog (StromVoiceInputDialog). Then state your command at your own pace. -
Manual Microphone Button:
In noise-sensitive environments, tap the Microphone icon (🎙️) in the Dashboard FAB or Grid Plan toolbar to trigger input manually.
⚙️ Voice Input Workflow & Interaction¶
- Automatic Silence Detection: After 1 second of silence, the app automatically stops recording and evaluates the command.
- Spoken Confirmation: Dialogs can be confirmed vocally ("Yes", "Confirm", "Execute", "Done" / "Ja", "Bestätigen", "Befehl ausführen").
- Manual Evaluate Button: You can tap "Done (Evaluate)" at any time to complete input without waiting.
- Disambiguation Popup: When a query matches multiple templates (e.g. several pumps), a numbered popup appears. Simply speak the option number (e.g. "1" or "2").
- Generator Refuel Prompt: When inserting a new generator template, the app prompts for the initial fuel level.
- 100% Offline & Private: All speech processing is executed entirely locally on device (Android On-Device Recognizer). No audio data leaves the phone.
Sample Voice Commands¶
| Feature Area | Example Voice Command | Executed Action |
|---|---|---|
| Missions | "New mission Disaster in Dresden" | Creates and activates a new mission |
| Fuel Levels | "Generator 1 fuel level 70%" or "Generator 1 fuel level 43 liters" | Manually updates tank level in % or liters |
| Connecting Equipment | "Connect Halogen 1000W to Generator 1 on phase 2" | Connects matching template device on phase L2 |
| Grid Plan | "Switch Pump 1 to phase 3" / "Disconnect Sub-pump 2" | Modifies phase assignment or removes node |
| Operating Hours | "Operating hours Generator 1 120 hours" | Updates hour meters for maintenance tracking |
| Logs & Reports | "Note: Cable damaged" / "Create mission report" | Logs event note or generates PDF report |
Voice Control in Settings
Hands-Free Voice Control can be turned on or off anytime under Settings → Hands-Free Voice Control. When enabled, the app actively monitors for "Hey Stromapp" and wake words in the foreground. When disabled, microphones are completely turned off.
🧭 App Navigation¶
The app provides two intuitive navigation paths:
- Main Navigation Drawer:
Swipe right from the left edge of the screen or tap the menu icon (
≡) at top left. Access all functional areas: - Dashboard (Operational overview)
- Generators (Power units)
- Consumers (Load management)
- Grid Plan (Topology)
- Fuel Logistics (Refueling & tank levels)
- Inventory (Material pool & stock tracking)
- Tactical Map (MBTiles mapping)
- Mission Reports (PDF generation)
- Settings (Security, Gloves Mode, P2P)
-
Manual & Help (Offline quick references, cheat sheet & PDF manual)
-
Quick Access Bar (Bottom Navigation): On standard screens, the bottom bar provides direct jumps to the four main operational views: Dashboard, Generators, Consumers, and Grid Plan.
👥 Role-Specific Quickstart¶
Depending on your role in the field, different functions take priority:
1. Machinist / Generator Operator (Technical Operation)¶
- Start: Go to Generators, add a power generator or load a preset.
- Monitoring: Keep an eye on phase currents (L1, L2, L3) on the Dashboard to avoid phase unbalance.
- Logistics: Enter fuel entries under Fuel Logistics during shift changes or refueling.
- Cheat Sheet: Use Appendix A: Machinist Cheat Sheet for limits and cable formulas.
2. Group Leader / Incident Commander (Grid Planning & Command)¶
- Start: Create a mission under Mission Management and select your unit's equipment preset.
- Topology: Build the grid in the Grid Plan and watch for yellow/red voltage drop warnings (\(\Delta U > 3.0\%\)).
- Mesh: Enable the sync server under Settings → Connectivity and assign roles to machinists.
- Documentation: Generate progress reports and the final PDF Mission Report for command staff.
3. Crew Member (Cable Deployment & Material)¶
- Scan: Scan QR codes on cable drums and distribution boxes using the camera before laying lines.
- Status: Check whether cable drums in the grid plan are marked as Coiled (fire hazard!).
- Material: Check in Inventory which equipment is still loaded on the vehicle.
📱 Smartphone Handheld Mode (MobileActivity)¶
For field machinists and squad members operating in the field, the app includes a tailored Smartphone Handheld View (MobileActivity):
- Single-Handed Usability: Compact layout designed for quick thumb interaction and minimal distraction.
- Rapid Field Data Entry: Fast access to refueling, phase readings, and generator switching directly at the generator.
- Background Synchronization: Automatically streams updates and refuels across the local P2P mesh network to the incident commander.