tamberg / fhnw-iot-bricks

FHNW IoT Bricks

FHNW IoT Bricks

Work in progress. Interested? Contact [e-mail]

Building blocks for distributed IoT use cases

IoT Bricks enable IoT prototyping in a room, building or city.

Simple, self-contained, connected

IoT Bricks come with connectivity and a simple Java SDK.

Hardware example

IoT Brick Temperature on Thingiverse.

Getting Started

On MacOS or Linux

$ git clone https://github.com/tamberg/fhnw-iot-bricks
$ cd fhnw-iot-bricks
$ cd Java
$ ./clean.sh
$ ./setup.sh
$ ./build.sh
$ java -cp ./src:target:lib/minimal-json-0.9.5.jar:lib/org.eclipse.paho.client.mqttv3-1.2.3.jar Bricks
usage: java Bricks mock|mqtt|ttn d|l|a|m|p|s|f

Software examples

Minimal config

final String BASE_URI = "brick.li"; // the registry has a base URI
final String BRICK_ID = "0000-0001"; // each brick has a unique ID

Shared proxy

//Proxy proxy = MockProxy.fromConfig(BASE_URI); // simulate it first
Proxy proxy = MqttProxy.fromConfig(BASE_URI); // then run for real

Door bell

ButtonBrick button = ButtonBrick.connect(proxy, BUTTON_BRICK_ID);
BuzzerBrick buzzer = BuzzerBrick.connect(proxy, BUZZER_BRICK_ID);

while (true) {
    boolean pressed = button.isPressed();
    buzzer.setEnabled(pressed);
    proxy.waitForUpdate();
}

Light switch

ButtonBrick button = ButtonBrick.connect(proxy, BUTTON_BRICK_ID);
RelayBrick relay = RelayBrick.connect(proxy, RELAY_BRICK_ID);

int state = 0;
while (true) {
    boolean pressed = button.isPressed();
    if (state == 0 && pressed) {
        relay.setEnabled(true);
        state = 1;
    } else if (state == 1 && !pressed) {
        state = 2;
    } else if (state == 2 && pressed) {
        state = 3;
        relay.setEnabled(false);
    } else if (state == 3 && !pressed) {
        state = 0;
    }
    proxy.waitForUpdate();
}

Monitoring system

HumiTempBrick sensor = HumiTempBrick.connect(proxy, HUMITEMP_BRICK_ID);
DigitsBrick display = DigitsBrick.connect(proxy, DIGITS_BRICK_ID);
ColorLedBrick led = ColorLedBrick.connect(proxy, COLORLED_BRICK_ID);

while (true) {
    double temp = sensor.getTemperature();
    display.setDoubleValue(temp);
    Color color = temp > 23 ? Color.RED : Color.GREEN;
    led.setColor(color);
    proxy.waitForUpdate();
}

Logging system

HumiTempBrick sensor = HumiTempBrick.connect(proxy, HUMITEMP_BRICK_ID);
FileWriter fileWriter = null;
try {
    fileWriter = new FileWriter("log.csv", true); // append
} catch (IOException e) {
    e.printStackTrace();
}

while (true) {
    double temp = sensor.getTemperature();
    String time = sensor.getTimestampIsoUtc();
    try {
        fileWriter.append(time + ", " + temp + "\n");
        fileWriter.flush();
    } catch (IOException e) {
        e.printStackTrace();
    }
    proxy.waitForUpdate();
}

Foosball counter

ButtonBrick reset = ButtonBrick.connect(proxy, BUTTON_BRICK_ID);
PresenceBrick sensor0 = PresenceBrick.connect(proxy, PRESENCE_BRICK_0_ID);
PresenceBrick sensor1 = PresenceBrick.connect(proxy, PRESENCE_BRICK_1_ID);
DigitsBrick display = DigitsBrick.connect(proxy, DIGITS_BRICK_ID);

double score = 00.00;
while (true) {
    boolean resetPressed = reset.isPressed();
    boolean team0Scored = sensor1.isActive();
    boolean team1Scored = sensor0.isActive();
    if (resetPressed) {
        score = 00.00;
    } else if (team0Scored && !team1Scored) {
        score += 01.00;
    } else if (team1Scored && !team0Scored) {
        score += 00.01;
    }
    display.setDoubleValue(score);
    proxy.waitForUpdate();
}

Software architecture

Public interfaces

// package ch.fhnw.imvs.bricks.core;

public abstract class Brick {
    public String getID();
    public double getBatteryVoltage();
    public Date getTimestamp();
    public String getTimestampIsoUtc();
}

public abstract class Proxy {
    public final void waitForUpdate();
}

// package ch.fhnw.imvs.bricks.mqtt;

public final class MqttProxy extends Proxy {
    public static MqttProxy fromConfig(String configBaseURI);
}     

// package ch.fhnw.imvs.bricks.mock;

public final class MockProxy extends Proxy {
    public static MockProxy fromConfig(String configBaseURI);
}

// package ch.fhnw.imvs.bricks.impl;

public abstract class DigitalInputBrick extends Brick {}
public abstract class DigitalOutputBrick extends Brick {}

// package ch.fhnw.imvs.bricks.sensors;

public final class ButtonBrick extends DigitalInputBrick {
    public boolean isPressed();
    public static ButtonBrick connect(Proxy proxy, String brickID);
}

public final class HumiTempBrick extends Brick {
    public double getHumidity();
    public double getTemperature();
    public static HumiTempBrick connect(Proxy proxy, String brickID);
}

public final class PresenceBrick extends DigitalInputBrick {
    public boolean isActive();
    public static PresenceBrick connect(Proxy proxy, String brickID);
}

// package ch.fhnw.imvs.bricks.actuators;

public final class BasicLedBrick extends DigitalOutputBrick {
    public void setEnabled(boolean enabled);
    public static BasicLedBrick connect(Proxy proxy, String brickID);
}

public final class BuzzerBrick extends DigitalOutputBrick {
    public void setEnabled(boolean enabled);
    public static BuzzerBrick connect(Proxy proxy, String brickID);
}

public final class ColorLedBrick extends Brick {
    public void setColor(Color value);
    public static ColorLedBrick connect(Proxy proxy, String brickID);
}

public final class DigitsBrick extends Brick;
    public void setDecimalPlaces(int value);
    public void setDoubleValue(double value);
    public static DigitsBrick connect(Proxy proxy, String brickID);
}

public final class RelayBrick extends DigitalOutputBrick {
    public void setEnabled(boolean enabled);
    public static RelayBrick connect(Proxy proxy, String brickID);
}

Class diagram