Send a measurement

    op=10 or op=MEASUREMENT

Sends a VSCP measurement event on a high level. Requires a valid session parameter

General form:

http://host:port/vscp/rest?
    vscpsession=d1c13eb83f52f319f14d167962048521&
    format=plain|csv|xml|json|jsonp&
    op=10|measurement&
    guid=00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:01
    type=valid VSCP measurement type
    eventformat=string|float&
    value=floating point value&
    [level=2]&
    [sensorindex]=0-7|255&
    [unit=(0-3)|255]&
    [zone=(0-255)]&
    [subzone=0-255]

Arguments:

  • guid is the GUID for the event. If not given it defaults to all zeros.

  • type is the VSCP type value specifying which type of measurement this is. Mandatory.

  • eventformat is optional and can be string or float to generate a string based or a float based event. If not give the default value, float, will be used.

  • value is a floating point value for the measurement.

  • level VSCP level (Level I or Level II) to send event as. Can be 1 or 2 and defaults to 2.

  • sensorindex is the index for the sensor for the unit. Can be in the range 0-7 for a Level I event and 0-255 for a Level II event. Defaults to zero.

  • unit is the measurement unit for this type of measurement. An be in the range 0-3 for a Level I event and 0-255 for a Level II event. Defaults to zero.

  • zone zone value for Level II events. Defaults to zero.

  • subzone zone value for Level II events. Defaults to zero.

HTTP Request with GET

http://demo.vscp.org:8884/vscp/rest?vscpsession=d1c13eb83f52f319f14d167962048521&
    format=plain|csv|xml|json|jsonp&
    op=10|measurement&
    guid=00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:01
    type=6&
    value=floating point value&
    [level=2]&
    [sensorindex]=0-7|255&
    [unit=0-3|255]&
    [zone=0-255]&
    [subzone=0-255]&

to test this with curl use the following format

curl -X GET "http://host:port/vscp/rest? \
    vscpsession=d1c13eb83f52f319f14d167962048521 & \
    format=plain|csv|xml|json|jsonp& \
    op=10|measurement"
example GET HTTP request
    http://localhost:8884/vscp/rest?  
              vscpsession=d1c13eb83f52f319f14d167962048521&
              format=plain&
              op=10

HTTP Request with POST

curl -X POST "http://localhost:8884/vscp/rest" \
    -H "vscpsession: d1c13eb83f52f319f14d167962048521" \ 
    -d "op=measurement&format=plain"

Demo

There is a a demo app in the source tree, that demonstrates this functionality using JavaScript.

Javascript Request with JSONP

Responses

Plain

CSV

XML



JSON



JSONP




Very Simple Control Protocol
Mon Sep 24 2018 15:28:11 GMT+0000 (UTC)
This document is licensed under Creative Commons BY 4.0 and can be freely copied, redistributed, remixed, transformed, built upon as long as you give credits to the author.

results matching ""

    No results matching ""