Skip to content

VSCP Demo server

Åke Hedman edited this page Aug 17, 2021 · 35 revisions

VSCP Demo server

The VSCP demo server is located at demo.vscp.org It is to be used for demo purposes only. It can't be used for mission critical tasks. Also https://test.mosquitto.org is available. A mirror is available at the test.mosquitto.org server )same topics as described below). Follow the link info about ports etc.

demo.vscp.org
tcp/ip port 1883 - no TLS, need authentication
websocket port 9001 - no TLS, need authentication
username: vscp
password: secret

Clients

Command line client tools

Mosquitto

On linux install mosquitto client package with

sudo apt install mosquitto-clients

After installation you can subscribe to events published on all VSCP topics with

mosquitto_sub -h demo.vscp.org -p 1883 -t vscp/#

or use

mosquitto_sub -h demo.vscp.org -p 1883 -t vscp/25:00:00:00:00:00:00:00:00:00:00:00:06:00:00:01/1040/6/1/2/#

to get the current fridge temperature in our kitchen.

MQTT.js

Another command line alternative is to use MQTT.js. Install with

npm install mqtt --save

Graphical interface client tools

MQTT Explorer

Info is here. Easy to use tool but (as it looks) apparently not developed anymore.

VSCP Works +

Not released yet but will have both general MQTT support and VSCP specific support.

Available topics

vscp-daemon

Each VSCP daemon that publish events to the demo server is listed here. The GUID for the server identifies it and drivers and discovery gives information about running drivers on the daemon and nodes discovered by the daemon respectively. See the VSCP daemon documentation for more information about this content.

vscp

Under this topic events from nodes are available. The format for a typical measurement topic is

vscp/guid/vscp-class/vscp-type/node-id/data-byte-0

This give maximum flexibility for the client to filter out the events it is interested in. Byte zero of the data is set because for Level II measurements this byte holds the sensor index for the sensor on the remote node that the measurement value comes from. For other events - that is non measurement events - data byte zero may have some other meaning so check the VSCP spec when interpreting event.

GUID's

For the demo server the Grodans Paradis AB assigned GUID

25:00:00:00:00:00:00:00:00:00:00:00:Y1:Y2:XX:XX

is used as a basis for all GUID's. A driver use the two LSB bytes (XX:XX above) for it's own use as node id's (nickname id's). The Y1:Y2 byte s are used for devices and drivers. Y1 is server specific, each server has a different value here. The Y2 byte is zero for the server itself and 1-255 for drivers. Btw you can request your own GUID series by sending a mail to [email protected] or use one of the available series.

note: The above is the schema we use in our house. You are free to setup any schema you like in your own setup of course. There is millions of possibilities.

So here is a list of the events and GUID's you may see on the vscp/# topic. I will add to this list as we go.

(pi4)[pi4]

Currently only the CAN4VSCP driver is forwarded to the demo. It connects to some nodes located in our kitchen that control a refrigerator and a fridge among other things.

Node/Server GUID Sensor index Description
pi4 25:00:00:00:00:00:00:00:00:00:00:00:06:00:00:00 - VSCP Daemon running on a Raspberry Pi 3+
can4vscp 25:00:00:00:00:00:00:00:00:00:00:00:06:01:00:00 - CAN4VSCP CAN driver
Clone this wiki locally