#protobuf #proto #definition #energyleaf

energyleaf-proto

Protobuf definitions for Energyleaf

10 releases (4 stable)

1.2.0 Aug 23, 2024
1.1.1 Aug 12, 2024
1.0.1 Jun 27, 2024
0.2.3 Jun 27, 2024
0.1.6 Jun 4, 2024

#2274 in Encoding

Download history 151/week @ 2024-06-01 327/week @ 2024-06-08 16/week @ 2024-06-15 265/week @ 2024-06-22 55/week @ 2024-06-29 28/week @ 2024-07-06 81/week @ 2024-07-27 106/week @ 2024-08-10 96/week @ 2024-08-17 40/week @ 2024-08-24

248 downloads per month

MIT license

5KB

Energyleaf Proto - Rust

Contains the protobuf files to interact with the energyleaf backend.

Installation

Install energyleaf-proto

  cargo add energyleaf-proto

Protocol

syntax = "proto3";

package energyleaf;

enum SensorType {
  ANALOG_ELECTRICITY = 0;
  DIGITAL_ELECTRICITY = 1;
  GAS = 2;
  WATER = 3;
}

message TokenRequest {
  string client_id = 1;
  SensorType type = 2;
  optional bool need_script = 3;
}

message TokenResponse {
  optional string access_token = 1;
  optional uint32 expires_in =
      2;             // in seconds (look documentation for correct value)
  uint32 status = 3; // In range of 200-299 correct, else bad
  optional string status_message = 4;
  optional string script = 5;
  optional uint32 analog_rotation_per_kwh = 6;
}

message SensorDataRequest {
  string access_token = 1;
  SensorType type = 2;
  double value = 3;                  // kWh total
  optional double value_current = 4; // W currently
  optional double value_out = 5;     // kWh total out (e.g. pv)
  optional uint64 timestamp = 6;
}

message SensorDataResponse {
  uint32 status = 1; // In range of 200-299 correct, else bad
  optional string status_message = 2;
}

message ScriptAcceptedRequest { string access_token = 1; }

message ScriptAcceptedResponse {
  uint32 status = 1;
  optional string status_message = 2;
}

Dependencies

~0.2–2MB
~27K SLoC