Project

General

Profile

DTXr features » History » Version 20

David Fredriksson, 03/29/2022 08:33 AM

1 1 Torbjorn Carlqvist Admin
h1. DTXr features
2
3 2 Torbjorn Carlqvist Admin
h3. BACNet/IP Stack
4 1 Torbjorn Carlqvist Admin
5 7 Torbjorn Carlqvist Admin
DTXr hosts a full BACnet/IP stack.
6
7 8 Torbjorn Carlqvist Admin
* Rev. 19 Ver. 1
8 7 Torbjorn Carlqvist Admin
* BTL tested
9 3 Torbjorn Carlqvist Admin
10 2 Torbjorn Carlqvist Admin
h3. IDE
11 4 Torbjorn Carlqvist Admin
12 17 David Fredriksson
h1. Introduction
13 20 David Fredriksson
14
This is the documentation of the DTXr Integrated Development Environment (IDE)
15 1 Torbjorn Carlqvist Admin
The IDE can be hosted on a BACnet device or on any other device that can run the application such as a PC or other device able to host a Virtual Java Machine. There are several reasons to hosting the IDE on a BACnet device rather than on a computer. Most importantly is the ability to cope with the future. Several years from now when a change is needed, the user will most likely have a different computer, a different operating system and will probably not keep track of old interface cables. Furthermore the syntax used to create the logic of the device is JavaScript. The reasons for this are many, but most important is the fact that JavaScript does not need to compile and downloaded to a device but is real time interpreted. Hence the code will be active as soon as it is saved, saving compilation and upload time.
16
17
h1.The Object page
18 20 David Fredriksson
19
The object page may look very different depending on what objects that are in the device that you have entered. If the device is Gateway or a HUB (also sometimes called a cloud server) the objects will appear as general or virtual objects but if the device is a BACnet device there will be objects according to what hardware is in the BACnet device.
20 17 David Fredriksson
If the device has many objects they may appear further down and you may have to scroll down quite a bit in order to see all the objects in the device.
21
In the Top pane of the Object side there are five drop down menus.
22 1 Torbjorn Carlqvist Admin
23
h2. Objects (leftmost drop down menu)
24 17 David Fredriksson
25 20 David Fredriksson
This only contains an option to refresh the page.
26
27 1 Torbjorn Carlqvist Admin
h2 .Devices (second leftmost menu)
28
29 20 David Fredriksson
When you first enter the Object page, you will see the objects that belong to the device that you have entered by writing its IP address or DNS name and logged in. In the Device dropdown menu you can enter any other BACnet device that is on your network.
30
31 17 David Fredriksson
h2. Priority
32 20 David Fredriksson
33
In the priority menu you may choose the priority that a change will be performed at if you make changes on objects. Default priority is eight, or Manual operator priority. Note that a change won’t happen if another command has a higher priority
34 17 David Fredriksson
Priority Level	Application
35
1	Manual-Life Safety
36
2	Automatic-Life Safety
37
3	Available
38
4	Available
39
5	Critical Equipment Control
40
6	Minimum On/Off
41
7	Available
42
8	Manual Operator
43
9	Available
44
10	Available
45 1 Torbjorn Carlqvist Admin
11	Available
46
12	Available
47
13	Available
48 17 David Fredriksson
14	Available
49
15	Available
50
16	Available
51
52 20 David Fredriksson
h2. Notifications
53
54
If something out of the ordinary happens there may be a notification. A notification can typically be set up if a value is out of the normal interval. If there are notifications they will appear here.
55 19 David Fredriksson
For more information about notifications se:
56 17 David Fredriksson
"Short article about notifiacations":http://www.bacnet.org/Bibliography/BACnet-Today-11/Isler-2011.pdf
57
"More advanced information on notifications":https://bacnetexperts.com/papers/Alarms%20and%20Events.pdf
58
59
h2. Page Browser Menu
60 20 David Fredriksson
61
This is where you surf to other pages in the DTXr Integrated Development Environment such as:
62 17 David Fredriksson
Setup
63
Code
64
API
65
Blocks
66
Logout
67
68 16 David Fredriksson
69 9 Torbjorn Carlqvist Admin
70 6 Torbjorn Carlqvist Admin
_TBD..._
71
72 4 Torbjorn Carlqvist Admin
h3. Graph Editor
73
74 6 Torbjorn Carlqvist Admin
_TBD..._
75
76 5 Torbjorn Carlqvist Admin
h3. Map Editor
77 6 Torbjorn Carlqvist Admin
78
_TBD..._
79 10 Torbjorn Carlqvist Admin
80 14 Torbjorn Carlqvist Admin
h3. Blockly
81 13 Torbjorn Carlqvist Admin
82 15 Torbjorn Carlqvist Admin
!Blockly.png!
83 13 Torbjorn Carlqvist Admin
84 11 Torbjorn Carlqvist Admin
h3. REST-API
85
86
Every running DTXr instance has it's own REST API that can be used to access and modify various aspects of the node.
87
88
A swagger index pages is offered as:
89
http://[IP]:[PORT]/browse/swagger/index.html
90 12 Torbjorn Carlqvist Admin
91
h4. Object Type enumeration
92
93
<pre>
94
analogInput: 0
95
analogOutput: 1
96
analogValue: 2
97
binaryInput: 3
98
binaryOutput: 4
99
binaryValue: 5
100
calendar: 6
101
command: 7
102
device: 8
103
eventEnrollment: 9
104
file: 10
105
group: 11
106
loop: 12
107
multiStateInput: 13
108
multiStateOutput: 14
109
notificationClass: 15
110
program: 16
111
schedule: 17
112
averaging: 18
113
multiStateValue: 19
114
trendLog: 20
115
lifeSafetyPoint: 21
116
lifeSafetyZone: 22
117
accumulator: 23
118
pulseConverter: 24
119
eventLog: 25
120
trendLogMultiple: 27
121
loadControl: 28
122
structuredView: 29
123
accessDoor: 30
124
accessCredentialInput: 37
125
characterStringValue: 40
126
integerValue: 45
127
alertEnrollment: 52
128
lightingOutput: 54
129
bacqlScript: 129
130
</pre>