Latest revision as of 10:55, 3 July 2019

Introduction

WiseSnail is the short name of Wise Sensor Network Abstract Interactive Layer. It is a layer to define the topology and behavior of sensor network. A complete device represented in WiseSnail includes one virtual gateway, one sensor connectivity interface and several sensor devices. WiseSnail provides a form-like array which we call it infospec array to define tha parameters of sensor device. And a form-like data array updates your real time data. So, you can easy to represent your device by creating several arrays.

Design intention

We refer the data handle flow on Wise-PaaS to design a data layout like right picture. There are two arrays, interface and sensor device, to implement the behavior of gateway. Each variable array includes several tags. A tag is a variable to indicate the parameter on interface or sensor device. So, we have two register functions and assign into two arrays to generate tags.

Hardware requirements

CPU architecture

• x86
• arm

Minimum ram size

• 256kb and above.

OS

• Ubuntu ( 14.04, 16.04 )

• Yocto ( 1.5.3 Dora )
• OpenWRT
• Windows ( x86 )

External library dependency requirements

1. OpenSSL
2. Paho
3. Mosquitto

Source Code

GitHub

https://github.com/ADVANTECH-Corp/WiseSnail.git

Source tree

inc	header files
library	includes AdvJSON, AdvLog, WiseCore
sample	a simple sample to test library.
source	source files

Configure

Optional

--disable-paho	Disable Paho support.
--disable-mosquitto	Disable Mosquitto support.

Compile

You can perform the following steps to build this library.

./configure Or ./configure --host=<your cross compiler> --prefix=<install path> make make install

Compile script

This script combines compile steps and version control handling.

./snailconf.sh Or ./snailconf.sh --host=<your cross compiler> --prefix=<install path>

Build sample

Enter the folder of sample,and make it directly. You can change the MQTT library by editing makefile.

Capability

#define MAX_DEVICES 16     //The Maximum number of sensor device
#define MAX_ITEMS 16       //The Maximum number of sensor value
#define MAX_CMDS 16        //The Maximum number of command that can be processed in one second.

Structures

Data Type

    WISE_VALUE  //for numeric value
    WISE_FLOAT  //for floating point
    WISE_STRING //for string
    WISE_BOOL   //for boolean
    WISE_CUSTOMIZE          //for a customize value, use the following type definition
        WISE_BASE64         // a base64 format data.

Infospec

    struct WiseSnail_InfoSpec{
      WiseSnail_DataType type;
      char *name;
      char *unit;
      union {
        float value;
        char *string;
        WiseSnail_RAW *raw;
      };
      float min;
      float max;
      char *resourcetype;
      WiseSnail_SetValue setValue;
      WiseSnail_GetValue getValue;
      WiseSnail_FormatType format;
    };

    {
      WISE_VALUE,                  //WiseSnail_DataType 
      "Temperature",               //name
      "Cel",                       //unit
      0,                           //value or string
      -100,                        //min
      200,                         //max
      "ucum.Cel",                  //resourcetype, optional
      NULL,                        //set function
      NULL                         //get function
    }

Data

    struct WiseSnail_Data{
      WiseSnail_DataType type;
      char *name;
      union {
        float value;
        char *string;
        WiseSnail_RAW *raw;
      };
      WiseSnail_FormatType format;
      char *clientId;              //internal
      WiseSnail_InfoSpec *info;    //internal
    }

    {
      WISE_VALUE,                  //WiseSnail_DataType 
      "Temperature",               //name
      100                          //value or string
    }

Callbacks

 typedef int (*WiseSnail_SetValue)(WiseSnail_Data *data);

 typedef int (*WiseSnail_GetValue)(WiseSnail_Data *data);

 typedef void (*WiseSnail_SleepOneSecond)(void);

Functions

Initial & Uninitial

• WiseSnail_Init

• WiseSnail_Uninit

Register

• WiseSnail_RegisterInterface

One instance only includes one interface.

• WiseSnail_RegisterSensor

The maximum number of sensor devcie, please refer to MAX_DEVICES.

Connect

• WiseSnail_Connect

Update

• WiseSnail_Update

You can update your data from this function by assigning a data array.

Main Handle Loop function

• WiseSnail_MainLoop

This is a very important function. It includes main logic and error handling. The interval of sleepOneSec must be one second.

You also can run an external timer, but this function must be executed per one second.

Sample Program

Prerequest

1. Visual Studio 2015 or above.

    Download URL: https://docs.microsoft.com/zh-tw/visualstudio/install/install-visual-studio?view=vs-2019

2. WISE-Agent 1.1.x

    Download from WISE-PaaS/EdgeSense Portal, Settings Page.

3. API-GW 2.0.x

    Download URL: https://www.dropbox.com/s/amsooqwswabfxbk/API-GW-2.0.7.exe?dl=0

Sample Code Overview

(pseudo code)

WiseSnail_InfoSpec interface[] = {
		{
				WISE_BOOL,
				"/Info/reset",
				"",
				0,
				0,
				1,
				"",
				Reset
		}
};

void SetGPIO_1(WiseSnail_Data*data) {
    printf("(GPIO 1) = %d\r\n",data->value);
}

