1. IoT Dev Board (Raspberry Pi 3/4 preferred)
2. microSD card and microSD card Reader/Adapter
3. Chosen Hardware Sensor

Before you begin testing please, Check

• Ensure that the H/W sensor is working perfectly. (Test with Arduino and Arduino library to know if the sensor H/W works)
• Ensure that the sensor is fully ported.
• Ensure that an example for your Sensor/Feature is available in the examples/ folder.

1. Install Shunya OS.
2. Install the library.
3. Compile the examples.
4. Connect Hardware.
5. Configure and Run.

Download and Install Shunya OS, follow this guide if you have any problems installing Shunya OS.

Boot into Shunya Interfaces and you are ready to test!.

Shunya Interfaces uses Cmake as it build engine, you can follow these steps to compile and install the library from scratch.

Note: These steps are for native compile (i.e Run these commands on Shunya OS). Currently, We do not have instructions for cross-compiling (i.e Compiling on your laptop) the library.

Running these commands below on the Terminal in Shunya OS, should get you the latest source.

# Clone the project, Skip if you have cloned the project.
git clone https://github.com/shunyaos/shunyainterfaces.git
cd shunyainterfaces

Most of the sensor under testing may not be available in the master branch, So Checkout to the testing branch by running command.

How to find the branch name?: Each sensor that is under porting must have an issue, Please check issues tab, navigate to the sensor specific issue, and you will find the branch-name.

TODO: Dry run this once, Check if this is true. Make it easy for the testers to find the branch and checkout.

git checkout <branch-name>

Running these commands in the Terminal should get shunya interfaces installed.

# Create a build directory
mkdir build
cd build 
# Configure 
cmake ../
# Build 
make 
# Install Shunya Interfaces
sudo make install 

You will find examples for testing the sensor in the examples/ folder, compiling the example is just compiling a C program.

# Command assumes that you are in build folder, from the previous run
# Change the cd command according to your current folder.
cd ../examples 
# Replace the names appropriately
gcc -o test example.c -lshunyaInterfaces_user -lshuynaInterfaces_core

It is time to connect sensors to the board.

• Make sure dev board power supply is off, before you start connecting.
• Check the Vcc and GND pins of the sensor are connected correctly.
• Check if you connected 1.8 V or 3.3 V pin on the dev board to the Sensors 1.8V or 3.3V pin and not the 5V pin.

After checking these things you can connect the Power Supply to the dev Board.

Note:

Tell Shunya Interfaces your hardware connections, by writing the connections into a YAML file.

You will find the file at /etc/shunya/interfaces/config.yaml

to Open the file Run command

$ sudo vi /etc/shunya/interfaces/config.yaml

We write Pin number to Sensor ID, key:value pairs, where pin number is the key and Sensor ID is the value.

For Example:

pin 3: 1.1 # Key: Value

Sensors for Shunya Interfaces are represented in Sensor ID's. Sensors also have pins, these Pins are also numbered and these numbers are called

Each Sensor is given a number (Sensor ID) which the Shunya Interfaces library recognizes. And each data pins(pins used for data transfer) on the Sensor is given a number (Connection ID).

So when we write pin 1: 1.1 Shunya Interfaces understands it as <Sensor 1>.<Sensor data pin 1> connected to pin 1 of Raspberry Pi (or a board).

For example: Sensor 6 and Data Pin 1 connected to pin 3 on the board.

pin 3: 6.1

You can create an array of Sensor ID's and assign it to a pin.

For Example:

pin 3: [1.1, 6.1]

Final Step, Just run the compiled example to test the sensor.

# Replace test with your binary name.
$ sudo ./test 

Note: Make sure to provide sudo permissions for the example, to make it run correctly.