blob: 2a53e3e2b447a6cda93bff58a19a8f22dcc186a3 [file] [log] [blame]
Amit Ghosh09f28362020-06-12 21:52:19 +01001syntax = "proto3";
2
3option go_package = "github.com/opencord/device-management-interface/v3/go/dmi";
4package dmi;
5
6import "dmi/commons.proto";
7import "dmi/hw.proto";
8import "google/protobuf/timestamp.proto";
9
10// Management of Events and protos for encoding of Events
11
12enum EventIds {
13 EVENT_NAME_UNDEFINED = 0;
14
15 // Events from the Transceivers
16 EVENT_TRANSCEIVER_PLUG_OUT = 100;
17 EVENT_TRANSCEIVER_PLUG_IN = 101;
18 EVENT_TRANSCEIVER_VOLTAGE_ABOVE_THRESHOLD = 102;
19 EVENT_TRANSCEIVER_VOLTAGE_BELOW_THRESHOLD = 103;
20 EVENT_TRANSCEIVER_TEMPERATURE_ABOVE_THRESHOLD = 104;
21 EVENT_TRANSCEIVER_TEMPERATURE_BELOW_THRESHOLD = 105;
22 EVENT_TRANSCEIVER_CURRENT_ABOVE_THRESHOLD = 106;
23 EVENT_TRANSCEIVER_CURRENT_BELOW_THRESHOLD = 107;
24 EVENT_TRANSCEIVER_RX_POWER_ABOVE_THRESHOLD = 108;
25 EVENT_TRANSCEIVER_RX_POWER_BELOW_THRESHOLD = 109;
26 EVENT_TRANSCEIVER_TX_POWER_ABOVE_THRESHOLD = 110;
27 EVENT_TRANSCEIVER_TX_POWER_BELOW_THRESHOLD = 111;
28 EVENT_TRANSCEIVER_FAILURE = 112;
Amit Ghosh9d6658d2020-06-25 10:43:30 +010029 EVENT_TRANSCEIVER_VOLTAGE_ABOVE_THRESHOLD_RECOVERED = 113;
30 EVENT_TRANSCEIVER_VOLTAGE_BELOW_THRESHOLD_RECOVERED = 114;
31 EVENT_TRANSCEIVER_TEMPERATURE_ABOVE_THRESHOLD_RECOVERED = 115;
32 EVENT_TRANSCEIVER_TEMPERATURE_BELOW_THRESHOLD_RECOVERED = 116;
33 EVENT_TRANSCEIVER_CURRENT_ABOVE_THRESHOLD_RECOVERED = 117;
34 EVENT_TRANSCEIVER_CURRENT_BELOW_THRESHOLD_RECOVERED = 118;
35 EVENT_TRANSCEIVER_RX_POWER_ABOVE_THRESHOLD_RECOVERED = 119;
36 EVENT_TRANSCEIVER_RX_POWER_BELOW_THRESHOLD_RECOVERED = 120;
37 EVENT_TRANSCEIVER_TX_POWER_ABOVE_THRESHOLD_RECOVERED = 121;
38 EVENT_TRANSCEIVER_TX_POWER_BELOW_THRESHOLD_RECOVERED = 122;
39 EVENT_TRANSCEIVER_FAILURE_RECOVERED = 123;
Amit Ghosh09f28362020-06-12 21:52:19 +010040
41 // Events from the PSU
42 EVENT_PSU_PLUG_OUT = 200;
43 EVENT_PSU_PLUG_IN = 201;
44 EVENT_PSU_FAILURE = 202;
Amit Ghosh9d6658d2020-06-25 10:43:30 +010045 EVENT_PSU_FAILURE_RECOVERED = 203;
Amit Ghosh09f28362020-06-12 21:52:19 +010046
47 // Events for the Fans
48 EVENT_FAN_FAILURE = 300;
49 EVENT_FAN_PLUG_OUT = 301;
50 EVENT_FAN_PLUG_IN = 302;
Amit Ghosh9d6658d2020-06-25 10:43:30 +010051 EVENT_FAN_FAILURE_RECOVERED = 303;
Amit Ghosh09f28362020-06-12 21:52:19 +010052
53 // Events for the CPUs
54 EVENT_CPU_TEMPERATURE_ABOVE_CRITICAL = 400;
55 EVENT_CPU_TEMPERATURE_ABOVE_FATAL = 401;
Amit Ghosh9d6658d2020-06-25 10:43:30 +010056 EVENT_CPU_TEMPERATURE_ABOVE_CRITICAL_RECOVERED = 402;
57 EVENT_CPU_TEMPERATURE_ABOVE_FATAL_RECOVERED = 403;
Amit Ghosh09f28362020-06-12 21:52:19 +010058
59 // Events for the complete HW Device
60 EVENT_HW_DEVICE_RESET = 500;
61 EVENT_HW_DEVICE_TEMPERATURE_ABOVE_CRITICAL = 501;
62 EVENT_HW_DEVICE_TEMPERATURE_ABOVE_FATAL = 502;
Amit Ghosh9d6658d2020-06-25 10:43:30 +010063 EVENT_HW_DEVICE_TEMPERATURE_ABOVE_CRITICAL_RECOVERED = 503;
64 EVENT_HW_DEVICE_TEMPERATURE_ABOVE_FATAL_RECOVERED = 504;
Amit Ghosh09f28362020-06-12 21:52:19 +010065
66 // More to be added
67}
68
69message ValueType {
70 oneof val{
71 int64 int_val = 1;
72 uint64 uint_val = 2;
73 float float_val = 3;
74 }
75}
76
77message WaterMarks {
78 ValueType high = 1;
79 ValueType low = 2;
80}
81
82message Thresholds {
83 oneof threshold {
84 WaterMarks upper = 1;
85 WaterMarks lower = 2;
86 }
87}
88
89message ThresholdInformation {
90 ValueType observed_value = 1;
91 Thresholds thresholds = 2;
92}
93
94message EventCfg {
95 EventIds event_id = 1;
96 bool is_configured = 2;
97 // Optional threshold values, applicable only for some specific events
98 Thresholds thresholds = 3;
99}
100
101message EventsCfg {
102 repeated EventCfg items = 1;
103}
104
105message ListEventsResponse {
106 Status status = 1;
107 Reason reason = 2;
108 EventsCfg events = 3;
109}
110
111message EventsConfigurationRequest {
112 Uuid device_uuid = 1;
113 oneof operation {
114 EventsCfg changes = 2;
115 bool reset_to_default = 3;
116 }
117}
118
119message EventsConfigurationResponse {
120 Status status = 1;
121 Reason reason = 2;
122}
123
124message EventMetaData {
125 Uuid device_uuid = 1;
126 // uuid of the component
127 Uuid component_uuid = 2;
128 string component_name = 3;
129}
130
131// The Events are conveyed to external systems by submitting them on a kafka bus.
132// The topic to which are Events are submitted would be configured as startup
133// configuration of the components
134
135message Event {
136 EventMetaData event_metadata = 1;
137 EventIds event_id = 2;
138 google.protobuf.Timestamp raised_ts = 3;
139 // Optional threshold information for an event
140 ThresholdInformation threshold_info = 4;
141 // Any additional info regarding the event
142 string add_info = 5;
143}
144
145service NativeEventsManagementService {
146
147 // List the supported events for the passed device
148 rpc ListEvents(HardwareID) returns(ListEventsResponse);
149
150 // Updates the configuration of the list of events in the request
aghoshc301dcd2020-09-03 16:55:34 +0100151 // The default behavior of the device is to report all the supported events
Amit Ghosh09f28362020-06-12 21:52:19 +0100152 // This configuration is persisted across reboots of the device or the device manager
153 rpc UpdateEventsConfiguration(EventsConfigurationRequest) returns(EventsConfigurationResponse);
154}