HA7Net User Manual - Embedded Data Systems
Contents
1. 0x0001 For Example 0x48410001 gt HA 000 001 This packet should be transmitted to group IP 224 1 2 3 port 4567 Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 15 37 When this packet is detected the HA7Net will respond with a UDP packet directed back to the same IP address and originating port of the client that transmitted the multicast The format of the response packet is as follows char signature 2 gt HA WORD16 command gt 0x8001 WORD16 port Non SSL http port 80 WORD16 sslport gt SSL http port 443 char serial num 12 gt HA7Net serial MAC char dev_name 64 gt HA Net device name Note that the serial_num and dev_name fields will not be null terminated if the data occupies the entire allocation otherwise they will be null terminated The client should be able to locate each of the HA7Nets by querying the client s underlying TCP IP stack for the remote IP information of the received UDP packet As shown above the response packet will include the port numbers of both the non SSL and SSL http servers These servers default to being located on ports 80 and 443 respectively but can be re configured by the integrator If either of the http servers are disabled then the port number will be returned as 0 The following is an excerpt from a Visual Basic code sample for transmitting the multicast packet and receiving the response Privat2. Bits Table that contains the bit read from the 1 Wire bus This value is stored in a text field named Bit 0 Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 32 37 Read Pages Command URL 1Wire ReadPages html Example http ha7 net 1Wire ReadPages html Address 2400000007377212 amp StartPage 1 amp PagesToRead 4 Reads 4 memory pages from device having ROMId 2400000007377212 starting at page 1 Description This command is used to read one or more consecutive memory pages from 1 Wire devices that have memory pages If the Optional Address parameter is given then the 1 Wire bus will be reset and the devices specified by Address will be selected prior to reading the memory pages If NumPages is not specified then only one page will be read StartPage must be specified Parameters Optional LockID Ten byte decimal number previously returned by GetLock Required StartPage Page number to begin reading on Should be an integral value between 0 and 255 Optional PagesToRead Number of pages to read Defaults to 1 if not specified Optional 8 byte hex 1 Wire ROM Address Returns Pages Table that contains the pages read from the 1 Wire device This value is stored as hex in a text field named Page x where x is a 0 based sequentially numbered integer Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 3
3. HA7Net TCP IP File Version 1 0 0 14 RC2 1 Wire Security Header ID Header ID is correct Date Time Header Size Header is fine 248 gt 248 SNTP Image Type EOS Image i S Available Space Space required 743282 Space available 1048576 Miscellaneous File Size Header Size 743282 Actual Size 743282 Update CRC Actual CRC 0x2E7BEADS Expected CRC 0x2E7BEAD9 Reboot aire Forms Discard File Flash Device To commit the new firmware to flash memory click on the Flash Device button Note that this process will take 2 3 minutes and the HA7Net will automatically restart after the process is complete Unless otherwise noted in the firmware release notes your existing configuration will be preserved during the update Disconnecting power during this process will result in corrupted firmware If this happens please contact technical support for a recovery process Reboot Some configuration settings require restarting the HA7Net before they will take effect This form allows you to reboot the HA7Net from remote Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 10 37 Factory Reset Resetting the HA7Net to factory defaults will set the following configuration values IP Address First tries DHCP if no DHCP server found then defaults to 192 168 0 250 Admin User admin Admin Password eds Http Port 80 Https Port 443 The reset procedure is performed as follows Start by u
4. unique This allows any single device to be individually selected from among many that can be connected to the same bus wire Because one two or even dozens of 1 Wire devices can share a single wire for communications a binary searching algorithm is used to find each device in turn Once each device serial number is known any device can be uniquely selected for communication using that serial number to address it Device Selection The first part of any 1 Wire communication generally involves the bus master issuing a reset which synchronizes the entire bus A slave device is then selected for subsequent communications This can be done by selecting all slaves or by selecting a specific slave using the serial number of the device These commands are referred to collectively as network or ROM Read Only Memory commands and are implemented on the HA7Net in the form of the Search Address and Match commands Once a specific device has been selected all other devices drop out and ignore subsequent communications until the next reset is issued Because each 1 Wire device type performs different functions and serves a different purpose each has a unique protocol once it has been selected Even though each device type may have different protocols and features they all have the same selection process and follow the command flow as seen in the following figure Select 1 Wire Perform Device Wi md o x K Rese
5. 73000000B0E22E28 12 The ReadDS18B20 function allows you to read the current temperature from a list of DS18B20 temperature sensors You provide a list of the sensors to read and for each sensor the resolution 9 12 at which you want the temperature conversion to be performed The HA7Net will sequentially read each sensor then return a single html page containing a list of the sensors and the temperature of each expressed in degrees Celsius as shown below Read DS18B20 Repl HA7Net 1 0 0 9 Address Temperature Resolution 73000000B0E22E28 21 9 73000000B0E22E28 20 875 12 Set Display URL 1Wire SetDisplay html Address Message Array Address1 Message1 Address2 Message2 Example http ha7 net 1Wire SetDisplay html Address Message Array 73000000B0E22E12 1234 3 84000000B0E22E12 12 34 The SetDisplay function allows you to easily control the message displayed on Embedded Data System s DSP7x4 1 Wire LED displays You provide a list of the displays to set and for each display the message you want to be displayed The HA7Net will sequentially set each display then return a single html page containing a list of the displays and status field indicating whether the message was transmitted successfully or not as shown below Set Display Repl HA7Net 1 0 0 14 RC2 Address Status B600000020988F 12 OK Special characters can be embedded into the message to control the format of the message as shown below The space chara
6. sensors or consider using higher latency Internet connections such as satellite and it quickly becomes obvious how lower level solutions will fail to scale up Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 20 37 High Level Command List The following is an overview of each high level http request that can be made to the HA7Net Detailed reference on each command can be found on the pages that follow Read Analog Probe URL 1Wire ReadAnalogProbe html Address Array Address1 Address2 Address3 Example http ha7 net 1Wire ReadAnalogProbe html Address Array DE0000001B137312 The ReadAnalogProbe function allows you to easily read the current value from a mixed list of Embedded Data Systems complex 1 Wire sensors Currently supported devices include BAR2001S Barometric Pressure Temperature Sensor e HMP2001S Humidity Temperature Sensor When calling the URL you provide a list of the sensors you want to be read The HA7Net will sequentially read each sensor and then return a single html page containing a list of the sensors the sensor type the engineering value of the sensor reading the units the address of any associated temperature sensor and the temperature of each sensor expressed in degrees Celsius as shown below Any errors encountered while reading the sensor will be listed in the status field Read Analog Probe Repl HA7Net 1 0 0 12 Probe Type Probe Addres
7. you intend to write to the bus you must pad the data you are writing with 1 bits in order to generate the necessary time slots for the devices to write their entire response back to you In short you can only read as many bits from the 1 Wire bus as you write For a complete explanation of 1 Wire bus timing and communication please see chapter one of the Book of DS19xx iButton Standards from Dallas Semiconductor Parameters Optional LockID Ten byte decimal number previously returned by GetLock 8 byte hex 1 Wire ROM Address 1 32 bytes of data formatted as HEX Returns ResultData Table that contains the data read back from the 1 Wire bus This value is stored in a text field named ResultData O Examples To tell the 1 Wire temperature sensor having ROM code 280000003042C210 to perform a temperature conversion http HA7Net com 1Wire WriteBlock html Address 280000003042C210 amp Data 44 To read the 9 byte scratchpad from the temperature sensor above in order to obtain the temperature information http HA7Net com 1Wire WriteBlock html Address 2800090003042C210 amp Data BEFFFFFFFFFFFFFFFFFF Notice the 9 FF bytes This will create the necessary time slots on the 1 wire bus in order for the sensor to write back the response as discussed in the description above To select the DS2406 with ROM code 2400000007377212 issue the Channel Access command and read the Channel Info Byte which contains the input latches outpu
8. 3 37 Read File Records Command URL 1Wire ReadFileRecords html Example http HA7Net com 1Wire ReadFileRecords html Address 2400000007377212 amp StartRecord 1 amp RecordsToRead 4 Reads 4 consecutive file records beginning with the record located at page 1 from the from the 1 Wire device having ROM code 2400000007377212 Description The Read File Record command is used to read one or more consecutive TMEX formatted file records from 1 Wire devices that have memory pages The CRC16 is automatically checked on the records and if any record is not a valid Touch Memory File Record an exception will be returned and all good records up to the point of error will be returned The byte count continuation code and CRC16 bytes of the TMEX record are stripped from the file record before it is returned See Chapter 7 of the Book of DS19xx iButton Standards from Dallas Semiconductor for a complete discussion of the Touch Memory File Structure If the Optional Address parameter is given then the 1 Wire bus will be reset and the device specified by Address will be selected prior to reading the file records If RecordsToRead is not specified then only one record will be read StartRecord must be specified Parameters Optional Lock D Ten byte decimal number previously returned by GetLock Required StartRecord Page number to reading the record from Should be an integral value between 0 and 255 RecordsToRead Num
9. Embedded Data Systems HA7Net Ethernet to 1 Wire Bus Master User s Manual and Programmer s Guide Revised 08 09 2006 i ae 7 Met 7e mN ert Bus AS Y aster Atr E EIDA A T 7 4524 47 Wire CO n3 2 Embedq Weit Date Systems HA7Net 1 Wire RJ41 9vpc Ee EH Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 859 5490 1 37 EE SUD EN RR CEP TR 4 intended RETE BE mE eee et ae re ee eee ee eer 4 HA7Net Hardware OVeErvieW cence eee ee cece eee cece cece cece eee cece seen cece ce eeceeeneesnesseesseessesssessuessuessuessesssussnensss 5 rcgi TRECE 5 Power Supply Requirements daher EA 5 Jeu E EE 5 Hiena EE 5 Site MENCO RR RE RERO 5 Tire terate oeii anien TTE 6 E d EE Z Administrator Password EE EE i B cct RR TTE T TF E SeN t eT Fa AR EE 9 biliecell ar Ola iier eir Eed 9 Jc RUMP 9 e RENE H 10 mE Ra dicic NR ER RDCRIE ree 11 1 Wire Technology Overvi amp ew cssssssenieiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiliiiliiiliiiliiilil 12 Device Selection ee eee e eee eee eee ne nimiriiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiliiiiiiiiiiiiliiiliiililiiiliiiliiiiliiiliiiliiil 12 Device Inierachon ee eee eee cece eee neni riitiiiiiiiiiiiiiiiiiiiiiiiitiiiiiiiiiiiiiiiiiiliiiiiliiiliiilliiiliiililiiliiiiii
10. L 1Wire WriteBlock html Examples http ha7 net 1Wire WriteBlock html Data OO0FFO1IFE02FDO3FC Writes 8 bytes of data to the 1 Wire bus http ha7 net 1Wire WriteBlock html Address 9D00080027AFA4A10 amp Data 44 Resets the bus addresses the device having id 9D00080027AF4A10 then writes a single byte 0x44 This particular example tells the DS18520 to perform a temperature conversion Description Perhaps the most important low level HA7Net command the Write Block command allows you to write and read any raw data to the 1 Wire bus under any context This will allow you to implement any device specific protocols If the optional Address parameter is specified the HA7Net will first reset the 1 Wire bus then select the device having that address prior to writing the block of data to the bus If the Address parameter is not present then the HA7Net will simply write the data and reads data back from the bus without regard for the current state of the bus While a complete understanding of the 1 Wire electrical interface is not necessary there is an important concept for you to understand in order to effectively use this command Every 1 Wire device can only talk back to the bus master during a read cycle on the bus The only time that read cycles are created on the bus is immediately after each bit that the host master writes to the bus Therefore if the response you expect to read back from the 1 Wire bus is longer than the data
11. Y 40342 Phone Fax 502 8595490 13 37 Family Codes An integral part of the unique serial number in each 1 Wire device is an 8 bit family code This code is specific to the device s model type Because each device model performs different functions this code can be used to select the protocol that will be used to control or interrogate it The following table provides a partial mapping of family codes to Dallas Semiconductor part numbers Code JiButton Package Memory size in bits unless specified Single addressable switch 1k NV RAM memory DS1982 DS2502 1k EPROM memory jo DS1985 DS2505 16k EPROM memory 0C DS1996 DS1996x2 64k to 256k NV RAM memory DS1996x4 OF OF DS1986 DS2506 64k EPROM memory DS1920 DS1820 Temperature with alarm trips DS18S20 1 10 E 1 DS1921 DS1921H Thermochron temperature logger DS1921Z Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 14 37 HA7Net Ethernet Communication Interfaces The HA7Net provides 3 network services accessible via TCP IP 1 HTTP Server The primary means of interfacing with the HA7Net is via the HTTP protocol available by default on port 80 non SSL and port 443 SSL 2 Telnet Server A debugging facility is also provided via a Telnet interface located on the standard telnet port 23 3 Multicast Listener A multicast listener is integrated into the HA7Net for ease of device discove
12. al Address parameter is given then the 1 Wire bus will be reset and the device specified by Address will be selected prior to reading the file records StartRecord must be specified Parameters Optional Lock D Ten byte decimal number previously returned by GetLock Required RecordNumber Page number to write the record to Should be an integral value between 0 and 255 Up to 28 bytes in hex 56 hex characters Optional 8 byte hex 1 Wire ROM Address Returns This command does not return anything other than the page statistics and an exception if applicable Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 35 37 Get Lock Command URL 1Wire GetLock html Example http HA7Net com 1Wire GetLock html Gets exclusive access to the 1 Wire bus Description The Get Lock command is used to obtain exclusive access to the 1 Wire bus This is useful to prevent other clients from interrupting a sequence of commands about to be performed on the bus The lock will exist until one of two conditions occurs 1 It can be explicitly released via the Release Lock command 2 It can timeout due to inactivity The default timeout value can be configured per HA7Net using the configuration web pages By default this value is 60 seconds Each time a command is used that references the given lock id the activity counter will be reset If another client already has the bus locked th
13. an Device Name Dame bus locking see the section entitled oue ce TOTNM Concurrency Management later in this Miscellaneous document Re 1 Wire Forms pcILOE Update The update form is used to flash the HA7Net with new versions of its firmware which we make available from time to time on our technical support website at the following URL http talk1wire com q node 60 After unzipping the firmware file downloaded from our website you should be left with a bin file named something similar to HA7 1 0 0 14 bin It is this bm file that you will need to upload to the HA7Net using the Update form found on the configuration menu Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 859 5490 9 37 HA7Net 1 0 0 11 Upload Flash HA7Net Configuration User Password Admin Password TCP IP 1 Wire Security Upload File Choose _ Date Time SNTP Miscellaneous Update Reboot 1 Wire Forms After the upload process the HA7Net will perform several validity tests on the new firmware file If any of the tests fail then the HA7Net will not allow you to commit the firmware to flash memory If all of the tests pass then the HA7Net will prompt for final confirmation that you want to write the new firmware to flash memory as shown below HA7Net 1 0 0 14 RC2 Confirm Upload HA7Net Configuration User Password Admin Password File Name HA7_1 0 0 14 RC2 bin File Description
14. ax 502 8595490 24 37 Address Device Command URL 1Wire AddressDevice html Example http ha7 net 1Wire AddressDevice html Address 9D00080027AF4A10 Address DS18S20 having ROMId 9D00080027AF4A10 Description This command will reset the 1 Wire bus and then select the particular 1 Wire device on the 1 Wire bus that you want to talk to Generally communications on the 1 Wire bus occur between the bus master HA7Net and a single 1 Wire device Before you can have communications with that particular device you must select the device which accomplishes two things 1 It tells the device you are addressing that you intend to communicate with it 2 All other devices drop off of the bus until the next bus reset Parameters 8 byte 1 Wire ROM Address expressed as 16 HEX characters Optional LocklD Ten byte decimal number previously returned by GetLock Returns Addresses Table that contains the single 8 byte 1 Wire ROM address code This value is stored in a text field named Address O and is the same value that was passed in the Address parameter Sample Response Address Device Repl HA7Net 1 0 0 12 9D00080027AF4A1 Sample address table from HTML page lt table name Addresses id Addresses gt lt tr gt lt td gt lt input TYPE TEXT NAME Address 0 SIZE 16 MAXLENGTH 16 VALUE 9D00080027AF4A10 gt lt td gt lt tr gt lt table gt Embedded Data Systems LLC 1446 Gilberts Cre
15. ber of records to read Defaults to 1 if not specified Optional 8 byte hex 1 Wire ROM Address Returns Records Table that contains the records read from the 1 Wire device This value is stored as hex in a text field named Record x where x is a 0 based sequentially numbered integer Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 34 37 Write File Record Command URL 1Wire WriteFileRecord html Example http HA7Net com 1Wire WriteFileRecord html Address EF00000003B7890C amp RecordNumber 21 amp Data 484137206973204561737920544F20555345 Write the record HA7 is Easy to USE into the file that contains page 21h of the DS1996 with ROM code EF00000003B78960C Description The Write File Record command is used to write a TMEX formatted file record to the memory page specified by RecordNumber During the write process the HA7Net will automatically set the continuation pointer in the file record to the next memory page which limits its use to files having contiguous records The HA7Net will always write 28 bytes of data to the file record even if less than 28 bytes are supplied The record is validated as it is written to the device and an exception will be returned if the record fails to write correctly Please see Chapter 7 of the Book of DS19xx iButton Standards from Dallas Semiconductor for a complete discussion of the Touch Memory File Structure If the Option
16. cter can be used as a placeholder for characters that should not be illuminated The period character can be used to illuminate the decimal point The colon character can be used to illuminate the colon The caret character can be used to illuminate the degrees symbol Note that the placement of the period colon and caret characters is not significant They may appear anywhere in the message string nm Valid message characters include the digits 0 9 the letters a d dash underscore and the special formatting characters given above Others Additional high level device support may be added to the HA7Net from time to time When available firmware updates will be posted on our technical support website http Talk1Wire com Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 22 37 Low Level Commands The HA7Net s low level command set allows you to take complete control of the 1 Wire bus down to the level of reading and writing individual data bits This level of control is useful for working with devices that are not yet implemented in the HA7Net s high level command set or for interacting with existing devices in non standard ways Using the low level command set requires a fundamental understanding of both the 1 Wire protocol and the 1 Wire device with which you are communicating Examples of low level communications with certain 1 W
17. d E pa beet Ed 31 Read File Records Commnd e erecti rase cess pisi adi c pir Y s iprsii psa p Dil pp Dp sa Dn P RS DDR xd s 34 Write File Record Command a geed ENNER 35 Get Lock Command EE 36 Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 2 37 Reslas Lock Command osos osea EDD DLE aL ee ae eee 37 Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 859 5490 3 37 Introduction Welcome to the HA7Net A product that is designed to simplify the integration of distributed 1 Wire iButton networks into your application or system By acting as an Ethernet to 1 Wire bridge the HA7Net serves as an efficient tool that can be used to overcome a variety of challenges related to the successful implementation of 1 Wire MicroLans Client PC Any Client PC shown here can talk to any 1 Wire device shown here using standard Ethernet Internet technologies as the communications backbone HATNet Client PC HA7Net Figure 1 The HA7Net allows you to effectively use industry standard Ethernet networking products to build out the backbone of your 1 Wire sensor system providing several important benefits First the individual 1 Wire MicroLans can be kept to a smaller physical size thereby improving reliability and decreasing installation costs Second since the HA7Net communicates via TCP IP over standard Ethernet yo
18. e application Pressing the Guess button CRM will populate the fields by converting your TCP IP n e Bux PC s time to GMT Note that the HA7Net 1 Wire Security can automatically keep its clock Dese riwo SNTP GMT Time hh mm ss 18 37 56 synchronized toa network time server by Miscellaneous configuring the SNTP settings Update Reboot S NTP 1 Wire Forms SNTP is a simple network time protocol which is supported by many commonly available servers By enabling the Sync Time using SNTP ipis see qq option and configuring at least one SNTP server nd Sync Time using SNTP the HA7Net will periodically synchronize its internal 1 Wire Security Date Time Primary SNTP Server 000 000 000 000 clock to that of the SNTP server Note that using ped this option will force the HA7Net s clock to GMT Miscellaneous Secondary SNTP Server 000 000 ooo 000 For more information on SNTP please consult your Repost favorite Internet search engine Arre Forte Miscellaneous The miscellaneous tab is used to configure the following parameters Device Name This allows you to assign a friendly name to your HA7Net This name will be reported during the multicast discovery process Lock idle timeout seconds This timeout discusses the amount of time that a 1 Wire bus lock can remain ee D ser Passwort idle before the HA7Net forcibly releases Admin Password it For a complete discussion of 1 Wire rae
19. e Sub Form_Load Dim sckHndl As Long Winsock1 Protocol sckUDPProtocol sckHndl Winsock1 SocketHandle setsockopt sckHndl SOL SOCKET SO BROADCAST 1 1 With Winsock1 RemotePort 4567 RemoteHost 224 1 2 3 SendData HA amp Chr 0 amp Chr 1 End With End Sub Private Sub Winsock1 DataArrival ByVal bytesTotal As Long Dim responseData As String Winsock1 GetData responseData vbString bytesTotal Debug Print responseData amp Winsock1 RemoteHostIP amp Winsock1 RemotePort End Sub HTTP Interface Primary communication with the HA7Net is via the http protocol The actual data is exchanged in the form of html documents which have been designed to accommodate both human readability and 10096 reliable machine parsing This is accomplished through the use of unique predictably named form fields that can be automatically parsed by Document Object Model DOM parsers or easily digested via regular expressions on lighter weight platforms Data is passed to the HA7Net in the form of parameters placed in the URL Since the result pages are human readable both proof of concept and integration time is reduced as you can effectively interact with the HA7Net using a standard web browser For example to discover all of the devices that are connected to the 1 Wire bus the client would request the following URL from the HA7Net http HA7 net 1Wire Search html The HA7Net will then respond with an html document that renders similar t
20. ek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 25 37 Match ROM Command URL 1Wire MatchRom html Example http ha7 net 1Wire MatchRom html Matches the previously addressed device Description This command is used to simultaneously reset the 1 Wire bus and then reselect the 1 Wire device that was most recently selected with the Address Device command Parameters Optional LockID Ten byte decimal number previously returned by GetLock Returns Addresses Table that contains the single 8 byte 1 Wire ROM address code This value is stored in a text field named Address O and is the ROM Id of the matched device See Also The Address Device command provides a method to directly select a device given its ROM id Sample Response Match Rom Repl HA7Net 1 0 0 12 D60000000C3E6C2 Sample address table from HTML page table name Addresses id Addresses gt lt tr gt lt td gt lt input TYPE TEXT NAME Address 0 SIZE 16 MAXLENGTH 16 VALUE D60000000C3E6C27 gt lt td gt lt tr gt lt table gt EH Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 26 37 Reset Command URL 1Wire Reset html Example http ha7 net 1Wire Reset html Resets the 1 Wire bus Description This command is used to reset the 1 Wire bus Resetting the bus returns all devices on the bus to the addressing mode where they wait for you to select t
21. en this command will block until it is able to acquire the lock For a complete discussion of bus locking please see the Concurrency Management section presented earlier in this manual No Parameters Returns LockIDs Table that contains a single record containing the acquired lock This value is stored in a text field named LockID O Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 36 37 Release Lock Command URL 1Wire ReleaseLock html Example http HA7Net com 1Wire ReleaselLock html LockId 4148637993 Releases lock id 4148637993 previously acquired via GetLock Description The Release Lock command is used to release exclusive access to the 1 Wire bus so that other clients may access it For a complete discussion of bus locking please see the Concurrency Management section presented earlier in this manual Parameters LocklD Ten byte decimal number previously returned by GetLock Returns This command does not return anything other than the page statistics and an exception if applicable Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 37 37
22. he next device s that you want to talk to Parameters Optional LockID Ten byte decimal number previously returned by GetLock Returns This command does not return anything other than the page statistics and an exception if applicable EOE eee Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 27 37 Power Down Bus Command URL 1Wire PowerDownBus html Example http ha7 net 1Wire PowerDownBus html Powers off the 1 Wire Bus Description This command is used to completely power down the 1 Wire bus During normal operation the HA7Net holds the voltage level on the 1 Wire bus high 5 Volts For power sensitive applications the Power Down Bus command can be called to reduce the 1 Wire bus voltage to 0 Any 1 Wire activity from the HA7Net will cancel the Power Down mode although the suggested method for coming out of power down is via the Reset command Parameters Optional Lock iD Ten byte decimal number previously returned by GetLock Returns This command does not return anything other than the page statistics and an exception if applicable up B22 E SIGCCLBBLU LE XJC jj jkL NpDI LLLLLLLLL LL LLELILGGI L GGG GO LAAMISISSLUGC EDIA LLZED EATA OIIDLOZLEOLOOALLLLLLLLLLLLLLt dd BEB OES BAcAVDDQECELLLLLLELLCGLbZLLG Luc Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 28 37 Write Block Command UR
23. i 12 KC nien EEN 13 ani O OO a NR a a aman eee 14 HAZ Net Ethernet Communication Interfaces sssssss IR rIRrttritttrttmrtimititritrritirrtiriiiil 15 Telnet Imer ace EE 15 Multicast Listener lssssssssen neni riiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiliiiili gg iiiiidiiiiidiiiiiidiiiiiii 15 Packet FOU e ee EE D re ocu Foe prs esae Reus ENEE Nee 15 ACIE BIER eias anuo E en Ft dst Eu EN Sue en ERU m DRE EM Cat E a 16 RI TL D NR eT 17 EO RI lr TADE EE EE EE EE 17 e MUN ee ISTE ROUEN 18 Concurrency Management e ecole ps whee ENNEN AEN 18 HTTP Interface API Feterenge nt a e secans aca cee c ick cele pili spi dpa cR IR Rl dm Rp Desa RIP li 20 Hon Level rari RR 20 in Oa Level Command LES add onda uda a boda Muda fua Ea SAM oU SER RM UN 21 Read Analog FODS io a 21 Regd romte EE 21 Ecoe Oe im iE MAU EI M EE tae M EE EE 22 bee MTT ouis uL ub ui Di Md EU M Ue Ui 22 Low Level ai uu en casu citado EE 23 Low Level Command Liste itus cic aAa e asa dec ll a nl ai 23 Search ROM Command c Eu cit aient dE 24 Address Device Command eer a e EEN peas ce pee uc si ne ie e ssa acus pce ru v inn CER OE aa 25 Maten ROM COmimard i e e reo ace ce E nal i at lp deren P nca ESL wa Ce Leeds 26 lil OMMA ae lc te a seach eens Tt 27 Power Down Bus Comnmt and iu a e esiti se een EE ppl erri uaa dig e blade make PD e cea Rai a ee gei d E 28 Vite lei El EE 29 Read Bit ar torio oa hd Lscadeb tuba rase dd decimate ce cde id Eoi S UR aa
24. ire devices can be found on our technical support website at http Talk1Wire com Low Level Command List The following is an overview of each http request that can be made to the HA7Net Detailed reference on each command can be found on the pages that follow Search The search command allows you to discover the unique serial number address of each 1 Wire device connected to the HA7Net Specifically the search command implements the 1 Wire search algorithm including the regular search family search and conditional search This function is used to discover the 64 bit ROM codes addresses of all the devices connected to the 1 Wire bus The search function can optionally restrict the returned list of addresses to those devices belonging to a particular family and or those that are in a device defined conditional state Address Device Used to select the particular 1 Wire device on the 1 Wire bus that you want to talk to Match ROM Provides a shortcut method to reset the 1 Wire bus and reselect the 1 Wire device that was selected with the last Address Device command Reset Used to reset the 1 Wire bus Power Down Bus Used to completely power down the 1 Wire bus Read Bit Used to read a single bit from the 1 Wire bus Write Bit Used to write a single bit to the 1 Wire bus Write Block Used to write and simultaneously read up to 32 bytes of data to the 1 Wire bus Read Pages Used to read one or more consec
25. isted pair net and automatically provides smart strong pull up for sensors ESD protection to more than 27kV IEC801 2 Reference Model is provided on the 1 Wire bus Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 859 5490 6 37 Configuration Setup The HA7Net is generally usable right out of the box but in most cases you will want to configure certain options as discussed here Configuration is performed by using a web browser to connect to the HA7Net whereby the following page should be presented Embedded Data Systems Providing Innovative 1 Wire Products amp Solutions HA7Net 1 0 0 11 HA7Net Configuration User Password Admin Password TCP IP The HA7Net is a low cost Ethernet enabled 1 Wire interface used to remotely monitor and control 1 1 Wire Security Wire networks sensors and controls Integrators and OEMs can substantially decrease development Date Time time and costs by letting the HA7Net handle the 1 Wire details SNTP Miscellaneous Support and documentation available at http Talk1Wire com Update Reboot 1 Wire Forms The left hand side of this page contains a menu of the various configuration options available To enter into any of the configuration screens you must be able to supply the current administration password Administrator Password The default administrator username password combination is as follows please note that these are case sensit
26. ive User admin can not be changed Password eds We highly recommend changing the default HA7Net Configuration User Password password Admin Password TCP IP Old Password ini 1 1 1 d 1 Wire Security The administrative password is required in Eine eS order to access any of the HA7Net SNTP configuration screens as well as the telnet weng Confirm Password interface Additionally the administrative Reboot password can be used in lieu of the User saa roms password to gain access to the 1 Wire bus AS User Password If set this password will be required in order to access any of the 1 Wire Forms or API By default this password is not set This password can be used to provide access control to your 1 Wire bus The username associated with this password is user TCP IP Settings The HA7Net ships with the following default TCP IP configuration First the device will attempt to obtain an IP addresses from a local DHCP server If that fails then the HA7Net will default to a static IP address of 192 168 0 250 with a netmask of 255 255 255 0 Using the TCP IP configuration screen the following parameters can be specified Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 7 37 Obtain IP Configuration via DHCP This instructs the HA7Net to load all TCP IP settings from a local DHCP server Use Static on DHCP Failure By enabling this option the HA7Net will fall back
27. lts to devices ofa given family Optional Conditional A 0 or 1 with 1 indicating that only devices in a conditional state are to be returned Returns Addresses Table that contains a list of 8 byte 1 Wire ROM address codes with each ROM code residing a text field named Address x where x is a 0 based sequential integer Sample Response 9D00080027AF4A10 73000000B0E22E28 DE000000181 37312 830000005A4E2426 D60000000C3E6C27 Sample address table from HTML page lt table name Addresses id Addresses gt lt tr gt lt td gt lt input CLASS HA7Value NAME Address 0 ID A lt td gt lt tr gt lt tr gt is DRESS 0 TYPE text VALUE 9D00080027AF4A10 gt lt td gt o input CLASS HA7Value NAME Address 1 ID A td lt tr gt lt tr gt DRESS 1 TYPE text VALUE 73000000B0E22E28 td v input CLASS HA7Value NAME Address 2 ID ADDRESS 2 TYPE text VALUE DE0000001B137312 td lt tr gt lt tr gt lt td gt v lt input CLASS HA7Value NAME Address 3 ID ADDRESS 3 TYPE text VALUE 830000005A4E2426 td lt tr gt lt tr gt lt td gt is v input CLASS HA7Value NAME Address 4 ID A td lt tr gt lt table gt DRESS 4 TYPE text VALUE D60000000C3E6C27 Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone F
28. n management Concurrency management is provided on the HA7Net via a traditional locking mechanism wherein a client will request a lock on the 1 Wire bus and no other clients will be allowed access to the bus until the lock is either explicitly released by the client or expires due to inactivity The default maximum idle lifetime of the locks can be configured per HA7Net and has a default value of 60 seconds The general process for interacting with the HA7Net in a multi user environment looks like this Client requests lock of the 1 Wire bus o http HA7 Net 1 Wire GetLock html HA7Net responds with a new Lockld when the bus is available Client performs transactions while referencing the LockID o http HA7 Net 1 Wire Temperature html LockID xxxxxxx amp Address 1234567812345678 o http HA7 Net 1 Wire Search html LockID xxxxxx amp FamilyCode 10 amp Conditional True Client releases previously acquired lock O http HA7 Net 1 Wire ReleaseLock html LockID xxxxxxx For the duration of the lock only clients that reference the currently valid lock id will be allowed to access the 1 Wire bus All other requests will block until the bus is available In summary all 1 Wire activities are handled atomically within the HA7Net so all requests made that do not reference a LocklD are guaranteed to have uninterrupted access to the 1 Wire bus for the duration Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fa
29. n a text field named Address x where x is a 0 based sequential number This can data can be parsed automatically by DOM parsers or by simply by using a regular expression similar to the following s lt INPUT NAME Address_ VALUE 2 p In fact the following is a sample Linux command line that can be used to communicate to an HA7Net which will print the address of all of the 1 Wire devices connected to the HA7Net to stdout curl q http ha7 net 1Wire Search html 2 gt dev null sed silent e s lt INPUT NAME Address_ VALUE 2 p Exception Table The following is the section of the html document shown above that discusses any exceptions that may have occurred during the request EEN Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 17 37 lt table name Exceptions ID Exceptions gt lt td gt lt input CLASS HA7Value NAME Exception Code 0 ID Exception Code 0 TYPE hidden VALUE 0 gt td td input CLASS HA7Value NAME Exception String 0 ID Exception String 0 TYPE hidden VALUE None gt td lt tr gt lt tahla gt In this example there where no exceptions encountered as indicated by the form field named Exception_Code_0 having its value equal to 0 When this is the case the exception fields are type hidden to prevent rendering in the web browser If there had been an actual excep
30. nplugging the HA7Net and then remove the top cover Inside you will see two metallic pads near the center of the PCB labeled Factory Reset Use an appropriate tool tweezers paper clip etc to short these two pads together While shorting these two contacts power up the HA7Net Keep the two contacts shorted together until you see the green and red LEDs on the front of the HA7Net begin to flash alternately At this point you have triggered the HA7Net to perform a reset and you can remove the short Overall the reset will take one to two minutes to complete as the HA7Net will generate a new SSL certificate during the process a very computationally intensive task After the reset is complete the LEDs will return to normal operation and the HA7Net should operate using the default configuration values given above Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 11 37 1 Wire Technology Overview 1 Wire is a technology created by Dallas Semiconductor which is centered around a data bus that implements a simple signaling scheme used to perform two way communications between a single master and multiple peripheral devices over a single connection A powerful feature common to all 1 Wire bus devices is that each and every device whether in a chip or an iButton form has a factory lasered serial number that will never be repeated in any other device That is to say every device is
31. o the following in a standard web browser Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 16 37 Search Repl HA7Net 1 0 0 12 31000800B1B12910 1D000800C31EBB10 5100000020A0AA12 3F00000022D19512 DA00000008607E27 You can see that the serial number of each 1 Wire device appears in a form field Taking a look at the source of this html document you can see how the data is also easily machine parseable via regular expressions or higher level DOM or SAX parsers Each html response document is typically divided into three primary sections that are organized into html tables The three sections are used to discuss The data portion of the response Exceptions that may occur during the request Statistical information about the request Data Table The following is the section of the html document shown above that discusses the serial numbers of the 1 Wire devices table name Addresses id Addresses gt tr td input CLASS HA7Value NAME Address 0 ID ADDRESS 0 TYPE text VALUE A100000000E22820 gt lt td gt lt tr gt lt tr gt lt td gt input CLASS HA7Value NAME Address 1 ID ADDRESS_1 TYPE text VALUE 280000003042C210 gt lt td gt lt tr gt lt tr gt lt td gt From this you can see that all of the 1 Wire addresses are contained in a table named Addresses and each of the individual addresses are contained i
32. ry in dynamically configured networks When the HA7Net hears the appropriate multicast packet it will respond with a directed UDP packet containing information about how to contact the HA7Net Telnet Interface As an aid in both troubleshooting and the initial integration process the HA7Net offers a telnet server that can be used to monitor what is happening internal to the device This interface is available on the standard telnet port 23 and is secured by the HA7Net s administrative level password The telnet interface provides access to messages and logging from each of the individual subsystems in the HA7Net currently Http Server Debug Logging Facility 1 Wire Network Activity Telnet Server Clock Maintenance The messages are formatted in the standard Unix syslog format and each subsystem can be individually configured for the desired logging level ranging from practically none Emergency to nearly everything Debug Multicast Listener In order to provide a mechanism for discovering HA7Nets on a dynamically addressed i e DHCP networks the HA7Net has an integrated multicast listener that will respond to properly formatted multicast packets with a directed UDP packet This allows the client to discover all of the HA7Nets within reach of a single multicast packet Packet Format The multicast packet transmitted from the client to the HA7Net should be constructed as follows Char signature 2 gt HA WORD16 command
33. s LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 5 37 1 Wire Interface For ease of use the HA7Net is equipped with three 1 Wire ports which are wired in parallel Each port is a standard 6 Wire RJ11 RJ12 jack pinned for use with 1 Wire devices as follows Pin 1 No Connection RJ11 Jack Pin 2 No Connection Pin 3 1 Wire Signal Data Pin 4 Ground Pin 5 No Connection Pin 6 User Selectable Vdd Regarding pin 6 Vdd inside the HA7Net are three jumpers located next to the RJ11 jacks By manipulating these jumpers pin 6 can be configured for any of three states 5 Volt DC power supplied up to 200mA This might be useful if you want to provide external power to sensors such as the DS18x20 GND Pin will be held to the common 1 Wire GND level Floating The pin will be physically disconnected inside the HA7Net This might be useful if you have other devices on the bus that need to control this line The default configuration when shipped from us is Floating No Connection Depending on the exact type of sensors you are connecting to the HA7Net you may want to supply power i e to operate a DS18x20 in powered mode or an extra ground i e to operate a DS18x20 in parasitic power mode in which case the Vdd pin must be connected to ground For most iButtons the Floating No Connection configuration is just fine The HA7Net supports up to 2000 feet of cabling and 100 1 Wire devices on a CAT 5 tw
34. s Probe Value Probe Units Pelham Temperature Status HMP2001S DE0000001B137312 35 6448 Relative Humidity 9D00080027AF4A10 24 5 OK Read Temperature URL 1Wire ReadTemperature html Address Array Address1 Address2 Address3 Example http ha7 net 1Wire ReadTemperature html Address Array 9D00080027AF4A10 73000000B0E22E28 The ReadTemperature function allows you to read the current temperature from a list of mixed 1 Wire device types Currently supported devices include DS18B20 DS18S20 DS1920 gt DS2438 When calling the URL you provide a list of the sensors you want to be read Any sensors that can be operated at multiple resolutions e g DS18B20 will be read using their current configurations The HA7Net will sequentially read each sensor and then return a single html page containing a list of the sensors the temperature of each sensor expressed in degrees Celsius and the current operating resolution of the sensor as shown below If you want to control the resolution of the DS18B20 see the ReadDS18B20 function below Address Temperature Resolution 9D00080027AF4A10 24 1875 9 73000000B0E22E28 20 8125 12 Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 21 37 Read DS18B20 URL 1Wire ReadDS18B20 htm1 DS18B20Request Address1 Resolution1 Address2 Resolution2 Example http ha7 net 1Wire ReadDS18B20 htm1 DS18B20Request 73000000B0E22E28 91
35. s and re address the sensor Tell the sensor to perform a temperature conversion Wait for the conversion to complete Reset the 1 Wire bus and re address the sensor Read the scratchpad memory of the DS18B20 Decipher the temperature reading from the data in the scratchpad Instead of executing these low level steps you can simply ask for the current temperature of an entire list of DS18B20s using the HA7Net s high level ReadDS18B20 command The HA7Net will execute the steps above for each sensor on your list and then return you a single html page containing the temperature of every sensor expressed in degrees Celsius In addition to reducing the required learning curve and implementation time this functionality also dramatically decreases the time required to complete certain operations and allows your application to scale much better than non intelligent network bus masters Traditionally 1 Wire bus masters have been connected directly to serial ports on PCs or PLCs where the latency between the application and the bus master is negligible Now that your bus master may be located anywhere in the world away from your application the latency introduced by the underlying communication infrastructure becomes significant Even with typical Internet ping times of 100 200 mS you can see that the DS18B20 example above would have between 1 to 2 seconds of additional overhead added to the reading of each sensor Multiply this by 100 or more temperature
36. t latches and sensed levels of the two IO lines PIOA and PIOB http HA7Net com 1Wire WriteBlock html Address 2400000007377212 amp Data F5CFFFFF Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 29 37 Note that 4 bytes were written and 4 bytes were read Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 30 37 Read Bit Command URL 1Wire ReadBit html Example http ha7 net 1Wire ReadBit html Reads a single bit of data from the 1 Wire bus Description This command is used to read a single bit from the 1 Wire bus regardless of context Parameters Optional Lock D Ten byte decimal number previously returned by GetLock Returns Bits Table that contains the bit read from the 1 Wire bus This value is stored in a text field named Bit O Embedded Data Systems LLC 1446 Gilberts Cr k Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 31 37 Write Bit Command URL 1Wire WriteBit html Example http ha7 net 1Wire WriteBit html Bit 0 Writes a single bit of data 0 to the 1 Wire bus Description This command is used to write a single bit from the 1 Wire bus regardless of context Any response from a 1 Wire device on the bus is read and returned Parameters Optional LockID Ten byte decimal number previously returned by GetLock Bit to write to the 1 Wire bus Should be either 0 or 1 Returns
37. t vite Bus Device s Specific Operation Device Interaction Once a device is isolated for bus communication selected the master can issue device specific commands to it send data to it or read data from it This is generally accomplished using combinations of the following HA7Net commands Write Block Write Bit Read Bit Read Pages Read Records and Write Record Since each 1 Wire device type performs different functions they each implement their own protocol for interacting with it after the selection process The HA7Net commands above will allow you to effectively interact with any 1 Wire device manufactured present or future regardless of its protocol Ern OAtLG D KKEL eSNO NLLLLLLLLLLLLLLLLLLQL AD A OIL ELECLLLLLLLLELE XXXXIAUEEOEIOZOCDBDLbLLLLALI Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 12 37 Typical 1 Wire Communication Process Putting this altogether communications with devices on a 1 Wire bus typically follow a flow similar to the following i Yes S 4 4 o Perform Acquire Exclusive use of 1 Discover Select 1 Wire Perform Device Specific Release Exclusive x m S m S Another Nop 5 Wire Bus Device Interactions Action use of 1 Wire Bus Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg K
38. tificate lifetimes as related to the SSL portion of the internal http server and is also used as a reference for time stamping each result page returned from the HA7Net Since the clock is connected to the primary 1 Wire bus it can be used in simple diagnostics to determine the correct operation of the HA7Net This also means that it can be completely accessed by the integrator The DS2417 clock has a specified accuracy of 2 minutes per month For increased long term accuracy the HA7Net can be configured to periodically synchronize it with a SNTP time server Internal Battery The HA7Net is equipped with a user replaceable Lithium CR2032 coin cell battery This battery serves to power the internal real time clock such that the HA7Net s clock settings are not lost during power failures etc Note that all other configuration settings network settings user names etc are stored in non volatile memory that is not dependant on the battery In other words removing the battery will only affect the clock it will not erase other configuration settings Ethernet Interface The HA7Net is equipped with a standard 8 Wire RJ 45 Ethernet jack that meets the ISO 8877 requirements for 10 100BASE T Both half and full duplex modes of operation are supported on the Ethernet interface If you are connecting to a hub or switch a straight through cable should be used If connecting directly to a PC then a crossover cable should be used Embedded Data System
39. tion the fields would be type text It is recommended that client applications always check for exceptions and handle them as appropriate A complete listing of exceptions and possible causes are discussed later in this document Statistics Table The following is the section of the html document show above that discusses statistics regarding the specific request lt table name Statistics ID Statistics gt lt tr gt SES igh TYPE HIDDEN NAME Completed_0 VALUE 101446 gt lt td gt lt tr gt lt table gt Shown here is the only statistical data currently implemented which is the timestamp when the html document was created on the HA7Net The value represents the number of seconds since January 1 1970 and is stored in the field named Completed_0 This timestamp can be used to determine the when the request was completed regardless of any latency between the client and the HA7Net This can be useful when calculating the rate at which a piece of data is changing across multiple requests Concurrency Management The physical layer of the 1 Wire MicroLan is designed such that only one data request or operation can be made on the 1 Wire bus at a time It is also common for a single logical transaction to span multiple physical 1 Wire requests Given this modal nature of the 1 Wire bus and the multi user nature of the http interface it is necessary for the HA7Net to provide a means of concurrency and bus contentio
40. to its statically configured parameters if it is unable to negotiate a DHCP lease If this is not enabled then the HA7Net will continuously attempt to locate a DHCP server Static IP Address Network Mask Default Route Gateway Primary DNS server optional Secondary DNS server optional HTTP Port Defines which port number the HA7Net s internal web server will listen on Note that if the device successfully configures itself via DHCP then you will either have to consult your DHCP server logs or take advantage of the HA7Net s multicast listener in order to discover the HA7Net s IP address HA7Net 1 0 0 11 re Meier HA7Net Configuration User Password Admin Password Obtain IP Configuration via DHCP V TCP IP 1 Wire Security Date Time SNTP Miscellaneous Static IP Address 192 168 000 250 Update Reboot 1 Wire Forms Use Static on DHCP Failure v Network Mask 255 255 255 000 Default Route 192 168 000 254 Primary DNS 000 000 ooo 000 Secondary DNS 000 000 000 om HTTP Port 80 Change TCP IP Embedded Data Systems LLC 1446 Gilberts Cr k Rd Lawrenceburg KY 40342 Phone Fax 502 859 5490 8 37 Date Time This form can be used to configure the time and date stored in the HA7Net s real time clock We recommend setting this to GMT but this is not a requirement and you may want to et Configuration use another time zone depending on your E
41. u can take advantage of existing corporate LANs the Internet and in house MIS expertise for building out your sensor network as shown in figure 1 Another advantage is the number of readily available libraries and developer tools that can be used to communicate with the HA7Net These are widely available for common development platforms Intended Audience This document is intended for the developer integrator charged with the task of designing the 1 Wire sensor MicroLans and writing the software that will interface with the HA7Net Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 4 37 HA7Net Hardware Overview Form Factor The HA7Net is available in both panel mount and DIN rail form factors The panel mount version suitable for desktop or wall mounting while the DIN rail version is compatible with industry standard DIN 35 mounting rails typically found in industrial environments Power Supply Requirements The HA7Net is fitted with a 2 5mm power jack suitable for connection to any 6 12 Volt DC power supply having a F2 2 5mmlID x 5 5mmOD female type plug wired for positive polarity on the center conductor The power supply should capable of delivering 500mA Internal Clock The HA7Net is equipped with an internal battery backed DS2417 real time clock which itself is a 1 Wire device connected to the primary 1 Wire bus The clock is used for such things as managing security cer
42. utive pages of memory from 1 Wire memory devices Read File Records Used to read one or more consecutive TMEX formatted file records from 1 Wire memory devices Write File Record Used to write a single TMEX formatted file record to a 1 Wire memory device Get Lock Used to obtain exclusive access to the 1 Wire bus for a period of time Release Lock Used to release exclusive access to the 1 Wire bus Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 23 37 Search ROM Command URL 1Wire Search html Examples http ha7 net 1Wire Search html Locates all 1 Wire devices http ha7 net 1Wire Search html FamilyCode 10 Locates all DS18S20s http ha7 net 1Wire Search html FamilyCode 10 amp Conditional 1 Locates all DS18S20s in conditional alarm state Description The search ROM command implements the 1 Wire search algorithm including each of the regular search family search and conditional search functionalities This function is used to discover the 64 bit ROM codes addresses of devices connected to the 1 Wire bus The search function can optionally restrict the returned list of addresses to include only devices belonging to a particular family and or those that are in a device defined conditional state Parameters Optional LocklD Ten byte decimal number previously returned by GetLock Optional FamilyCode Two byte hex number used to restrict the resu
43. x 502 8595490 18 37 of that particular request By requesting and referencing an explicit lock a client can guarantee itself uninterrupted access to the 1 Wire bus across multiple requests Embedded Data Systems LLC 1446 Gilberts Creek Rd Lawrenceburg KY 40342 Phone Fax 502 8595490 19 37 HTTP Interface API Reference In terms of interacting with the 1 Wire bus we divide the HA7Net command set into two categories The first is a high level command set in which the HA7Net provides high level functionality for working with various 1 Wire devices This saves the developer from having the learn and implement the low level details of communicating to each different type of 1 Wire device For example you can simply ask the HA7Net to read the current temperature from a DS18S20 The second category is a low level command set By using the low level commands you can take complete manual control of the 1 Wire bus down to the level of reading and writing individual data bits High Level Commands The high level commands are designed to simplify the process of interacting with specific 1 Wire devices Many 1 Wire devices require a number of communications between the bus master and the slave in order to accomplish a single task For example to read the current temperature from a DS18B20 temperature sensor the following low level steps are typically required Address the DS18B20 Configure the Operating Resolution of the sensor Reset the 1 Wire bu
Download Pdf Manuals
Related Search