How mushketer888/grblcontroller works
Grbl Controller is an Android CNC control app. The main workflow is selecting a connection, attaching to a GRBL machine, using the control panels or sending a G-code file, and monitoring machine responses and job progress. Its major capabilities include Bluetooth, USB and TCP serial services, jogging, probing, console commands, file streaming, real-time overrides and status reporting. The README supports the product-level workflow; source excerpts and the index confirm selected service, parsing, event and UI relationships. Several panel-to-command and connection-activity wiring details were not shown, so those links are omitted or marked unverified.
Main entry points: SerialCommunicationHandler.java Serial handlers · GrblActivity.java Main activity · FileStreamerIntentService.java File streamer · GrblBluetoothSerialService.java Bluetooth service
Components 20
Connections
- Serial services
app/src/main/java/com/iljal/grblcontoller/service - Bluetooth service
app/src/main/java/com/iljal/grblcontoller/service/GrblBluetoothSerialService.java - USB service
app/src/main/java/com/iljal/grblcontoller/service/GrblUsbSerialService.java - TCP service
app/src/main/java/com/iljal/grblcontoller/service/GrblTcpSerialService.java
Machine controls
- Control panels
app/src/main/java/com/iljal/grblcontoller/ui - Jogging
app/src/main/java/com/iljal/grblcontoller/ui/JoggingTabFragment.java
G-code streaming
- File streamer
app/src/main/java/com/iljal/grblcontoller/service/FileStreamerIntentService.java - G-code commands
app/src/main/java/com/iljal/grblcontoller/model/GcodeCommand.java
GRBL protocol and state
- Serial handlers
app/src/main/java/com/iljal/grblcontoller/listeners/SerialCommunicationHandler.java - Bluetooth handler
app/src/main/java/com/iljal/grblcontoller/listeners/SerialBluetoothCommunicationHandler.java - Machine status
app/src/main/java/com/iljal/grblcontoller/listeners/MachineStatusListener.java - GRBL utilities
app/src/main/java/com/iljal/grblcontoller/util/GrblUtils.java - Event messages
app/src/main/java/com/iljal/grblcontoller/events
App interface and support
- Main activity
app/src/main/java/com/iljal/grblcontoller/GrblActivity.java - Preferences
app/src/main/java/com/iljal/grblcontoller/helpers/EnhancedSharedPreferences.java - Notifications
app/src/main/java/com/iljal/grblcontoller/helpers/NotificationHelper.java - Icon rendering
app/src/main/java/com/joanzapata/iconify/Iconify.java
Other components
- Operator
- GRBL machine
- G-code file
Connections 24
- Operator → Main activity: controls
- Main activity → Control panels: presents
app/src/main/java/com/iljal/grblcontoller/GrblActivity.java - Operator → Bluetooth service: connects via
- Operator → USB service: connects via
- Operator → TCP service: connects via
- Bluetooth service → Bluetooth handler: dispatches to
app/src/main/java/com/iljal/grblcontoller/service/GrblBluetoothSerialService.java - USB service → Serial handlers: dispatches to
- TCP service → Serial handlers: dispatches to
- GRBL machine → Serial services: exchanges serial data
- Serial services → Serial handlers: routes messages
- Serial handlers → GRBL utilities: parses with
app/src/main/java/com/iljal/grblcontoller/listeners/SerialCommunicationHandler.java - Serial handlers → Machine status: updates
app/src/main/java/com/iljal/grblcontoller/listeners/SerialCommunicationHandler.java - Serial handlers → Event messages: posts
app/src/main/java/com/iljal/grblcontoller/listeners/SerialCommunicationHandler.java - Operator → Jogging: jogs machine
- Jogging → GRBL machine: sends jog commands
- Operator → File streamer: starts file send
- G-code file → File streamer: provides G-code
- File streamer → G-code commands: creates commands
app/src/main/java/com/iljal/grblcontoller/service/FileStreamerIntentService.java - File streamer → Event messages: posts progress
app/src/main/java/com/iljal/grblcontoller/service/FileStreamerIntentService.java - Main activity → Preferences: reads settings
app/src/main/java/com/iljal/grblcontoller/GrblActivity.java - Main activity → Notifications: uses
app/src/main/java/com/iljal/grblcontoller/GrblActivity.java - File streamer → Notifications: notifies job state
app/src/main/java/com/iljal/grblcontoller/service/FileStreamerIntentService.java - Main activity → Icon rendering: renders icons
app/src/main/java/com/iljal/grblcontoller/GrblActivity.java - Bluetooth service → GRBL machine: sends commands