Reverse-engineer DWARF II telescope API and build open-source Go client
Complete reverse-engineering of the DWARFLAB Android app (v3.4.0) protocol
and implementation of a working CLI tool to control DWARF II telescopes.
Analysis (from APK decompilation with jadx):
- Extracted 17 protobuf definitions (382 messages) from embedded descriptors
- Mapped all 323 WebSocket command IDs across 16 modules
- Documented the full protocol: BLE discovery, WebSocket control (port 9900),
RTSP preview, WsPacket envelope (proto v2.3)
- Documented the Android UI structure (screens, navigation, shooting modes)
- Key discovery: telescope responds with type=3 (reply), not type=1 (response),
and several commands are fire-and-forget (RGB, camera open/close)
dwarfctl Go client:
- Protobuf bindings generated from extracted .proto files (397 messages)
- WebSocket transport layer with request-response matching and notification fan-out
- Typed API covering cameras, motors, astrophotography, focus, tracking, system, power
- Cobra CLI with 30+ subcommands and --debug traffic logging
- 57 unit tests (transport round-trip, command routing, proto encoding)
- Validated on real hardware: state, photo, motor slew (all directions/speeds),
focus, RGB, time/location sync all confirmed working
💘 Generated with Crush
Assisted-by: Crush:glm-5.2
This commit is contained in:
51
dwarfctl/proto/base.proto
Normal file
51
dwarfctl/proto/base.proto
Normal file
@ -0,0 +1,51 @@
|
||||
syntax = "proto3";
|
||||
option go_package = "github.com/antitbone/dwarfctl/proto;pb";
|
||||
enum WsMajorVersion {
|
||||
WS_MAJOR_VERSION_UNKNOWN = 0;
|
||||
WS_MAJOR_VERSION_NUMBER = 2;
|
||||
}
|
||||
|
||||
enum WsMinorVersion {
|
||||
WS_MINOR_VERSION_UNKNOWN = 0;
|
||||
WS_MINOR_VERSION_NUMBER = 3;
|
||||
}
|
||||
|
||||
message WsPacket {
|
||||
uint32 major_version = 1;
|
||||
uint32 minor_version = 2;
|
||||
uint32 device_id = 3;
|
||||
uint32 module_id = 4;
|
||||
uint32 cmd = 5;
|
||||
uint32 type = 6;
|
||||
bytes data = 7;
|
||||
string client_id = 8;
|
||||
}
|
||||
|
||||
message ComResponse {
|
||||
int32 code = 1;
|
||||
}
|
||||
|
||||
message ComResWithInt {
|
||||
int32 value = 1;
|
||||
int32 code = 2;
|
||||
}
|
||||
|
||||
message ComResWithDouble {
|
||||
double value = 1;
|
||||
int32 code = 2;
|
||||
}
|
||||
|
||||
message ComResWithString {
|
||||
string str = 1;
|
||||
int32 code = 2;
|
||||
}
|
||||
|
||||
message CommonParam {
|
||||
bool hasAuto = 1;
|
||||
int32 auto_mode = 2;
|
||||
int32 id = 3;
|
||||
int32 mode_index = 4;
|
||||
int32 index = 5;
|
||||
double continue_value = 6;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user