DCH 2.0 Documentation
SI Docs
SI Docs
  • DCH Onboarding (timeseries data)
    • DCH timeseries Onboarding Process
    • Gateway Requirements
    • Confirm Network Permissions
    • Selecting the Points
    • Building to DCH Data Export Process
    • Special Character Conversions
    • Gateway instructions
  • DCH Onboarding (BRICK Model Construction)
    • Overview
    • Usage
    • CREATE Operation
    • RELATE Operation
    • POINT_CREATE_LINK_PATTERN_MATCH Operation
    • GENERATE_CLASSIFIERSET Operation
    • Point Classifier UI
Powered by GitBook
On this page
  1. DCH Onboarding (timeseries data)

DCH timeseries Onboarding Process

NextGateway Requirements

Last updated 5 months ago

Before you continue, make sure you have read the Core Docs and have created the site and building you are onboarding. Also make sure you have created a data source and you have the username and password of that data source (unless you are onboarding without MQTT).

Current broker address is broker.dataclearinghouse.org. Legacy systems (setup prior to October 2024) used broker2.dataclearinghouse.org. Systems using broker2 should be updated when the opportunity arises.

If you would like to onboard your timeseries data using our REST API instead of MQTT, see our walkthrough .

The main steps to be followed for the onboarding process are below and are described in more detail in the sections of this document:

Step
Requirement
How
Requires DCH Access

1

Check network will allow connection between the gateway and the DCH MQTT broker.

Configured by LAN administrator using site network management tools

No

2

Identify the DCH data source username and password that the site data will be associated with.

Provided in DCH under the data source page.

Yes

3

Setup the MQTT publish connection to DCH (host: broker.dataclearinghouse.org) and check connection.

Configured in the gateway.

No

4

Set up the MQTT topic under which the MQTT messages will be published.

5

Select the points in the gateway to be exported.

6

Configure the JSON messages with the required fields.

7

Check upload speed and queue sizes.

8

Initiate the upload.

9

Check the messages are arriving at the MQTT broker.

Configured via a PC.

No

10

Check that the datastreams in DCH are populating with data.

Data Source page in DCH

Yes

11

Check Gateway CPU usage because message queues can overload the processor.

Checked in the gateway.

No

here