Installation

Install using

pip install tclab

To upgrade an existing installation, use the command

pip install tclab --upgrade

The development version contains new features, but may be less stable. To install the development version use the command

pip install --upgrade https://github.com/jckantor/TCLab/archive/development.zip

Hardware setup

1. Plug a compatible Arduino device (UNO, Leonardo, NHduino) with the lab attached into your computer via the USB connection. Plug the DC power adapter into the wall.

2. (optional) Install Arduino Drivers

   If you are using Windows 10, the Arduino board should connect without additional drivers required.

   For Arduino clones using the CH340G, CH34G or CH34X chipset you may need additional drivers. Only install these if you see a message saying “No Arduino device found.” when connecting.

   • macOS.

   • Windows.

3. (optional) Install Arduino Firmware

   TCLab requires the one-time installation of custom firmware on an Arduino device. If it hasn’t been pre-installed, the necessary firmware and instructions are available from the TCLab-Sketch repository.

Checking that everything works

Execute the following code

import tclab
with tclab.TCLab() as lab:
    print(lab.T1)

If everything has worked, you should see the following output message

Connecting to TCLab
TCLab Firmware Version 1.2.1 on NHduino connected to port XXXX
21.54
TCLab disconnected successfully.

The number returned is the temperature of sensor T1 in °C.

Troubleshooting

If something went wrong in the above process, refer to our troubleshooting guide in TROUBLESHOOTING.md.

Next Steps

The notebook directory provides examples on how to use the TCLab module. The latest documentation is available at Read the Docs.

Course Websites

Additional information, instructional videos, and Jupyter notebook examples are available at the following course websites.

• Arduino temperature control lab page on the BYU Process Dynamics and Control course website.

• CBE 30338 for the Notre Dame Chemical Process Control course website.

• Dynamics and Control for notebooks developed at the University of Pretoria.