Connect a Device to Sensgreen
Connecting a device to our platform is your gateway to accessing real-time data, making data-driven decisions, and improving your building's sustainability.
Supported Integration Methods
We offer various methods for connecting your devices to the Sensgreen platform. Each method is designed to suit different IoT networks and device types. Explore the integration options below:
Sensgreen LoRaWAN Network Server: Ideal for LoRaWAN devices, this method simplifies device registration and management.
IoT Networks (The Things Network, Thingpark Community): Leverage existing IoT networks for easy device connectivity.
MQTT: Use the MQTT protocol for seamless device communication.
HTTP: Connect devices via HTTP for straightforward data transfer.
Data Processing Workflow
When you connect your device to the Sensgreen Smart Building Platform, you're enabling a streamlined data processing workflow that involves several essential steps to make the most out of your data.
1. Payload Parsing
Data Ingestion: Your device sends data to the Sensgreen platform in its raw format. This data typically includes vital information about your building's environment, such as temperature, humidity, occupancy, and more.
Payload Parsing: The first stop for your data is the payload parser. This essential component deciphers the raw data, extracting meaningful information. It interprets the data's structure and converts it into a format that the platform can understand and work with.
2. Data Storage
Once parsed, the data is securely stored in the Sensgreen Database. This database serves as the central repository for all your building's data, offering scalability, reliability, and robust data management capabilities.
3. Data Utilization
By connecting your device to the Sensgreen Smart Building Platform, you're not only collecting data but also unleashing its full potential to optimize building performance, reduce energy consumption, improve indoor air quality, and enhance overall efficiency.
Fast and Secure Processing: The Sensgreen Platform's architecture is designed for both speed and security. Data processing is optimized for real-time and batch operations, ensuring fast response times.
Scalability: The platform's architecture is highly scalable, capable of handling large volumes of data as your building portfolio grows.
Redundancy and Reliability: Redundant components and backup systems are in place to ensure data reliability and minimize downtime.
Multi-Layer Security: Sensgreen employs multi-layered security measures, including encryption, access controls, and continuous monitoring, to safeguard your data.
Connect a Device to Sensgreen LoRaWAN Network Server
Sensgreen LoRaWAN Network Server (LNS) is a robust and reliable component of the Sensgreen Smart Building Platform that plays a crucial role in managing LoRaWAN-connected devices within your building. LoRaWAN is a low-power, wide-area networking (LPWAN) protocol designed for long-range communication between IoT devices and gateways.
Step 1: Connect the Gateway
Connect your LoRaWAN gateway to the Sensgreen LoRaWAN Network Server (LNS). If you don’t know how to connect your LoRaWAN Gateway to Sensgreen LNS, please visit this page. Gateway Connection Page Link Here
Step 2: Add a New Device
On the Device Management page, click the "+ New Device" button.
Step 3: Choose Connectivity Method
Select "LoRaWAN" as your connectivity method, and click "Next". Select "Sensgreen LoRaWAN" as your LoRaWAN Network Server, and click "Next".
Step 4: Select Device Type
Choose the device type as "Sensor".
Step 5: Enter Device EUI
Enter the Device EUI that is printed on your device. The Device EUI is a unique identifier for your LoRaWAN device. Device EUI, or Device Extended Unique Identifier, is a 64-bit unique identifier for LoRaWAN devices. It serves as a unique serial number for your device within the LoRaWAN network.
Step 6: Choose Device Brand and Type
Select the brand and type of the device you want to connect.
Step 7: Configure Application EUI
If required, type the Application EUI. This can often be pre-configured based on your device type. If you see the "Encrypted & Non-Erasable" label on the App EUI tab, it means it's already configured, and you don't need to enter it.
Step 8: Select Frequency Band
Choose the frequency band that is used in your region.
Step 9: Choose Building and Room
Select the building where you want to add the sensor and enter the room name where the sensor is installed.
Step 10: Device Connected
Congratulations! Your device is now connected to the Sensgreen LoRaWAN Network Server. You can check if the device has sent any data on the Device Management page.
This process allows you to easily connect and register LoRaWAN devices to the Sensgreen Smart Building Platform, enabling efficient data collection and monitoring for your building's optimization.
For more detailed instructions on connecting specific types of devices, refer to the respective device integration guides available in the platform's documentation.
If you encounter any issues or need further assistance, please don't hesitate to reach out to our support team.
Connect a Device to Sensgreen Smart Building Platform via MQTT Integration
Integrating your sensors with the Sensgreen Smart Building Platform through MQTT is a seamless process. Follow these steps to get started:
Step 1: Generate MQTT Integration Details
To begin, you'll need MQTT integration credentials. These credentials allow your sensors to communicate with the Sensgreen platform.
Access Integration Management:
Navigate to the "Import" section under the "Integration" tab in the sidebar.
Generate MQTT Credentials:
Click the "Generate" button on MQTT Integration box. This action will provide you with essential MQTT integration details:
Host: global.mqttbroker.sensgreen.com
Port: 1883
Username: Auto-generated
Password: Auto-generated
Topic: Auto-generated
These credentials are vital for establishing a connection between your servers and the Sensgreen Smart Building Platform.
Step 2: Add Your Devices to the Sensgreen Smart Building Platform
Now that you have your MQTT integration details, it's time to add your sensors to the platform:
Navigate to Device Management:
Under the "Management" tab, find and click on "Device Management".
Add Your Sensors:
Provide the necessary information for each sensor:
Device Id: A globally unique identifier for your sensor.
Sensor Type: Select the sensor type from the provided list. Choose 'Other' if your sensor type isn't listed.
Sensor Name: Assign a name for your sensor that will be displayed on the platform.
Step 3: Format Your Sensor Data JSON
For compatibility with the Sensgreen platform, your sensor data must be formatted in a specific JSON structure:
{
"deviceEui": "string", // Device identifier registered on the platform
"timestamp": "timestamp", // Unix timestamp in milliseconds in UTC (GMT)
"data": {
"data_title1": "value1", // Replace data_title with your metric (e.g., temperature, humidity)
"data_title2": "value2", // Ensure your metrics exist on the metric table
// Add more metrics as needed
}
}
Available data titles can be found at the end of this document. If your data title is not included in the list, please contact our support team for assistance.
Step 4: Publish Messages Using MQTT
Configure your application to connect to the MQTT broker using the provided MQTT parameters. Once connected, publish your sensor data in the JSON format mentioned in the generated topic.
Step 5: Check Data Reception
To ensure successful integration, check if your device has sent data to the platform. This can be verified on the Device Management page.
Data Security and Encryption
At Sensgreen, we prioritize the security of your data, ensuring that all information transmitted and stored within the platform is protected. Here's an overview of our data security and encryption measures:
1. Secure Data Transmission
All data transmitted from your devices to the platform is encrypted using industry-standard protocols. We use HTTPS for secure data transfer, ensuring that your information remains confidential during transit.
2. Device Authentication
To prevent unauthorized access, we employ device authentication mechanisms. Only registered and authorized devices can communicate with the platform, adding an extra layer of security.
3. Role-Based Access Control
The platform features role-based access control (RBAC), which means that users have specific permissions based on their roles. This restricts access to sensitive data and functionalities, ensuring that only authorized personnel can access critical information.
4. Compliance and Certification
We are committed to complying with all relevant data protection regulations, including GDPR. Sensgreen's Smart Building IoT Platform is designed with data privacy and security in mind, helping you meet your compliance requirements.
For EU Data Security regulations, Sensgreen adheres to the following:
GDPR (General Data Protection Regulation): Ensuring the protection of personal data and providing individuals with control over their data.
ISO 27001: Implementing strict information security management standards.
5. Secure Integrations
When you connect devices through integrations like MQTT or HTTP, your data is transmitted securely. We follow security best practices for data exchange with external systems.
For MQTT and HTTP integrations, we've implemented robust security measures:
MQTT Integration Security: MQTT connections can be secured through various methods such as TLS/SSL encryption and username/password authentication. This ensures that data transmitted between your devices and the platform is encrypted and secure.
HTTP Integration Security: HTTP integration supports HTTPS (HTTP Secure) for encrypted data transmission. This ensures that data exchanged between your systems and Sensgreen Smart Building Platform remains confidential and tamper-proof.
6. Data Privacy
Data privacy is at the core of the platform. We implement strict access controls, ensuring that only authorized personnel can access sensitive information. Additionally, data anonymization techniques are used when necessary to further protect privacy.
If you have any concerns about data security or encounter any security-related issues, please don't hesitate to contact our support team for assistance.
We take data security seriously and continuously work to enhance our security measures to protect your valuable data.