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