Domotcl

Download

Terminology

Operation

Actions

Nodes

Drivers

Development

OS specifics

To install domotcl, basically all that needs to be done is to unpack the domotcl.tgz file in a location of your choice. You will also need a runtime appropriate for the platform to run the various parts. All of these can be downloaded from the download page.

Below are some more detailed instructions for selected platforms.

Ubuntu LTS 18.04.2 Desktop
Raspbian Stretch with desktop
Windows (domotcl explorer only)

Ubuntu LTS 18.04.2 Desktop

The Ubuntu Desktop 18.04 LTS ISO can be downloaded from https://www.ubuntu.com/download/desktop. Follow the instructions on the same page for creating a DVD or a bootable USB stick.

When booting from the installation DVD or USB stick, select "Install Ubuntu". The minimal installation suffices as a starting point for running domotcl, although the normal installation can of course also be used. The default disk partitioning (a single ext4 partition) will work fine.

During installation, a user account will be created. This can be the user that will run domotcl. An account to run domotcl can also be created later, if desired. These instructions assume the username for this account is domotcl.

When the installation is complete, log in with the domotcl user account. Then create a bin directory and download and install the domotcl runtime into that directory. 

    mkdir ~/bin
cd ~/bin
wget http://domotcl.tclcode.com/download/linux64/tclkit
chmod +x tclkit
The domotcl user account must be added to the dialout group to allow access to serial devices. 
    sudo usermod -aG dialout domotcl
This change will only take effect in future login sessions, so you may want to log off and log in again. That will also result in the ~/bin directory being added to the PATH variable.

A few additional packages will improve the appearance of the domotical explorer. 

    sudo apt install tango-icon-theme oxygen-icon-theme
To install domotcl, run the following commands: 
    cd
wget -qO- http://domotcl.tclcode.com/download/domotcl.tgz | tar xzv

Raspbian Stretch with desktop

The Raspbian Stretch ISO can be downloaded from https://www.ubuntu.com/download/desktop. Follow the instructions on the same page for installing the image onto an SD card.

By default a user account called pi is available. You can use this account to run domotcl, but these instructions assume a separate account called domotcl will be created for this purpose.

After booting raspbian, log in with the domotcl user account. Then create a bin directory and download and install the domotcl runtime into that directory. 

    mkdir ~/bin
cd ~/bin
wget http://domotcl.tclcode.com/download/linuxahf/tclkit
chmod +x tclkit
The domotcl user account must be added to the dialout group to allow access to serial devices. 
    sudo usermod -aG dialout domotcl
This change will only take effect in future login sessions, so you may want to log off and log in again. That will also result in the ~/bin directory being added to the PATH variable.

A few additional packages will improve the appearance of the domotical explorer. 

    sudo apt install tango-icon-theme oxygen-icon-theme
To install domotcl, run the following commands: 
    cd
wget -qO- http://domotcl.tclcode.com/download/domotcl.tgz | tar xzv

Windows

Windows can only be used to run the domotcl explorer. It does not have the capabilities required to run the core.
  1. Download the domotcl application and unpack it in a location of your choice.
  2. Download the 32-bit runtime package, or the 64-bit runtime package, as appropriate for the OS. The 32-bit version should work in most cases.
  3. Unpack the runtime package inside the domotcl directory that was created in step #1.
  4. The domotcl explorer shortcut points to H:\domotcl. Chances are that is not where you put the domotcl application. Edit the properties of the shortcut to set the correct location. You may also have to change the --address argument to point to the machine that will run the domotcl core.