Intro

This page will attempt to describe the POST HTTP request for the Stoker web page.


HTTP Headers

The changes the user makes is passed to the Stoker using the POST method. This means the standard HTTP request is required:

POST /stoker.Post_Handler HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: xxx

the-encoded-data

The xxx is replaced by the actual length of the encoded data. The encoded data is the standard pair of "name=value" separated by &'s. This is all pretty much standard HTTP.


Name Fields with serial numbers

Below are the currently supported name files that require a serial number:

Format Description Value
naSTOKER_SERIAL_NUMBER Change the name Letters and numbers
alSTOKER_SERIAL_NUMBER Change the alarm type 0, 1, 2
taSTOKER_SERIAL_NUMBER Change the target temp Number
thSTOKER_SERIAL_NUMBER Change the alarm high temp Number
tlSTOKER_SERIAL_NUMBER Change the alarm low temp Number
swSTOKER_SERIAL_NUMBER Change the blower associated with the sensor Blower serial number
In development
faSTOKER_SERIAL_NUMBER Modify the fan operating mode on, off, normal

STOKER_SERIAL_NUMBER is the serial number that uniquely identifies the sensor or blower.

Value Fields

The value field depends on the parameter being modified. The name change accepts a string of letters and numbers and other symbols. The temperature value is a value in Fahrenheit.

Alarm value of 0 disables the alarm for the sensor. Alarm value of 1 enables the target alarm. Alarm value of 2 enables the fire alarm.

The value for the swSTOKER_SERIAL_NUMBER must be a valid blower serial number. This associates the sensor and the blower to eachother. The special value of "None" is also accepted. This disassociates the sensor from any blower.

The web page supports the ability for the user to force the fan on or off. When forced on or off, the fan will ignore any changes requested by the associated sensor. If forced on, the fan will remain on forever. Same when forced off.

To return to the normal mode of operation, where the fan is controlled by the sensor, use the normal setting.

Name Fields - general behavior

Format Description
qx Toggle for showing serial numbers

There is no on/off here. If the field is present then the serial numbers will be shown on the next refresh of the page. If not, then the serial numbers will be suppressed.

Name Fields - Twitter

Format Description Value
tu Specify the Twitter username username
tp Specify the Twitter password password
te Enable or disable periodic updates to Twitter 1 to enable, 0 to disable
ti Specify the update time value in minutes number
tr Specify the header used when tweeting
tn Set the hostname
tx Send a custom message

Name Fields - Read-only mode

Format Description Value
ro Enable read-only This should always be used with the rp field.
If this value is present, then the rp field will be the password.
If this value is not present, then the rp field will be checked before disabling read-only mode.
rp Read-only password
rx Read-only mode, password change (old) Assumes read-only mode already enabled
rn Read-only mode, password change (new) Assumes read-only mode already enabled

ro and rp should be used together. rx and rm should be used together to change the current password.

Name Fields - Wifi Settings

Format Description Value
we Enable If this field doesn't exist but other wifi settings do, then wifi will be disabled.
ws SSID
wd Enable DHCP If this field doesn't exist but other wifi settings do, then DHCP will be disabled.
wh Enable ad-hoc If this field doesn't exist but other wifi settings do, then ad-hoc will be disabled.
wc Security 0, 1, 2, 3
wp Security pass phrase
wi IP address Used for static IP configuration
wm Subnet mask Used for static IP configuration
wg Gateway Used for static IP configuration
wv DNS Used for static IP configuration

Security: 0 - none, 1 - WEP open, 2 - WEP shared, 3 - PSK


Example 1

To change the name of the sensor with serial number 1234567890ABCDEF to "Pork Shoulder", the HTTP request would look like:

POST /stoker.Post_Handler HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 25

na1234567890ABCDEF=Pork+Shoulder

Please note a few things:


Example 2

To change the name of the sensor with serial number 1234567890ABCDEF to "Pork Shoulder" and the target temperature to 250.1, the HTTP request would look like:

POST /stoker.Post_Handler HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 44

na1234567890ABCDEF=Pork+Shoulder&ta1234567890=250.1
        

Tools

To debug or to test some of these settings, manually creating a HTTT POST request might be pain. So use curl. Go to the page, then the Download section, then the Packages section and download the package with type binary. I used "Win32 - Generic", "Win32 2000/XP", binary with SSL and SSH.

Examples

Assume 192.168.1.10 is the IP address of your Stoker.

Example 1 using curl:
        curl -v -d "na1234567890ABCDEF=Pork+Shoulder" http://192.168.1.10/stoker.Post_Handler
        
Example 2 using curl:
        curl -v -d "na1234567890ABCDEF=Pork+Shoulder&ta1234567890=250.1" http://192.168.1.10/stoker.Post_Handler