node-susi/README.md

Access data from SUSI on ADVANTECH platform

# node-susi

This node.js module supports SUSI driver function from ADVANTECH platform.

## Installation
``` bash
$ npm install node-susi
```

## Usage

This module uses the SUSI driver that requires access to 
/open/mem. Because of this, you will typically run node with admin privileges.

The first step is initialization(select) specifying the sensor or IO type . It should work for SUSI HWM function. If the initialization succeeds when you can call the read function to obtain the latest readout from the ADVANTECH platform. Readout values contains a temperature...etc property.

### First Example

This sample queries the SUSI HWM CPU temperature and displays the result on the console. 

``` javascript
var sensorLib = require('node-susi');
var cpuIndex = 0;

var sensor = {
    read: function () {
        var readout = sensorLib.getTemperature(cpuIndex);
        console.log('Temperature: ' + readout + 'C');
        setTimeout(function () {
            sensor.read();
        }, 2000);
    }
};

sensor.read();

```

### Reference for building from source

Standard node-gyp commands are used to build the module.

1. Generate the configuration files
``` bash
$ node-gyp configure
```
2. Build the component
``` bash
$ node-gyp build
```

### References

[1]: Node.js latest release - http://nodejs.org/dist/latest/

[2]: SUSI API - http://www2.advantech.tw/products/SUSI-API/sub_7ECC9263-4178-4E8D-A9CF-3397A2128FFA.aspx

[3]: SUSI Driver download (by platform)- http://support.advantech.com.tw/support/SearchResult.aspx?keyword=AIMB-215%20B1&searchtabs=%20Utility,Software%20Utility,Software%20API

[4]: Node.js native addon build tool - https://github.com/TooTallNate/node-gyp