first-fix

common/edge-api/pom.xml

@@ -0,0 +1,127 @@
+<!--
+
+    Copyright © 2016-2023 The Thingsboard Authors
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.thingsboard</groupId>
+        <version>0.6.2-SNAPSHOT</version>
+        <artifactId>common</artifactId>
+    </parent>
+    <groupId>org.thingsboard.common</groupId>
+    <artifactId>edge-api</artifactId>
+    <packaging>jar</packaging>
+
+    <name>Thingsboard Server Remote Edge wrapper</name>
+    <url>https://thingsboard.io</url>
+
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <main.dir>${basedir}/../..</main.dir>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.thingsboard.common</groupId>
+            <artifactId>data</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.thingsboard.common</groupId>
+            <artifactId>queue</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.thingsboard.common</groupId>
+            <artifactId>message</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.google.code.gson</groupId>
+            <artifactId>gson</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.slf4j</groupId>
+            <artifactId>slf4j-api</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.slf4j</groupId>
+            <artifactId>log4j-over-slf4j</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-core</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-classic</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-context</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.netty</groupId>
+            <artifactId>netty-all</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.netty</groupId>
+            <artifactId>netty-tcnative-boringssl-static</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.google.guava</groupId>
+            <artifactId>guava</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.grpc</groupId>
+            <artifactId>grpc-netty-shaded</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.grpc</groupId>
+            <artifactId>grpc-protobuf</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.grpc</groupId>
+            <artifactId>grpc-stub</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.google.protobuf</groupId>
+            <artifactId>protobuf-java</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.xolstice.maven.plugins</groupId>
+                <artifactId>protobuf-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
+    <distributionManagement>
+        <repository>
+            <id>thingsboard-repo-deploy</id>
+            <name>ThingsBoard Repo Deployment</name>
+            <url>https://repo.thingsboard.io/artifactory/libs-release-public</url>
+        </repository>
+    </distributionManagement>
+
+</project>

common/edge-api/src/main/java/org/thingsboard/edge/exception/EdgeConnectionException.java

