Files
dwarf-go/analysis/protos/Astro.proto
Jacquin Antoine 814a836c5a 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
2026-07-12 15:18:56 +02:00

369 lines
6.0 KiB
Protocol Buffer

// source: astro.proto
syntax = "proto3";
message ReqStartCalibration {
double lon = 1;
double lat = 2;
}
message ReqStopCalibration {
}
message ReqGotoDSO {
double ra = 1;
double dec = 2;
string target_name = 3;
bool goto_only = 4;
}
message ReqGotoSolarSystem {
int32 index = 1;
double lon = 2;
double lat = 3;
string target_name = 4;
bool force_start = 5;
}
message ResGotoSolarSystem {
int32 code = 1;
ReqGotoSolarSystem req = 2;
}
message ReqStopGoto {
}
message ReqCaptureRawLiveStacking {
int32 ir_index = 1;
bool force_start = 2;
}
message ReqStopCaptureRawLiveStacking {
}
message ReqFastStopCaptureRawLiveStacking {
}
message ReqCheckDarkFrame {
}
message ResCheckDarkFrame {
int32 progress = 1;
int32 code = 2;
}
message ReqCaptureDarkFrame {
int32 reshoot = 1;
}
message ReqStopCaptureDarkFrame {
}
message ReqCaptureDarkFrameWithParam {
int32 exp_index = 1;
int32 gain_index = 2;
int32 bin_index = 3;
int32 cap_size = 4;
}
message ReqStopCaptureDarkFrameWithParam {
}
message ReqGetDarkFrameList {
}
message ResGetDarkFrameInfo {
// oneof _temperature
int32 exp_index = 1;
int32 gain_index = 2;
int32 bin_index = 3;
string exp_name = 4;
string gain_name = 5;
string bin_name = 6;
int32 temperature = 7;
}
message ResGetDarkFrameInfoList {
int32 code = 1;
repeated ResGetDarkFrameInfo results = 2;
}
message ReqDelDarkFrame {
int32 exp_index = 1;
int32 gain_index = 2;
int32 bin_index = 3;
int32 temp_value = 4;
}
message ReqDelDarkFrameList {
repeated ReqDelDarkFrame dark_list = 1;
}
message ResDelDarkFrameList {
int32 code = 1;
}
message ReqGoLive {
}
message ReqTrackSpecialTarget {
int32 index = 1;
double lon = 2;
double lat = 3;
}
message ReqStopTrackSpecialTarget {
}
message ReqOneClickGotoDSO {
double ra = 1;
double dec = 2;
string target_name = 3;
double lon = 4;
double lat = 5;
int32 shooting_mode = 6;
bool goto_only = 7;
}
message ResOneClickGoto {
int32 step = 1;
int32 code = 2;
bool all_end = 3;
}
message ReqOneClickGotoSolarSystem {
int32 index = 1;
double lon = 2;
double lat = 3;
string target_name = 4;
int32 shooting_mode = 5;
bool force_start = 6;
}
message ResOneClickGotoSolarSystem {
int32 step = 1;
int32 code = 2;
bool all_end = 3;
ReqOneClickGotoSolarSystem req = 4;
}
message ReqStopOneClickGoto {
}
message ReqCaptureWideRawLiveStacking {
bool force_start = 1;
}
message ReqStopCaptureWideRawLiveStacking {
}
message ReqFastStopCaptureWideRawLiveStacking {
}
message ReqStartEqSolving {
double lon = 1;
double lat = 2;
}
message ResStartEqSolving {
double azi_err = 1;
double alt_err = 2;
int32 code = 3;
}
message ReqStopEqSolving {
}
message ReqStartAiEnhance {
}
message ReqStopAiEnhance {
}
message ReqStartMosaic {
int32 horizontal_scale = 1;
int32 vertical_scale = 2;
int32 rotation = 3;
int32 ir_index = 4;
bool force_start = 5;
}
message ReqStartMakeFitsThumb {
string src_dir = 1;
}
message ReqStopMakeFitsThumb {
}
message ResMakeFitsThumb {
int32 code = 1;
string src_dir = 2;
}
message MakeFitsThumbTaskParam {
string src_dir = 1;
}
message ReqIsImageStackable {
repeated string src_dirs = 1;
}
message ResIsImageStackable {
int32 code = 1;
repeated ResGetDarkFrameInfo need_dark_frame_info = 2;
}
message ReqStartRepostprocess {
repeated string src_dirs = 1;
}
message ReqStopRepostprocess {
}
message ResRepostprocess {
int32 code = 1;
string result_dir = 2;
}
message RepostprocessTaskParam {
string result_dir = 1;
}
message ReqGetAstroShootingTime {
int32 exp_index = 1;
int32 horizontal_scale = 2;
int32 vertical_scale = 3;
int32 rotation = 4;
int32 cam_id = 5;
int32 shooting_mode = 6;
}
message ResGetAstroShootingTime {
enum AstroMode {
NORMAL = 0;
MOSAIC = 1;
}
int32 code = 1;
int32 shooting_time = 2;
int32 cam_id = 3;
ResGetAstroShootingTime.AstroMode astro_mode = 4;
int32 shooting_mode = 5;
}
message ReqGetCaliFrameList {
int32 camera_type = 1;
int32 cali_frame_type = 2;
}
message CaliFrameInfo {
// oneof _filter_type
// oneof _info_id
// oneof _temp_value
string exp_name = 1;
int32 gain = 2;
int32 resolution = 3;
int32 camera_type = 4;
int32 progress = 5;
int32 cali_frame_type = 6;
int32 filter_type = 7;
int32 info_id = 8;
int32 temp_value = 9;
}
message ResGetCaliFrameList {
int32 code = 1;
repeated CaliFrameInfo list = 2;
int32 camera_type = 3;
int32 cali_frame_type = 4;
}
message ReqDelCaliFrameList {
repeated int32 info_ids = 1;
}
message ReqCaptureCaliFrame {
// oneof _filter_type
int32 exp_index = 1;
int32 gain = 2;
int32 resolution = 3;
int32 cap_size = 4;
int32 camera_type = 5;
int32 cali_frame_type = 6;
int32 filter_type = 7;
int32 scene_type = 8;
}
message ReqStopCaptureCaliFrame {
int32 camera_type = 1;
}
message CaptureCaliFrameTaskParam {
int32 camera_type = 1;
int32 cali_frame_type = 2;
}
message ReqGetQuickSetList {
int32 camera_type = 1;
}
message QuikSetInfo {
string exp_name = 1;
int32 exp_index = 2;
int32 gain = 3;
int32 resolution = 4;
int32 camera_type = 5;
string info_id = 6;
}
message ResGetQuikSetList {
int32 code = 1;
repeated QuikSetInfo quick_set_list = 2;
int32 camera_type = 3;
}
message ReqSetQuickSet {
string info_id = 1;
}
message ResSetQuickSet {
int32 code = 1;
string info_id = 2;
}
message ReqOneClickShooting {
}
message ResAstroShooting {
// oneof _exp_name
// oneof _gain
// oneof _resolution
// oneof _filter_type
// oneof _temp_threshold
int32 code = 1;
string exp_name = 2;
int32 gain = 3;
int32 resolution = 4;
int32 filter_type = 5;
int32 temp_threshold = 6;
}
message ReqStartSkyTargetFinder {
double lon = 1;
double lat = 2;
bool force_restart = 3;
int32 scene_type = 4;
}
message ResStartSkyTargetFinder {
int32 code = 1;
double zenith_azi = 2;
double zenith_alt = 3;
double center_azi = 4;
double center_alt = 5;
double center_roll = 6;
int32 scene_type = 7;
}
message ReqStopSkyTargetFinder {
}