Project

General

Profile

DTXr doc » History » Version 50

David Fredriksson, 04/07/2022 01:47 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 43 David Fredriksson
This will excecute nesesary commands as well as change the file 
49
/lib/systemd/system/setmac.service
50 1 Torbjorn Carlqvist Admin
51 45 David Fredriksson
_$ sudo chmod 644 /lib/systemd/system/setmac.service_
52
_$ sudo systemctl daemon-reload_
53
_$ sudo systemctl enable setmac.service_
54 43 David Fredriksson
55
*System files
56
**settings.json
57
/usr/local/davitor/dtx/settings.json
58
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.
59
If the file is changed manually, than please stop dtx envronment by:
60
use of **systemctl **
61
62
sudo systemctl --help
63
64
systemctl [OPTIONS...] {COMMAND} ...
65
66
67
Example:
68
Stop
69
sudo systemctl stop dtx
70
71
Run
72
sudo systemctl start dtx
73
74
Check
75
systemctl status dtx.service
76 42 David Fredriksson
77
78 15 Torbjorn Carlqvist Admin
** For other Linux distributions follow this steps
79
### _TBD..._
80
81
* Install on Windows
82 1 Torbjorn Carlqvist Admin
** Follow these steps:
83
### _TBD..._
84 32 David Fredriksson
85 38 Torbjorn Carlqvist Admin
h3. LION Fieldbus
86 32 David Fredriksson
87 38 Torbjorn Carlqvist Admin
* See LION [[LION:Wiki]] for howto in installataion, channel assigmnets and testing.
88 15 Torbjorn Carlqvist Admin
89 11 Torbjorn Carlqvist Admin
h3. Setup
90 10 Torbjorn Carlqvist Admin
91 11 Torbjorn Carlqvist Admin
DTXr is setup via Menu -> Setup page.
92 1 Torbjorn Carlqvist Admin
93 11 Torbjorn Carlqvist Admin
* System
94 1 Torbjorn Carlqvist Admin
** Administrator password - Password for the default (and not changeable) account  **"admin"**. Default is **"davitor"**.
95 42 David Fredriksson
_When you log in you will start att /home/admin
96
There is another user "pi" as well with a secret password._
97 13 Torbjorn Carlqvist Admin
** Operator username - Username for the typical user of any HMI developed on this device. Typically a machine operator. [Optional]
98
** Operator password - Password for the operator user. [Optional]
99
** Operator start page - Set any web page in the project folder that will automatically shown on an operator login. [Optional]
100
** Log Level - The system severity level for the system_app.log in /Logs tree directory.
101 11 Torbjorn Carlqvist Admin
102
* BACnet
103 14 Torbjorn Carlqvist Admin
** _TBD..._
104 11 Torbjorn Carlqvist Admin
105
* Davitor Advantage
106 14 Torbjorn Carlqvist Admin
** _TBD..._
107 11 Torbjorn Carlqvist Admin
108
* Wireless Mesh
109 14 Torbjorn Carlqvist Admin
** _TBD..._
110 11 Torbjorn Carlqvist Admin
111
* Bluetooth
112 14 Torbjorn Carlqvist Admin
** _TBD..._
113 11 Torbjorn Carlqvist Admin
114
* External Database Access
115 14 Torbjorn Carlqvist Admin
** _TBD..._
116 11 Torbjorn Carlqvist Admin
117
* File Integration
118 14 Torbjorn Carlqvist Admin
** _TBD..._
119 11 Torbjorn Carlqvist Admin
120
* HTTP
121 14 Torbjorn Carlqvist Admin
** _TBD..._
122 11 Torbjorn Carlqvist Admin
123
* LION Interface
124 14 Torbjorn Carlqvist Admin
** _TBD..._
125 11 Torbjorn Carlqvist Admin
126
* IoT HUB (BETA)
127 14 Torbjorn Carlqvist Admin
** _TBD..._
128 11 Torbjorn Carlqvist Admin
129 1 Torbjorn Carlqvist Admin
130
h3. User's Guide
131 2 Torbjorn Carlqvist Admin
132 14 Torbjorn Carlqvist Admin
* _TBD..._
133
134 5 Torbjorn Carlqvist Admin
h3. Developer's Guide
135 14 Torbjorn Carlqvist Admin
136 19 Torbjorn Carlqvist Admin
[[IDE|IDE walk through]]
137
[[Javascript|The DTXr Javascript guide]]
138
[[Blockly|Blockly tutorials]]