benthos_atm900.proto

Go to the documentation of this file.

syntax = "proto2";
import "goby/protobuf/option_extensions.proto";
import "goby/acomms/protobuf/driver_base.proto";
import "goby/acomms/protobuf/modem_message.proto";
import "dccl/option_extensions.proto";
 
package goby.acomms.benthos.protobuf;
 
message Config
{
    optional bool factory_reset = 1 [
        default = false,
        (goby.field).description =
            "Reset modem to factory defaults prior to applying "
            "configuration values specified in 'config' (i.e. load values "
            "from ffs/factcfg.ini)"
    ];
    optional string config_load = 2
        [(goby.field).description =
             "Path to config file to load on the modem, e.g. "
             "'ffs/standard.ini'"];
    repeated string config = 3
        [(goby.field).description =
             "Strings of configuration values to set in CLAM format, for "
             "example \"@AcRspTmOut=10.0\""];
    optional int32 start_timeout = 5 [
        default = 20,
        (goby.field).description =
            "Number of seconds to initialize the modem before giving up"
    ];
    optional uint32 max_frame_size = 6 [
        default = 64,
        (goby.field).description =
            "Enforce maximum packet size for all rates (also used if "
            "max_frame_bytes not set in ModemTransmission)"
    ];
}
 
// 1441
extend goby.acomms.protobuf.DriverConfig
{
    optional Config config = 1441;
}
 
// subset of goby.acomms.protobuf.ModemTransmission
message BenthosHeader
{
    option (dccl.msg).id = 0;
    option (dccl.msg).max_bytes = 5;
    option (dccl.msg).codec_version = 3;
 
    required goby.acomms.protobuf.ModemTransmission.TransmissionType type = 1;
 
    optional bool ack_requested = 3;
    repeated int32 acked_frame = 4 [
        (dccl.field).min = 0,
        (dccl.field).max = 0x7,
        (dccl.field).max_repeat = 8
    ];
}
 
enum TransmissionType
{
    BASE_TYPE = 0;
    BENTHOS_TWO_WAY_PING = 1;  // modem 1 interrogates modem 2; modem 2 replies
                               // and modem 1 computes one way travel time
}
 
message ReceiveStatistics
{
    option (dccl.msg).unit_system = "si";
 
    enum CRCState
    {
        CRC_PASS = 1;
        CRC_FAIL = 2;
    }
 
    required CRCState crc = 1;
    optional float multipath_delay = 2
        [(dccl.field).units.base_dimensions = "T"];
    optional float snr = 3;
    optional float relative_speed = 4
        [(dccl.field).units.base_dimensions = "LT^-1"];
    optional float auto_gain_control = 5;
    optional int32 corrected_channel_error = 6;
}
 
message RangingReply
{
    required double one_way_travel_time = 1
        [(dccl.field).units.unit = "si::second"];
}
 
message Transmission
{
    optional TransmissionType type = 1 [
        (goby.field).description =
            "Type of transmission if base `type` == DRIVER_SPECIFIC",
        default = BASE_TYPE
    ];
    optional ReceiveStatistics receive_stat = 2;
    optional RangingReply ranging_reply = 3;    
}
 
extend goby.acomms.protobuf.ModemTransmission
{
    optional Transmission transmission = 1401;
}