void SetGPIO_2(WiseSnail_Data*data) {
    printf("(GPIO 2) = %d\r\n",data->value);
}

/***********************CUSTOMIZE VALUE FOR BASE64*******************************/
char rawData[128] = "ABCDE";
WiseSnail_RAW rawItem = {
    .data = rawData,
    .len = 5
};

int SetRAW(WiseSnail_Data *data) {
    if(data->type == WISE_CUSTOMIZE) {
        memcpy(&rawItem, data->raw, sizeof(rawItem));
    }
}

int GetRAW(WiseSnail_Data *data) {
    if(data->type == WISE_CUSTOMIZE) {
        memcpy(data->raw, &rawItem, sizeof(rawItem));
    }
}
/********************************************************************************/

WiseSnail_InfoSpec infospec[] = {
		{
				WISE_STRING,
				"/Info/Name",
				"",
				.string = "SenHub1",  // Device Name of SenHub (*) 
				0,
				0,
				"",
				//SetSHName,
				.getValue = GetSHName
		},
		{
				WISE_VALUE,			//type
				"Temperature",	    //name
				"Cel",				//unit
				0,				    //value[union]
				-100,				//min
				200,				//max
				"ucum.Cel"			//resourceType
		},
		{
				WISE_VALUE,			//type
				"Humidity",			//name
				"%",				//unit
				0,				    //value[union]
				0,				    //min
				100,				//max
				"ucum.%"			//resourceType
		},
                {
		        	WISE_IO_BOOL,
                        	"GPIO1",
                        	"",
                        	0,
                        	0,
                        	1,
                        	"",
                        	SetGPIO_1
                },
                {
                        	WISE_IO_BOOL,
                        	"GPIO2",
                        	"",
                        	0,
                        	0,
                        	1,
                        	"",
                        	SetGPIO_2
		},
                {
                                WISE_CUSTOMIZE,
                                "RAW",
                                "",
                                .raw = &rawItem,
                                0,
                                1,
                                "",
                                SetRAW,
                                GetRAW,
                                WISE_BASE64
		}
};

WiseSnail_Data data[] = {
		{
				WISE_VALUE,			//type
				"Temperature",			//name
				100				//value
		},
		{
				WISE_VALUE,			//type
				"Humidity",			//name
				55				//value
		},
                {
                                WISE_CUSTOMIZE,
                                "RAW",
                                .raw = &rawItem,
                                WISE_BASE64
		}
};

void sleepOneSecond() {
	sleep(1);
}

#define SERVER_ADDRESS "rmm.wise-paas.com"

int main() {
	//initial
	WiseSnail_Init("IotGW",NULL, NULL, NULL, 0);
	WiseSnail_RegisterInterface("000E4CAB1234", "Ethernet", -1, interface, 1);
		
	if(WiseSnail_Connect(SERVER_ADDRESS, 1883, "", "", NULL, 0) == 0) {
		//
		// no succesful connection to broker
		//
		return -1;
	} else {
		WiseSnail_RegisterSensor("000E4C000000", "OnBoard", infospec, sizeof(infospec)/sizeof(WiseSnail_InfoSpec));
	}
		
	int count = 0;
	int second = 0;
	for(;;) {
		if(second == 0) {
			/*HDC1050_GetSensorData(&Temperature, &Humidity);
			  data[0].value = Temperature;
			  data[1].value = Humidity;
			*/
				
			if(data[0].value < 100) {
				data[0].value++;
			} else {
				data[0].value = 0;
			}
				
			if(data[1].value < 100) {
				data[1].value++;
			} else {
				data[1].value = 0;
			}

			printf("\r\n****** \033[33mSend update.\033[0m ******\r\n");
			WiseSnail_Update("000E4C000000", data, 2);
		count++;
		}

		WiseSnail_MainLoop(sleepOneSecond);	
		second = (second+1)%5;
	}
	return 0; 
}

Get WiseSnail Project

1. Open WiseSnail project URL: https://github.com/ADVANTECH-Corp/WiseSnail.git

2. Download ZIP of WiseSnail project and unzip it to your local storage, for example: "C:\Projects\WiseSnail"

Compile Sample Code

1. Install prerequest packages that listed in Prequested Packages session.

2. Open \WiseSnail\project\VS2015\WiseSnail\Test.sln from Visual Studio menu.

3. Change Solution Platform to "x86".

4. Rebuild Solution.

5. After sample program rebuilt, open Debug (or Release) folder to check if the output file Test.exe is created.

Run Sample Code

1. Create a new folder named WSNTest on Desktop (or any folder you like)

2. Copy all DLL files in the folder \WiseSnail\prebuilt_files\ and put sample program Test.exe together in the same folder.

3. Double click "Test.exe" to run sample program, the simulated sensor data will start uploading.

Check Cloud Data

1. Open WISE-PaaS/EdgeSense Portal and login using your account. 

2. Click "+Add" to add your device to WISE-PaaS/EdgeSense.

3. Click on your device name, for example "GW-ARK-1123H".

4. Click on "Device Children" to open the page.

5. Click on "Monitor" icon to check sensor hub list.

6. Click on SenHub icon to check sensor data.

7. In this page, you can find all sensors that you uploaded.