Install the SDK and start building your own applications for interacting with the Touch Sensor Module. You can also run the included example program to immediately start communicating with the Touch Sensor Module. 

Downloading zForce SDK

Download the SDK.

Preparing the system for building and running SDK programs

The SDK has been tested on Ubuntu 18.04, 20.04 and 22.04 but should work well on other linux flavours too.

Preparing Ubuntu 18.04/20.04/22.04

This instruction may work on other Ubuntu and Debian versions as well.

1. Make sure there is an Internet connection.
2. Open a terminal.

3. Execute the following command to install gcc, the libudev development files and update the system.

   sudo apt-get update && sudo apt-get -y install build-essential libudev-dev && sudo apt-get -y dist-upgrade

4. Enter the password when prompted.

5. When the installation completes, reboot the system.
6. Extract zForceSDK-x.x.x.tar.gz or zForceSDK-x.x.x.zip into any folder.

Preparing Other Linux Flavors

1. Follow the Linux distribution's normal methods to install packages, for example, if Internet access is required, make sure it is available.
2. Install the following tools:
   1. gcc or clang.
   2. make
   3. cpp
   4. binutils
3. Install the following development files:
   1. glibc development files
   2. pthreads development files
   3. libudev development files
4. Extract zForceSDK-x.x.x.tar.gz or zForceSDK-x.x.x.zip into any folder.

Building and Running the Example Program

The example program is included in the SDK for two reasons, to allow you to start communicating with the Touch Sensor Module and to serve as a starting point for creating your own application. 

1. Enter the directory that was created when extracting the .tar.gz or .zip file.
2. Open the file called "Makefile" with a texteditor. 

3. Go to the top of the file, and remove the hash from whichever CPU architecture you are using, and then save and close the file.
   If you are using ARMv6+VFPv2 it should look like this:

   #ARCHITECTURE=x86-64 ARCHITECTURE=ARMv6+VFPv2

4. In the terminal, navigate to the directory that was created when extracting the .tar.gz or .zip file.

5. Execute the following command to build the example program:

   make

6. Check for errors. If errors occur, make sure that all steps for Preparing the system were performed correctly. If another flavor of Linux than Ubuntu 16.04 is used, the compiler version may be too old. If that is the case, upgrade the compiler.

7. To run the example program using USB HID:
   a. Plug in a USB-HID enabled Touch Sensor Module into a USB port of the computer.
   b. Navigate to the root folder of the SDK release.
   c. Execute the following command to run the example program:

   sudo ./zForceSDK-Example

8. If prompted, enter the password.
9. To break the program, press Control-C.