#harkhack

Showcase your talents and build something that interacts with physical devices on display based on different inputs.

For example:

• Temperature control system that turns on the fan under certain conditions.
• A payment gateway that allows you to turn on the kettle and bills for the total amount of electricity
• A twitter bot that tweets sensor information or can be used to control lights.

• Ability to work to the brief
• Technical accuracy and innovation
• Real world application

Various sensors and devices are available to use. The sensor data includes temperature, CO2, humidity, vibration and kWh, and will be streamed and made available in real-time via an MQTT feed.

There are also a set of devices that can be turned on and off, including a kettle, heater, fan, motor and red, green and blue lamps. Changes to the state of these devices (ie: whether they have been turned on or off) will also be available via the same MQTT feed.

Each team will be given a Dell Edge Gateway.

The Dell Edge Gateway, with powerful dual-core Intel® Atom™ processors, connects varied wired and wireless devices and systems, aggregates and analyzes the input, and sends it on.

The Edge Gateway is made to withstand harsh conditions. It works out in the field, down on the factory floor, and stuck on an HVAC system, because it has industrial-grade form factors. Some models offer an operating temperature range of -30°C to 70°C.

Your gateway will be running in Development Mode which will include access to a control panel with emulated devices and data.

It allows you to simulate turning devices on and off, as well as setting the temperature, CO2 level, humidity and motor speed. You can also generate a temporary small, medium or large vibration. This data will be sent to an MQTT feed running on the same gateway.

• {GATEWAY_IP_ADDRESS}:3000

• mqtt://{GATEWAY_IP_ADDRESS}:1883
• ws://{GATEWAY_IP_ADDRESS}:1884

The control panel is designed to emulate the real set of devices and sensor data.

Be sure to factor in a way to easily change these details as at the end of the day, you will need to connect to the real data feed and devices to showcase your invention.

The devices are controlled via a simple api.

GET /api/devices/state

Response:

{
  "state": {
    "fan": false,
    "greenLamp": false,
    "heater": false,
    "kettle": false,
    "redLamp": false,
    "blueLamp": false
  }
}

Where true means the device is ON, and false means the device is OFF.

GET /api/devices/{device}/state

Where {device} is one of the following:

• fan
• greenLamp
• heater
• kettle
• redLamp
• blueLamp

Response:

{
  "isOn": false
}

isOn will be either true or false.

POST /api/devices/{device}/state

Where {device} is one of the following:

• fan
• greenLamp
• heater
• kettle
• redLamp
• blueLamp

Body:

{
  "turnOn": true
}

turnOn excepts either true or false.

Response: 200 OK (no body)

GET /api/devices/motor

Response:

{
  "amps": 0,
  "frequency": 0,
  "rpm": 0,
  "volts": 0,
  "watts": 0,
  "speed": 0,
  "running": false
}

POST /api/devices/motor

Body:

{
  "speed": 100
}

The allowed values for speed are 0 - 4000 in steps of 100.

Response: 200 OK (no body)

Metrics are streamed to an MQTT feed every second. This includes values from all the sensors, IO devices and motor.

Sensor metrics are identified by the following ids:

The topic will be metrics/{id} - ie: metrics/1 for the IFM temperature data.

The payload includes the id, the value and the UTC received time.

{ "id":"1", "receivedUtc":"2019-07-15T11:49:18Z", "value":20}
{ "id":"2", "receivedUtc":"2019-07-15T11:49:18Z", "value":0}
{ "id":"8", "receivedUtc":"2019-07-15T11:49:18Z", "value":60
{ "id":"10" ,"receivedUtc":"2019-07-15T11:49:18Z", "value":10}

Events are raised when the state of an IO device changes, or the speed of the motor changes. The topic is devices and motor respectively.

{ "key":"redLamp", "isOn": false }
{ "key":"redLamp", "isOn": true }
{ "speed": 1000 }

Why not check out the sample code in this repo. There are examples of using the devices api and subscribing to the mqtt feed in C#, Typescript and Python.

• Hark Hack Day Website
• Hark Hack Day Eventbrite Page