Project

General

Profile

DTXr doc » History » Version 49

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