DTXsc

{{>toc}}

h1. DTXsc documentation

h3. Installation

* System Requirements

DTXsc 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

DTXsc require an IPV4 interface to function. The service using UDP broadcast to communicate with local network device according to BACnet/IP standard. To reach Internet HUB's the service uses WebSocket communication.

* Download DTXsc software packages

Currently only customers to DAVITOR can download DTXsc. 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 DTXsc _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 the installation script from davitor repository

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

There is also a utillity script that can set the host name and MAC adress. Note, optional and only applicable on LION product appliances (Lx-serie)

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

Make the scripts exec

<pre>sudo chmod 770 *.sh</pre>

### Run installation script. See details below and change to fit your network setup:

<pre>sudo ./dtxsc.sh -v 1.6 -u **** -p **** --bip_instance 777124 --sc_network 2000 --sc_mac 021020040501 --bip_network 3344 --bip_ip 192.168.1.175 --bip_port 47809 --sc_hub_ip 83.145.40.201 --sc_hub_port 44456 -loc HEMMA -descr SCRIPT</pre>

*** -v DTXsc version to run

*** -u user for download

*** -p psw for download

*** --bip_instance Device id on the BACnet/IP side of the router.

*** --sc_network Virtual network id on the Securore Connect side of the router

*** --sc_mac Virtuell MAC for this device on the Secure Connect side of the router. Has to be unique within the whole virtual network.

*** --bip_ip The desired IPv4 address to bind the UDP-port for the BACnet/IP side of the router. Leave blank to let DTXsc determine the IP automatically.

*** --bip_port The UDP port for the BACnet/IP-side of the Router.

*** --sc_hub_ip The IP address to the Internet Secure Connect HUB. (Which is another DTXsc configured as a HUB)

*** -loc Sets the freetext BACnet/IP-device location-property. Use for localization of the Router.

*** -descr Sets the freetext BACnet/IP-device dexcription-property. Use for localization of the Router.

* Utillity script to set MAC and host name

<pre>sudo ./system.sh -mac 70:B3:D5:16:E8:99 -hn DTX-L1-8R8DI</pre>

* Manage the DTXsc service

Stop<pre>sudo systemctl stop dtxsc</pre>

Start<pre>sudo systemctl start dtxsc</pre>

Check status<pre>systemctl status dtxsc</pre>

Disable service, wont start at reboot<pre>sudo systemctl disable dtxsc</pre>

Enable service, will start automatically at reboot<pre>sudo systemctl enable dtxsc</pre>