接口清单

message DeviceStatusReport {
    message DeviceStatus {
        sint32 app_sessions = 1; // APP 会话数
    }
    Header header = 1;
    uint32 modeling_state = 2; // 统一状态码
    string device_sn = 3;      // 设备序列号
    string project_id = 4;     // 工程名
    string time_zone = 5;      // 当前时区
    bool init_ready = 6;       // 0：未初始化，1：已初始化
    SystemStatus system_status = 7;
    RtkStatus rtk_status = 8;
    DeviceStatus device_status = 9;
}

message DeviceControlRequest {
    Header header = 1;
    Application.ActionCmd action = 2;
}

message DeviceControlResponse {
    Header header = 1;
    Application.ActionCmd action = 2;
    Error error = 15;
}

message DeviceConfigRequest {
    message TimeConfig {
        sint64 time_secs = 1; // 时间戳（秒精度）
        string time_zone = 2; // 时区（如 "Asia/Shanghai"）
    }
    message MainStorageConfig {
        sint32 storage_type = 1; // 0：内部存储，1：TF 卡，2：USB 盘
    }
    Header header = 1;
    optional TimeConfig time_config = 4;
    optional MainStorageConfig main_storage_config = 8;
}

message ModelingRequest {
    Header header = 1;
    Application.ActionCmd action = 2;    // 支持 AC_START / AC_STOP
    string project_name = 3;             // 自定义工程名
    Modeling.RecordMode record_mode = 4; // RM_CALC / RM_RECORD / RM_RECORD_CALC
    Modeling.ScanMode scan_mode = 5;     // SM_PCL / SM_LCC / SM_PORTRAIT
    Modeling.MountType mount_type = 6;   // MT_HAND / MT_CAR / MT_UAV / MT_BACKPACK
    string pre_project_id = 7;           // 前序工程 ID（后续版本的续扫功能）
    Modeling.AssistMode assist_mode = 8; // 扫描辅助模式 AM_GUIDED / AM_VISUAL
}

message ModelingReport {
    message ScanStatus {
        float move_distance = 1; // 行进距离
        float move_speed = 2;    // 移动速度
        sint64 scan_time = 3;    // 扫描时长（秒）
    }
    Header header = 1;
    sint32 pgo_progress = 2; // 扫描结束后数据处理进度（0~100）
    ScanStatus scan_status = 3;
}

message ControlPointRequest {
    Header header = 1;
    Application.ActionCmd action = 2; // 仅支持 AC_ADD / AC_REMOVE / AC_UPDATE
    sint32 id = 3;                    // 控制点 ID
    sint32 type = 4;                  // 类型（0：设备，1：对中杆，100：旧版）
    string label = 5;                 // 控制点标签
    sint32 height = 6;                // 基点高度（单位：mm）
}

message ProjectListRequest {
    Header header = 1;
    // 仅支持 AC_LIST_ALL_PROJECTS / AC_MODIFY_PROJECT_LABELS / AC_DELETE_PROJECTS
    Application.ActionCmd action = 2;
    optional string id = 3;
    optional string tag_name = 4;
    repeated string id_list = 5; // 批量删除多个工程
}

message DataUnpackRequest {
    enum DataSource {
        XBIN_DATA = 0; // xbin 数据
    }
    Header header = 1;
    string project_name = 2;           // 工程名
    DataSource data_source = 3;        // 数据源
    repeated string data_topics = 4;   // 数据话题（不指定则默认解包全部）
    optional string data_ouputdir = 5; // 输出目录名（相对工程目录）
}