Modeled coverage

src/service/mobile_config.proto

@@ -95,6 +95,7 @@ enum admin_key_role {
 enum network_key_role {
   mobile_carrier = 0;
   mobile_router = 1;
+  mobile_pcs = 2;
 }
 
 message authorization_verify_req_v1 {

src/service/poc_mobile.proto

@@ -42,6 +42,9 @@ message cell_heartbeat_req_v1 {
   string cbsd_id = 9;
 
   bytes signature = 10;
+
+  // Last known coverage object UUID
+  bytes coverage_object = 11;
 }
 
 message cell_heartbeat_resp_v1 { string id = 1; }
@@ -80,6 +83,42 @@ message subscriber_location_ingest_report_v1 {
   subscriber_location_req_v1 report = 2;
 }
 
+enum signal_level {
+  NO = 0;
+  LOW = 1;
+  MEDIUM = 2;
+  HIGH = 3;
+}
+
+// Radio signal level and power in the h3 hex.
+message radio_hex_signal_level {
+  // H3 hex tile covered by the radio
+  string location = 1;
+  signal_level signal_level = 2;
+  // Signal power of the radio in dBm (decibel-milliwatts)
+  double signal_power = 3;
+}
+
+message coverage_object_req_v1 {
+  bytes pub_key = 1;
+  bytes uuid = 2;
+  string cbsd_id = 3;
+  // Timestamp in seconds since the unix epoch indicating the start of coverage
+  uint64 coverage_claim_time = 4;
+  repeated radio_hex_signal_level coverage = 5;
+  bool indoor = 6;
+  bytes signature = 7;
+}
+
+message coverage_object_resp_v1 { string id = 1; }
+
+// Coverage object report output by ingestor, tagged with received_timestamp
+message coverage_object_ingest_report_v1 {
+  // Timestamp in milliseconds since unix epoch
+  uint64 received_timestamp = 1;
+  coverage_object_req_v1 report = 2;
+}
+
 service poc_mobile {
   rpc submit_speedtest(speedtest_req_v1) returns (speedtest_resp_v1);
   rpc submit_cell_heartbeat(cell_heartbeat_req_v1)
@@ -88,6 +127,8 @@ service poc_mobile {
       returns (data_transfer_session_resp_v1);
   rpc submit_subscriber_location(subscriber_location_req_v1)
       returns (subscriber_location_resp_v1);
+  rpc submit_coverage_object(coverage_object_req_v1)
+      returns (coverage_object_resp_v1);
 }
 
 message file_info {
@@ -99,13 +140,30 @@ message file_info {
 
 message processed_files { repeated file_info files = 1; }
 
+message coverage_object {
+  bytes pub_key = 1;
+  bytes uuid = 2;
+  string cbsd_id = 3;
+  uint64 coverage_claim_time = 4;
+  repeated radio_hex_signal_level coverage = 5;
+  bool indoor = 6;
+  coverage_object_validity validity = 7;
+}
+
+enum coverage_object_validity {
+  coverage_object_validity_valid = 0;
+  coverage_object_validity_invalid_pub_key = 1;
+}
+
 message heartbeat {
   string cbsd_id = 1;
   bytes pub_key = 2;
   float reward_multiplier = 3;
   uint64 timestamp = 4;
   cell_type cell_type = 5;
   heartbeat_validity validity = 6;
+  // UUID of the coverage object associated with this heartbeat
+  bytes coverage_object = 7;
 }
 
 enum heartbeat_validity {
@@ -114,8 +172,16 @@ enum heartbeat_validity {
   heartbeat_validity_heartbeat_outside_range = 2;
   heartbeat_validity_bad_cbsd_id = 3;
   heartbeat_validity_not_operational = 4;
-  /// Gateway not found on the blockchain
+  // Gateway not found on the blockchain
   heartbeat_validity_gateway_not_found = 5;
+  // No such coverage object with that UUID
+  heartbeat_validity_no_such_coverage_object = 6;
+  // Invalid coverage object UUID (cbsd_id did not match)
+  heartbeat_validity_bad_coverage_object = 7;
+  // Invalid latitude and/or longitude
+  heartbeat_validity_invalid_lat_lon = 8;
+  // Heartbeat is too distant from the coverage object's hex coverage
+  heartbeat_validity_too_far_from_coverage = 9;
 }
 
 message speedtest_avg {