DTXr

{{>toc}}

h1. DTXr documentation

h3. Installation

* System Requirements

DTXr can run on any machine that can run +Java 11+ and has sufficient with RAM and disk capacity.

|Requirement|System RAM|System DISK|Example|

|Minimal|512Mbyte|512Mbyte|Raspberry 1, Raspberry Zero|

|Better|512Mbyte|512Mbyte|Rasberry Zero 2|

|Avarage|1GByte|1Gbyte|Raspberry 2-4|

|Top|2GByte|8Gbyte|Raspberry 4, Raspberry CM4, Server, PC|

* Network Requirements

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.

* Download DTXr software packages

Currently only customers to DAVITOR can download DTXr. Contact info@davitor.com for purchase information.

* Install on Linux

** For Raspberry with Raspberry OS/Rasbian there is special install scripts, please follow these steps:

### Download latest DTXr _base_ image and copy to a SD-card that has 16Gbyte capacity or more

### Insert the SD card, attach keyboard and screen via cable and start the device

### When you get prompt login as admin/davitor

### Download install scripts with password for davitor sight

#### <pre>wget --user=admin --password=**** https://artifacts.davitor.com/repository/dtx-raw/scripts/dtx.sh</pre>

#### <pre>wget --user=admin --password=****  https://artifacts.davitor.com/repository/dtx-raw/scripts/system.sh</pre>

### Run installation as <pre>sudo ./dtx.sh -v 2.25 -u admin -p davitor -s "bac-device-id=83336 bac-device-name=DTX-AMADA app-password=******* lion-enabled=true"

The line above is an example where chosen parameters where set at installation and where ******* is the new password for the new device to use.

</pre>

### Set MAC by system.sh script

### Example:

### <pre>sudo ./system.sh -mac 70:B3:D5:E6:00:10 -hn WASH</pre>

** For other Linux distributions follow this steps

### _TBD..._

* Install on Windows

** Follow these steps:

### _TBD..._

h3. Adressing Lion

* Enter the catalog liontool by <pre>cd liontool</pre> and run <pre>sudo ./liontool.sh -a</pre>

h3. Setup

DTXr is setup via Menu -> Setup page.

* System

** Administrator password - Password for the default (and not changeable) account "admin". Default is "davitor".

** Operator username - Username for the typical user of any HMI developed on this device. Typically a machine operator. [Optional]

** Operator password - Password for the operator user. [Optional]

** Operator start page - Set any web page in the project folder that will automatically shown on an operator login. [Optional]

** Log Level - The system severity level for the system_app.log in /Logs tree directory.

* BACnet

** _TBD..._

* Davitor Advantage

** _TBD..._

* Wireless Mesh

** _TBD..._

* Bluetooth

** _TBD..._

* External Database Access

** _TBD..._

* File Integration

** _TBD..._

* HTTP

** _TBD..._

* LION Interface

** _TBD..._

* IoT HUB (BETA)

** _TBD..._

h3. User's Guide

* _TBD..._

h3. Developer's Guide

[[IDE|IDE walk through]]

[[Javascript|The DTXr Javascript guide]]

[[Blockly|Blockly tutorials]]