Wattmon Documentation Wiki

User Tools

Site Tools

You are here: start » uphp » functions » ow_first
Trace:
uphp:functions:ow_first

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision Both sides next revision
uphp:functions:ow_first [2017/05/11 09:59]
admin 		uphp:functions:ow_first [2017/05/11 23:30]
jeff
Line 1: Line 1:
 ======ow_first====== ======ow_first======
  
-<badge>WMPRO, WMMINI FW >= 1.0</badge> <badge>WMMEGA FW >= 2.0</badge>+<badge>WMPRO >= 1.0</badge> <badge>WMMEGA FW >= 2.0</badge>
  
-Start a new OneWire bus scan and return the first device.  Currently only DS18B20 temperature sensors are detectable.+Initiate a OneWire bus scan and return the address of the first device found
  
 ====Description==== ====Description====
  
 <well size="sm"><html> <well size="sm"><html>
-<span style="font-size:125%;color:green">array +<span style="font-size:125%;color:green">mixed 
-<span style="color:black">ow_first ( +<span style="color:black">ow_first ( )
-<span style="color:black">)+
 </html></well> </html></well>
  
-====Parameter====+This function starts a new OneWire bus scan and provides the address of the first device found.  Currently only DS18B20 temperature sensors are detectable.
  
-none+====Parameters==== 
 + 
 +None
  
 ====Return Values==== ====Return Values====
  
-An <html><b><span style="color:green">array<span style="color:black"></b></html> of 8 elements containing the unique onewire address.  Returns 0 if no devices were detected+An <html><b><span style="color:green">array<span style="color:black"></b> of 8 elements containing the unique OneWire address.  Returns <b><span style="color:green">int<span style="color:black"></b> 0 if no devices were detected.</html>
  
 ====Example==== ====Example====
  
 <code php> <code php>
-<pre><?+<?
   $arr=ow_first();   $arr=ow_first();
   if ($arr) {   if ($arr) {
     $devname=sprintf("%02X%02X%02X%02X%02X%02X%02X%02X",$arr[0],$arr[1],$arr[2],$arr[3],$arr[4],$arr[5],$arr[6],$arr[7]);     $devname=sprintf("%02X%02X%02X%02X%02X%02X%02X%02X",$arr[0],$arr[1],$arr[2],$arr[3],$arr[4],$arr[5],$arr[6],$arr[7]);
-    print("Detected Onewire device ".$devname); +    print("Detected the first OneWire device ".$devname); 
-  } else print("No devices detected.");+  } else { 
 +    print("No devices detected."); 
 +  }
 ?> ?>
 </code> </code>
 +
 ====See Also==== ====See Also====
  
-[[ow_next()]] - Get next onewire device+[[ow_next()]] - Return the address of the next OneWire device found (after an ow_first)
  
-[[ow_read()]] - Read from onewire bus+[[ow_read()]] - Read a byte from the OneWire bus
  
-[[ow_read_temp()]] - Read a temperature from a device+[[ow_read_temp()]] - Read a temperature from a device on the OneWire bus
  
-[[ow_reset()]] - Reset the onewire bus+[[ow_reset()]] - Reset the OneWire bus
  
-[[ow_write()]] - Write to onewire bus+[[ow_write()]] - Write a byte to the OneWire bus
  
uphp/functions/ow_first.txt · Last modified: 2021/09/13 05:57 (external edit)

Page Tools

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki