• Table of contents
• DTXr documentation
  • • Installation
    • LION Fieldbus
    • Setup
    • User's Guide
    • Developer's Guide

DTXr documentation¶

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:
    1. Download latest DTXr base image and copy to a SD-card that has 16Gbyte capacity or more
    2. Insert the SD card, attach keyboard and screen via cable and start the device
    3. When you get prompt login as admin/davitor
    4. Download the installation script from davitor repository
       

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

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

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

       
       Make the scripts exec
       

       sudo chmod 770 *.sh

    5. Run installation as below where you first alter:
    • Required version (-v x.y.z)
    • Partner user name (-u **)
    • Partner password (-p **)
    • Application password for the HTTP interface login on port 9090 (-app-password xxxxxxx)
    • BACnet password which you will use to control the BACnet device DCC (bacnet-password=xxxxxx)
    • BACnet Device Name (bac-device-name=yyyy)
      For LION products use:
      

      sudo ./dtx.sh -v 3.0.15 -u **** -p **** -s "bac-device-id=83336 bac-device-name=yyyy app-password=xxxxxx bac-password=xxxxxx lion-enabled=true"

      
      For other installations like PC, Servers etc. use:
      

      sudo ./dtx.sh -v 3.0.15 -u **** -p **** -s "bac-device-id=83336 bac-device-name=yyyy app-password=xxxxxx bac-password=xxxxxx"

    1. Utillity script to set MAC and host name
       

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

• Manage the DTX service
  Stop

  sudo systemctl stop dtx

  
  Start

  sudo systemctl start dtx

  
  Check status

  systemctl status dtx

  
  Disable service, wont start at reboot

  sudo systemctl disable dtx

  
  Enable service, will start automatically at reboot

  sudo systemctl enable dtx

• For other Linux distributions follow this steps
  1. TBD...

• Install on Windows
  • Follow these steps:
    1. TBD...

LION Fieldbus¶

• See LION Wiki for howto in installataion, channel assigmnets and testing.

Setup¶

DTXr is setup via Menu -> Setup page.

• System
  • Administrator password - Password for the default (and not changeable) account "admin". Default is "davitor".
    When you log in you will start att /home/admin
    There is another user "pi" as well with a secret password.
  • 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...

User's Guide¶

• TBD...

Developer's Guide¶

IDE walk through
The DTXr Javascript guide
Blockly tutorials