Skip to content

URLs and Commands

CapnBry edited this page Oct 12, 2011 · 12 revisions

Both HeaterMeter and LinkMeter accept commands via URL-type form.

HeaterMeter URLs

  • Received via serial
  • No authentication
  • Begin with a forward slash (/)
  • End with CR or CR/LF
  • Maximum length: 64 characters
  • Do not URL encode parameters

LinkMeter URLs

  • Received via HTTP
  • Authentication possible
  • Begin with /luci/
  • URL encoded parameters OK
URL Description LM HM
/lm/ Main index or LinkMeter "home" page. Displays current temperature and fan status with graph.
  • rrd=file use file from stashpath instead of live
Y N
/lm/login Bounce to the LinkMeter login page for authentication. Y N
/lm/set Passed through to HeaterMeter one parameter at a time. See HeaterMeter Set Parameter list. A Y
/admin/lm/conf LinkMeter probe and behavior configuration. Front-end to /lm/set A N
/admin/lm/home Bounce to /lm/ A N
/admin/lm/stashdb LinkMeter utility URL for managing databases
  • backup=1 backup to stashpath
  • restore=1 restore to active
  • reset=1 reset active
  • rrd=file use file instead of 'hm.rrd' for stashpath file
A N
/admin/lm/archive LinkMeter database archive. Front-end to /admin/lm/stashdb A N
/admin/lm/fw LinkMeter Arduino / AVR firmware upgrade A N
/admin/lm/credits LinkMeter software credits page A N
/reboot HeaterMeter software reboot N Y
/config HeaterMeter dump configuration N Y

HeaterMeter Set Parameters

The definitive source on HeaterMeter set parameters is the HeaterMeter README. All set parameters are proceeded by /set? followed by the parameter name. HeaterMeter only supports one setting one parameter at a time, LinkMeter can set several parameters at once.

Name Description
sp=A Set the setpoint to integer A
pidA=B Tune PID parameter A to value float B. A can be b (bias), p (proportional), i (integral), or d (derivative)
pnA=B Set probe name A to string B.
poA=B Set probe offset A to integer B.
pcN=A,B,C,R,TRM Set the probe coefficients and type for probe N.
Any of A,B,C,R,TRM set to 0 will not be modified.
A, B, and C are the Steinhart-Hart coeffieicents and R is the fixed side of the probe voltage divider.
A, B, C and R are floating point and should be specified in scienfific noation, e.g. 0.00023067434 -> 2.3067434e-4.
TRM is either the type of probe OR an RF map specifier. If TRM is an integer, it indicates a probe type. Probe types are 1=Disabled, 2=Internal, 3=RFM12B. If the first character of TRM is a capital letter A-Z followed by a single digit number 0-5, it is considered an RF Map item <rfSource (letter)>.
e.g. a TRM of B0 sets this probe to use RF Source B pin 0. If an RF map is present, the probe type is automatically switched to type RFM12B.
lb=A Set the LCD backlight to A. Range is 0 (off) to 255 (full)
pnXXX Retrieve the current probe names (XXX is literally the string "XXX")
Probe Number Description
0 Pit - This is the probe that controls the blower
1 Food Probe 1
2 Food Probe 2
3 Food Probe 3 / Ambient
Probe Type (URL) Probe Type (Code) Description
0 (Undefined) Do not change probe type
1 PROBETYPE_DISABLED (0) Disabled. Do not measure or report a value for this probe
2 PROBETYPE_INTERNAL (1) Internal. Probe connected directly to HeaterMeter via voltage divider / probe jack / thermistor
3 PROBETYPE_RF12 (2) RFM12B. RF Wireless via RFM12B radio transciever. Probes of this type also require an RFMap item to map the appropriate source node and pin.
Clone this wiki locally