Skip to main content

client implementation of "DMS JSON Data Exchange v1.4"

Project description

visitoolkit_connector

client-side implementation of 'DMS JSON Data Exchange'

(most parts of specification v1.4 is already implemented,
but my code currently contains many rough edges...)

Installation via pip
https://pypi.org/project/visitoolkit-connector
(runs on Python 3)

description

An INOFFICIAL OpenSource client library written in Python to
ProMoS NT (c) AKA Saia Visi.Plus (c) version 1.7 or higher

  • search for datapoints
  • manipulations on datapoints (get, set, delete)
  • retrieving of trend data
  • retrieving of alarms and protocols
  • event-based monitoring of datapoints

visitoolkit_connector communicates over websockets to DMS and implements the official 'DMS JSON Data Exchange' protocol.
All JSON objects (requests and responses) are mapped to instances of Python classes.
All JSON values are mapped to attributes.
Events from datapoint subscriptions are handled by visitoolkit_eventsystem for executing your Python callbacks in a background thread.

documentation for this protocol is without any warranty temporary available under https://github.com/stefanbraun-private/stefanbraun-private.github.io/tree/master/ProMoS_dev_docs
All rights reserved by the respective owner 'MST Systemtechnik AG'

usage

from visitoolkit_connector import connector

TODO: add examples...

=>at the moment you find minimal usage examples at the end of the main Python script:
https://github.com/stefanbraun-private/visitoolkit_connector/blob/master/visitoolkit_connector/connector.py

Increasing logging level for bughunting:

import logging
logging.getLogger('visitoolkit_connector').setLevel(logging.DEBUG)

background information

visitoolkit_connector is a core part of visitoolkit.

visitoolkit is written for the proprietary Building and Process Management System 'ProMoS NT' (c) MST Systemtechnik AG'
(also known as 'Saia Visi.Plus' (c) Saia-Burgess Controls AG)

Intention:
Support creator of visualisation projects...
Add efficiency...
Reduce manual error-prone processes...
Add missing features...

Disclaimer:
'visitoolkit' is an open source homegrown hobby project
without any warranty and liability.
=>Use 'visitoolkit' at your own risk!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
visitoolkit_connector-0.1.2-py3-none-any.whl (20.5 kB) Copy SHA256 hash SHA256 Wheel py3
visitoolkit-connector-0.1.2.tar.gz (37.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page