Project

General

Profile

DTXr doc » History » Version 53

David Fredriksson, 04/07/2022 01:54 PM

1 20 Torbjorn Carlqvist Admin
{{>toc}}
2
3
h1. DTXr documentation
4 1 Torbjorn Carlqvist Admin
5 5 Torbjorn Carlqvist Admin
h3. Installation
6 2 Torbjorn Carlqvist Admin
7 6 Torbjorn Carlqvist Admin
8
* System Requirements
9 21 Torbjorn Carlqvist Admin
DTXr can run on any machine that can run +Java 11+ and has sufficient with RAM and disk capacity.
10 1 Torbjorn Carlqvist Admin
11 21 Torbjorn Carlqvist Admin
|Requirement|System RAM|System DISK|Example|
12
|Minimal|512Mbyte|512Mbyte|Raspberry 1, Raspberry Zero|
13 31 Torbjorn Carlqvist Admin
|Better|512Mbyte|512Mbyte|Rasberry Zero 2|
14
|Avarage|1GByte|1Gbyte|Raspberry 2-4|
15 21 Torbjorn Carlqvist Admin
|Top|2GByte|8Gbyte|Raspberry 4, Raspberry CM4, Server, PC|
16
17 6 Torbjorn Carlqvist Admin
* Network Requirements
18
DTXr can run stand alone without any active network connection. In that case the management pages is accessible via localhost interface. But for DTXr to be a fully functional BACnet/IP device it must be connected to an IP network that offers IP address via DHCP and where broadcast traffic is allowed.
19 10 Torbjorn Carlqvist Admin
20 1 Torbjorn Carlqvist Admin
* Download DTXr software packages
21 10 Torbjorn Carlqvist Admin
Currently only customers to DAVITOR can download DTXr. Contact info@davitor.com for purchase information.
22
23 15 Torbjorn Carlqvist Admin
* Install on Linux
24 21 Torbjorn Carlqvist Admin
** For Raspberry with Raspberry OS/Rasbian there is special install scripts, please follow these steps:
25 22 Torbjorn Carlqvist Admin
### Download latest DTXr _base_ image and copy to a SD-card that has 16Gbyte capacity or more
26
### Insert the SD card, attach keyboard and screen via cable and start the device
27 41 David Fredriksson
### When you get prompt login as **admin/davitor**
28 32 David Fredriksson
### Download install scripts with password for davitor sight
29 29 Torbjorn Carlqvist Admin
#### <pre>wget --user=admin --password=**** https://artifacts.davitor.com/repository/dtx-raw/scripts/dtx.sh</pre>
30 1 Torbjorn Carlqvist Admin
#### <pre>wget --user=admin --password=****  https://artifacts.davitor.com/repository/dtx-raw/scripts/system.sh</pre>
31 37 David Fredriksson
### Run installation as <pre>sudo ./dtx.sh -v 2.25 -u admin -p **** -s "bac-device-id=83336 bac-device-name=DTX-AMADA app-password=xxxxxx lion-enabled=true"
32 1 Torbjorn Carlqvist Admin
</pre>
33 37 David Fredriksson
The line above is an example where chosen parameters where set at installation and where xxxxxx is the new password for the new device to use.
34 36 David Fredriksson
35 1 Torbjorn Carlqvist Admin
36 27 David Fredriksson
### Set MAC by system.sh script
37
### Example:
38 1 Torbjorn Carlqvist Admin
39 50 David Fredriksson
<pre>sudo systemctl stop dtx</pre>
40 49 David Fredriksson
<pre>sudo ./system.sh -mac 70:B3:D5:16:E8:99 -hn DTX-L1-8R8DI</pre>
41
<pre>Setting MAC to 70:B3:D5:16:E8:99
42 46 David Fredriksson
Enabling and starting MAC service
43
New MAC will be effective on next reboot
44
Setting new hostname to DTX-L1-8R8DI
45 1 Torbjorn Carlqvist Admin
DTX-L1-8R8DI</pre>
46 50 David Fredriksson
<pre>sudo systemctl start dtx</pre>
47 46 David Fredriksson
48 52 David Fredriksson
This will excecute nesesary commands for the MAC, change the name of the node as well as change the files 
49 1 Torbjorn Carlqvist Admin
/lib/systemd/system/setmac.service
50 52 David Fredriksson
/usr/local/davitor/dtx/settings.json
51 45 David Fredriksson
52 43 David Fredriksson
53
*System files
54
**settings.json
55
/usr/local/davitor/dtx/settings.json
56
The file contains most of the important settings that is used by the DTX environment and most of it can be changed from the settingspage.
57
If the file is changed manually, than please stop dtx envronment by:
58
use of **systemctl **
59
60
sudo systemctl --help
61
62
systemctl [OPTIONS...] {COMMAND} ...
63
64
65
Example:
66
Stop
67
sudo systemctl stop dtx
68
69
Run
70
sudo systemctl start dtx
71
72
Check
73
systemctl status dtx.service
74 42 David Fredriksson
75
76 53 David Fredriksson
77
{
78
 "da-listen-hub-port": "",
79
 "da-listen-hub-jms-port": "",
80
 "bt-enabled": false,
81
 "jdbc-password": "",
82
 "bt-console-enabled": null,
83
 "platform": "A1",
84
 "iot-enabled": null,
85
 "app-api-token": "214751c3-8d06-4c5a-ad0a-53371bd30fad",
86
 "da-vnet": "",
87
 "reload": false,
88
 "jdbc-user": "",
89
 "app-password": "*******",
90
 "gateway-enabled": false,
91
 "file-input-folder-path": "",
92
 "bac-bind-addr": "0.0.0.0",
93
 "bac-port": 47808,
94
 "bac-password": "*******",
95
 "app-ws-port": 9091,
96
 "da-remote-hub-host": "",
97
 "bacnet-enabled": true,
98
 "bac-device-name": "DTX-L1-8R8DI",
99
 "mesh-enabled": false,
100
 "da-domain": "",
101
 "app-http-port": 9090,
102
 "da-remote-hub-port": "",
103
 "app-username": "admin",
104
 "jdbc-url": "",
105
 "lion-enabled": true,
106
 "jdbc-enabled": false,
107
 "log-level": "WARN",
108
 "broker-enabled": false,
109
 "bbmd-enabled": false,
110
 "bac-device-id": 83315,
111
 "bt-beacon-enabled": null
112
}
113
114
115 15 Torbjorn Carlqvist Admin
** For other Linux distributions follow this steps
116
### _TBD..._
117
118
* Install on Windows
119 1 Torbjorn Carlqvist Admin
** Follow these steps:
120
### _TBD..._
121 32 David Fredriksson
122 38 Torbjorn Carlqvist Admin
h3. LION Fieldbus
123 32 David Fredriksson
124 38 Torbjorn Carlqvist Admin
* See LION [[LION:Wiki]] for howto in installataion, channel assigmnets and testing.
125 15 Torbjorn Carlqvist Admin
126 11 Torbjorn Carlqvist Admin
h3. Setup
127 10 Torbjorn Carlqvist Admin
128 11 Torbjorn Carlqvist Admin
DTXr is setup via Menu -> Setup page.
129 1 Torbjorn Carlqvist Admin
130 11 Torbjorn Carlqvist Admin
* System
131 1 Torbjorn Carlqvist Admin
** Administrator password - Password for the default (and not changeable) account  **"admin"**. Default is **"davitor"**.
132 42 David Fredriksson
_When you log in you will start att /home/admin
133
There is another user "pi" as well with a secret password._
134 13 Torbjorn Carlqvist Admin
** Operator username - Username for the typical user of any HMI developed on this device. Typically a machine operator. [Optional]
135
** Operator password - Password for the operator user. [Optional]
136
** Operator start page - Set any web page in the project folder that will automatically shown on an operator login. [Optional]
137
** Log Level - The system severity level for the system_app.log in /Logs tree directory.
138 11 Torbjorn Carlqvist Admin
139
* BACnet
140 14 Torbjorn Carlqvist Admin
** _TBD..._
141 11 Torbjorn Carlqvist Admin
142
* Davitor Advantage
143 14 Torbjorn Carlqvist Admin
** _TBD..._
144 11 Torbjorn Carlqvist Admin
145
* Wireless Mesh
146 14 Torbjorn Carlqvist Admin
** _TBD..._
147 11 Torbjorn Carlqvist Admin
148
* Bluetooth
149 14 Torbjorn Carlqvist Admin
** _TBD..._
150 11 Torbjorn Carlqvist Admin
151
* External Database Access
152 14 Torbjorn Carlqvist Admin
** _TBD..._
153 11 Torbjorn Carlqvist Admin
154
* File Integration
155 14 Torbjorn Carlqvist Admin
** _TBD..._
156 11 Torbjorn Carlqvist Admin
157
* HTTP
158 14 Torbjorn Carlqvist Admin
** _TBD..._
159 11 Torbjorn Carlqvist Admin
160
* LION Interface
161 14 Torbjorn Carlqvist Admin
** _TBD..._
162 11 Torbjorn Carlqvist Admin
163
* IoT HUB (BETA)
164 14 Torbjorn Carlqvist Admin
** _TBD..._
165 11 Torbjorn Carlqvist Admin
166 1 Torbjorn Carlqvist Admin
167
h3. User's Guide
168 2 Torbjorn Carlqvist Admin
169 14 Torbjorn Carlqvist Admin
* _TBD..._
170
171 5 Torbjorn Carlqvist Admin
h3. Developer's Guide
172 14 Torbjorn Carlqvist Admin
173 19 Torbjorn Carlqvist Admin
[[IDE|IDE walk through]]
174
[[Javascript|The DTXr Javascript guide]]
175
[[Blockly|Blockly tutorials]]