AwiaTech WirelessHARTTM Evaluation Kit Manual
Contents
1. Second make sure you have both WirelessHART Gateway exe and WirelessHART Daemon exe processes in the Windows Task Manager If you don t see them exit AwiaVanguard and restart it 3 What if cannot find the GATEWAY in the GUI of WirelessHART mentioned in Question 2 Make sure Microsoft Visual C 2008 Redistributable is installed correctly Check in the Control Panel gt Programs 4 How to make sure the serial port over USB driver is installed correctly Test your AP device It cannot be unknown device in the Device Manager if the driver is installed correctly 5 What if Access Point cannot be detected Check Question 2 and 4 first If it still does not work contact us through the email given in www awiatech com 6 What if one device doesn t join e Make sure its power Led is on Check if it is communicating the other LED flashes Is the device within range e Does it show up in the network manager message communicated Rev 2 2 22 AwiaTech WirelessHART Evaluation Kit Manual e Restart the device Other helpful hints e Look up online at www awiatech com e Check the error messages from application and Windows Event Viewer e Email to support awiatech com Rev 2 2 23 AwiaTech WirelessHART Evaluation Kit Manual 2 DEVELOPMENT GUIDE 2 1 System Architecture An AwiaNet provides a wireless medium to transport sensor data to the host application a2. Don t create icons F Create Icons for All Users 8 During the installation a serial port over USB device driver is installed After the following Device Driver Installation Wizard window appears click Next Rev 2 2 Please Review the Following Before Continuing Product Name WirelessHART Install Folder C Program Files WirelessHART Shortcut Folder C Users Ulee AppData Roaming Microsoft Windows Start Menu Programs WirelessHART Disk Space Information for Installation Target Required 23 640 383 bytes Available 161 238 593 536 bytes 11 AwiaTech WirelessHART Evaluation Kit Manual Dee er tsbionWerd E Welcome to the Device Driver Installation Wizard This wizard helps you install the software drivers that some computers devices need in order to work wait WirelessHART is being configured for your system This may take a moment To continue click Next 9 Click Finish after completing the device driver installation Lee E Completing the Device Driver Installation Wizard The drivers were successfully installed on this computer You can now connect your device to this computer If your device came with instructions please read them first Driver Name Sahn elessHART is being configured for your system g This may take a moment W FTDI CDM Driver Packa Ready to use W FTDI CDM Driver Packa Ready to
3. AwiaTech WirelessHART Evaluation Kit Manual AwiaTech Corporation 2011 All rights reserved AwiaTech WirelessHART Evaluation Kit Manual FCC STATEMENT 1 This device complies with Part 15 of the FCC Rules Operation is subject to the following two conditions 1 This device may not cause harmful interference and 2 This device must accept any interference received including interference that may cause undesired operation 2 Changes or modifications not expressly approved by the party responsible for compliance could void the user s authority to operate the equipment NOTE This equipment has been tested and found to comply with the limits for a Class B digital device pursuant to Part 15 of the FCC Rules These limits are designed to provide reasonable protection against harmful interference in a residential installation This equipment generates uses and can radiate radio frequency energy and if not installed and used in accordance with the instructions may cause harmful interference to radio communications However there is no guarantee that interference will not occur in a particular installation If this equipment does cause harmful interference to radio or television reception which can be determined by turning the equipment off and on the user is encouraged to try to correct the interference by one or more of the following measures e Reorient or relocate the receiving antenna e Increase the separation between the e
4. 5 IEEE 802 15 4 5 35 network layer 6 Rev 2 2 38 AwiaTech WirelessHART Evaluation Kit Manual AwiaTech Corporation 2011 All rights reserved AwiaTech Awia Warrior Awia Vanguard Awia Commander Awia Captain and AwiaNet are trademarks of AwiaTech Corporation HART and WirelessHART is a trademark of the HART Communication Foundation Other company and product names mentioned herein may be trademarks of their respective companies Mention of third party products is for informational purposes only and constitutes neither an endorsement nor a recommendation AwiaTech assumes no responsibility with regard to the performance or use of these products All understandings agreements or warranties if any take place directly between the vendors and the prospective users Every effort has been made to ensure that the information in this manual is accurate AwiaTech is not responsible for printing or clerical errors The product described in this manual incorporates copyright protection technology that is protected by method claims of certain U S patents and other intellectual property rights owned by AwiaTech Corporation and other rights owners Use of this copyright protection technology must be authorized by AwiaTech Corporation Reverse engineering or disassembly is prohibited Rev 2 2 39
5. ID 2 3 6 From Sensor to Warrior Write Join Key Command 961 This is a standard WirelessHART command This command is used to set the join key of the device During the join process the join key is used for authentication with the network manager In this command Cmd Data is the 16 byte join key Command Data Bytes Byte Format Description 0 15 Unsigned 128 Key value 2 4 Putting It All Together 2 4 1 Use Awia Net as a data transmission medium Burst Just like other network infrastructure the Awia Net can serve as a medium for two peers to exchange data In this case the peers are the host application and the sensors in the field For this purpose the Awia Net receives data from the host and delivers to the sensor and vice versa From host to sensor The host application calls Write with a string of bytes to be sent to the sensor The Awia Net will route the data to the Warrior associated with that sensor copy the data to the Warrior s cache for Command 170 then send Command 170 to the sensor with the same string of bytes From sensor to host The sensor sends Command 170 to the Awia Warrior with a string of bytes The Awia Warrior will cache the bytes If bursting is established by the host The Awia Warrior will periodically publish the data in its cache to the gateway Upon the reception of an update from the Awia Warrior the gateway puts the data in its own cache and forwards to the host by calling Data Oc
6. WarriorTM Awia VanguardIM Awia igo and Awia CommanderTM software and rela d materials Software including any upgrades modified versions or jupdates of the Software BY USING THE SOFTWARE EITHER ON A PC OR EMBEDDED ON A WIRELESS DEVICE Device YOU ACCEPT ALL THE TERMS AND CONDTTIONS OF THIS AGREEMENT Tf von dn 4 After the following window appears select Typical and click Next Rev 2 2 AwiaTech WirelessHART Evaluation Kit Manual Typical The most common application features will be installed This option is recommended for most users Minimal Only required application features will be installed This option is recommended only for users with limited disk space Custom Choose this option to customize the features to be installed ere Would You Like to Install C Program Files WirelessHART Restore DefaultFolder_ Choose Installing Install Corr 6 After the following window appears click Next Rev 2 2 10 AwiaTech WirelessHART Evaluation Kit Manual ewe 7 After the following window appears all information needed for the installation has been collected Please click Install Where would you like to create product icons Ina new Program Group WirelessHART In an existing Program Group WirelessHART In the Start Menu onthe Desktop In the Quick Launch Bar Other
7. for a packet to cross a network connection from sender to receiver Link full communication specification between adjacent devices in a network and it includes the communication parameters necessary to move a DLPDU one hop NOTE A Link is a function of source and destination address pairing slot and channel offset assignment direction of communication dedicated or shared communication and type Links are assigned to superframes as part of the scheduling process Master a device that initiates communication activity by sending request APDU to a device and expecting a response PDU Rev 2 2 36 AwiaTech WirelessHART Evaluation Kit Manual Medium access control lower of the two data link layer levels NOTE This level controls the access to the communication channel Neighbor adjacent node in the network such that the receive signal level RSL from it suggests that the communication is possible in at least one direction Network device device with a direct physical layer connection to the network Network ID identifier used to indicate a network to which all intercommunicating devices are connected NOTE A device connected to one network can not send a PDU to another device connected to a different network Network manager entity that is responsible for configuration of the network scheduling communication between network devices management of the routing tables and monitoring and reporting the health of the network NOTE There is on
8. least one of each component mentioned above A complete list of AwiaTech product definitions is listed in Table 1 WirelessHART Component Corresponding AwiaTech Product Name AwiaTech Product Form Network Stack Awia Warrior Stack Software Device Module Awia Warrior Module Hardware Software Gateway Awia Vanguard Software Network Manager Awia Commander as part of Awia Vanguard Software Access Point Awia Captain Hardware Software Network AwiaNet Hardware Software LA What is in the Kit Table 1 AwiaTech Product Definition First of all please make sure your evaluation kit is complete and familiarize yourself with the content This evaluation kit contains e One Awia Captain Access Point e Five Awia Warrior Modules plus o AA Battery cases Batteries not included e One Software CD containing Rev 2 2 AwiaTech WirelessHART Evaluation Kit Manual o Awia Vanguard Gateway o User Manual e One USB cable for connecting the Awia Captain to a PC e One printed copy of user manual 1 4 Install Software on PC Before you start an AwiaNet please make sure the Awia Vanguard software is installed on a PC that meets the following requirements Minimum System Requirements e Windows XP Windows Vista or Windows 7 for both 32 bit and 64 bit e 200 MB available in the hard disk e 1GBRAM e An available USB port e CD ROM 2
9. start of the next preamble are discarded Some of the commands are defined in the following Rev 2 2 29 AwiaTech WirelessHART Evaluation Kit Manual 2 3 1 From Warrior to Sensor Host Data Burst Command 170 This is an AwiaTech device specific command This command writes a series of bytes received by the gateway from the host The host sends the bytes by calling Write in the Host API The host could also call HARTCmd with Command Number set to 170 In either case the gateway will send Command 170 to Awia Warrior Awia Warrior sends Command 170 to the sensor when and only when it receives Command 170 from the gateway At this point the Warrior copies the host bytes to its local data cache for Command 170 sends them to the sensor and then sends Command 170 response back to the gateway The Command 170 response includes the same host bytes Maximum allowed host data size is 72 bytes but can also be 0 bytes 2 3 2 From Warrior to Sensor Host Data Non Burst Command 171 This is an AwiaTech device specific command This command writes a series of bytes received by the gateway from the host The host sends the bytes by calling HART Cmd with Command Number set to 171 and the gateway will send Command 171 to the Awia Warrior The Warrior sends Command 171 to the sensor when and only when it receives Command 171 from the gateway At this point the Awia Warrior sends the host data to the sensor without copying
10. D OxEF CRC OxBB OxFF OxAE OxAD Table 6 Command 170 messages field value The following is the code snippet for calculating CRC update the crc for each byte x void crc_ccitt_update unsigned short crc unsigned char x unsigned short crc_new unsigned char crc gt gt 8 ere lt lt 8 crc_new x crc_new unsigned char crc_new amp xff gt gt 4 crc_new crc_new lt lt 12 crc_new crc_new amp xff lt lt 5 crc crc_new int _tmain int argc _TCHAR argv unsigned short crc xFFFF the initial crc unsigned char frame 2 x C Oxee 0x40 x0 Oxee 0x00 O xAA 0x03 xAB xCD OxEF Rev 2 2 32 AwiaTech WirelessHART Evaluation Kit Manual unsigned char i unsigned char length 9 for i i lt length i crc_ccitt_update amp crc frame i frame length unsigned char crc gt gt 8 amp OxfFf frame length unsigned char crc amp OxfFf return 2 4 2 Use Awia Net as a data transmission medium Non Burst We use Command 170 for subscription based method to retrieve sensor data i e push or unsolicited data publication It works best for frequent sensor updates the host does not need to ask for update each time In many other applications though the host only needs to read from the sensor once in a long while or occasionally skips a read This is better achieved with pull or solicit
11. R_ADDR addr sin_port htons OPC_SERVER_PORT bind serSocket SOCKADDR amp addr sizeof SOCKADDR listen serSocket 5 listening loop rue SOCKET serConn accept serSocket NULL NULL char receiveBuf 200 int len recv serConn receiveBuf strlen receiveBuFf 1 9 if len 1 char npdubytes new char len memcpy npdubytes receiveBuf len this gt m_gwProcessor gt addNpduBytes npdubytes len handle commands if m_queryBytes 1 m_apiIndex m_queryBytes 1 switch int m_apiIndex case 1 ReadTagList break case 2 Subscribe deviceTag updateRate break case 3 Unsubscribe deviceTag and Read deviceTag break case 4 break case 5 TagList tag list copies a variable amount of deviceTags te array m_tagListLength m_queryLength 2 m_tagList new char m_tagListLength memcpy m_tagList m_queryBytes 2 m_tagListLength break 27 AwiaTech WirelessHART Evaluation Kit Manual Send Rev 2 2 case 6 Data deviceTag dataValue if len lt 12 m_isenough else if len gt 12 m_istoomuch 1 m_isenough 1 m_remaindata new char len 12 memcpy m_remaindata m_queryBytes 12 len 12 m_remaindataLength len 12 else m_isenough 1 m_istoomuch if m_isenough 1 m_queryLength 12 m_deviceTag new char devicetagLength memcpy m_deviceTag m_queryBytes 2 devicetagLength m_dataValueLength m_queryLength 8 m_dataVal
12. casionally the host could call Read and in response the gateway calls Data to forward the string of data in its cache to the host application The host application should first call Subscribe with burst command number set to 170 Calling Subscribe with burst command number set to 1 will activate the simulated sensor in the Awia Warrior and the actual sensor data will not be transmitted to the gateway Rev 2 2 31 AwiaTech WirelessHART Evaluation Kit Manual It s up to the user to define the protocol between the host and the sensor i e the semantics of the byte string exchanged between the two The host and sensor should manage the acknowledgement and retry it is possible that the wireless network may lose a message In addition since there is a limit of 72 bytes per message the user should handle data larger than 72 bytes by breaking them up in the sender and reassembling in the receiver Table 6 shows example message field values for Command 170 In this example the data from host to sensor is Ox01 0x23 0x45 0x67 0x89 and the data from sensor to host is OxAB 0xCD OxEF Warrior gt Sensor Sensor gt Warrior Preambles OxFF OxFFO xFF OxFF OxFF OxFF OxFFO xFF OxFF OxFF 0x86 0x86 0x86 LEN Ox0E UNC SEO 0x00 0x00 Transport Byte 0x00 0x40 Device Status 0x00 0x00 Extended Status 0x00 0x00 Command No 0x00 OxAA 0x00 OxAA Byte Count 0x05 0x03 Data 0x01 0x23 0x45 0x67 0x89 OxAB OxC
13. e WirelessHART field device s e One WirelessHART Gateway including Network Manager e One WirelessHART Access Point It may also contain e WirelessHART Adaptor e WirelessHART Router Device Figure shows a WirelessHART network example Rev 2 2 5 AwiaTech WirelessHART Evaluation Kit Manual Gateway Access Point tf ACCESS Nswiwe se 3 Field Device 7 a e 7 Field D n ef d Device 1 NERE Pi N 7 d Pa d k K a d Router ye R Device d 7 Field r E e A Device pi P pam a s V r 7 4 s G o gege Adapter b Field Field Field Field Device Device Device Device Figure 1 A WirelessHART network example Figure 2 illustrates the architecture of WirelessHART protocol stack according to the OSI 7 layer communication model It includes five layers physical layer data link layer network layer transport layer and application layer Provides the User with Network Capable Command Oriented Predefined Data Types and Applications Application Procedures Converts Application Data Between Network and Local Machine Formats Presentation i Connection Management Services for Applications Provides Network Independent Transparent Message Transfer T t Auto Segmented transfer of large data sets reliable ranspor stream transport Negotiated Segment sizes End to End Routing of Packets Resolving Power Optimized Redundant Path Self Network Addresses Hea
14. e and only one network manager per instance of Type 20 network Although the network manager need not have a direct physical layer connection it still has a unique address Node addressable logical or physical device attached to the network Security Manager An application that manages the Network Device s security resources and monitors the status of the network security Slot fixed time interval that may be used for communication between neighbors Superframe collection of slots repeating at a constant rate each slot has a link associated with it Time division multiple access medium access control technique that uses time slots where communications between devices can occur NOTE It provides collision free deterministic communications Transaction exchange of related consecutive frames between two peer medium access control entities required for a successful transmission NOTE A transaction consists of either a a single PhPDU transmission from a source device or b one PhPDU from the source device followed by a second link level acknowledgement PhPDU from the destination device Rev 2 2 37 AwiaTech WirelessHART Evaluation Kit Manual 5 INDEX application layer 6 29 OSI 6 Awia Warrior 7 17 18 24 26 29 30 physical layer 6 37 31 33 34 35 36 39 transport layer 6 29 data link layer 6 WirelessHART 5 6 7 8 14 18 21 22 Gateway 5 7 8 20 21 22 36 24 29 30 31 34 35 36 39 IEC 62591
15. e network ID from device 0x00001b1e0002 It will send HART command 774 0x0306 to that device The host will then send message byte string 0x010800001b1e00020306 to the gateway The message the host gets back will be 0x010800001b1e0002030600AAAA which says the network ID is OxAAAA 2 2 2 Usage In this section we describe how to set up the host to receive burst data from the Awia Warrior First the host application establishes the socket connection with the gateway The host application should call ReadTagList periodically to find new sensors in the network Once having received TagList the host application calls Subscribe to activate sensor data publishing The sensor will then periodically send data to the cache in the gateway which will forward the data to the host via Data Whenever the host wants to view the latest cached data it sends Read to the gateway who will respond by sending Data back Rev 2 2 26 AwiaTech WirelessHART Evaluation Kit Manual 2 2 3 Sample code The demo host application serves as the sample JAVA code The following is C sample Receive while t into by Rev 2 2 code load and create socket WORD myVersionRequest WSADATA wsaData myVersionRequest MAKEWORD 1 1 int err err WSAStartup myVersionRequest amp wsaData serSocket socket AF_INET SOCK_STREAM SOCKADDR_IN addr addr sin_family AF_INET addr sin_addr S_un S_addr inet_addr OPC_SERVE
16. ed data retrieval The host does not need to subscribe for data update The Awia Net supports this with Command 171 From host to sensor The host application calls HARTCmd with Command 171 and a string of bytes to be sent to the sensor The Awia network will route the data to the Awia Warrior associated with that sensor who sends Command 171 to the sensor with the same string of bytes From sensor to host The sensor sends Command 171 to the Awia Warrior with a string of bytes The Awia Warrior will copy the data to its local cache for Command 171 Independently when the Awia Warrior receives Command 171 from the gateway it will prepare Command 171 response with its cached data and send back to the gateway Note in the response the Awia Warrior will prefix one byte status value to the cached data When the gateway receives the response it will send HARTCmd with Command 171 to the host with the received string of bytes There is no data cache for Command 171 in the gateway Similar to the subscription based method it s up to the user to define the protocol between the host and the sensor An example In this application the first byte of the byte string will be a handle The host increments the handle each time it sends to the sensor asking for a new data The sensor sends back the data with the handle copied to the first byte The host could call a read function whenever it needs to read a new data from the sensor The pseudo code o
17. en in JAVA Users can use any programming language because the communication with the gateway is via the standard socket 2 2 1 Definition The host application talks to the Awia Vanguard via socket The port number of the Awia Vanguard gateway is 8890 The port number of the host application is 8891 The gateway and the host application exchange messages The message data format is defined in Table Protocol Number Payload Table 1 Host API Message Format The Protocol Number is a one byte field indicating the different communication protocols used This evaluation kit release only supports Protocol 1 the simple data access In other words this field must be set to 1 The Protocol 1 message payloads are formatted as commands The payload is one byte command number followed by the command content whose size differs for different commands The commands are Cmd Name content in the Definition Host gt GW GW gt Host parenthesis 1 ReadTagList Read the list of devices in the network Yes No 2 Subscribe device tag Instruct the device to publish data to Yes No update rate burst the host The data is also saved in the command number gateway cache 3 Unsubscribe device tag Stop publishing Yes No 4 Read device tag Read data from the gateway cache Yes No 5 TagList tag list Report the device list No Yes 6 Data device tag data Forward the published data fro
18. f read is as follows char handle Rev 2 2 33 AwiaTech WirelessHART Evaluation Kit Manual char data 10e char read handle do HARTCmd deviceTag 171 handle receive HARTCmd retDeviceTag amp cmdNo data sleep 1s while retDeviceTag deviceTag cmdNo 171 data 1 handle return amp data 2 data is the HART status byte The sensor could implement the following endless loop char handle go char data 100 while 1 receive _Command171 amp hand1le if handle data Handle data read_sensor amp data 1 Command171 data 2 4 3 Use Awia Warrior in a WirelessHART device Awia Warrior could be experimented as a standalone WirelessHART device Generally a WirelessHART device has to be configured before being deployed This step is required for normal operation and security concerns Awia Warrior is designed to require minimal configuration There are only two required parameters for normal operations first the network that the device intends to join second the join key The user could use the serial communication to write the join key and network ID into the Warrior Or the user could configure the targeted network with the network ID 0x1236 and join key 0x000012360000000000000000 used in the evaluation kit With these pieces of information a device equipped with Awia Warrior can join the designated WirelessHART network au
19. his code has already been activated Please confirm that you wish to re activate it by entering your current password and then a new password Forgot your Password Re Activate 1 6 Start the Network This section describes the steps to start an AwiaNet e On the PC launch the Awia Vanguard Rev 2 2 16 AwiaTech WirelessHART Evaluation Kit Manual C Gateway p Fle Hap Torco Of Visualizer Message Vertex Edge Statistics Graph Info Device List Wm Nick Name Unique ID Type 1 een 0o1b1ef981000002 _ GATEWAY e Connect Awia Captain to the PC via a USB cable included in the kit Awia Captain is powered through the USB cable You shall see a window similar to the one below Click on the Connect button e A new Access Point is detected to join the network Through PORT COM24 e Power on the Awia Warriors e Start the host application 1 7 Explore and Evaluate As its name implies this evaluation kit allows you to explore and evaluate various kinds of scenarios in the field You will notice the topology change on Awia Vanguard Below are a few suggestions to start with 1 Turn a single Awia Warrior module on and off 2 Move an Awia Warrior module to a remote location Rev 2 2 17 AwiaTech WirelessHART Evaluation Kit Manual 3 Turn on Awia Warrior modules all at the same time vs
20. ling Wireless Mesh Network A Binary Byte Oriented Token Passing Secure amp Reliable Tme synched Master Slave Protocol TDMA CSMA Frequency Agile with ARQ Ph I Mechanical Electrical Connection Simultaneous Analog amp Digital Signaling 2 4GHz Wireless 802 15 4 based radios ysica Transmits Raw Bit Stream Normal 4 20mA Copper Wiring 10dBm Tx Power Wired FSK PSK amp RS485 Wireless 2 4GHz Establishes Data Packet Structure Data Link Framing Error Detection Bus Arbitration gt kej EI Figure 2 Architecture of HART Communication Protocol Rev 2 2 6 AwiaTech WirelessHART Evaluation Kit Manual 1 2 AwiaTech WirelessHART Products The Awia Warrior stack fully conforms to the WirelessHART standard Any functionality or interface described in this document that falls under the scope of the WirelessHART standard will contain the same description as the WirelessHART standard Throughout this document Awia Warrior refers to a hardware module with wireless radio communication capabilities and running AwiaTech s WirelessHART network stack thus it acts as a node to the network Awia Vanguard refers to AwiaTech s WirelessHART Gateway which includes Awia Commander AwiaTech s WirelessHART Network Manager Both Awia Vanguard and Awia Commander are software components Awia Captain refers to AwiaTech s Access Point Finally AwiaNet refers to a functioning WirelessHART network consisting of at
21. logy Visualizer Show Broadcast Graph Overlay the graph from Gateway to all nodes Show Downlink Graph Overlay downlink means the graph path from the gateway to a certain node thus it depends on which node the user currently selects Figure 1 Awia Vanguard Menu Description Demo Host shown in Figure 4 Rev 2 2 19 AwiaTech WirelessHART Evaluation Kit Manual E Sent Recieved 0x00001b1e0002 0x00001b1e0005 0x00001b1e0006 0x00001b1e0007 0x00001b1e0002 Value 0 9100000262260437 0x00001b1e0005 Value 0x00001b1e0006 Value 0x00001b1e0007 Value 0x00001b1e0008 Value Ox00001b1e0009 Value 0x00001b1e000d Value Ox00001b1e000F Value 0x00001b1e0011 Value 0x00001b1e0012 Value 0 949999988079071 0 949999988079071 0 9100000262260437 0 38999998569488525 0 38999998569488525 0 2800000011920929 0 4399999976158142 1 0 0 4399999976158142 Figure 4 Awia demo host 1 10 Trouble Shooting Due to a vast number of configuration possibilities of the Windows OS on the PC you may encounter the following issues For an updated list of trouble shooting please visit www awiatech com for the FAQ section 1 Awia Vanguard doesn t start If the PC runs Windows Vista or Windows 7 try running Awia Vanguard as administrator This can be set by either Right click the Gateway Icon and click Run as Administrator O Open Run as administrator Pin
22. m the No Yes value device or as response to the Read command report data in the gateway cache 7 Write device tag data Write data to the device Yes No value 8 HARTCmd device tag Send a HART command Yes Yes command number command content Table 2 Command numbers Rev 2 2 25 AwiaTech WirelessHART Evaluation Kit Manual The content parameters are 1 device tag 6 bytes Uniquely identifies a Warrior node 2 update rate 1 byte The frequency of which the Warrior will publish data Its value v is from 0 to 12 The update period DI x250ms 3 burst command 2 bytes number 0x00 0x01 Command 1 Burst from the simulated sensor in the Warrior 0x00 OxAA Command 170 Burst the data in the Warrior cache updated by the real sensor 4 data value 0x00 0x01 Command 1 4 bytes IEEE 754 IEC 559 compatible single precision floating point number The value is sampled from a sinusoid curve in the range of 1 1 Reference the source code in the sample host for its interpretation 0x00 OxAA Command 170 Byte string the sensor put in the Warrior cache Maximum size is 72 bytes 5 command number 2 bytes A valid HART command Most significant byte first 6 command content The payload of the HART command The first byte is the status byte if itis a command response from the Warrior Table 3 Payload parameters As an example the host wants to read th
23. nd other data from the host to the sensors There are two interfaces one to the sensors and one to the host application as is shown in Figure 4 In a WirelessHART network the conventional gateway is divided into three components the access point that talks wirelessly to the network the gateway GW that interfaces to the host applications and the network manager NM that manages the wireless network In the Awia network the access point is a hardware module that is connected to a personal computer The gateway and network manager are software in the computer The software is called Awia Vanguard and is installed from the CD The Awia Warriors represent the rest of the Awia network They are the network nodes Host Application Socket Communication Awia Vanguard Awia Captain Awia Net Awia Warrior SE Serial Communication Sensor Figure 2 AwiaNet Network Diagram AwiaTech WirelessHART Evaluation kit is a demo system with all the components within the circle of Figure 4 plus a demo host application There is a simulated sensor built into the Awia Warrior which can be activated in the demo system AwiaTech WirelessHART evaluation kit provides the interfaces for host application developers and sensor developers Rev 2 2 24 AwiaTech WirelessHART Evaluation Kit Manual 2 2 Host API Users can develop their own host applications using the API defined in the following The demo host is writt
24. one by one after the prior module has joined the network Notice that sometimes it takes some time for a new device to join According the WirelessHART standard it takes the following steps for a new device to join e The new device listens on one physical channel at a time for a certain period of time e The network devices randomly broadcast advertisements Therefore the change of the new device hears an advertisement is arbitrary To increase the chance the network device should be given more chances to advertise during network forming phase Notice that if you turn a device off it will take a few minutes for it to disappear from the network display There is a configurable timeout value If a device is not communicating after this timeout a path down failure will be generated and the device will be taken off the network The device could rejoin before the timeout in which it is reconfigured 1 8 Device Description Awia Warrior 220 AwiaTech www awiatech com a An Device Picture LED Light 1 Power indicator It is on when power is present LED Light 2 Communication indicator It is normally on and blinks when rransmitting or receiving Rev 2 2 18 AwiaTech WirelessHART Evaluation Kit Manual 1 9 Menu Description AwiaVanguard shown in Figure 1 Show Uplink Graph Overlay Uplink means the graph from nodes to the gateway Reset Topology Graph 201 Gateway File Help Topo
25. packs and security updates for this product For more information visit the following Web site Product Support Center Congratulations WirelessHART has been successfully installed to C Program Files WirelessHART Press Done to quit the installer Rev 2 2 14 AwiaTech WirelessHART Evaluation Kit Manual 1 5 Activation 1 The AwiaVanguard software needs activation at its first running The following window will pop up and please enter the activation code Make sure the PC has internet access then click Next i E Please enter your Activation Code Activation Code Request Eval Code Proxy Settings 2 If you enter an unused activation code simply enter the password and email for this code and then click Activation The wirelessHART software will be activated on your computer Activation 7992738410530366 Activation Information Please enter and confirm a password It is recommended that you also enter and confirm your email address in the Le that you need to retrieve your password for re activation 3 If you enter a used activation code the following window will pop up That means you can no longer use this activation code on your computer Rev 2 2 15 AwiaTech WirelessHART Evaluation Kit Manual Re Activation Information Current Password New Password Confirm T
26. quipment and receiver e Connect the equipment into an outlet on a circuit different from that to which the receiver is connected e Consult the dealer or an experienced radio TV technician for help FCC Radiation Exposure Statement This equipment complies with FCC radiation exposure limits set forth for an uncontrolled environment This equipment should be installed and operated with minimum distance 20cm between the radiator amp your body Rev 2 2 2 AwiaTech WirelessHART Evaluation Kit Manual Table of Contents 1 User GUJE stessa a a a E E ree 5 1 1 What is WirelesSHART cccccccccsessssssssssessssssssessessssseusesssesessssnsevsssusesevsuers 5 1 2 AwiaTech WirelessHART Products AAA 7 1 3 Whatis in the E 7 1 4 Install Software Eeer Ee 8 tS 29 1h e enee et a ere Mee ee eee eer ee eee ee 15 1 6 Start the ING eeh 16 1 7 Explore and Evaluate eee ee ee eee ne en ee eee eer ee 17 1 8 Device Description gebeten 18 1 9 Menu Description i recscicnentinceteiacenevzecimatecetneus era ionereitinentreieduboeseuteriiet tontecds are 19 110 Trouble SNOGUAG DEE 20 Development Guide eat ass cst nectccrtase deena eects dienes nk eet ea dte nasd center cenenasdcetctedenets 24 2 1 System Architecture eae eee ee Ee 24 22 HOSTAR E 25 2 2 1 DEED eege eege 25 222 UGA EE 26 Reeg EE Eege 27 23 DMC E 29 2 3 1 From Warrior to Sensor Host Data Burst Command 170 0005 30 2 3 2 From Warrior to Sensor Host Da
27. ta Non Burst Command 171 30 2 3 3 From Sensor to Warrior Sensor Data Burst Command oo 30 2 3 4 From Sensor to Warrior Sensor Data Non Burst Command 171 30 2 3 5 From Sensor to Warrior Set Network ID Command 4931 30 2 3 6 From Sensor to Warrior Write Join Key Command 961 ceeee 31 2 4 Putting AINT e TEE 31 2 4 1 Use Awia Net as a data transmission medium Burst eeeeeeeees 31 2 4 2 Use Awia Net as a data transmission medium Non Buret 33 Rev 2 2 3 AwiaTech WirelessHART Evaluation Kit Manual 2 4 3 Use Awia Warrior in a WirelesSHART device saeeeneneneeenrnnrnerrerrerrenne 34 2 4 4 Use Awia Net as a WirelessHART evaluation tool 34 Technical SPOCIICANON EE 35 Glossary OF Terms EE 36 ING OX EE 38 Rev 2 2 4 AwiaTech WirelessHART Evaluation Kit Manual 1 USER GUIDE LI What is WirelessHART WirelessHART Highway Addressable Remote Transducer is an open standard wireless networking technology developed by the HART Communication Foundation for industrial automation It is also the first international wireless standard for industrial automation IEC 62591 WirelessHART uses a time synchronized self organizing and self healing mesh network architecture Its current version HART 7 supports operation in the 2 4 GHz ISM Band on IEEE 802 15 4 standard radios A typical WirelessHART network consists of the following components e One or mor
28. the host bytes to its local data cache for Command 171 it then sends Command 171 response back to the gateway The Command 171 response includes the data from its local data cache for Command 171 Maximum allowed host data size is 72 bytes but can also be 0 bytes 2 3 3 From Sensor to Warrior Sensor Data Burst Command 170 This is an AwiaTech device specific command In this command the sensor sends a series of bytes for bursting The Warrior copies the bytes to its local data cache for Command 170 If the host has subscribed for publishing Command 170 the Awia Warrior will periodically burst Command 170 to the gateway with the data in this local cache 2 3 4 From Sensor to Warrior Sensor Data Non Burst Command 171 This is an AwiaTech device specific command In this command the sensor sends a series of bytes The Awia Warrior copies the bytes to its local data cache for Command 171 The host retrieves the data in this cache by sending Command 171 to the Awia Warrior 2 3 5 From Sensor to Warrior Set Network ID Command 773 This is a standard WirelessHART command This command configures the Awia Warrior to recognize the proper Network ID Upon power on the device starts to capture broadcasts from a network with such ID Rev 2 2 30 AwiaTech WirelessHART Evaluation Kit Manual In this command Cmd Data is the two byte network ID in big endian Command Data Bytes Byte Format Description 0 1 Unsigned 16 Network
29. to Taskbar Pin to Start Menu Remove from this list Properties Or right click the Gateway Icon click Properties click Compatibility Tab and Make sure the software is installed correctly O O Rev 2 2 20 AwiaTech WirelessHART Evaluation Kit Manual Security Details Previous Versions General Shortcut Compatibility F you have problems with this program and it worked correctly on an earlier version of Windows select the compatibility mode that matches that earlier version Help me choose the settings Compatibility mode Windows XP Service Pack 3 Settings Run in 256 colors Run in 640 x 480 screen resolution _ Disable visual themes Disable desktop composition Disable display scaling on high DPI settings Privilege Level Run this program as an administrator Change settings for all users 2 How do I know the WirelessHART Gateway is launched correctly First make sure you see GATEWAY in the Visualizer graph and Vertex table in the GUI of WirelessHART as shown below Rev 2 2 21 AwiaTech WirelessHART Evaluation Kit Manual Gateway Sa File Help Topco S Visualizer Message Vertex Edge Statistics Graph Info Device List ID Nick Names nique ID ype an Period ES n 001b1ef981000002 GATEWAY Or Debug Output Send Be
30. tomatically upon power on 2 4 4 Use Awia Net as a WirelessHART evaluation tool A major purpose of the AwiaTech WirelessHART evaluation kit is for users to explore and learn about WirelessHART A WirelessHART network could be set up right out of the box with the parts in the kit as is described in Section 1 The user can also run the Wi Analys tool from the HART Communication Foundation side by side with this kit to view the WirelessHART network traffic Rev 2 2 34 AwiaTech WirelessHART Evaluation Kit Manual 3 TECHNICAL SPECIFICATION WirelessHART Software e WirelessHART User Guide HCF_LIT 84 e Coexistence Test Plan HCF_LIT 85 e Approved IEEE 802 15 4 Transceivers HCF_LIT 088 e EEE STD 802 15 4 2006 Wireless Medium Access Control MAC and Physical Layer PHY Specifications for Low Rate Wireless Personal Area Networks WPANS 2006 Awia Warrior 220 Hardware Peripherals Software Input HART FSK interface Radio Hardware Chip Electrical amp Mechanical Input Voltage Main Board Dimensions Certifications EMI Standard UART RS485 FSK HART over 4 20mA FSK HART Maintenance Port 1x Awia Warrior 210 IEEE802 15 4 radio module FreeScale MC1322X RF MCU 4 5 12VDC 2 2in W x 3 4in L 5 5cm W x 8 7cm L FCC U S CE WirelessHART conforming registration ready Subject to change without prior notice Rev 2 2 35 AwiaTech WirelessHART Evaluation Kit Manual 4 GLOSSARY OF TERMS A
31. ue new char m_dataValueLength memcpy m_dataValue m_queryBytes 8 m_dataValueLength break Form command message ReadTagList 2 bytes m_queryBytes new char 2 m_queryLength 2 m_queryBytes 1 m_queryBytes 1 index 1 m_apiIndex index Send command int err WORD versionRequired WSADATA wsaData versionRequired MAKEWORD 1 1 err WSAStartup versionRequired amp wsaData SOCKET clientSocket socket AF_INET SOCK_STREAM SOCKADDR_IN clientsock_in clientsock_in sin_addr S_un S_addr inet_addr GW_ADDR clientsock_in sin_family AF_INET clientsock_in sin_port htons GW_PORT connect clientSocket SOCKADDR amp clientsock_in sizeof SOCKADDR send clientSocket message len closesocket clientSocket WSACleanup 28 AwiaTech WirelessHART Evaluation Kit Manual 2 3 Device API As is shown in Figure 4 a sensor can use the serial port COM or virtual COM over USB to communicate with the Awia Warrior stack The serial port is configured as follows e Parity None e DataBit 8 e StopBit 1 e Baudrate 1200 e FlowControl None The message data format is defined in Table Preambles 0x86 LEN SEQ Message CRC Table 4 Command Format The preambles are a fixed sequence of 5 bytes OxFF OxFF OxFF OxFF OxFF to indicate the start of the command Byte 0x86 is used as a delimiter Then it is the LEN field which is 1 b
32. use AwiaTech 10 After the Microsoft Visual C 2008 Redistributable window appear click Next Rev 2 2 12 AwiaTech WirelessHART Evaluation Kit Manual Welcome to Microsoft Visual C 2008 Redistributable Setup Ps This wizard will guide you through the installation process 11 Read the Microsoft Software License Terms If you agree select I have read and accept the license terms and click Install Be sure to carefully read and understand all the rights and restrictions described in the license terms You must accept the license terms before you can install the software MICROSOFT SOFTWARE LICENSE TERMS MICROSOFT VISUAL C 2008 RUNTIME LIBRARIES X86 IA64 AND X64 These license terms are an agreement between Microsoft Corporation or based on where you live one of its affiliates and you Please read them They apply to the software named above which includes the media on which you received it if any The terms also apply to any Microsoft e Press the Page Down key to see more text gt VI have read and accept the license terms Ce Ged Coe 12 Click Finish after Microsoft Visual C 2008 Redistributable setup completes Rev 2 2 13 AwiaTech WirelessHART Evaluation Kit Manual Microsoft Visual C 2008 Redistributable has been successfully installed Itis highly recommended that you download and install the latest service
33. wia Captain AwiaTech s Access Point product Awia Commander AwiaTech s WirelessHART Network Manager which also includes AwiaTech WirelessHART Security Manager AwiaNet a WirelessHART network consisting of AwiaTech s WirelessHART products Awia Vanguard AwiaTech s WirelessHART Gateway Awia Warrior a hardware module running AwiaTech s WirelessHART network stack thus acting as a node to the network It is usually attached to a sensor device Channel RF frequency band used to transmit a modulated signal carrying packets Frame A Data Link Layer packet which contains the header and trailer information required by the physical medium That is Network Layer packets are encapsulated to become frames Frequency channel allocation of the frequency spectrum in a given frequency range Gateway network device containing at least one host interface such as serial or Ethernet acting as ingress or an egress point enabling communication between host applications and field devices Graph routing structure that forms a directed end to end connection between network devices Graph ID identifier used to indicate a specific graph entry Join process by which a network device is authenticated and allowed to participate in the network NOTE A device is considered Joined when it has the network key a network manager session and a normal not join superframe and links Join key security key that is used to start the join process Latency time it takes
34. x or higher Recommended System Requirements e Windows 7 for both 32 bit and 64 bit e 200 MB available in the hard disk e 2GBRAM e An available USB port e CD ROM 2x or higher Then follow the steps below to ensure a successful installation 1 Double click the WirelessHART installation file setup exe on the CD 2 After the following window appears click Next Rev 2 2 8 AwiaTech WirelessHART Evaluation Kit Manual Install noose Shortcut E InstallAnywhere will guide you through the installation of WirelessHART Itis strongly recommended that you quit all programs before continuing with this installation Click the Next button to proceed to the next screen If you want to change something on a previous screen click the Previous button You may cancel this installation at any time by clicking the Cancel button Previous 3 Read the End User License Agreement If you agree select I accept the terms of the License Agreement and click Next Noose Install Set Install ma Mal sp Pl ie Inst Install Installation and Use of WirelessHART Requires Acceptance of the Following License Agreement END USER LICENSE AGREEMENT This End User License Agreement Agreement is hereby entered into between AwiaTech Corporation AwiaTech and the End User you or your The terms and conditions of this Agreement govern your use of AwiaTech s Awia
35. yte long and includes the number of bytes from SEQ to CAC inclusively The 1 byte SEQ field indicates the sequence number of this packet which usually starts from 0 and is incremented by one every time when a packet is sent wrapping around 255 to 0 Message contains the HART command To detect possible data corruption a 2 byte CRC field is added at the end of the packet We use CCITT 16 checksum algorithm to calculate this field http en wikipedia org wiki Cyclic_redundancy_check The CRC calculation is applied from LEN to Message inclusively The format for Message is defined in Table 5 It follows the transport layer and application layer of the WirelessHART standard Please refer to the Network Management Specification HCF_SPEC_085 for more details Transport Byte Device Status Extended Command Byte Count Data Table 5 Message Payload Format Transport Byte is a one byte field Set it to O for command request set it to 0x40 for command response Device Status and Extended Status follow the HART standard Both are set to 0 in normal cases Command is a two byte field in big endian which is followed by the one byte Byte Count of the command Data and then the actual command Data Via the serial connection a receiver sees a sequence of bytes from the sender It will search for the preamble the 5 OxFF bytes to determine the start of a message All the bytes if any from the end of a previous message to the
Download Pdf Manuals
Related Search