[{"data":1,"prerenderedAt":256},["ShallowReactive",2],{"doc-\u002Fhardware\u002Fshelly-h-t":3},{"id":4,"title":5,"body":6,"description":246,"edit":247,"extension":248,"meta":249,"navigation":250,"path":251,"seo":252,"stem":253,"vertical":247,"weight":254,"__hash__":255},"content\u002Fhardware\u002Fshelly-h-t.md","Shelly H&T",{"type":7,"value":8,"toc":233},"minimark",[9,13,16,21,34,40,44,80,84,87,101,104,128,132,135,142,165,169,180,183,187,203,207,214,218],[10,11,12],"p",{},"The Shelly H&T is the recommended starting point for OpenSense. It is a\nself-contained WiFi sensor with a 18650 battery, a Sensirion SHT temperature\n\u002F humidity sensor, and an HTTP \"action\" feature that can POST to an arbitrary\nURL on every wake-up.",[10,14,15],{},"We support three generations: the original (H&T), the Plus (H&T Plus) and\nthe Gen3 (Shelly H&T Gen3). All three work with the same ingest URL; the\nonly difference is the menu layout.",[17,18,20],"h2",{"id":19},"buy","Buy",[22,23,24,28,31],"ul",{},[25,26,27],"li",{},"Manufacturer: Allterco \u002F Shelly.",[25,29,30],{},"Price band: €25–€35 retail in the EU.",[25,32,33],{},"Where: shelly.com direct, Amazon EU, Reichelt, Conrad. Avoid third-party\nAliexpress listings — counterfeits with a different (worse) sensor exist.",[35,36],"stoplight",{"alarm":37,"ok":38,"warn":39},"‘Smart H&T sensor’ with no Shelly logo. Counterfeit.","Box says ‘Shelly H&T Gen3’ or ‘Plus H&T’ and SHT-3x sensor inside","Original H&T (Gen1) — works but no longer manufactured",[17,41,43],{"id":42},"pair","Pair",[45,46,47,55,61,67,73],"ol",{},[25,48,49,50,54],{},"Hold the side button until the LED blinks blue. The Shelly creates a\nsetup WiFi network ",[51,52,53],"code",{},"ShellyHT-XXXXXX",".",[25,56,57,58,54],{},"Join that network from your laptop. Open ",[51,59,60],{},"http:\u002F\u002F192.168.33.1",[25,62,63,66],{},[51,64,65],{},"Internet & Security → WiFi 1",". Enter your real WiFi credentials. Save.",[25,68,69,70,54],{},"After reboot, find the new IP on your network. On Gen3 the device also\nexposes mDNS as ",[51,71,72],{},"shellyhtgen3-XXXXXX.local",[25,74,75,76,79],{},"In OpenSense, ",[51,77,78],{},"+ ADD DEVICE → SHELLY → H&T",". Copy the ingest URL. It is\ntoken-bearing; treat it like a password.",[17,81,83],{"id":82},"configure-http-push","Configure HTTP push",[10,85,86],{},"On Gen1:",[22,88,89,95],{},[25,90,91,94],{},[51,92,93],{},"IoT settings → Reporting URL"," → paste the OpenSense ingest URL.",[25,96,97,100],{},[51,98,99],{},"Reporting period"," → 60 s (HACCP) or 300 s (climate).",[10,102,103],{},"On Plus \u002F Gen3:",[22,105,106,115,118,125],{},[25,107,108,111,112,54],{},[51,109,110],{},"Settings → Actions",". Create a new action of type ",[51,113,114],{},"Sensor reports",[25,116,117],{},"URL: paste the OpenSense ingest URL.",[25,119,120,121,124],{},"Method: ",[51,122,123],{},"GET"," (Shelly appends sensor values as query params).",[25,126,127],{},"Save.",[17,129,131],{"id":130},"sample-payload","Sample payload",[10,133,134],{},"Shelly does not let you change the payload format; OpenSense parses what\nthe device sends. The format on Gen3 is:",[136,137,139],"cmd",{"label":138},"$ shelly reports",[10,140,141],{},"GET \u002Fv1\u002Fingest\u002Fshelly?token=ds_live_…&device=hut01&temp=4.2&hum=68.0&battery=3.92&signal=-58",[10,143,144,147,148,151,152,155,156,159,160,54],{},[51,145,146],{},"temp"," is °C, ",[51,149,150],{},"hum"," is %RH, ",[51,153,154],{},"battery"," is volts on Gen3 (and percent on Gen1),\n",[51,157,158],{},"signal"," is dBm. All five are stored. Battery and signal are auxiliary\nchannels — they do not trigger alarms by default but are visible on the\ndevice page and useful when ",[161,162,164],"a",{"href":163},"\u002Ftroubleshooting\u002Fdevice-offline","diagnosing offline devices",[17,166,168],{"id":167},"cadence-and-battery","Cadence and battery",[22,170,171,174,177],{},[25,172,173],{},"60 s cadence on a fresh 18650 → ≈ 4–6 months of battery life.",[25,175,176],{},"300 s cadence → ≈ 18 months.",[25,178,179],{},"900 s cadence → ≈ 36 months.",[10,181,182],{},"For HACCP use 60 s, period. The auditor will not accept a 15-minute gap\nbetween samples in a –18 °C freezer, and the battery cost (one swap per\nseason) is cheap insurance.",[17,184,186],{"id":185},"mount","Mount",[22,188,189,197,200],{},[25,190,191,192,196],{},"Walk-in fridge: top shelf, away from the door, ",[193,194,195],"strong",{},"not"," taped to the\nevaporator. The evaporator surface is colder than the air; readings will\nlook fine while the food rots.",[25,198,199],{},"Wall fridge \u002F display chiller: mid-height, back wall.",[25,201,202],{},"Use Velcro or the magnetic mount accessory. Do not screw into the cabinet.",[17,204,206],{"id":205},"troubleshooting","Troubleshooting",[10,208,209,210,213],{},"See ",[161,211,212],{"href":163},"device offline"," for the usual issues:\ndeep-sleep boot time, captive-portal WiFi, MAC filtering on guest networks.",[17,215,217],{"id":216},"what-you-give-up","What you give up",[22,219,220,227,230],{},[25,221,222,223,226],{},"The Shelly H&T cannot do ",[193,224,225],{},"dual probe",". One sensor per device.",[25,228,229],{},"The original H&T does not have HTTPS — only the Plus \u002F Gen3 do. We tolerate\nHTTP from Gen1 because the only payload is a small reading and the auth is\nvia a hard-to-guess token, but we recommend Gen3 for new deployments.",[25,231,232],{},"Wake-up latency is 1.2–3.0 s on a deep-sleep cycle. If your alarm pathway\nis \"fridge door propped open\", the first reading might land after the\ndamage. Add a Shelly motion sensor in front of the fridge for door-open\ndetection.",{"title":234,"searchDepth":235,"depth":235,"links":236},"",3,[237,239,240,241,242,243,244,245],{"id":19,"depth":238,"text":20},2,{"id":42,"depth":238,"text":43},{"id":82,"depth":238,"text":83},{"id":130,"depth":238,"text":131},{"id":167,"depth":238,"text":168},{"id":185,"depth":238,"text":186},{"id":205,"depth":238,"text":206},{"id":216,"depth":238,"text":217},"WiFi battery sensor, recommended default",null,"md",{},true,"\u002Fhardware\u002Fshelly-h-t",{"title":5,"description":246},"hardware\u002Fshelly-h-t",110,"2V1NYonGFmFHqe_yhDeB5kLl3U0C2g9YSL6EitzA5mg",1779022953699]