Help

The next paragraphs describe the main features that NearBus offer to you, in order to allows you to configure, supervise and troubleshooting the remote devices connections.

If you are going to configure the Arduino Ethernet platform for the first time, please try the App Note 1218 - Hello World example.

This screen allows you interconnect different NearBus device using the Xively Cloud Services as an interconnection HUB (of analog signals). This feature allows to POST data to Xively (WRITE) and to GET data from Xively (READ). Additionally this module allows you to process the signal with three basic transfer functions (Gain, Offset and Deadband).

The following picture shown the X-CONTROLLER screen configuration fields:

Function: This field shown the Function configutaed over the Channel.

Manual: This field shows if the channel is on manual mode or not. In order to work with this module the selected Channel should be in manual mode (mandatory).

--> : Selecting this option allows you to configure that a remote-device's read signal (eg. with ADC_INPUT) be sent to a specific Xively Datastream.

<-- : Selecting this option allows you to configure that a Xively read signal be sent to the a defined NearBus Function on a specified channel.

Gaint, Offset and DeadBand: This feature allows you to apply a basic signal processing to the signal before connect it to Xively, or a NearBus Channel:

     f(x) = DeadBand( x * Gain + offset )

The DeadBand() function works as an Hysteresis Transfer Function, generating a digital output signal (1 or 0). The following example shown a generic deadband operation (with a -0,5 deadband not zero centred):

When the sensed signal drops below the bottom setting value in the hysteresis block (below 21,5 deg. C) , the output will be UP (1). In turn when the temperature rises over the top setting value in the hysteresis block ( over 22,5 deg. C) the output will go DOWN (0).

(in this example in order to center the sensed signal around 0 an offset of -21 should be configured)

IMPORTANT: The Deadband function only will work arround 0 (zero). That means that the specified parameter represents 1/2 of the deadband centred on 0. A negative deadband value will generate an inverted output.

Filter: This feature allows you to apply a Digital Filter to the signal processed value in order to smoothing the output (First Order Digital Filter). The following picture shows a comparison between: (A) An output with filter and (B) and output without filter:

Features:

- The filter output will reach the 90% of its final value in approximately 16 refresh-time slots.

- The digital filtering is the first function applied in the signal processing chain.

Stream ID: This field allows you to set the Xively datastream where you want to write/read the signal.

Value: This field shown the signal value after processing.

Connect: This option allows you to "connect" each NearBus channel to/from a Xively Data Stream.

Xively Feed and API Key: This option allows you to configure the required parameters to connect succesfully to www.xively.com.

IMPORTANT: This feature only will work on devices with NearBus release v0.14 onwards.

X-Control V2 - Digital Signal Processing - NEW!!!

These features only will work on devices with NearBus release v0.15 onwards.

DIGITAL FILTER: The X-Control v2 applies a Second Order Bessel Digital Filter that offers a better performance (noise mitigation and signal smoothing).

DIFFERENTIAL PROCCESSING: This module allows you to apply a Differential proccessing over the signal (Inegration and Derivation):

INTEGR: The output signal will be the integral of the input signal. (eg: to obtain the Energy [KW/hr] from the instant power [W] measured from a Current transformer)

DERIV: The output signal will be the derivative of the input signal.

OFF: The module is desactivated (no proccessing is applied to the signal).

RESET: Set the initial values to zero (eg: to reset the output when working in Integration mode).

OUTPUT LIMITER: This module when configured will limit the output signal to the set value. This feature is useful when you send data to Xively because its auto-scale feature can be useless when you are experimenting with wide flapping signals (the saturation peaks hide the valid readings).

OFF: The module is desactivated (no limitation is applied to the signal).

<value>: Here you should set the absolute value to limit  the signal (the system limits both positive and negative values).

Device Monitor

This screen shows you the system data interchange for each device over the following interfaces:

NearHub <--> Device

NearApi <--> User App

AGENT DEBUG: (not shown) This option allows you to activate and deactivate the Agent debug output (the terminal output on the Arduino platform).

Note: this feature is intended to be used in troubleshooting and system tuning.

REMEMBER: If you are experimenting random errors with your code (usually on memory exhaustion conditions), verify that the #define parameters DEBUG_DATA, DEBUG_BETA and DEBUG_ERROR (in file NearBusxxx_xxx.cpp) are all set to 0 (in order to deactivate the output debug messages).

Changing User Configuration

In order to change your user configuration (password / email) you should "click" on the user name link in the DEVICES LIST screen, as showen in the following picture:

The EDIT USER screen allows you to change your account password and/or your notification email address:

REST API - VMCU MODE

For information about the VMCU mode please go to: NearAPI REST Documentation

REST API - TRANSPARENT MODE

Probably the most powerful feature of NearBus system is the Transparent mode working with RTESful. Under this mode the system allows you to exchange up to eight 32 bits registers (int) in each system call.

The API URL is the following:

http://www.nearbus.net/v1/api_transp

This interchange (or synchronization works) as a simple function call that you can do from your Arduino sketch, as a traditional function call.

There are 2 group of 8 (32 bits) registers each: rxChannel[ ] and txChannel[ ]:

The rxChannel[ ] is used to receive the data from the Cloud and the txChannel[ ] is used to send the data to the Cloud.

As you can see in the following example (to turn on and turn off the Arduino pin 3), there is no change in the way in which the sketch is programmed. The only requirement is to set the txChannel[ ] registers, then call the Agente.NearChannel() function and finally process the received values in the rxChannel[ ].

IMPORTANT: Remember to configure your NearBus device in "TRSNP" mode (uncheck the VMCU option) in the "EDIT DEVICE" configuration screen.

When calling the Agente.NearChannel() function, the data in the txChannel[ ] will be replicated in the NearHub data base Reg A (data from the Agent) and the rxChannel[ ] will be updated with a copy of the data in the NearHub data base Reg B (data to the Agent)

From the application point of view the data can be exchanged through the RESTful API calls, in a similar way as was shown in the VMCU mode.

The following examples shows the browser's command line (browser's address bar) that should be used to turn on and turn off the Arduino's pin 3 in the last example.

Turning ON the pin

http://nearbus.net/v1/api_transp/NB100xxx?user=****&pass=****&method=POST&reg00=1

Turning OFF the pin

http://nearbus.net/v1/api_transp/NB100xxx?user=****&pass=****&method=POST&reg00=0

Note: In order to simplify the example the unused registers have been avoided (the transp_api supports this syntax). The full example to turn on the pin should be:

http://nearbus.net/v1/api_transp/NB100xxx?user=****&pass=****&method=POST&reg00=1&reg01=0&reg02=0&reg03=0&reg04=0&reg05=0&reg06=0&reg07=0

If you are interested in trying the NearAPI please contact us at: info@nearbus.net

(*) This initial trial release has been deployed only for the Arduino Ethernet platform. We are deploying new Agent libraries for other Arduino boards and platforms with Ethernet and Wi-Fi connectivity.

Help

Contents

Devices List

Device Configuration

New Device / Edit Device

Device Statistics

Xively Configuration (former Cosm)

X-Control (Xively) NEW!!!

X-Control V2 - Digital Signal Processing - NEW!!!

Device Monitor

Changing User Configuration

REST API - VMCU MODE

REST API - TRANSPARENT MODE

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

NEAR HELP

JAVA SCRIPT CODE

APPS NOTES

GROVE SUPPORT

EEWEB RESOURCES

RESOURCES

DATASHEETS

Tools