Zack Williams | 5220966 | 2019-02-07 10:15:31 -0700 | [diff] [blame] | 1 | syntax = "proto3"; |
| 2 | |
| 3 | option go_package = "github.com/opencord/voltha-go/protos/voltha"; |
| 4 | |
| 5 | package voltha; |
| 6 | |
| 7 | import "google/protobuf/any.proto"; |
| 8 | import "voltha_protos/common.proto"; |
| 9 | import "voltha_protos/meta.proto"; |
| 10 | import "voltha_protos/openflow_13.proto"; |
| 11 | import "voltha_protos/yang_options.proto"; |
| 12 | |
| 13 | // A Device Type |
| 14 | message DeviceType { |
| 15 | |
| 16 | // Unique name for the device type |
| 17 | string id = 1; |
| 18 | |
| 19 | // Unique venor id for the device type applicable to ONU |
| 20 | // 4 bytes of vendor id from ONU serial number |
| 21 | string vendor_id = 5; |
| 22 | |
| 23 | repeated string vendor_ids = 6; |
| 24 | |
| 25 | // Name of the adapter that handles device type |
| 26 | string adapter = 2; |
| 27 | |
| 28 | // Capabilitities |
| 29 | |
| 30 | bool accepts_bulk_flow_update = 3; |
| 31 | bool accepts_add_remove_flow_updates = 4; |
| 32 | bool accepts_direct_logical_flows_update = 7; |
| 33 | |
| 34 | } |
| 35 | |
| 36 | // A plurality of device types |
| 37 | message DeviceTypes { |
| 38 | repeated DeviceType items = 1; |
| 39 | } |
| 40 | |
| 41 | message PmConfig { |
| 42 | enum PmType { |
| 43 | COUNTER = 0; |
| 44 | GAUGE = 1; |
| 45 | STATE = 2; |
| 46 | CONTEXT = 3; |
| 47 | } |
| 48 | string name = 1; |
| 49 | PmType type = 2; |
| 50 | bool enabled = 3; // Whether or not this metric makes it to Kafka |
| 51 | uint32 sample_freq = 4; // Sample rate in 10ths of a second |
| 52 | } |
| 53 | |
| 54 | message PmGroupConfig { |
| 55 | string group_name = 1; |
| 56 | uint32 group_freq = 2; // Frequency applicable to the grop |
| 57 | bool enabled = 3; // Enable/disable group level only |
| 58 | repeated PmConfig metrics = 4; |
| 59 | } |
| 60 | |
| 61 | message PmConfigs { |
| 62 | string id = 1; // To work around a chameleon POST bug |
| 63 | uint32 default_freq = 2; // Default sample rate |
| 64 | // Forces group names and group semantics |
| 65 | bool grouped = 3 [(access) = READ_ONLY]; |
| 66 | // Allows Pm to set an individual sample frequency |
| 67 | bool freq_override = 4 [(access) = READ_ONLY]; |
| 68 | repeated PmGroupConfig groups = 5; // The groups if grouped is true |
| 69 | repeated PmConfig metrics = 6; // The metrics themselves if grouped is false. |
| 70 | } |
| 71 | |
| 72 | // Describes instance of software image on the device |
| 73 | message Image { |
| 74 | string name = 1; // software patch name |
| 75 | string version = 2; // version of software |
| 76 | string hash = 3; // md5 hash |
| 77 | string install_datetime = 4; // combined date and time expressed in UTC. |
| 78 | // use ISO 8601 format for date and time |
| 79 | |
| 80 | // The active software image is one that is currently loaded and executing |
| 81 | // in the ONU or circuit pack. Under normal operation, one software image |
| 82 | // is always active while the other is inactive. Under no circumstances are |
| 83 | // both software images allowed to be active at the same time |
| 84 | bool is_active = 5; // True if the image is active |
| 85 | |
| 86 | // The committed software image is loaded and executed upon reboot of the |
| 87 | // ONU and/or circuit pack. During normal operation, one software image is |
| 88 | // always committed, while the other is uncommitted. |
| 89 | bool is_committed = 6; // True if the image is committed |
| 90 | |
| 91 | // A software image is valid if it has been verified to be an executable |
| 92 | // code image. The verification mechanism is not subject to standardization; |
| 93 | // however, it should include at least a data integrity (e.g., CRC) check of |
| 94 | // the entire code image. |
| 95 | bool is_valid = 7; // True if the image is valid |
| 96 | } |
| 97 | |
| 98 | // List of software on the device |
| 99 | message Images { |
| 100 | repeated Image image = 1; |
| 101 | } |
| 102 | |
| 103 | message ImageDownload { |
| 104 | option (yang_child_rule) = MOVE_TO_PARENT_LEVEL; |
| 105 | |
| 106 | enum ImageDownloadState { |
| 107 | DOWNLOAD_UNKNOWN = 0; |
| 108 | DOWNLOAD_SUCCEEDED = 1; |
| 109 | DOWNLOAD_REQUESTED = 2; |
| 110 | DOWNLOAD_STARTED = 3; |
| 111 | DOWNLOAD_FAILED = 4; |
| 112 | DOWNLOAD_UNSUPPORTED = 5; |
| 113 | DOWNLOAD_CANCELLED = 6; |
| 114 | } |
| 115 | |
| 116 | enum ImageDownloadFailureReason { |
| 117 | NO_ERROR = 0; |
| 118 | INVALID_URL = 1; |
| 119 | DEVICE_BUSY = 2; |
| 120 | INSUFFICIENT_SPACE = 3; |
| 121 | UNKNOWN_ERROR = 4; |
| 122 | CANCELLED = 5; |
| 123 | } |
| 124 | |
| 125 | enum ImageActivateState { |
| 126 | IMAGE_UNKNOWN = 0; |
| 127 | IMAGE_INACTIVE = 1; |
| 128 | IMAGE_ACTIVATE = 2; |
| 129 | IMAGE_ACTIVE = 3; |
| 130 | IMAGE_REVERT = 4; |
| 131 | } |
| 132 | |
| 133 | // Device Identifier |
| 134 | string id = 1; |
| 135 | |
| 136 | // Image unique identifier |
| 137 | string name = 2; |
| 138 | |
| 139 | // URL where the image is available |
| 140 | // should include username password |
| 141 | string url = 3; |
| 142 | |
| 143 | // CRC of the image to be verified aginst |
| 144 | uint32 crc = 4; |
| 145 | |
| 146 | // Download state |
| 147 | ImageDownloadState download_state = 5; |
| 148 | |
| 149 | // Downloaded version |
| 150 | string image_version = 6; |
| 151 | |
| 152 | // Bytes downloaded |
| 153 | uint32 downloaded_bytes = 7; |
| 154 | |
| 155 | // Download failure reason |
| 156 | ImageDownloadFailureReason reason= 8; |
| 157 | |
| 158 | // Additional info |
| 159 | string additional_info = 9; |
| 160 | |
| 161 | // Save current configuration |
| 162 | bool save_config = 10; |
| 163 | |
| 164 | // Image local location |
| 165 | string local_dir = 11; |
| 166 | |
| 167 | // Image activation state |
| 168 | ImageActivateState image_state = 12; |
| 169 | |
| 170 | // Image file size |
| 171 | uint32 file_size = 13; |
| 172 | } |
| 173 | |
| 174 | message ImageDownloads { |
| 175 | repeated ImageDownload items = 2; |
| 176 | } |
| 177 | |
| 178 | message Port { |
| 179 | option (voltha.yang_child_rule) = MOVE_TO_PARENT_LEVEL; |
| 180 | |
| 181 | enum PortType { |
| 182 | UNKNOWN = 0; |
| 183 | ETHERNET_NNI = 1; |
| 184 | ETHERNET_UNI = 2; |
| 185 | PON_OLT = 3; |
| 186 | PON_ONU = 4; |
| 187 | VENET_OLT = 5; |
| 188 | VENET_ONU = 6; |
| 189 | } |
| 190 | |
| 191 | uint32 port_no = 1; // Device-unique port number |
| 192 | |
| 193 | string label = 2; // Arbitrary port label |
| 194 | |
| 195 | PortType type = 3; // Type of port |
| 196 | |
| 197 | AdminState.AdminState admin_state = 5; |
| 198 | |
| 199 | OperStatus.OperStatus oper_status = 6; |
| 200 | |
| 201 | string device_id = 7; // Unique .id of device that owns this port |
| 202 | |
| 203 | message PeerPort { |
| 204 | string device_id = 1; |
| 205 | uint32 port_no = 2; |
| 206 | } |
| 207 | repeated PeerPort peers = 8; |
| 208 | |
| 209 | fixed64 rx_packets = 9; |
| 210 | fixed64 rx_bytes = 10; |
| 211 | fixed64 rx_errors = 11; |
| 212 | fixed64 tx_packets = 12; |
| 213 | fixed64 tx_bytes = 13; |
| 214 | fixed64 tx_errors = 14; |
| 215 | |
| 216 | } |
| 217 | |
| 218 | message Ports { |
| 219 | repeated Port items = 1; |
| 220 | } |
| 221 | |
| 222 | // A Physical Device instance |
| 223 | message Device { |
| 224 | option (voltha.yang_child_rule) = MOVE_TO_PARENT_LEVEL; |
| 225 | |
| 226 | // Voltha's device identifier |
| 227 | string id = 1 [(access) = READ_ONLY]; |
| 228 | |
| 229 | // Device type, refers to one of the registered device types |
| 230 | string type = 2 [(access) = READ_ONLY]; |
| 231 | |
| 232 | // Is this device a root device. Each logical switch has one root |
| 233 | // device that is associated with the logical flow switch. |
| 234 | bool root = 3 [(access) = READ_ONLY]; |
| 235 | |
| 236 | // Parent device id, in the device tree (for a root device, the parent_id |
| 237 | // is the logical_device.id) |
| 238 | string parent_id = 4 [(access) = READ_ONLY]; |
| 239 | uint32 parent_port_no = 20 [(access) = READ_ONLY]; |
| 240 | |
| 241 | // Vendor, version, serial number, etc. |
| 242 | string vendor = 5 [(access) = READ_ONLY]; |
| 243 | string model = 6 [(access) = READ_ONLY]; |
| 244 | string hardware_version = 7 [(access) = READ_ONLY]; |
| 245 | string firmware_version = 8 [(access) = READ_ONLY]; |
| 246 | // List of software on the device |
| 247 | Images images = 9 [(access) = READ_ONLY]; |
| 248 | string serial_number = 10 [(access) = READ_ONLY]; |
| 249 | string vendor_id = 24 [(access) = READ_ONLY]; |
| 250 | |
| 251 | // Addapter that takes care of device |
| 252 | string adapter = 11 [(access) = READ_ONLY]; |
| 253 | |
| 254 | // Device contact on vlan (if 0, no vlan) |
| 255 | uint32 vlan = 12; |
| 256 | |
| 257 | message ProxyAddress { |
| 258 | string device_id = 1; // Which device to use as proxy to this device |
| 259 | string device_type = 2; // The device type of the proxy device to use as the adapter name |
| 260 | uint32 channel_id = 3; // Sub-address within proxy |
| 261 | uint32 channel_group_id = 4; // Channel Group index |
| 262 | string channel_termination = 5; // Channel Termination name |
| 263 | uint32 onu_id = 6; // onu identifier; optional |
| 264 | uint32 onu_session_id = 7; // session identifier for the ONU; optional |
| 265 | }; |
| 266 | |
| 267 | oneof address { |
| 268 | // Device contact MAC address (format: "xx:xx:xx:xx:xx:xx") |
| 269 | string mac_address = 13; |
| 270 | |
| 271 | // Device contact IPv4 address (format: "a.b.c.d" or can use hostname too) |
| 272 | string ipv4_address = 14; |
| 273 | |
| 274 | // Device contact IPv6 address using the canonical string form |
| 275 | // ("xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx") |
| 276 | string ipv6_address = 15; |
| 277 | |
| 278 | string host_and_port = 21; |
| 279 | |
| 280 | }; |
| 281 | string extra_args = 23; // Used to pass additional device specific arguments |
| 282 | |
| 283 | ProxyAddress proxy_address = 19; |
| 284 | |
| 285 | AdminState.AdminState admin_state = 16; |
| 286 | |
| 287 | OperStatus.OperStatus oper_status = 17 [(access) = READ_ONLY]; |
| 288 | |
| 289 | string reason = 22 [(access) = READ_ONLY]; // Used in FAILED state |
| 290 | |
| 291 | ConnectStatus.ConnectStatus connect_status = 18 [(access) = READ_ONLY]; |
| 292 | |
| 293 | // TODO additional common attribute here |
| 294 | |
| 295 | // Device type specific attributes |
| 296 | google.protobuf.Any custom = 64; |
| 297 | |
| 298 | repeated Port ports = 128 [(child_node) = {key: "port_no"}]; |
| 299 | openflow_13.Flows flows = 129 [(child_node) = {}]; |
| 300 | openflow_13.FlowGroups flow_groups = 130 [(child_node) = {}]; |
| 301 | // PmConfigs will eventually converted to a child node of the |
| 302 | // device to falicitata callbacks and to simplify manipulation. |
| 303 | PmConfigs pm_configs = 131 [(child_node) = {}]; |
| 304 | |
| 305 | repeated ImageDownload image_downloads = 133 [(child_node) = {key: "name"}]; |
| 306 | } |
| 307 | |
| 308 | message Devices { |
| 309 | repeated Device items = 1; |
| 310 | } |
| 311 | |
| 312 | message SimulateAlarmRequest { |
| 313 | enum OperationType { |
| 314 | RAISE = 0; |
| 315 | CLEAR = 1; |
| 316 | } |
| 317 | // Device Identifier |
| 318 | string id = 1; |
| 319 | string indicator = 2; |
| 320 | string intf_id = 3; |
| 321 | string port_type_name = 4; |
| 322 | string onu_device_id = 5; |
| 323 | int32 inverse_bit_error_rate = 6; |
| 324 | int32 drift = 7; |
| 325 | int32 new_eqd = 8; |
| 326 | string onu_serial_number = 9; |
| 327 | OperationType operation = 10; |
| 328 | } |