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