• Redis installed and running.

sudo apt install redis-server

• UART enabled
• Weinzierl KNX BAOS 83x module connected to UART.
• nodejs - for dobaos.tool.

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

First of all, I compile it with ldc(LLVM backend for dlang) on FriendlyARM NanoPi Neo Core2(aarch64?).

To install ldc use script:

curl -fsS https://dlang.org/install.sh | bash -s ldc

then follow on-screen instructions

after installing and activating ldc environment, clone and compile this repo

git clone https://github.com/dobaos/dobaos.git
cd ./dobaos
dub

if everything is ok, process will start. Stop it and proceed next.

If you can't compile source by yourself(ldc2 can't be installed on Raspberry Pi3, so cross-compilation tool should be used), compiled versions for NanoPi Neo Core2 and Raspberry Pi 3 can be found on google drive.

If you downloaded binary from google drive, then put it to user home folder on your single board computer. If you are working on linux/macOS do it with help of scp or sshfs(which I recommend as a convenient way to work with remote filesystem). For Windows take a look at billziss-gh/sshfs-win. After you copied file to home folder, do ssh login and put this file to /usr/local/bin/dobaos.

Assuming binary name in user home folder is dobaos. Give it permission to run at first, and copy to global bin directory:

chmod +x ./dobaos
sudo cp ./dobaos /usr/local/bin/dobaos

so, now you are able to run it with just dobaos command.

Since version 10_mar_2020 default device is /dev/ttyAMA0 and all config now is stored at redis database. At a first run, dobaos service creates all needed keys there. Default config prefix is dobaos:. It can be changed with command line argument --prefix/-p.

To see created keys:

$ redis-cli keys dobaos:*
1) "dobaos:config:bcast_channel"
2) "dobaos:config:stream_maxlen"
3) "dobaos:config:stream_raw"
4) "dobaos:config:stream_datapoints"
5) "dobaos:config:uart_params"
6) "dobaos:config:uart_device"
7) "dobaos:config:req_channel"

To get or change config key value redis-cli get and redis-cli set command may be executed.

You may install redis-commander package as well for simple web interface.

$ sudo npm i -g redis-commander
$ redis-commander

Running dobaos with --device/-d argument will overwrite dobaos:config:uart_device value.

redis-cli get dobaos:config:uart_device
redis-cli set dobaos:config:uart_device /dev/ttyS1

Systemd daemon manages running application at system startup.

Create and edit dobaos.service:

sudo touch /etc/systemd/system/dobaos.service 
sudo nano /etc/systemd/system/dobaos.service 

and paste following:

[Unit]
Description=Dobaos backend service
After=redis.service

[Service]
User=pi
ExecStart=/usr/bin/env dobaos
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Save and close file. Enable and start service:

sudo systemctl daemon-reload
sudo systemctl enable dobaos.service
sudo systemctl start dobaos.service

Check service state with dobaos.tool. To install it, run

sudo npm i -g dobaos.tool

To run:

dobaos-tool

Use command version inside tool interface to check that main service is up and running(otherwise there will be error ERR_TIMEOUT). If command was successful, use command progmode 1 to set device into programming mode, so, you will be able to download physicall address from ETS. After application download to see all configured datapoints serves command description *. To receive help enter help command.

This app provides software interface to work with Weinzierl BAOS modules(830/838 kBerry/..).

What this process do, step by step:

1. Connect to serialport.
2. Load server item [Current Buffer Size].
3. Load all configured datapoint descriptions.
4. Connect to redis.
5. Subscribe to request channel.
6. while(true): receive uart messages, receive redis messages.

On uart message: broadcast datapoint value. On redis message: parse JSON, send request to UART, then respond.

JSON messages should be sent to pub/sub channel, "dobaos_req" by default.

{
  "response_channel": "",
  "method": "...",
  "payload": ...
}

This three fields are required. If one of them is not found in message, request will be declined.

Response is sent to "response_channel", therefore, client should be subscribed, before sending request. Good practice is to select channel prefix name, e.g. client_listener_ch and use Redis command PSUBSCRIBE client_listener_ch_*. Generate random number, add to that prefix and send as a response_channel value.

Response:

{
  "method": "success"/"error",
  "payload": ...
}

There is messages broadcasted to bcast_channel on incoming datapoint values or when set/put value method was successfully called. Message format is the same as for getValue response.

Also, on server item change(e.g. programming mode button or bus connect/disconnect), message with server item as a method is broadcasted.

On sdk reset - message with sdk reset as a method.

Since version 10_mar_2020, there is support for Redis streams(redis v5.0.0 at least required).

Streaming is customizable by changing keys dobaos:config:stream_*.

Maxlen parameter is a maximum amount of one datapoint record.

Key stream_datapoints is a json serialized array, default is []. Put your datapoints there: [1, 2, 3, 5, 10]. You may add datapoint names in this array as well: [1, 2, 3, "room_temperature"].

Parameter stream_raw indicates if dobaos should save base64-encoded values. By default it's false to save memory.

Added support for datapoint names in version 3_jul_2020. To assign a name, edit a redis hash table dobaos:config:names. Format: table[name] = id.

Example of command for redis-cli:

HSET dobaos:config:names room_temperature 123

Reload application or send reset request after mading changes to hash table. From now on you can work with string identifiers.

{
  "method": "get description",
  "payload": "room_temperature"
}

{
  "method": "get description",
  "payload": [1, "room_temperature"]
}

Same format applies to get stored/get value/read value. In set value payload id field may be replaced by name value as well.

{
  "method": "set value",
  "payload": {
    "id": "room_temperature",
    "value": 21
  }
}

Note: datapoint names may be received by reading redis hash table keys and values and by get description request.

• dobaos.js
• dobaos.py
• dobaos.d

• dobaos.tool