blob: 238742061ce48492fb0cfeab3293ee8685d7e8e6 [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 {
amit.ghoshae473032021-01-10 11:59:10 +0100106 enum Reason {
107 UNDEFINED_REASON = 0;
108 UNKNOWN_DEVICE = 1;
109 INTERNAL_ERROR = 2;
110 }
Amit Ghosh09f28362020-06-12 21:52:19 +0100111 Status status = 1;
112 Reason reason = 2;
113 EventsCfg events = 3;
114}
115
116message EventsConfigurationRequest {
117 Uuid device_uuid = 1;
118 oneof operation {
119 EventsCfg changes = 2;
120 bool reset_to_default = 3;
121 }
122}
123
124message EventsConfigurationResponse {
amit.ghoshae473032021-01-10 11:59:10 +0100125 enum Reason {
126 UNDEFINED_REASON = 0;
127 UNKNOWN_DEVICE = 1;
128 INTERNAL_ERROR = 2;
129 INVALID_CONFIG = 3;
130 }
Amit Ghosh09f28362020-06-12 21:52:19 +0100131 Status status = 1;
132 Reason reason = 2;
133}
134
135message EventMetaData {
136 Uuid device_uuid = 1;
137 // uuid of the component
138 Uuid component_uuid = 2;
139 string component_name = 3;
140}
141
142// The Events are conveyed to external systems by submitting them on a kafka bus.
143// The topic to which are Events are submitted would be configured as startup
144// configuration of the components
145
146message Event {
147 EventMetaData event_metadata = 1;
148 EventIds event_id = 2;
149 google.protobuf.Timestamp raised_ts = 3;
150 // Optional threshold information for an event
151 ThresholdInformation threshold_info = 4;
152 // Any additional info regarding the event
153 string add_info = 5;
154}
155
156service NativeEventsManagementService {
157
158 // List the supported events for the passed device
159 rpc ListEvents(HardwareID) returns(ListEventsResponse);
160
161 // Updates the configuration of the list of events in the request
aghoshc301dcd2020-09-03 16:55:34 +0100162 // The default behavior of the device is to report all the supported events
Amit Ghosh09f28362020-06-12 21:52:19 +0100163 // This configuration is persisted across reboots of the device or the device manager
164 rpc UpdateEventsConfiguration(EventsConfigurationRequest) returns(EventsConfigurationResponse);
165}