@@ -0,0 +1,29 @@
+/**
+ * Copyright © 2016-2023 The Thingsboard Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.thingsboard.edge.exception;
+
+public class EdgeConnectionException extends RuntimeException {
+
+    private static final long serialVersionUID = -4372754681230555723L;
+
+    public EdgeConnectionException(String message) {
+        super(message);
+    }
+
+    public EdgeConnectionException(String message, Throwable cause) {
+        super(message, cause);
+    }
+}

common/edge-api/src/main/java/org/thingsboard/edge/rpc/EdgeGrpcClient.java

@@ -0,0 +1,257 @@
+/**
+ * Copyright © 2016-2023 The Thingsboard Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.thingsboard.edge.rpc;
+
+import io.grpc.ManagedChannel;
+import io.grpc.netty.shaded.io.grpc.netty.GrpcSslContexts;
+import io.grpc.netty.shaded.io.grpc.netty.NettyChannelBuilder;
+import io.grpc.netty.shaded.io.netty.handler.ssl.SslContextBuilder;
+import io.grpc.stub.StreamObserver;
+import lombok.Getter;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+import org.thingsboard.edge.exception.EdgeConnectionException;
+import org.thingsboard.server.common.data.ResourceUtils;
+import org.thingsboard.server.common.data.StringUtils;
+import org.thingsboard.server.gen.edge.v1.ConnectRequestMsg;
+import org.thingsboard.server.gen.edge.v1.ConnectResponseCode;
+import org.thingsboard.server.gen.edge.v1.ConnectResponseMsg;
+import org.thingsboard.server.gen.edge.v1.DownlinkMsg;
+import org.thingsboard.server.gen.edge.v1.DownlinkResponseMsg;
+import org.thingsboard.server.gen.edge.v1.EdgeConfiguration;
+import org.thingsboard.server.gen.edge.v1.EdgeRpcServiceGrpc;
+import org.thingsboard.server.gen.edge.v1.EdgeVersion;
+import org.thingsboard.server.gen.edge.v1.RequestMsg;
+import org.thingsboard.server.gen.edge.v1.RequestMsgType;
+import org.thingsboard.server.gen.edge.v1.ResponseMsg;
+import org.thingsboard.server.gen.edge.v1.SyncRequestMsg;
+import org.thingsboard.server.gen.edge.v1.UplinkMsg;
+import org.thingsboard.server.gen.edge.v1.UplinkResponseMsg;
+
+import javax.net.ssl.SSLException;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.locks.ReentrantLock;
+import java.util.function.Consumer;
+
+@Service
+@Slf4j
+public class EdgeGrpcClient implements EdgeRpcClient {
+
+    @Value("${cloud.rpc.host}")
+    private String rpcHost;
+    @Value("${cloud.rpc.port}")
+    private int rpcPort;
+    @Value("${cloud.rpc.timeout}")
+    private int timeoutSecs;
+    @Value("${cloud.rpc.keep_alive_time_sec:10}")
+    private int keepAliveTimeSec;
+    @Value("${cloud.rpc.keep_alive_timeout_sec:5}")
+    private int keepAliveTimeoutSec;
+    @Value("${cloud.rpc.ssl.enabled}")
+    private boolean sslEnabled;
+    @Value("${cloud.rpc.ssl.cert:}")
+    private String certResource;
+    @Value("${cloud.rpc.max_inbound_message_size:4194304}")
+    private int maxInboundMessageSize;
+    @Getter
+    private int serverMaxInboundMessageSize;
+
+    private ManagedChannel channel;
+
+    private StreamObserver<RequestMsg> inputStream;
+
+    private static final ReentrantLock uplinkMsgLock = new ReentrantLock();
+
+    @Override
+    public void connect(String edgeKey,
+                        String edgeSecret,
+                        Consumer<UplinkResponseMsg> onUplinkResponse,
+                        Consumer<EdgeConfiguration> onEdgeUpdate,
+                        Consumer<DownlinkMsg> onDownlink,
+                        Consumer<Exception> onError) {
+        NettyChannelBuilder builder = NettyChannelBuilder.forAddress(rpcHost, rpcPort)
+                .maxInboundMessageSize(maxInboundMessageSize)
+                .keepAliveTime(keepAliveTimeSec, TimeUnit.SECONDS)
+                .keepAliveTimeout(keepAliveTimeoutSec, TimeUnit.SECONDS)
+                .keepAliveWithoutCalls(true);
+        if (sslEnabled) {
+            try {
+                SslContextBuilder sslContextBuilder = GrpcSslContexts.forClient();
+                if (StringUtils.isNotEmpty(certResource)) {
+                    sslContextBuilder.trustManager(ResourceUtils.getInputStream(this, certResource));
+                }
+                builder.sslContext(sslContextBuilder.build());
+            } catch (SSLException e) {
+                log.error("Failed to initialize channel!", e);
+                throw new RuntimeException(e);
+            }
+        } else {
+            builder.usePlaintext();
+        }
+        channel = builder.build();
+        EdgeRpcServiceGrpc.EdgeRpcServiceStub stub = EdgeRpcServiceGrpc.newStub(channel);
+        log.info("[{}] Sending a connect request to the TB!", edgeKey);
+        this.inputStream = stub.withCompression("gzip").handleMsgs(initOutputStream(edgeKey, onUplinkResponse, onEdgeUpdate, onDownlink, onError));
+        this.inputStream.onNext(RequestMsg.newBuilder()
+                .setMsgType(RequestMsgType.CONNECT_RPC_MESSAGE)
+                .setConnectRequestMsg(ConnectRequestMsg.newBuilder()
+                        .setEdgeRoutingKey(edgeKey)
+                        .setEdgeSecret(edgeSecret)
+                        .setEdgeVersion(EdgeVersion.V_3_4_0)
+                        .setMaxInboundMessageSize(maxInboundMessageSize)
+                        .build())
+                .build());
+    }
+
+    private StreamObserver<ResponseMsg> initOutputStream(String edgeKey,
+                                                         Consumer<UplinkResponseMsg> onUplinkResponse,
+                                                         Consumer<EdgeConfiguration> onEdgeUpdate,
+                                                         Consumer<DownlinkMsg> onDownlink,
+                                                         Consumer<Exception> onError) {
+        return new StreamObserver<>() {
+            @Override
+            public void onNext(ResponseMsg responseMsg) {
+                if (responseMsg.hasConnectResponseMsg()) {
+                    ConnectResponseMsg connectResponseMsg = responseMsg.getConnectResponseMsg();
+                    if (connectResponseMsg.getResponseCode().equals(ConnectResponseCode.ACCEPTED)) {
+                        if (connectResponseMsg.hasMaxInboundMessageSize()) {
+                            log.debug("[{}] Server max inbound message size: {}", edgeKey, connectResponseMsg.getMaxInboundMessageSize());
+                            serverMaxInboundMessageSize = connectResponseMsg.getMaxInboundMessageSize();
+                        }
+                        log.info("[{}] Configuration received: {}", edgeKey, connectResponseMsg.getConfiguration());
+                        onEdgeUpdate.accept(connectResponseMsg.getConfiguration());
+                    } else {
+                        log.error("[{}] Failed to establish the connection! Code: {}. Error message: {}.", edgeKey, connectResponseMsg.getResponseCode(), connectResponseMsg.getErrorMsg());
+                        try {
+                            EdgeGrpcClient.this.disconnect(true);
+                        } catch (InterruptedException e) {
+                            log.error("[{}] Got interruption during disconnect!", edgeKey, e);
+                        }
+                        onError.accept(new EdgeConnectionException("Failed to establish the connection! Response code: " + connectResponseMsg.getResponseCode().name()));
+                    }
+                } else if (responseMsg.hasEdgeUpdateMsg()) {
+                    log.debug("[{}] Edge update message received {}", edgeKey, responseMsg.getEdgeUpdateMsg());
+                    onEdgeUpdate.accept(responseMsg.getEdgeUpdateMsg().getConfiguration());
+                } else if (responseMsg.hasUplinkResponseMsg()) {
+                    log.debug("[{}] Uplink response message received {}", edgeKey, responseMsg.getUplinkResponseMsg());
+                    onUplinkResponse.accept(responseMsg.getUplinkResponseMsg());
+                } else if (responseMsg.hasDownlinkMsg()) {
+                    log.debug("[{}] Downlink message received {}", edgeKey, responseMsg.getDownlinkMsg());
+                    onDownlink.accept(responseMsg.getDownlinkMsg());
+                }
+            }
+
+            @Override
+            public void onError(Throwable t) {
+                log.warn("[{}] Stream was terminated due to error:", edgeKey, t);
+                try {
+                    EdgeGrpcClient.this.disconnect(true);
+                } catch (InterruptedException e) {
+                    log.error("[{}] Got interruption during disconnect!", edgeKey, e);
+                }
+                onError.accept(new RuntimeException(t));
+            }
+
+            @Override
+            public void onCompleted() {
+                log.info("[{}] Stream was closed and completed successfully!", edgeKey);
+            }
+        };
+    }
+
+    @Override
+    public void disconnect(boolean onError) throws InterruptedException {
+        if (!onError) {
+            try {
+                if (inputStream != null) {
+                    inputStream.onCompleted();
+                }
+            } catch (Exception e) {
+                log.error("Exception during onCompleted", e);
+            }
+        }
+        if (channel != null) {
+            channel.shutdown();
+            int attempt = 0;
+            do {
+                try {
+                    channel.awaitTermination(timeoutSecs, TimeUnit.SECONDS);
+                } catch (Exception e) {
+                    log.error("Channel await termination was interrupted", e);
+                }
+                if (attempt > 5) {
+                    log.warn("We had reached maximum of termination attempts. Force closing channel");
+                    try {
+                        channel.shutdownNow();
+                    } catch (Exception e) {
+                        log.error("Exception during shutdownNow", e);
+                    }
+                    break;
+                }
+                attempt++;
+            } while (!channel.isTerminated());
+        }
+    }
+
+    @Override
+    public void sendUplinkMsg(UplinkMsg msg) {
+        uplinkMsgLock.lock();
+        try {
+            this.inputStream.onNext(RequestMsg.newBuilder()
+                    .setMsgType(RequestMsgType.UPLINK_RPC_MESSAGE)
+                    .setUplinkMsg(msg)
+                    .build());
+        } finally {
+            uplinkMsgLock.unlock();
+        }
+    }
+
+    @Override
+    public void sendSyncRequestMsg(boolean syncRequired) {
+        sendSyncRequestMsg(syncRequired, true);
+    }
+
+    @Override
+    public void sendSyncRequestMsg(boolean syncRequired, boolean fullSync) {
+        uplinkMsgLock.lock();
+        try {
+            SyncRequestMsg syncRequestMsg = SyncRequestMsg.newBuilder()
+                    .setSyncRequired(syncRequired)
+                    .setFullSync(fullSync)
+                    .build();
+            this.inputStream.onNext(RequestMsg.newBuilder()
+                    .setMsgType(RequestMsgType.SYNC_REQUEST_RPC_MESSAGE)
+                    .setSyncRequestMsg(syncRequestMsg)
+                    .build());
+        } finally {
+            uplinkMsgLock.unlock();
+        }
+    }
+
+    @Override
+    public void sendDownlinkResponseMsg(DownlinkResponseMsg downlinkResponseMsg) {
+        uplinkMsgLock.lock();
+        try {
+            this.inputStream.onNext(RequestMsg.newBuilder()
+                    .setMsgType(RequestMsgType.UPLINK_RPC_MESSAGE)
+                    .setDownlinkResponseMsg(downlinkResponseMsg)
+                    .build());
+        } finally {
+            uplinkMsgLock.unlock();
+        }
+    }
+}

common/edge-api/src/main/java/org/thingsboard/edge/rpc/EdgeRpcClient.java

@@ -0,0 +1,46 @@
+/**
+ * Copyright © 2016-2023 The Thingsboard Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.thingsboard.edge.rpc;
+
+import org.thingsboard.server.gen.edge.v1.DownlinkMsg;
+import org.thingsboard.server.gen.edge.v1.DownlinkResponseMsg;
+import org.thingsboard.server.gen.edge.v1.EdgeConfiguration;
+import org.thingsboard.server.gen.edge.v1.UplinkMsg;
+import org.thingsboard.server.gen.edge.v1.UplinkResponseMsg;
+
+import java.util.function.Consumer;
+
+public interface EdgeRpcClient {
+
+    void connect(String integrationKey,
+                 String integrationSecret,
+                 Consumer<UplinkResponseMsg> onUplinkResponse,
+                 Consumer<EdgeConfiguration> onEdgeUpdate,
+                 Consumer<DownlinkMsg> onDownlink,
+                 Consumer<Exception> onError);
+
+    void disconnect(boolean onError) throws InterruptedException;
+
+    void sendSyncRequestMsg(boolean syncRequired);
+
+    void sendSyncRequestMsg(boolean syncRequired, boolean fullSync);
+
+    void sendUplinkMsg(UplinkMsg uplinkMsg);
+
+    void sendDownlinkResponseMsg(DownlinkResponseMsg downlinkResponseMsg);
+
+    int getServerMaxInboundMessageSize();
+}

common/edge-api/src/main/proto/edge.proto

@@ -0,0 +1,588 @@
+/**
+ * Copyright © 2016-2023 The Thingsboard Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+syntax = "proto3";
+
+option java_package = "org.thingsboard.server.gen.edge.v1";
+option java_multiple_files = true;
+option java_outer_classname = "EdgeProtos";
+
+import "queue.proto";
+
+package edge;
+
+// Interface exported by the ThingsBoard Edge Transport.
+service EdgeRpcService {
+
+  rpc handleMsgs(stream RequestMsg) returns (stream ResponseMsg) {}
+
+}
+
+enum EdgeVersion {
+  V_3_3_0 = 0;
+  V_3_3_3 = 1;
+  V_3_4_0 = 2;
+}
+
+/**
+ * Data Structures;
+ */
+message RequestMsg {
+  RequestMsgType msgType = 1;
+  ConnectRequestMsg connectRequestMsg = 2;
+  UplinkMsg uplinkMsg = 3;
+  DownlinkResponseMsg downlinkResponseMsg = 4;
+  SyncRequestMsg syncRequestMsg = 5;
+}
+
+message ResponseMsg {
+  ConnectResponseMsg connectResponseMsg = 1;
+  UplinkResponseMsg uplinkResponseMsg = 2;
+  DownlinkMsg downlinkMsg = 3;
+  EdgeUpdateMsg edgeUpdateMsg = 4;
+}
+
+enum RequestMsgType {
+  CONNECT_RPC_MESSAGE = 0;
+  UPLINK_RPC_MESSAGE = 1;
+  SYNC_REQUEST_RPC_MESSAGE = 2;
+}
+
+message EdgeUpdateMsg {
+  EdgeConfiguration configuration = 1;
+}
+
+message ConnectRequestMsg {
+  string edgeRoutingKey = 1;
+  string edgeSecret = 2;
+  EdgeVersion edgeVersion = 3;
+  optional int32 maxInboundMessageSize = 4;
+}
+
+enum ConnectResponseCode {
+  ACCEPTED = 0;
+  BAD_CREDENTIALS = 1;
+  SERVER_UNAVAILABLE = 2;
+}
+
+message ConnectResponseMsg {
+  ConnectResponseCode responseCode = 1;
+  string errorMsg = 2;
+  EdgeConfiguration configuration = 3;
+  optional int32 maxInboundMessageSize = 4;
+}
+
+message SyncRequestMsg {
+  bool syncRequired = 1;
+  optional bool fullSync = 2;
+}
+
+message SyncCompletedMsg {
+}
+
+message EdgeConfiguration {
+  int64 edgeIdMSB = 1;
+  int64 edgeIdLSB = 2;
+  int64 tenantIdMSB = 3;
+  int64 tenantIdLSB = 4;
+  int64 customerIdMSB = 5;
+  int64 customerIdLSB = 6;
+  string name = 7;
+  string type = 8;
+  string routingKey = 9;
+  string secret = 10;
+  string additionalInfo = 11;
+  string cloudType = 12;
+}
+
+enum UpdateMsgType {
+  ENTITY_CREATED_RPC_MESSAGE = 0;
+  ENTITY_UPDATED_RPC_MESSAGE = 1;
+  ENTITY_DELETED_RPC_MESSAGE = 2;
+  ALARM_ACK_RPC_MESSAGE = 3;
+  ALARM_CLEAR_RPC_MESSAGE = 4;
+  ENTITY_MERGE_RPC_MESSAGE = 5; // deprecated
+}
+
+message EntityDataProto {
+  int64 entityIdMSB = 1;
+  int64 entityIdLSB = 2;
+  string entityType = 3;
+  transport.PostTelemetryMsg postTelemetryMsg = 4;
+  transport.PostAttributeMsg postAttributesMsg = 5;
+  transport.PostAttributeMsg attributesUpdatedMsg = 6;
+  string postAttributeScope = 7;
+  AttributeDeleteMsg attributeDeleteMsg = 8;
+}
+
+message AttributeDeleteMsg {
+  string scope = 1;
+  repeated string attributeNames = 2;
+}
+
+message RuleChainUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  string name = 4;
+  optional int64 firstRuleNodeIdMSB = 5;
+  optional int64 firstRuleNodeIdLSB = 6;
+  bool root = 7;
+  bool debugMode = 8;
+  string configuration = 9;
+}
+
+message RuleChainMetadataUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 ruleChainIdMSB = 2;
+  int64 ruleChainIdLSB = 3;
+  int32 firstNodeIndex = 4;
+  repeated RuleNodeProto nodes = 5;
+  repeated NodeConnectionInfoProto connections = 6;
+  repeated RuleChainConnectionInfoProto ruleChainConnections = 7;
+}
+
+message RuleNodeProto {
+  int64 idMSB = 1;
+  int64 idLSB = 2;
+  string type = 3;
+  string name = 4;
+  bool debugMode = 5;
+  string configuration = 6;
+  string additionalInfo = 7;
+}
+
+message NodeConnectionInfoProto {
+  int32 fromIndex = 1;
+  int32 toIndex = 2;
+  string type = 3;
+}
+
+message RuleChainConnectionInfoProto {
+  int32 fromIndex = 1;
+  int64 targetRuleChainIdMSB = 2;
+  int64 targetRuleChainIdLSB = 3;
+  string type = 4;
+  string additionalInfo = 5;
+}
+
+message DashboardUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  optional int64 customerIdMSB = 4;
+  optional int64 customerIdLSB = 5;
+  string title = 6;
+  string configuration = 7;
+  optional string assignedCustomers = 8;
+}
+
+message DeviceUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  optional int64 customerIdMSB = 4;
+  optional int64 customerIdLSB = 5;
+  optional int64 deviceProfileIdMSB = 6;
+  optional int64 deviceProfileIdLSB = 7;
+  string name = 8;
+  string type = 9;
+  optional string label = 10;
+  optional string additionalInfo = 11;
+  optional string conflictName = 12; // deprecated
+  optional int64 firmwareIdMSB = 13;
+  optional int64 firmwareIdLSB = 14;
+  optional bytes deviceDataBytes = 15;
+  optional int64 softwareIdMSB = 16;
+  optional int64 softwareIdLSB = 17;
+  optional int64 entityGroupIdMSB = 18;
+  optional int64 entityGroupIdLSB = 19;
+}
+
+message DeviceProfileUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  string name = 4;
+  optional string description = 5;
+  bool default = 6;
+  string type = 7;
+  optional string transportType = 8;
+  optional string provisionType = 9;
+  int64 defaultRuleChainIdMSB = 10;
+  int64 defaultRuleChainIdLSB = 11;
+  string defaultQueueName = 12;
+  bytes profileDataBytes = 13;
+  optional string provisionDeviceKey = 14;
+  optional bytes image = 15;
+  optional int64 firmwareIdMSB = 16;
+  optional int64 firmwareIdLSB = 17;
+  optional int64 softwareIdMSB = 18;
+  optional int64 softwareIdLSB = 19;
+  optional int64 defaultDashboardIdMSB = 20;
+  optional int64 defaultDashboardIdLSB = 21;
+}
+
+message AssetProfileUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  string name = 4;
+  optional string description = 5;
+  bool default = 6;
+  int64 defaultRuleChainIdMSB = 7;
+  int64 defaultRuleChainIdLSB = 8;
+  int64 defaultDashboardIdMSB = 9;
+  int64 defaultDashboardIdLSB = 10;
+  optional string defaultQueueName = 11;
+  optional bytes image = 12;
+}
+
+message DeviceCredentialsUpdateMsg {
+  int64 deviceIdMSB = 1;
+  int64 deviceIdLSB = 2;
+  string credentialsType = 3;
+  string credentialsId = 4;
+  optional string credentialsValue = 5;
+}
+
+message AssetUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  optional int64 customerIdMSB = 4;
+  optional int64 customerIdLSB = 5;
+  string name = 6;
+  string type = 7;
+  optional string label = 8;
+  optional string additionalInfo = 9;
+  optional int64 assetProfileIdMSB = 10;
+  optional int64 assetProfileIdLSB = 11;
+}
+
+message EntityViewUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  optional int64 customerIdMSB = 4;
+  optional int64 customerIdLSB = 5;
+  string name = 6;
+  string type = 7;
+  int64 entityIdMSB = 8;
+  int64 entityIdLSB = 9;
+  EdgeEntityType entityType = 10;
+  optional string additionalInfo = 11;
+}
+
+message AlarmUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  string name = 4;
+  string type = 5;
+  string originatorType = 6;
+  string originatorName = 7;
+  string severity = 8;
+  string status = 9;
+  int64 startTs = 10;
+  int64 endTs = 11;
+  int64 ackTs = 12;
+  int64 clearTs = 13;
+  string details = 14;
+  bool propagate = 15;
+  bool propagateToOwner = 16;
+  bool propagateToTenant = 17;
+}
+
+message CustomerUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  string title = 4;
+  optional string country = 5;
+  optional string state = 6;
+  optional string city = 7;
+  optional string address = 8;
+  optional string address2 = 9;
+  optional string zip = 10;
+  optional string phone = 11;
+  optional string email = 12;
+  optional string additionalInfo = 13;
+}
+
+message RelationUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 fromIdMSB = 2;
+  int64 fromIdLSB = 3;
+  string fromEntityType = 4;
+  int64 toIdMSB = 5;
+  int64 toIdLSB = 6;
+  string toEntityType = 7;
+  string type = 8;
+  optional string typeGroup = 9;
+  string additionalInfo = 10;
+}
+
+message UserUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  optional int64 customerIdMSB = 4;
+  optional int64 customerIdLSB = 5;
+  string email = 6;
+  string authority = 7;
+  optional string firstName = 8;
+  optional string lastName = 9;
+  optional string additionalInfo = 10;
+}
+
+message WidgetsBundleUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  string title = 4;
+  string alias = 5;
+  optional bytes image = 6;
+  bool isSystem = 7;
+  optional string description = 8;
+}
+
+message WidgetTypeUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  optional string bundleAlias = 4;
+  optional string alias = 5;
+  optional string name = 6;
+  optional string descriptorJson = 7;
+  bool isSystem = 8;
+  optional string image = 9;
+  optional string description = 10;
+}
+
+message AdminSettingsUpdateMsg {
+  bool isSystem = 1;
+  string key = 2;
+  string jsonValue = 3;
+}
+
+message UserCredentialsUpdateMsg {
+  int64 userIdMSB = 1;
+  int64 userIdLSB = 2;
+  bool enabled = 3;
+  string password = 4;
+}
+
+message RuleChainMetadataRequestMsg {
+  int64 ruleChainIdMSB = 1;
+  int64 ruleChainIdLSB = 2;
+}
+
+message AttributesRequestMsg {
+  int64 entityIdMSB = 1;
+  int64 entityIdLSB = 2;
+  string entityType = 3;
+  string scope = 4;
+}
+
+message RelationRequestMsg {
+  int64 entityIdMSB = 1;
+  int64 entityIdLSB = 2;
+  string entityType = 3;
+}
+
+message UserCredentialsRequestMsg {
+  int64 userIdMSB = 1;
+  int64 userIdLSB = 2;
+}
+
+message DeviceCredentialsRequestMsg {
+  int64 deviceIdMSB = 1;
+  int64 deviceIdLSB = 2;
+}
+
+// deprecated
+message DeviceProfileDevicesRequestMsg {
+  int64 deviceProfileIdMSB = 1;
+  int64 deviceProfileIdLSB = 2;
+}
+
+message WidgetBundleTypesRequestMsg {
+  int64 widgetBundleIdMSB = 1;
+  int64 widgetBundleIdLSB = 2;
+}
+
+message EntityViewsRequestMsg {
+  int64 entityIdMSB = 1;
+  int64 entityIdLSB = 2;
+  string entityType = 3;
+}
+
+message SchedulerEventUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  optional int64 customerIdMSB = 4;
+  optional int64 customerIdLSB = 5;
+  string name = 6;
+  string type = 7;
+  string schedule = 8;
+  string configuration = 9;
+}
+
+message DeviceRpcCallMsg {
+  int64 deviceIdMSB = 1;
+  int64 deviceIdLSB = 2;
+  int64 requestUuidMSB = 3;
+  int64 requestUuidLSB = 4;
+  int32 requestId = 5;
+  int64 expirationTime = 6;
+  bool oneway = 7;
+  RpcRequestMsg requestMsg = 8;
+  RpcResponseMsg responseMsg = 9;
+  optional bool persisted = 10;
+  optional int32 retries = 11;
+  optional string additionalInfo = 12;
+  optional string serviceId = 13;
+  optional string sessionId = 14;
+}
+
+message RpcRequestMsg {
+  string method = 1;
+  string params = 2;
+}
+
+message RpcResponseMsg {
+  string response = 1;
+  string error = 2;
+}
+
+enum EdgeEntityType {
+  DEVICE = 0;
+  ASSET = 1;
+}
+
+message OtaPackageUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  int64 deviceProfileIdMSB = 4;
+  int64 deviceProfileIdLSB = 5;
+  string type = 6;
+  string title = 7;
+  string version = 8;
+  string tag = 9;
+  optional string url = 10;
+  optional string fileName = 11;
+  optional string contentType = 12;
+  optional string checksumAlgorithm = 13;
+  optional string checksum = 14;
+  optional int64 dataSize = 15;
+  optional bytes data = 16;
+  optional string additionalInfo = 17;
+}
+
+message QueueUpdateMsg {
+  UpdateMsgType msgType = 1;
+  int64 idMSB = 2;
+  int64 idLSB = 3;
+  int64 tenantIdMSB = 4;
+  int64 tenantIdLSB = 5;
+  string name = 6;
+  string topic = 7;
+  int32 pollInterval = 8;
+  int32 partitions = 9;
+  bool consumerPerPartition = 10;
+  int64 packProcessingTimeout = 11;
+  SubmitStrategyProto submitStrategy = 12;
+  ProcessingStrategyProto processingStrategy = 13;
+}
+
+message SubmitStrategyProto {
+  string type = 1;
+  int32 batchSize = 2;
+}
+
+message ProcessingStrategyProto {
+  string type = 1;
+  int32 retries = 2;
+  double failurePercentage = 3;
+  int64 pauseBetweenRetries = 4;
+  int64 maxPauseBetweenRetries = 5;
+}
+
+/**
+ * Main Messages;
+ */
+
+message UplinkMsg {
+  int32 uplinkMsgId = 1;
+  repeated EntityDataProto entityData = 2;
+  repeated DeviceUpdateMsg deviceUpdateMsg = 3;
+  repeated DeviceCredentialsUpdateMsg deviceCredentialsUpdateMsg = 4;
+  repeated AlarmUpdateMsg alarmUpdateMsg = 5;
+  repeated RelationUpdateMsg relationUpdateMsg = 6;
+  repeated RuleChainMetadataRequestMsg ruleChainMetadataRequestMsg = 7;
+  repeated AttributesRequestMsg attributesRequestMsg = 8;
+  repeated RelationRequestMsg relationRequestMsg = 9;
+  repeated UserCredentialsRequestMsg userCredentialsRequestMsg = 10;
+  repeated DeviceCredentialsRequestMsg deviceCredentialsRequestMsg = 11;
+  repeated DeviceRpcCallMsg deviceRpcCallMsg = 12;
+  repeated DeviceProfileDevicesRequestMsg deviceProfileDevicesRequestMsg = 13; // deprecated
+  repeated WidgetBundleTypesRequestMsg widgetBundleTypesRequestMsg = 14;
+  repeated EntityViewsRequestMsg entityViewsRequestMsg = 15;
+}
+
+message UplinkResponseMsg {
+  bool success = 1;
+  string errorMsg = 2;
+  int32 uplinkMsgId = 3;
+}
+
+message DownlinkResponseMsg {
+  bool success = 1;
+  string errorMsg = 2;
+  int32 downlinkMsgId = 3;
+}
+
+message DownlinkMsg {
+  int32 downlinkMsgId = 1;
+  SyncCompletedMsg syncCompletedMsg = 2;
+  repeated EntityDataProto entityData = 3;
+  repeated DeviceCredentialsRequestMsg deviceCredentialsRequestMsg = 4;
+  repeated DeviceUpdateMsg deviceUpdateMsg = 5;
+  repeated DeviceProfileUpdateMsg deviceProfileUpdateMsg = 6;
+  repeated DeviceCredentialsUpdateMsg deviceCredentialsUpdateMsg = 7;
+  repeated RuleChainUpdateMsg ruleChainUpdateMsg = 8;
+  repeated RuleChainMetadataUpdateMsg ruleChainMetadataUpdateMsg = 9;
+  repeated DashboardUpdateMsg dashboardUpdateMsg = 10;
+  repeated AssetUpdateMsg assetUpdateMsg = 11;
+  repeated EntityViewUpdateMsg entityViewUpdateMsg = 12;
+  repeated AlarmUpdateMsg alarmUpdateMsg = 13;
+  repeated UserUpdateMsg userUpdateMsg = 14;
+  repeated UserCredentialsUpdateMsg userCredentialsUpdateMsg = 15;
+  repeated CustomerUpdateMsg customerUpdateMsg = 16;
+  repeated RelationUpdateMsg relationUpdateMsg = 17;
+  repeated WidgetsBundleUpdateMsg widgetsBundleUpdateMsg = 18;
+  repeated WidgetTypeUpdateMsg widgetTypeUpdateMsg = 19;
+  repeated AdminSettingsUpdateMsg adminSettingsUpdateMsg = 20;
+  repeated DeviceRpcCallMsg deviceRpcCallMsg = 21;
+  repeated OtaPackageUpdateMsg otaPackageUpdateMsg = 22;
+  repeated QueueUpdateMsg queueUpdateMsg = 23;
+  repeated AssetProfileUpdateMsg assetProfileUpdateMsg = 24;
+  EdgeConfiguration edgeConfiguration = 25;
+  repeated SchedulerEventUpdateMsg schedulerEventUpdateMsg = 26;
+}
+