Project

General

Profile

DTXr doc » History » Version 57

Torbjorn Carlqvist Admin, 09/05/2022 10:16 AM

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 56 Torbjorn Carlqvist Admin
### Download the installation script from davitor repository
29 1 Torbjorn Carlqvist Admin
<pre>wget --user=admin --password=**** https://artifacts.davitor.com/repository/dtx-raw/scripts/dtx.sh</pre>
30 56 Torbjorn Carlqvist Admin
There is also a utillity script that can set the host name and MAC adress. Note, optional and only applicable on LION product appliances.
31 1 Torbjorn Carlqvist Admin
<pre>wget --user=admin --password=****  https://artifacts.davitor.com/repository/dtx-raw/scripts/system.sh</pre>
32 56 Torbjorn Carlqvist Admin
Make the scripts exec
33
<pre>sudo chmod 770 *.sh</pre>
34 57 Torbjorn Carlqvist Admin
### Run installation as below where you first alter:
35
*** Required version (-v x.y.z)
36
*** Partner user name (-u ****)
37
*** Partner password (-p ****)
38
*** Application password for the HTTP interface login on port 9090 (-app-password xxxxxxx)
39
*** BACnet password which you will use to control the BACnet device DCC (bacnet-password=xxxxxx)
40
*** BACnet Device Name (bac-device-name=yyyy)
41
For LION products use:
42
<pre>sudo ./dtx.sh -v 3.0.15 -u **** -p **** -s "bac-device-id=83336 bac-device-name=yyyy app-password=xxxxxx bac-password=xxxxxx lion-enabled=true"</pre>
43
For other installations like PC, Servers etc. use:
44
<pre>sudo ./dtx.sh -v 3.0.15 -u **** -p **** -s "bac-device-id=83336 bac-device-name=yyyy app-password=xxxxxx bac-password=xxxxxx"</pre>
45 55 Torbjorn Carlqvist Admin
### Utillity script to set MAC and host name
46 54 Torbjorn Carlqvist Admin
<pre>sudo ./system.sh -mac 70:B3:D5:16:E8:99 -hn DTX-L1-8R8DI</pre>
47
48 55 Torbjorn Carlqvist Admin
* Manage the DTX service
49
Stop<pre>sudo systemctl stop dtx</pre>
50
Start<pre>sudo systemctl start dtx</pre>
51
Check status<pre>systemctl status dtx</pre>
52
Disable service, wont start at reboot<pre>sudo systemctl disable dtx</pre>
53
Enable service, will start automatically at reboot<pre>sudo systemctl enable dtx</pre>
54 15 Torbjorn Carlqvist Admin
55 55 Torbjorn Carlqvist Admin
* For other Linux distributions follow this steps
56 15 Torbjorn Carlqvist Admin
### _TBD..._
57
58 1 Torbjorn Carlqvist Admin
* Install on Windows
59
** Follow these steps:
60 32 David Fredriksson
### _TBD..._
61 38 Torbjorn Carlqvist Admin
62 32 David Fredriksson
h3. LION Fieldbus
63 38 Torbjorn Carlqvist Admin
64 15 Torbjorn Carlqvist Admin
* See LION [[LION:Wiki]] for howto in installataion, channel assigmnets and testing.
65 11 Torbjorn Carlqvist Admin
66 10 Torbjorn Carlqvist Admin
h3. Setup
67 11 Torbjorn Carlqvist Admin
68 1 Torbjorn Carlqvist Admin
DTXr is setup via Menu -> Setup page.
69 11 Torbjorn Carlqvist Admin
70 1 Torbjorn Carlqvist Admin
* System
71 42 David Fredriksson
** Administrator password - Password for the default (and not changeable) account  **"admin"**. Default is **"davitor"**.
72
_When you log in you will start att /home/admin
73 13 Torbjorn Carlqvist Admin
There is another user "pi" as well with a secret password._
74
** Operator username - Username for the typical user of any HMI developed on this device. Typically a machine operator. [Optional]
75
** Operator password - Password for the operator user. [Optional]
76
** Operator start page - Set any web page in the project folder that will automatically shown on an operator login. [Optional]
77 11 Torbjorn Carlqvist Admin
** Log Level - The system severity level for the system_app.log in /Logs tree directory.
78
79 14 Torbjorn Carlqvist Admin
* BACnet
80 11 Torbjorn Carlqvist Admin
** _TBD..._
81
82 14 Torbjorn Carlqvist Admin
* Davitor Advantage
83 11 Torbjorn Carlqvist Admin
** _TBD..._
84
85 14 Torbjorn Carlqvist Admin
* Wireless Mesh
86 11 Torbjorn Carlqvist Admin
** _TBD..._
87
88 14 Torbjorn Carlqvist Admin
* Bluetooth
89 11 Torbjorn Carlqvist Admin
** _TBD..._
90
91 14 Torbjorn Carlqvist Admin
* External Database Access
92 11 Torbjorn Carlqvist Admin
** _TBD..._
93
94 14 Torbjorn Carlqvist Admin
* File Integration
95 11 Torbjorn Carlqvist Admin
** _TBD..._
96
97 14 Torbjorn Carlqvist Admin
* HTTP
98 11 Torbjorn Carlqvist Admin
** _TBD..._
99
100 14 Torbjorn Carlqvist Admin
* LION Interface
101 11 Torbjorn Carlqvist Admin
** _TBD..._
102
103 14 Torbjorn Carlqvist Admin
* IoT HUB (BETA)
104 11 Torbjorn Carlqvist Admin
** _TBD..._
105 1 Torbjorn Carlqvist Admin
106
107 2 Torbjorn Carlqvist Admin
h3. User's Guide
108 14 Torbjorn Carlqvist Admin
109
* _TBD..._
110 5 Torbjorn Carlqvist Admin
111 14 Torbjorn Carlqvist Admin
h3. Developer's Guide
112 19 Torbjorn Carlqvist Admin
113
[[IDE|IDE walk through]]
114
[[Javascript|The DTXr Javascript guide]]
115 1 Torbjorn Carlqvist Admin
[[Blockly|Blockly tutorials]]