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