Project

General

Profile

DTXr doc » History » Version 44

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