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
203 lines
3.2 KiB
Protocol Buffer
203 lines
3.2 KiB
Protocol Buffer
syntax = "proto3";
|
|
option go_package = "github.com/antitbone/dwarfctl/proto;pb";
|
|
enum VocalType {
|
|
VT_UNKNOWN = 0;
|
|
VT_PING = 1;
|
|
VT_ECHO = 2;
|
|
}
|
|
|
|
message ReqGetconfig {
|
|
int32 cmd = 1;
|
|
string ble_psd = 2;
|
|
string client_id = 3;
|
|
}
|
|
|
|
message ReqAp {
|
|
int32 cmd = 1;
|
|
int32 wifi_type = 2;
|
|
int32 auto_start = 3;
|
|
int32 country_list = 4;
|
|
string country = 5;
|
|
string ble_psd = 6;
|
|
string client_id = 7;
|
|
bool force_restart = 8;
|
|
}
|
|
|
|
message ReqSta {
|
|
int32 cmd = 1;
|
|
int32 auto_start = 2;
|
|
string ble_psd = 3;
|
|
string ssid = 4;
|
|
string psd = 5;
|
|
string client_id = 6;
|
|
}
|
|
|
|
message ReqSetblewifi {
|
|
int32 cmd = 1;
|
|
int32 mode = 2;
|
|
string ble_psd = 3;
|
|
string value = 4;
|
|
string client_id = 5;
|
|
}
|
|
|
|
message ReqReset {
|
|
int32 cmd = 1;
|
|
string client_id = 2;
|
|
}
|
|
|
|
message ReqGetwifilist {
|
|
int32 cmd = 1;
|
|
string client_id = 2;
|
|
}
|
|
|
|
message ReqGetsysteminfo {
|
|
int32 cmd = 1;
|
|
string client_id = 2;
|
|
}
|
|
|
|
message ReqCheckFile {
|
|
int32 cmd = 1;
|
|
string file_path = 2;
|
|
string md5 = 3;
|
|
}
|
|
|
|
message ResCommon {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
}
|
|
|
|
message ResGetconfig {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
int32 state = 3;
|
|
int32 wifi_mode = 4;
|
|
int32 ap_mode = 5;
|
|
int32 auto_start = 6;
|
|
int32 ap_country_list = 7;
|
|
string ssid = 8;
|
|
string psd = 9;
|
|
string ip = 10;
|
|
string ap_country = 11;
|
|
}
|
|
|
|
message ResAp {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
int32 mode = 3;
|
|
string ssid = 4;
|
|
string psd = 5;
|
|
}
|
|
|
|
message ResSta {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
string ssid = 3;
|
|
string psd = 4;
|
|
string ip = 5;
|
|
}
|
|
|
|
message ResSetblewifi {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
int32 mode = 3;
|
|
string value = 4;
|
|
}
|
|
|
|
message ResReset {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
}
|
|
|
|
message WifiInfo {
|
|
int32 signal_level = 1;
|
|
string ssid = 2;
|
|
string security_capability = 3;
|
|
}
|
|
|
|
message ResWifilist {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
repeated string ssid = 4;
|
|
repeated WifiInfo wifi_info_list = 5;
|
|
}
|
|
|
|
message ResGetsysteminfo {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
int32 protocol_version = 3;
|
|
string device = 4;
|
|
string mac_address = 5;
|
|
string dwarf_ota_version = 6;
|
|
}
|
|
|
|
message ResReceiveDataError {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
}
|
|
|
|
message ResCheckFile {
|
|
int32 cmd = 1;
|
|
int32 code = 2;
|
|
}
|
|
|
|
message ComDwarfMsg {
|
|
VocalType vocaltype = 1;
|
|
}
|
|
|
|
message DwarfPing {
|
|
VocalType vocaltype = 1;
|
|
uint64 timestamp = 2;
|
|
bytes magic = 3;
|
|
repeated bytes vocals = 4;
|
|
repeated bytes mutes = 5;
|
|
}
|
|
|
|
message StationModel {
|
|
uint32 family = 1;
|
|
uint32 revision = 2;
|
|
}
|
|
|
|
message NifAP {
|
|
// oneof _ipv6
|
|
string ifname = 1;
|
|
int32 mode = 2;
|
|
string country_code = 3;
|
|
string ssid = 4;
|
|
string sec = 5;
|
|
string psw = 6;
|
|
bytes ipv4 = 7;
|
|
bytes ipv6 = 8;
|
|
}
|
|
|
|
message NifSTA {
|
|
// oneof _ssid
|
|
// oneof _psw
|
|
// oneof _rssi
|
|
// oneof _ipv4
|
|
// oneof _ipv6
|
|
string ifname = 1;
|
|
string ssid = 2;
|
|
string psw = 3;
|
|
int32 rssi = 4;
|
|
bytes ipv4 = 5;
|
|
bytes ipv6 = 6;
|
|
}
|
|
|
|
message DwarfEcho {
|
|
VocalType vocaltype = 1;
|
|
uint64 timestamp = 2;
|
|
bytes magic = 3;
|
|
uint64 ts_ping = 4;
|
|
bytes mac_address = 5;
|
|
StationModel model = 6;
|
|
string sn = 7;
|
|
string name = 8;
|
|
string psw = 9;
|
|
string fw_version = 10;
|
|
string ws_scheme = 11;
|
|
uint32 session = 12;
|
|
NifAP ap = 13;
|
|
NifSTA sta = 14;
|
|
}
|
|
|