814a836c5a
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
108 lines
2.0 KiB
Protocol Buffer
108 lines
2.0 KiB
Protocol Buffer
syntax = "proto3";
|
|
option go_package = "github.com/antitbone/dwarfctl/proto;pb";
|
|
message ReqStartPanoramaByGrid {
|
|
}
|
|
|
|
message ReqStartPanoramaByEulerRange {
|
|
float yaw_range = 1;
|
|
float pitch_range = 2;
|
|
}
|
|
|
|
message ReqStartPanoramaStitchUpload {
|
|
uint64 resource_id = 1;
|
|
string user_id = 2;
|
|
int32 app_platform = 3;
|
|
string panorama_name = 4;
|
|
string ak = 5;
|
|
string sk = 6;
|
|
string token = 7;
|
|
string bucket = 8;
|
|
string bucket_prefix = 9;
|
|
string from = 10;
|
|
string env_type = 11;
|
|
}
|
|
|
|
message ReqStopPanorama {
|
|
}
|
|
|
|
message ReqStopPanoramaStitchUpload {
|
|
string user_id = 1;
|
|
}
|
|
|
|
message ReqGetPanoramaCurrentUploadState {
|
|
}
|
|
|
|
message ResGetPanoramaCurrentUploadState {
|
|
int32 code = 1;
|
|
string user_id = 2;
|
|
string busi_no = 3;
|
|
string panorama_name = 4;
|
|
string mac = 5;
|
|
uint32 total_files_num = 6;
|
|
uint32 compressed_files_num = 7;
|
|
uint64 total_size = 8;
|
|
uint64 uploaded_size = 9;
|
|
uint32 step = 10;
|
|
}
|
|
|
|
message ReqGetUploadPredict {
|
|
string panorama_name = 1;
|
|
}
|
|
|
|
message ResGetUploadPredict {
|
|
int32 code = 1;
|
|
string panorama_name = 2;
|
|
uint32 file_nums = 3;
|
|
string resolution = 4;
|
|
uint64 cloud_data_size = 5;
|
|
uint64 zip_data_size = 6;
|
|
uint64 app_zip_data_size = 7;
|
|
}
|
|
|
|
message PanoramaUploadParam {
|
|
string user_id = 1;
|
|
string busi_no = 2;
|
|
string panorama_name = 3;
|
|
string mac = 4;
|
|
uint32 total_files_num = 5;
|
|
uint32 compressed_files_num = 6;
|
|
uint64 total_size = 7;
|
|
uint64 uploaded_size = 8;
|
|
uint32 step = 9;
|
|
}
|
|
|
|
message ReqCompressPanorama {
|
|
string panorama_name = 1;
|
|
}
|
|
|
|
message ReqStopCompressPanorama {
|
|
}
|
|
|
|
message ReqStartPanoramaFraming {
|
|
}
|
|
|
|
message ReqResetPanoramaFraming {
|
|
}
|
|
|
|
message ReqStopPanoramaFraming {
|
|
}
|
|
|
|
message ReqStopPanoramaFramingAndStartGrid {
|
|
}
|
|
|
|
message ResStopPanoramaFraming {
|
|
int32 code = 1;
|
|
double centerX_degree_offset = 2;
|
|
double centerY_degree_offset = 3;
|
|
uint32 framing_rows = 4;
|
|
uint32 framing_cols = 5;
|
|
}
|
|
|
|
message ReqUpdatePanoramaFramingRect {
|
|
double norm_x_tl = 1;
|
|
double norm_y_tl = 2;
|
|
double norm_x_br = 3;
|
|
double norm_y_br = 4;
|
|
}
|
|
|