Get hot and steamy with Larz, your sauna control buddy. Larz is here to help you set and maintain a nice and toasty sauna for an ultimate sweating experience. Boots.
Larz is simply the bestest sauna buddy. All of Larz's operations deal with Arduino Yun's HTTP interface for its key-value store. Check out Arduino's guide for more information and examples.
Some of Larz's basic features include:
- Retrieving current sauna temperature
- Checking the current temperature outside of the sauna
- Countdown to desired sauna temperature
- Powering on the sauna with desired temperature
- Powering off the sauna to the default temperature
- Review session logs of sauna activity along with temperature status
To access Larz simply go to http://10.0.0.112
.
Larz is at your service when you use basic
authentication with the username root
along with using the same password as per our wifi.
Ask Larz how he's doing by using /data/get
.
Example Request:
curl -s -u root:<password> http://10.0.0.112/data/get
Example Response:
{
"value" : {
"temperature_out" : "25.69",
"heater" : "1",
"session" : "1448927714",
"temperature_in" : "26.06",
"hysteresis" : "1.00",
"temperature" : "27",
"power" : "1"
},
"response" : "get"
}
To control the sauna's current state change the boolean
value for the power
key within the key value store.
- Power ON the sauna by using
1
- Power OFF the sauna by using
0
Example Power ON Request:
curl -s -u root:<password> http://10.0.0.112/data/put/power/1
Example Power OFF Request:
curl -s -u root:<password> http://10.0.0.112/data/put/power/0
WARNING! The default temperature is very low, so even if you turn the sauna on, the heater will remain off. To make sure the sauna is nice and hot you'll have to set a higher temperature then the current temperature inside sauna to make sure the heater is heating!
Setting the temperature is updating the Arduino Yun HTTP key-value store key temperature
with integer value representing the target temperature in degrees Celsius.
Example Temperature Setting Request
curl -s -u root:<password> http://10.0.0.112/data/put/temperature/27
Larz stores the data for every sauna session.
Each line within the response represents one session and its start date and time in the Unix time format
Example Request:
curl -s -u root:<password> http://10.0.0.112/sd/sessions/sessions.txt
Example Response:
1448927628
1448927714
Session details are CSV-like data delimited by a semicolon (;
) logged every 10 seconds.
After delimiting:
- the first value is a boolean indicating if the heater is on (
1
) or off (0
) - the second value is a float with inner temperature in degrees Celsius
- the third value is a float with outer temperature in degrees Celsius
The name of the CSV
file is the session date (in unix time format) + the .csv
fromat suffix.
e.g. 1448927628.csv
for the first item in the previous example.
Example Request
curl -s -u root:<password> http://10.0.0.112/sd/sessions/1448927628.csv
Example Response
0;26.38;25.81
0;26.31;25.75
0;26.25;25.75
0;26.25;25.81
0;26.25;25.75
0;26.25;25.75
0;26.25;25.75
0;26.31;25.75
0;26.31;25.75
0;26.31;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.38;25.75
0;26.31;25.75
0;26.31;25.75
0;26.31;25.75
0;26.31;25.81
0;26.31;25.81
0;26.31;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.88
0;26.25;25.81
0;26.25;25.88
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.31;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.81
0;26.25;25.75
0;26.31;25.81
0;26.31;25.81
0;26.31;25.81
0;26.31;25.81
0;26.38;25.88
0;26.38;25.88