Home

WNP - connectBlue

1. 28 Chapter 4 Creating your custom configuration 4 3 Parameters in the configuration files DNS Server dns server DNS Host Name dns hostname WINS Server wins server File example XXX XXX XXX XXX If not specified DNS won t be negotiated during PPP connection establishment A valid DNS host wnp name up to 40 characters long XXX XXX XXX xxx If not specified WINS won t be negotiated during PPP connection establishment Network configuration network cfg Common settings default_gateway 10 0 0 8 dns_server 10 0 0 5 dns_hostname wnp wins_server 10 0 0 5 PPP interface ppp0_use_dhcp no ppp0 local ipaddr 10 0 0 200 20660 remote ipaddr 10 0 0 201 Ethernet interfac eth0 use dhcp no eth0 ipaddr 10 0 0 100 ethO netmask 255 255 0 0 29 4 3 Parameters in the configuration files Chapter 4 Creating your custom configuration Bluetooth This group of configuration parameters is used to configure the Bluetooth inter face in your WNP The configuration file is called bluetooth cfg Below is a list of all the entries in this configuration file Device Name bt_local_name The Device Name specifies a user friendly name for your WNP to help distinguish it from other Bluetooth devices in the vicinity The IP address is always appended to the Bluetooth name Passkey bt_passkey The Passkey is used to assure that only a
2. In parameters Parameter Description Valid values variableName The name of the variable The name of an existing web whose value shall be ex server or CGI variable tracted Return value The value of the selected variable is returned as a string string aspAND valueA valueB Description Returns the result of the bit wise logical operation valueA AND valueB Both the input parameters and the return value are 32 bit signed inte gers specified as decimal numbers for example 1035482 or 124691 In parameters valueA and valueB are the values that the AND operation is per formed on Return value The result of the bit wise logical operation valuea AND valueB string aspOR valueA valueB Description Returns the result of the bit wise logical operation valueA OR val 1468 Both the input parameters and the return value are 32 bit signed integers specified as decimal numbers for example 1035482 or 124691 In parameters valueA and valueB are the values that the OR operation is per formed on Return value The result of the bit wise logical operation valueA OR valueB string aspXOR valueA valueB Description Returns the result of the bit wise logical operation valueA XOR valueB Both the input parameters and the return value are 32 bit signed inte gers specified as decimal numbers for example 1035482 or 124691 In parameters valueA and valueB are the values that the XOR operatio
3. minval The lowest point on the floating point A floating point scale number maxval The highest point on the floating point A floating point scale number floatData The floating point number to be writ minVal max Val ten Return value If successfully executed the string OK is returned Otherwise ER ROR is returned string aspGBlReadl1Timel interfaceDescriptor id string aspGBlReadl2Timel interfaceDescriptor id string aspGBlReadldTimel interfaceDescriptor id Description Reads an integer from GBI holding a time value specified in number of seconds and then converts it to a string in the format hh mm ss which is re turned Parameter Description Valid val ues interfaceDescriptor Selects which bus interface to use 1 id A bus specific identifier specifying Bus specific which object or property to read from Return value If successfully executed the time is returned as a string in the format hh mm ss Otherwise the string ERROR is returned string aspGBIWritel1Time interfaceDescriptor id time string aspGBIWritel2Time interfaceDescriptor id time string aspGBIWritel4Time interfaceDescriptor id time 51 5 2 ASP script functions Chapter 5 Creating your custom web pages Description Converts the string time specified in the format hh mm ss to num ber of seconds and then writes this as an integer to GBI Parameter Description Valid v
4. Slave Function slave where this query shall start to read from The number of Modbus registers that 0 126 shall be read by this query Note Some slaves only support a limited number of registers to be read in one query response operation You must check how many registers your certain device supports Note The Scan List may not contain more than 20 entries Write List mb_write_list The Write List configuration parameter is used to map Modbus registers in your in dustrial equipment onto corresponding Virtual Registers in your WNP It is only possible for your application to write to Virtual Registers that have been mapped in the Write List When data is written to a Virtual Register in your WNP that has been mapped in the Write List a corresponding Modbus Write query will be sent to one of your Modbus devices This query will tell the device to write the data that it receives in the query to one or more of its registers The Write List has the following format Entry Entry2 EntryN where each en try defines one mapping The entries contain a list of variables in the format Slave Function Starting Virtual Register Starting Slave Register Number Of Regis ters Below is a description of what these variables mean Description Valid val ues The Modbus slave that this query shall be sent to 1 255 The Modbus function to use when sending the query 5 6 16 Starting Virtual Register The Virtual Re
5. Dt pan nap service name NAP Service bt pan panu service name PANU Service Remote panu servers bt pan remote peers 00 12 F3 00 9A 05 0012 3009a06 Remote terminal server peers Bluetooth address port number bt ts remote peers 00 12 F3 00 9A 05 2000 0012 3009a06 2001 Field bus configuration bt fieldbus type RS232 bt fieldbus baudrate 9600 bt fieldbus databits 8 bt fieldbus stopbits 1 bt fieldbus parity NONE bt fieldbus flowcontrol CTS RTS Web Server The configuration file is called webserver cfg Default Home Page ws default home page This parameter is used to set the default home page of the web server in Your WNP The default home page may be up to 20 characters long which is the maximum file name length in your WNP Summary of the entries in the web server configuration file Parameter Key name Valid val Default name ues value Default home ws default home page Up to 20 charac configuration html page ters File example Webserver configuration webserver cfg ws default home page configuration html Logger 33 4 3 Parameters in the configuration files Chapter 4 Creating your custom configuration This group of configuration parameters is used to configure the logger in your WNP The configuration file that contains these parameters must be named log ger cfg in your WNP Below is a list of all the entries in this configurati
6. Introduction User Management i s icin eke de en Ged du GENE Ge ERG Ge Ge Ge Gee dese Ed 54 Black Board nadi ies Wadena eel ames 54 string aspBLACKBOARDSavel fileName ee se ee 55 string aspBLACKBOARDSavelfileName ee ee ee ee 55 6 Installing your custom application 56 6 1 Installing file system using FTP esse se se ee ee se ee ee ee ee ee ee ee ee ke ee ee ee 56 6 2 Installing file system using the serial port iese ee ee ee ee 56 7 Firmware upgrade 57 7 1 Serial upgrade 5 Eg ee i De Ge ed Gede ee Pe ke ee ge ge 57 Upgrading firmware via the serial DOF eie ees ee ee ee ee ke ee 57 Reset to factory defaults ie ee ee Re ee ee ke ee ee ke ee ee ke ee 57 Upgrading the file system via the serial OF ees ee ee 57 7 2 Network upgrade eise se ee see ed cease de See ee de ee ie de Ge ee Se ee ee de 58 8 Regulatory information 59 8 1 Declaration of COMfOrMILY aeien ee ee Re ee RR ee Re ee ee TE 59 8 2 FCG AE KA AE AE 60 ANENA Ee Res AE eee teense elec ee ae ee EE SIG 60 Caution 60 8 3 IG Compliance iss EER r eh aati Ae 60 8 4 Safety 61 8 5 RF exposure Statement ee ee ee ER ER Re Re ee ee ee ee Ee Re ee ee ee ee 61 8 6 UL listing information ee ee ee ee Ge Re RR ee E i 61 8 7 Compliance with ROHS directive iese ees ee se ee ee ee ee ee Ee Re Re ee ee ee 61 8 8 Bluetooth Qualification information se ee ee ee RR RR Re ee ee ee 62 9 Additional information 63 9 1 Troubleshooting si i
7. Operating temperature 30 to 85 C Storage temperature 40 to 85 C Humidity 5 90 RH non condensing 67
8. Slave Function 4 3 Parameters in the configuration files In this chapter all the configurable parameters in your WNP are described The configuration parameters are divided into groups where each group of parameters is located in a separate configuration file For each of these configuration files there is a separate subsection below describing its contents If the entry for a parameter is left out of the configuration file it will be given a de fault value The default value for each parameter is specified in the summary at the end of each subsection Modbus This group of configuration parameters is used to configure the Modbus interface in your WNP The configuration file that contains these parameters must be named modbus cfg in your WNP Below is a list of all the entries in this con figuration file The key name is written within parenthesis after the parameter name in the headings below Serial Interface mb_interface The Serial Interface configuration parameter selects which type of serial interface to use RS 232 422 485 Parity mb_parity The Parity configuration parameter sets which type of parity to use Stop Bits mb_stop_bits The Stop Bits configuration parameter sets the number of stop bits to use Baud Rate mb_baud_rate The Baud Rate configuration parameter sets which baud rate to use Query Response Hold Time mb_query_response_hold_time The Query Response Hold Time specifies the time in num
9. an error state If your WNP ends up in an error state where it can t be reached via the Bluetooth or Ethernet interface debug the configuration files and then install the application files again 6 1 Installing file system using FTP This section describes the general steps you need to perform if you want to install your application using an FTP client Since every FTP client has its own user inter face the exact procedure will differ somewhat depending on which one you de cide to use Please turn to the manual for your specific FTP client for information on how a certain step is performed To install your application files using FTP follow the procedure below 1 Use an FTP client on your PC to establish a connection to the FTP server in your WNP For example Windows Explorer or WS_FTP LE or WS_FTP Home 2 Logon with the ip address of your device 10 0 0 100 as default and the user name super and password admin1234 3 Use your FTP client to send your application files to the FTP server in your WNP The FTP server will store the files it receives in the file system of your WNP If a file with the same name already exists in your WNP the new one that is re ceived via FTP will replace it 4 Disconnect your FTP client from the FTP server in your WNP 5 Reset your WNP by unplugging the power cable and then plugging it in again This will activate your new application If all goes well the Status LED of your WNP w
10. Bluetooth Device if you re using Windows XP The default pin code is 0 Chapter 2 Getting started 2 4 Connecting to your WNP via Bluetooth e Join the Personal Area Network and you ll be able to start accessing the network If you re using WindowsXP then enter the menu Join a Personal Area Network and connect to the WNP Note If you use the PANU service instead of the NAP service your WNP will not be able to handle more than one connection In order for your WNP to be a multipoint Network Access Point it shall have the following settings on the Bluetooth configuration page e PAN Role NAP e There should be no connections added However if you would like your WNP to connect to other PANU devices it s possible to add devices manually or by searching and pressing the Add button next to the devices you want to con nect to and check the PAN checkbox Setting up a multipoint Ethernet bridge This is used for transferring data between up to 8 Ethernet connected AP s e Power up the slaves up to 7 devices e Go to the Bluetooth configuration page on all slaves and change PAN role to PANU Save and restart all of them e Power up the device that shall be the center of communication e Go to the Connections page and search e Add the desired slaves and check the corresponding PAN checkboxes e Save reset and wait about 1 minute e All devices shall now have a blue diode In order to test if all devices ha
11. First value is always logged Polled value nr 2 3571 3428 3571 143 lt 200 Hysteresis gt Value not logged Polled value nr 3 3112 3428 3112 316 gt 200 Hysteresis gt Value logged Ring Buffer Number In which ring buffer shall the logged 0 1 value be stored 34 Chapter 4 Creating your custom configuration 4 3 Parameters in the configuration files Bit Number This variable is only applicable if the 0 7 for I1 Bit data type used is I1 Bit I2Bit or I4Bit In this case the logger will read an 1 2 or 4 byte integer from the selected GBI ID 0 31 for I4Bit and if the bit Bit Number in the integer has changed from its previously logged value the new value will be logged 0 15 for I2Bit For other data types this variable is ig nored Log Period logger_log_period This parameter determines how often the entries in the Log List shall be polled for their value The period is specified in number of seconds and it is common for all entries in the Log List Ring Buffer 0 logger_ring_buffer_0 The logger has two ring buffers that are used to store the entries that are logged The Ring Buffer 0 parameter value uses the following format Ring Buffer Size Number of Backup Files The Ring Buffer Size variable specifies the number of entries that the ring buffer can store The Number of Backup Files variable speci fies the number of backup files used for the ring buffer When an entry
12. Modbus interface including serial communication settings e Logger e User Management 4 1 Configuration files The configuration parameters are divided into groups where each group of pa rameters is located in a separate configuration file The name of each configura tion file is predetermined so that your WNP knows what file to look for Below is a summary of the all the configuration files in your WNP Configurable component Configuration file name Bluetooth bluetooth cfg TCP IP Networking network cfg Web server webserver cfg Modbus interface modbus cfg Logger logger cfg User Management umconfig txt The configuration files themselves are plain ASCII text files which can be created and edited in a normal text editor such as Notepad or WordPad for Windows The only exception to this rule is the User Management configuration file umcon fig txt since some of its contents are stored in an encrypted format 20 Chapter 4 Creating your custom configuration 4 2 Modbus configuration File format All configuration files have one or more entries Each entry specifies the value of a separate configurable parameter The syntax of all the entries are of Key Value type The Key uniquely identifies a certain configurable parameter and the Value specifies the value of that parameter Each configurable parameter uses a different format for its Value Therefore
13. Parameters in the con figuration files string aspCMAvailable cfgFileName Description This function checks whether a file exists in the WNP s file system In parameters Parameter Description Valid val ues cfgFileName The name of the file Any string Return value The function returns OK if the file exists string aspCMGetKeyValue cfgFileName key Description This function returns the value of a key in a file The syntax in the file could for example be bt_local_name MyDevice The key is the string to the left of the equal sign and the value is the string to the right Parameter Description Valid val ues cfgFileName T he name of an existing file Use A string aspCMAvailable to check if the file exists key The name of the variable to retrieve A string Return value The function returns the value of the key string aspCMSetKeyValue cfgFileName key value 43 5 2 ASP script functions Chapter 5 Creating your custom web pages Description This function writes a value to a file If the key already exists then the value will be replaced If the key doesn t exist then the key will be added to the file Parameter Description Valid values cfgFileName The name of an existing file Use A string aspCMAvailable to check if the file exists key The name of the variable to retrieve A string Value The value to be written in the file A string Return value The function returns OK if the call
14. WNP by checking the TCP IP networking configuration file Review your TCP IP network settings on the device you use when trying to connect to your WNP 4 My WNP can t communicate with units on the Modbus network to which it is attached Make sure that the RX and TX pins are correctly mounted on the cable at taching your WNP to the Modbus network See the chapter Getting started 63 9 2 Guidelines for efficient and safe use Chapter 9 Additional information ii Make sure your Modbus configuration is correct by checking the Modbus configuration file see the chapter Creating your custom configuration iii Make sure the Modbus unit you are trying to communicate with accepts the Modbus query packet size that your WNP sends to it Some Modbus units only support small Modbus packet sizes 5 The status LED of my WNP is red and can t access it A serious error has been encountered Try the following in order i Restart your WNP ii If the color of the status LED is still red check the format and contents of your configuration files If you find any error fix them and then install the corrected configuration files using the Flash Loader utility as described in the section Installing your custom application 9 2 Guidelines for efficient and safe use Important Read this information before using your WNP For any exceptions due to national requirements or limitations when using your WNP please vis
15. band Please insure that all medical devices used in proximity to this device meet appropriate susceptibility specifications for this type of RF energy Potentially Explosive Atmospheres Do not turn on or off your electronic device when in any area with potentially ex plosive atmosphere It is rare but your electronic device could generate sparks Sparks in such areas could cause an explosion or fire resulting in bodily injury or even death Areas with a potentially explosive atmosphere are often but not al ways clearly marked They include fuelling areas such as petrol station below deck on boats fuel or chemical transfer or storage facilities and areas where the air contains chemicals or particles such as grain dust or metal powders Power Supply e Only connect your power supply to designated power sources as marked on the product e Make sure all cords and cables are positioned so that they will not be stepped on tripped over or otherwise subject to damage or stress e To reduce risk of electric shock unplug the unit from any power source before attempting to clean it 9 3 Important information Important Changes or modifications not expressly approved by connectBlue AB will void the user s authority to operate the equipment 9 4 Technical specification Bluetooth Interface Supported Bluetooth Profiles General Access Profile Serial Port Profile LAN Access Profile PAN Profile Bluetooth radio Up to 17 dBm power
16. easy to learn and use Much of this is due to the fact that it uses the well known standard techniques ASP and JavaScript while many other embedded web servers rely on proprietary solutions to create dynamic content For a description of which parts of ASP and JavaScript are supported in the GoA head web server please visit http Awww goahead com Follow the links that di rect you to the GoAhead webserver There you ll also find an online documenta tion and a functionality overview 5 1 ASP scripts To insert ASP scripts in a web page the script code must be encapsulated between the special tags lt and gt A web page containing script code must also have an asp extension in the filename so that the web server can distinguish it from normal HTML pages When the web server receives a HTTP request for an ASP web page it will get the web page from the file system and then scan through it looking for script sections Whenever the web server detects a script section it will cut this section out of the web page and send it to the ASP script motor that evaluates the script code The evaluation of the script code can involve calls to the pre defined ASP functions in your WNP that are used for example to access the GBI interface If the script code returns any resulting HTML code this will be inserted into the web page in the place where the script code originally was When all script sections in the ASP web page have been pr
17. interface to any kind of industry standard bus interface such as Modbus or Profibus The idea behind GBI is to pro vide a common way of accessing all bus types without having to worry about their proprietary techniques and protocols 21 4 2 Modbus configuration Chapter 4 Creating your custom configuration When calling the GBI functions you always use an Interface Descriptor and an ld as in parameters The Interface Descriptor selects which kind of bus interface to use and the ld is an identifier for a specific property or object on a device attached to the selected bus interface How the mapping between an Id and a device prop erty such as a Modbus register is done varies and it is specific for each kind of bus interface To find out how the mapping is done for the Modbus interface see the section Mapping Modbus to GBI Note Currently the WNP support the following interfaces Modbus MMS and BMS However with the use of the GBI concept the WNP is well prepared if sup port for other industry standard bus interfaces is to be added in the future Mapping Modbus to GBI The natural way to access a Modbus device is to read from and write to a set of 16 bit registers In order make these registers accessible from the GBI interface see section The General Bus Interface it is necessary to map these Modbus registers to a set of GBI Id s This mapping is done in the configuration file for the Modbus interface see
18. output Range line of sight Up to 150 meters Bluetooth Qualification The product is Bluetooth qualified according to the Bluetooth 2 0 specification Serial Interface Serial connector Standard male RS 232 422 485 9 pin DSUB connector Supported bit rates 300 460 800 bits second Flow control for RS 232 CTS RTS or none Flow control for RS 422 485 None 65 9 4 Technical specification Chapter 9 Additional information Power current consumption Power connector Power connector for industrial use Power supply 9 30 V DC Power consumption TBD File system The file system in your WNP has 1 MB available for data storage Filenames may consist of up to 20 characters Directories are supported Configuration Files A set of configuration files stored in the file system of your WNP are used to con figure e Modbus e TCP IP Networking e Bluetooth e Web server e Logger e Security User Management Compatibility The FTP server in your WNP has been tested successfully with the following FTP cli ents in both passive and active mode e Windows 2000 DOS FTP client e Windows 2000 Windows Explorer e Windows XP Windows Explorer e WS_FTP LE e FIP Commander 7 33 The Flash Loader utility on your WNP product CD is compatible with the follow ing platforms e Windows 2000 e Windows ME e Windows XP Environmental IP 20 66 Chapter 9 Additional information 9 4 Technical specification
19. section Parameters in the configuration files subsection Mod bus In the case with Modbus your WNP stores all the data in a Virtual Register Area see picture below The register numbers in this Virtual Register Area are used as the Id parameter when calling GBI functions that access the Modbus interface Periodically the values of the Modbus registers of the attached industrial equip ment will be copied to the Virtual Register Area according to an entry in the Mod bus configuration file called the Scan List see section Parameters in the configu ration files subsection Modbus When your WNP application wants to read a value from a Modbus device via GBI it will in fact read from a Virtual Register and not from a device directly Similarly when writing data to a Virtual Register the data will propagate to a cor responding Modbus register on the industrial equipment that is attached to your WNP if this Virtual Register has been mapped in the Write List entry of the Mod bus configuration see section Parameters in the configuration files subsection Modbus RS 232 422 485 Mapping between Virtual Register Area and Modbus register Area is done in Scan List and Write List Virtual Register 0 Modbus Register xxx d eq EEEa Doo Virtual Register n lt gt 22 Chapter 4 Creating your custom configuration 4 3 Parameters in the configuration files Variable
20. succeeded string aspCMGetParam componentid parame terld Description This function returns the value of a certain setting for a selected com ponent Parameter Description Valid values componentld Selects which component to ac See table below cess parameterld Specifies which parameter from See table below the selected component to get componentid selects which component to access see the table below Component Component ID Notes Name Network 1 Smtp 2 Currently not acces sible Logger 3 Currently not acces sible Modbus 4 Currently not acces sible FTP 5 Currently not acces sible Web server 6 Bluetooth 7 parameterTda specifies which parameter from the selected component to get see the tables below 44 Chapter 5 Creating your custom web pages 5 2 ASP script functions Network Parameter Name Parameter ID Loopback interface IP address 1 Loopback interface net mask 2 Ethernet interface IP address 3 Ethernet interface subnet mask 4 Ethernet interface broadcast address 5 Ethernet interface MAC hardware address 6 PPP interface local IP address 7 PPP interface remote IP address 8 PPP interface subnet mask 9 Default gateway IP address 10 DNS server IP address 11 Web server Parameter Name Parameter ID Default home page 1 Bluetooth Parameter Name Parameter ID Bluetooth local name 1 Bluetooth passkey 2 Return value The value of the selected parameter is returned as a string Example aspCMGe
21. this format is always specified along with the description of each parameter see the section Parameters in the configuration files It is possible to add comments to your configuration files in order to ease the un derstanding of its content A line containing a comment starts with a hash sign and ends with a line feed Note It is very important that you follow the exact format specifications for each file when you create a new configuration Otherwise your WNP might have prob lems interpreting it which can result in a faulty or non expected behavior Example showing the format of a configuration file connectBlue AB configuration file ExampleKeyl Valuel ExampleKey2 Value2 4 2 Modbus configuration Before your application can access the industrial equipment that your WNP is at tached to the Modbus interface has to be configured A part of this configuration consists of making the Modbus registers in the indus trial devices visible to your application s web pages When your application wants to access the industrial equipment that is attached to your WNP it calls a set of pre defined functions in a bus interface abstraction layer called the General Bus In terface GBI The General Bus Interface is described in the following section Your application s web pages General Bus Interface GBI Bus eres merce eise The General Bus Interface GBI The General Bus Interface GBI is a generalized
22. INDUSTRIAL BLUETOOTHTM 3 Bluetooth Wireless Network Platform User Manual 4 4 connectBlue Wireless Network Platform User Manual 4 4 Copyright 2010 connectBlue AB The contents of this document can be changed by connectBlue AB without prior notice and do not constitute any binding undertakings from connectBlue AB con nectBlue AB is not responsible under any circumstances for direct indirect unex pected damage or consequent damage that is caused by this document All rights reserved Release 1002 Document version 4 4 Document number cBProduct 0111 04 Printed in Sweden Trademarks Registered trademarks from other companies are Bluetooth is a trademark owned by the Bluetooth SIG Inc Microsoft Windows Windows NT Windows 2000 TM Windows CE Windows ME TM are registered trademarks from Micro soft Corporation Contents 1 Introduction 9 1 1 1 What is Bluetooth wireless technology ee ee ee ee ee ee 9 2 Technical OVErVICW 0 2 2 ee ee ee AR ee AR ee AR ee AR ee ee ee ee ee 9 2 Getting started 11 2 1 Mounting instructions ee ee ee ee A Re ee RR ee ee Re ee ee ee ee ee 11 2 2 Electrical InterfaceS iese ee se ee ee ee ee ee Ee Re Re ee ee ee ee ee Re Re ee ee ee 11 RS 232 422 485 serial connector 9 pin DSUB type 11 Powef GOnneEtO EE EER Ee RE ER ee EER ge EER LAE GER EE 13 2 3 AUS LEDS EE ER EE EES E Ee ee ee cea a 13 System status LED is n ee dar
23. NP receives 10BASE T link pulses Normally this means that your WNP has been correctly attached to an active Ethernet LAN The LAN Link Activity is a green light which will be shown whenever your WNP sends or receives an Ethernet frame The LED will remain green until there has been no activity for 6 ms Serial Activity LED This led is placed opposite to the System Status LED It will be green whenever the UART receives data on the serial line and yellow when the WNP sends data on the UART 2 4 Connecting to your WNP via Bluetooth 2 4 Connecting to your WNP via Bluetooth Chapter 2 Getting started Your WNP supports the LAN Access profile PAN profile and SPP profile These can be used for accessing the Ethernet network the serial interface or Web Server in the WNP See below for more information how to establish different connec tions Setting up a Bluetooth Ethernet bridge It is possible to establish an Ethernet bridge between two WNPs The WNPs will then work as an Ethernet cable replacement Go to the unit s web page and press the Bluetooth link In order to go to your unit s web page you shall enter the unit s ipaddress e g 10 0 0 100 in Inter net Explorer Normally DHCP is activated in your WNP and in order to be sure that the device gets Its static ipaddress you shall start the WNP without the Ethernet cable connected to the network Set PAN role to PANU on the Bluetooth page and save Press the Con
24. a standard web based user interface to industrial ma chines It s then possible to use a web browser to view the machine s user inter face it s easy to control the machine or configure it from standard devices such as laptops and PDAs without the need for development and installation of proprie tary client side software 1 1 What is Bluetooth wireless technol ogy Bluetooth makes it possible to connect any compatible portable and stationary communications device without using cables The technology uses a radio link that offers fast and reliable transmission of voice and data information Due to the na ture of radio technology there is no need for a free line of sight between devices that wish to communicate with each other The Bluetooth wireless technology uses a globally available frequency range intended to ensure communication compati bility worldwide Bluetooth is very often standard in for example mobile phones laptops and handheld computers 1 2 Technical overview The WNP works as a Wireless Access Point with the PAN and LAN profile It sup ports up to 7 Bluetooth connections When the WNP works as an Ethernet Port Adapter it establishes a connection to one or several other WNPs In this scenario the WNP forwards all data from the Ethernet cable to all connected peers A switch will filter unwanted mac addresses The WNP can work as a Serial Port Adapter because it always has an SPP service enabled When another device
25. al maxVal nrDecimals ee ee ee ee RR Re Ee ee ee ee ee 50 string aspGBlReadldScale interfaceDescriptor id minVal maxVal nrDecimals ee ee ER RR Re Ee ee ee ee ee 50 string asoGBIWritel1Scale interfaceDescriptor id minVal maxVal floatData ee se ee ee ER RR ee ee ee ee ee 50 string aspGBlWritel2Scale interfaceDescriptor id minVal maxVal floatData ee se ee ee ee AR ee ee ee ee 50 string aspGBlWriteldScale interfaceDescriptor id minVal maxVal floatData ee se ee ee Ee ee RR ee ee ee ee ee ee 50 string aspGBlReadl1Timel interfaceDescriptor id ese 51 string aspGBlReadl2Timel interfaceDescriptor id ese 51 string aspGBlReadldTimel interfaceDescriptor id 51 string aspGBIWritel1 Time interfaceDescriptor id time 51 string aspGBIWritel2Time interfaceDescriptor id time 51 string aspGBIWritel4 Time interfaceDescriptor id time 51 Real Time Clock ER ER RE EE AG N heen ed Ge EE Ge EE 52 string ASPRTCGetTiMe ee ee ek ee Ge Re ee ee ee ek Ke ee 52 string aspRTCSetTimel time ie ee ek ee ee ee ek ke ee 52 string aspRTCGetDate ee ee ee e ee ee Re ee ee ee 53 string aspRTCSetDate date ee ee ek ee Re ee ee ke ee 53 Logger 53 string aspDumpLogToFile filename ringBufferNumber 53
26. al ues interfaceDescriptor Selects which bus interface to use 1 id A bus specific identifier specifying Bus specific which object or property to write to time A string holding the time to be written hh mm ss Return value If successfully executed the string OK is returned Otherwise ER ROR is returned Remarks Please note that the resulting integer that is to be written to GBI must fit within the boundaries of the selected integer size 11 12 or 14 These boundaries are presented below Integer size Boundaries 11 128 127 12 32768 32767 14 2147483648 2147483647 Real Time Clock This chapter describes the functions used to access the Real Time Clock RTC in your WNP Using these functions you can set and get the date and time of your WNP string aspRTCGetTime Description Returns the current time of the RTC in your WNP as a string with the format hh mm ss In parameters This function doesn t have any in parameter Return value If successfully executed this function returns the current time of the RTC in your WNP as a string with the format hh mm ss If the power to the RTC has been lost the string Power lost is returned If a general error in the RTC has been detected ERROR is returned string aspRTCSetTime time Description Sets the time of the RTC in your WNP according to the time string specified in the format hh mm ss Parameter Descri
27. ame bt_pan_nap_service_name This parameter can be set if the default name of the service shall be changed PAN PANU service name bt_pan_panu_service_name This parameter can be set if the default name of the service shall be changed PAN remote peers bt_pan_remote_peers This parameter shall be set if an Ethernet bridge shall be setup between this device and one or several PANU devices Make sure that this device is configured as a NAP device When this device starts it will try to connect to all the peers specified in this list Terminal server remote peers bt_ts_remote_peers This parameter shall be set if terminal server is required Up to seven remote peers can be configured 30 Chapter 4 Creating your custom configuration 4 3 Parameters in the configuration files Field bus configuration bt fieldbus type bt fieldbus baudrate bt fieldbus databits bt fieldbus stopbits bt fieldbus parity bt fieldbus flowcontrol These parameters can be set to change the default values of the field bus The val ues will be discarded if the WNP is set up to use the field bus for other communi Cation such as modbus or bms 31 4 3 Parameters in the configuration files Chapter 4 Creating your custom configuration Summary of the entries in the Bluetooth configuration file Parameter name Local Name Passkey Security Mode LAN Access Service Name PAN role PAN NAP Ser vice Name PAN PANU Ser
28. ber 10 millisecond ticks that your WNP shall wait after receiving a response before it may send the next query This parameter is only applicable when RS 422 485 is used Scan List mb_scan_list The Scan List configuration parameter is used to map Modbus registers in your in dustrial equipment onto corresponding Virtual Registers in your WNP Periodically your WNP will poll these Modbus registers for their current value by sending Read queries to your Modbus devices The data that is read will then be copied to the corresponding Virtual Register in your WNP The Scan List has the following format Entry Entry2 EntryN where each en try defines one mapping The entries contain a list of variables in the format Slave Function Starting Virtual Register Scan Period Starting Slave Regis ter Number Of Registers Below is a description of what these variables mean Description Valid Value The Modbus slave that this query shall 1 255 be sent to The Modbus function to use when 1 2 3 4 sending the query Starting Virtual Register The Virtual Register where your WNP 0 1024 shall start to store the data retrieved by 23 4 3 Parameters in the configuration files Chapter 4 Creating your custom configuration this guery Scan Period The number of seconds between each ISS refresh of the Virtual Registers Starting Slave Register The Modbus register address in the 0 65535 Number of Registers Variable
29. ch bus inter 1 face to use id A bus specific identifier Bus specific specifying which object or property to write to integerData The value of the integer 128 127 for integer size 1 to be written 32768 32767 for integer size 2 2147483648 2147483647 for integer size 14 Return value If successfully executed the string OK is returned Otherwise ER ROR is returned string aspGBlReadl1Dec interfaceDescriptor id nrDecimals string aspGBlReadl2Dec interfaceDescriptor id nrDecimals string aspGBIReadl4Dec interfaceDescriptor id nrDecimals Description Reads an integer from GBI converts it to a floating point number di vides the float by 10 A nrDecimals and returns the result Parameter Description Valid val ues interfaceDescriptor Selects which bus interface to use 1 id A bus specific identifier specifying Bus specific which object or property to read from nrDecimals The number of decimals to use 10 10 48 Chapter 5 Creating your custom web pages 5 2 ASP script functions Return value If successfully executed the resulting floating point number is re turned as a string Otherwise the string ERROR is returned Example Integer data read from GBI 38423 nrDecimals 3 gt The floating point number 38 423 is returned string aspGBIWritel1Dec interfaceDescriptor id floatData nrDecimals string aspGBIWritel2Dec interfaceDescriptor id fl
30. ch the visual design of your own custom application It is not recommended that you manually alter the contents of the User Manage ment configuration file named umconfig txt One of the reasons for this is that the password of a user is stored in an encrypted format in order to keep it secret from the other users on your WNP Hence it must be read and written by the software in your WNP which is able to encrypt and decrypt the passwords stored in the User Management configuration file 36 Chapter 5 Creating your custom web pages 5 1 ASP scripts Chapter 5 Creating your custom web pages The web pages stored in your WNP form the actual user interface to your indus trial equipment These web pages have the ability to include data such as a tem perature or speed measurement that has been collected from the devices in the network to which your WNP is attached It is also possible to set parameters in the devices from the web interface In order the manage those tasks the web server in side the WNP contains functionality to handle dynamic behavior on web pages The web server comes from a company called GoAhead It s especially created to run in embedded systems with limited CPU and memory resources This means that it is designed to be very efficient and sparse in its memory requirements Still in contrast to a lot of other embedded web servers the GoAhead web server has a framework to create dynamic content that is very
31. connects to this service the WNP will forward all the data from the Bluetooth connection to the physical serial port There is also a scenario where the WNP act as a Terminal Server In this case the WNP waits for a TCP connection from Ethernet and starts a Bluetooth connection when someone connects to the preconfigured TCP port All data that is sent on the TCP connection is sent to the Bluetooth SPP connection In the picture below there s an illustration of a system setup where the WNP is working as a Web Enabler and is attached via a serial cable to a machine To be able to present this information the WNP incorporates a small web server together with a set of web pages that dynamically can include the data that has 1 2 Technical overview Chapter 1 Introduction been collected from the industrial equipment After creating a connection from a Bluetooth enabled PDA or Laptop to the WNP these web pages can easily be viewed in a standard web browser Using this web based technique it s also possi ble to send information such as new settings to the machine by having the user fill in a HTML form in a web page and submitting it to the web server in the WNP The web server will then process the submitted information and convert it into cor responding fieldbus operations Ethernet LAN cable Fieldbus cable To help you gain a deeper insight of how the technique works the picture below describes the inner workings of the devices i
32. ct a new Bluetooth device to your WNP you will be asked to enter a Passkey To be granted access to your WNP the Passkey you enter must match the one that is stored in your WNP The Passkey in your WNP is configurable see Creating your custom configuration and in the pre installed application it is set to 0 2 Web security Using the User Management framework in your WNP it is possi ble to specify the access level for each user and what access level that is required to be granted access to a specific file The username and password is verified via the standard HTTP Basic Authentication procedure when a protected web page Is requested The User Management framework can easily be administered via a web 2 7 The security framework in your WNP Chapter 2 Getting started based user interface such as the one that is a part of the pre installed application in your WNP see the User Management section of the chapter called The pre installed application In the security configuration for the pre installed application there is a default a default user User ID admin Password admin Access Level 4 and a set of access limits that are placed on the files that handle the user man agement functionality 3 FTP security To access the FTP server the user must log in with the highest se curity level which is 5 If this requirement is fulfilled the user is granted full access to all the files in the file system of y
33. e oriented Do the following to write two 4 byte integers result asoGBIWritel4 6 0 thelnt result aspGBlWriteld 6 4 theOtherint It s possible to use Black Board to convert an int to a float result aspGBIWritel4 6 0 value value aspGBlReadF4 6 0 It s also possible to save the contents to and from flash aspBLACKBOARDSave settings txt aspBLACKBOARDLoad settings txt See descriptions below string aspBLACKBOARDSave fileName Description Used for saving BlackBoard s RAM buffer to flash In parameters filename is the name of the file e g mySettings txt Return value Return value If successfully executed the string OK is returned Otherwise ERROR is returned string aspBLACKBOARDSave fileName Description Used for loading BlackBoard s RAM buffer from flash In parameters filename is the name of the file e g mySettings txt Return value If successfully executed the string OK is returned Otherwise ER ROR is returned 55 6 1 Installing file system using FTP Chapter 6 Installing your custom application Chapter 6 Installing your custom application When you have created your application you have to install the configuration files and web pages that it consists of in your WNP Before you install a new application please take some time to check your configu ration files once again since an invalid configuration file might put your WNP in
34. ectrical and electronic equipment directive and com plies with the directive 61 8 8 Bluetooth Oualification information Chapter 8 Regulatory information 8 8 Bluetooth Oualification information Table 1 Bluetooth Qualification information Module Bluetooth specifica Bluetooth identi Qualification date tion fier cB 3013 01 cB 3021 2 0 BO3088 2006 04 24 01 cB 3022 01 cB 3023 01 cB 3024 01 cB 3025 01 and cB 3026 01 The following Bluetooth profiles are supported covered functionality Generic Access Profile GAP Serial Port Profile SPP Personal Area Networking Profile PAN LAN Access Profile When creating end products based on the Bluetooth Web Enabler the following applies The end product does not have to be re qualified The end product or the end product documentation based on o CB 3013 01 cB 3021 01 cB 3022 01 cB 3023 01 cB 3024 01 cB 3025 01 and cB 3026 01 products shall make the following informa tion available This product contains a Bluetooth qualified product QPLN BO3088 The Bluetooth Trademark may be placed on the end product requires Blue tooth SIG membership for more information see www bluetooth org The Bluetooth Trademark may be used in material related to the end product requires Bluetooth SIG membership for more information see www bluetooth org For more information please contact connectBlue 62 Chapter 9 Additional informati
35. er device via a Bluetooth link 6 Your WNP has detected a recoverable error that must be attended to 7 Your WNP has detected an irrecoverable error string aspResetSystem timeout Description This function will trigger a system reset after timeout milliseconds The reset operation is asynchronous so the web server will continue its operation after this function has been called until the system reset actually is performed This makes it possible to set a timeout that long enough for the web server to be able to return the contents of the web page that triggered the reset operation to the client 42 Chapter 5 Creating your custom web pages 5 2 ASP script functions In parameters Parameter Description Valid values timeout The number of milliseconds to wait before 0 30000 the web server triggers the reset Return value This function doesn t have a return value Configuration Manager The Configuration Manager is a part of your WNP that handles the configuration of the different components that your WNP is built up of such as Bluetooth and the web server Using the ASP function that accesses the Configuration Manager you can retrieve the settings for these components in order to for example include them in a status web page Note that with asoCMSetKeyValue and aspCMGet KeyValues it is possible to configure all parameters in the configuration files see chapter Creating your custom configuration section
36. er ee n DRS See ed ge ei 13 LAN Valid Link and LAN Link Activity LED iese ee ee ee ee ee 13 Serial Activity LED oo arrier VS ee aint Ee ieee 13 2 4 Connecting to your WNP via Bluetooth ees ees ee ee ee ee ee ke ee 13 Setting up a Bluetooth Ethernet bridge ee ee ee ee ee ee 14 Setting up a multipoint Network Access POINE ese ee see ee ee 14 Setting up a multipoint Ethernet bridge esse ee ee ee ee ee 15 Connecting using the LAN Access profile se ee ek ee 16 Connecting to the WNP as a Serial Port Adapter esse 16 Reset to factory defaults occ ee ee ee ee Re ee Ge Re ee ee ke ee ee 16 2 5 Accessing web pages in your WNP via Bluetooth ese ee 16 2 6 Accessing web pages in your WNP via Ethernet 17 2 7 The security framework in your WNP ees esse ee ee ee ee ee ee ee ee 17 3 How to create your custom WNP application 19 3 1 Creating you own custom application ee ee ee ee ee ke ee 19 4 Creating your custom configuration 20 4 1 Configuration fles EE tere n Ee Re ESE EE Ee WE agate cede 20 File TORIMAL s a EE Soden EE Ee Le DE ee Re de ve sata 21 4 2 Modbus configurator mrin annsa ad ee Re ee ek Ke ee ee ee ee ke ee ee 21 The General Bus Interface GBI ee ee ee ee RA ee 21 Mapping Modbus to GBI ee ee 22 4 3 Parameters in the configuration files se ee ee ee RR ee ee 23 Modbus 23 Network26 SIUE EE IEAA EE ER EE EA 30 Logger 33 Use
37. eral Bus Interface GBI ee ee ek ee ek ee ek Ke ee 45 string aspGBlReadBit interfaceDescriptor id ee ee 46 string aspGBIWriteBit interfaceDescriptor id dataBit 46 string aspGBlReadStr interfaceDescriptor id strLen 46 string aspGBlWriteStr interfaceDescriptor id textStr 47 string aspGBlReadl1 interfaceDescriptor id ee ee ee 47 string aspGBlReadl2 interfaceDescriptor id ee ee ee 47 string aspGBlReadl4 interfaceDescriptor id ee ee ee 47 string aspGBIWritel1 interfaceDescriptor id integerData 48 string aspGBIWritel2 interfaceDescriptor id integerData 48 string aspGBIWritel4 interfaceDescriptor id integerData 48 string asoGBIReadI1Dec interfaceDescriptor id nrDecimals 48 string aspGBlReadl2Dec interfaceDescriptor id nrDecimals 48 string asoGBIReadl4Dec interfaceDescriptor id nrDecimals 48 string aspGBIWritel1 Dec interfaceDescriptor id floatData NEDOCIMAIS ss Ese AREE EE REED 49 string asoGBIWritel2Dec interfaceDescriptor id floatData MEDSCIMAIS si EE Ee pts ease adder ese ER RD Ee Ges 49 string asoGBIWritel4Dec interfaceDescriptor id floatData MTDSCIMAIS EE ESE EE ER Ee Ee SE ee ER ee ee Ee 49 string aspGBlReadl1Scale interfaceDescriptor id minVal maxVal nrDecimals ee ee ER RR Re Ee ee ee ee 50 string aspGBlReadl2Scale interfaceDescriptor id minV
38. ew speed value is sent along with the request as a CGI variable with the name new_speed 3 When the web server receives the request for set_new_speed asp it detects that a CGI variable is sent along with the request This variable new speed and its value is extracted by the web server and made available to the script code in the web page that is requested We use this to call a script function that passes along the variable value to a fictive device Here s what is might look like set new speed asp lt HTML gt lt BODY gt lt aspGBIWriteI2 1 14 new speed S gt The new speed was successfully set to lt write new _ speed gt lt BODY gt lt HTML gt When the web server processes this web page it will call the script function aspGBlWritel2 with the new speed variable as input parameter This function will make the WNP send a message to a certain device telling it to set its speed pa rameter to the value of new_speed The second script section 39 5 2 ASP script functions Chapter 5 Creating your custom web pages amp write new speed is used to include the value of new speed in the web page Finally the processed web page will be returned to the client s web browser in forming that the operation was successful Here s what it would look like if the user had entered 1200 as the new speed value lt HTML gt lt BODY gt The
39. ger from GBI and maps scales it to a floating point num ber which is returned The floating point number will be within the range min Val to maxVal In parameters Parameter Description Valid val ues interfaceDescriptor Selects which bus interface to use 1 id A bus specific identifier specifying Bus specific which object or property to read from minval The lowest point on the floating point A floating point scale number maxval The highest point on the floating point A floating point scale number decimalPrecision The number of decimals to be used for 10 10 the return value Return value If successfully executed the resulting floating point number is re turned as a string Otherwise the string ERROR is returned string aspGBIWritel1Scale interfaceDescriptor id minVal maxVal floatData string aspGBIWritel2Scale interfaceDescriptor id minVal maxVal floatData string aspGBIWritel4Scale interfaceDescriptor id minVal maxVal floatData Description Maps scales the floating point number stored in floatData to an in teger The float number must be within the range minval to maxval Parameter Description Valid values interfaceDescriptor Selects which bus interface to use 1 50 Chapter 5 Creating your custom web pages 5 2 ASP script functions id A bus specific identifier specifying Bus specific which object or property to write to
40. gister where your WNP shall start to write 0 1024 the data that will be sent to the slave Starting Slave Register The starting Modbus register address in the slave where 0 65535 Number of Registers the data that it receives shall be written The maximum number of registers that can be sent to the 0 126 slave when performing a write to the Starting Virtual Reg ister in this entry Note The actual number of registers sent will be determined when a GBI write function is called however it can never exceed the Number of Regis ters specified in this entry 24 Chapter 4 Creating your custom configuration 4 3 Parameters in the configuration files Note The Write List may not contain more than 20 entries Summary of the entries in the modbus cfg configuration file Parameter Key name Valid values Default name value Serial Interface mb interface RS232 RS422 RS485 RS232 Parity mb_parity ODD EVEN NONE ODD Stop bits mb stop bits les 1 Baud rate mb baud rate 110 9600 300 1200 2400 4800 9600 19200 38400 757600 115200 Ouery Response mb guery response hold time 0 100 0 Hold Time Scan List mb scan list Entry l Entry 2 EntryN None Where each Entry Slave Function Starting Virtual Regis ter Scan Period Starting Slave Register Number of Registers Write List mb write list Entry l Ent
41. he PPP Local IP Address parameter specifies the IP address for the local side of the PPP interface in your WNP By this we mean the IP address that the PPP interface in your WNP will be given when a client connects via PPP over Bluetooth PPP Remote IP Address ppp0_remote_ipaddr The PPP Remote IP Address parameter specifies the IP address for the remote side of the PPP interface in your WNP By this we mean the IP address that a client will be given when connecting to your WNP via PPP over Bluetooth Ethernet use DHCP ethO_use_dhcp The Ethernet use DHCP parameter specifies whether or not DHCP is to be used to acquire the settings for the Ethernet interface Ethernet IP Address eth0 ipaddr The Ethernet P Address parameter specifies the IP address of the Ethernet inter face in your WNP Ethernet Subnet Mask eth0 netmask 27 4 3 Parameters in the configuration files Chapter 4 Creating your custom configuration The Fthernet Subnet Mask parameter specifies the subnet mask for the Ethernet interface in your WNP Default Gateway default_gateway The Default Gateway parameter specifies the IP address of a Default Gateway to be used by clients connecting via PPP This typically is the IP address of a Router on your Ethernet LAN The IP address is sent to the clients during the PPP connection establishment procedure DNS Server dns server The DNS Server parameter specifies the IP address of an external DNS server t
42. he unit again e When it has stopped blinking the factory defaults will be used 2 5 Accessing web pages in your WNP via Bluetooth Before you can access the web pages in your WNP you will have to connect to it as described in the section Connecting to your WNP via Bluetooth Once the connection is established bring up a web browser on your terminal type in the address of the web page you want to view in the address field and press lt ENTER gt The selected web page will now be downloaded from your WNP and displayed in Chapter 2 Getting started 2 6 Accessing web pages in your WNP via Ethernet your web browser You can for example write 10 0 0 100 or 10 0 0 100 sysoview asp If you don t know the IP address of your WNP and you re using PDA with the Lan Access profile you can enter http Awnp in the address field and press lt ENTER gt to get to the default web page This is possible since your WNP contains a local DNS server that is able to resolve the host name wnp into the IP address of your WNP For more information on how this works see the chapter Creating your custom configuration section Parameters in the configuration files under Network 2 6 Accessing web pages in your WNP via Ethernet If the WNP is connected to an Ethernet LAN you can access the web pages in your WNP from computers attached to the same LAN without performing any special connection procedure first J
43. hen you can just flash it again with the correct firmware Reset to factory defaults If your configuration sets the device in a faulty state meaning that you can t ac cess it or it just doesn t seems to start it s possible to reset the configuration files to factory defaults To do this you must use version 4 3 and above and you must be running RS232 on the DSUB If you have upgraded from an earlier version it has to have been with the imageAndFileSystem bin 1 Power off your device 2 Use an echo plug or shortcut RX with TX on the DSUB 3 Power on your device again and wait for it to start 4 If it fails to start you probably need to re flash your device with imageAnd FileSystem bin as described above Upgrading the file system via the serial port 57 7 2 Network upgrade Chapter 7 Firmware upgrade The WNP contains a number of configuration files and web pages which control the behavior of the WNP If the configuration files becomes faulty or if the WNP for some reason doesn t start it might be necessary to reflash all files in the filesys tem Do the same as described for upgrading firmware above but instead of using the firmware release you shall use a bin file which contains both the firmware and the file system Do the following to retrieve such a file 1 Use an FTP client on your PC to establish a connection to the FTP server in your WNP For example WS_FTP LE WS_FTP Home or the Windows na
44. igured in the WNP Open the virtual COM port to estab lish the Bluetooth connection e Make sure that your other serial device is connectable and has the same Blue tooth passkey com0com and com2tcp are licensed under GPL and could be used on the PC to install a virtual COM port For more information and guidance go to http com0com sourceforge net Connecting using the LAN Access profile Search for Bluetooth devices in the neighborhood Select your WNP device and perform pairing if necessary Connect to the LAN Access Profile The TCP IP con nection will then automatically be established If you use a PDA you can enter wnp in the address field in the Internet Explorer and you will access the web server in the WNP Connecting to the WNP as a Serial Port Adapter The WNP can act as a Serial Port Adapter which means that everything that is sent on the serial Bluetooth connection is sent to the physical serial port on the WNP and vice versa Configure the device that shall connect to the WNP If it s a PC or PDA you open the Bluetooth manager and search for Bluetooth devices in the neighborhood Se lect your WNP device perform pairing if necessary and connect to the SPP service The WNP will now act as a Serial Port Adapter Reset to factory defaults This will reset the configuration to factory defaults This is only available for WNPs with RS 232 e Turn off the WNP e Shortcut RX and TX on the RS 232 and power on t
45. ill become green 6 2 Installing file system using the serial port See the chapter about Upgrading file system via the serial port 56 Chapter 7 Firmware upgrade 7 1 Serial upgrade Chapter 7 Firmware upgrade There are two ways to upgrade the FW It can either be done via a serial cable or via the network The device can always be configured via the serial interface even when the device is configured wrong In order to upgrade the FW via the network the network connections must work via Ethernet or Bluetooth 7 1 Serial upgrade This upgrade is done via the serial port in the DSUB Upgrading firmware via the serial port 1 Install the program WNP Flash Loader Open the program by pressing Start gt Programs gt connectBlue gt WNP Flash Loader WNP Flash Loader 2 Select application file by pressing the Browse button to the right of the drop down list The application file shall be the bin file that represents the firmware Normally there are two choices image bin and imageAndFileSys tem bin With imageAndFileSystem bin both the application and the file sys tem including configuration files and web pages will be written 3 Select correct COM port 4 Press Load 5 Restart your device and wait until the status bar is finished 6 Wait for your device to restart itself You do not need to restart it manually If your device doesn t start it might have the wrong firmware and t
46. interfaceDescriptor Selects which bus interface to use 1 id A bus specific identifier specifying Bus specific which object or property to read from Return value If successfully executed the status is returned as a string with the value 0 or 1 Otherwise the string ERROR is returned string aspGBIWriteBit interfaceDescriptor id dataBit Description Writes the status of a bit to GBI Parameter Description Valid val ues interfaceDescriptor Selects which bus interface to use 1 id A bus interface specific identifier that Bus specific specifies which object or property to write to dataBit The value of the bit to be written Oor 1 Return value If successfully executed the string OK is returned Otherwise ER ROR is returned string aspGBIReadStr interfaceDescriptor id strLen Description Reads a string from GBI In parameters Parameter Description Valid val ues interfaceDescriptor Selects which bus interface to use 1 46 Chapter 5 Creating your custom web pages 5 2 ASP script functions id A bus interface specific identifier that Bus specific specifies which object or property to read from strLen The number of characters to be read 0 80 Return value If successfully executed the string that was read from GBI is re turned Otherwise the string ERROR is returned Remarks If strLen is set to the value 0 the whole string will be read until the string terminati
47. is stored in the ring buffer the logger starts writing from the be ginning of the ring buffer and then continuously adds new entries until the end is reached At the point when the end is reached the logger will first save the entries in the ring buffer to a backup file in the file system providing the ring buffer has been configured to use backup files Then the logger will start writing at the be ginning of the buffer again thereby overwriting the oldest entry Depending on how many backup files are used the following will happen when a ring buffer gets full before the logger starts writing over old entries in the ring buffer Number of Action taken when the ring buffer gets full backup files 0 No action will be taken The logger will start writing over old entries immediately The entries in the ring buffer will be stored in backup file on the file system named logbackup0 1 txt If a previous backup file named logbackup0 1 txt exists it will be overwritten The entries in the ring buffer will be stored in backup file on the file system named logbackup0 1 txt If a previous backup file named logbackup0 1 txt exists it will first be renamed to logbackup0 2 txt If a previous backup file named log backup0 2 txt exists it will be overwritten For each entry logged in the ring buffer the GBI Interface Descriptor GBI ID and a Time Stamp is stored The format of the backup files is the same as tha
48. it www b uetooth com Product Care e Do not expose your product to liquid or moisture e DO not expose you product to extreme hot or cold temperature see Techni cal Specification for further information e Do not expose your product to lit candles cigarettes cigars open flames etc e Do not drop throw or try to bend your product since rough treatment could damage it e DO not paint your product as the paint could prevent normal use e If you will not be using your product for a while store it in a place that is dry free from damp dust and extreme heat and cold Radio Frequency Exposure Your WNP contains a small radio transmitter and receiver During communication with other Bluetooth products your WNP receives and transmits radio frequency RF electromagnetic fields microwaves in the frequency range 2400 to 2500 MHz The output power of the radio transmitter is very low 0 001 Watt 1 mW When using your WNP you will be exposed to some of the transmitted RF energy This exposure is well below the prescribed limits in all national and international RF safety standards and regulations Electronic Equipment Most modern electronic equipment for example in hospitals and cars is shielded from RF Energy However certain electronic equipment is not Therefore 64 Chapter 9 Additional information 9 3 Important information Note This equipment emits RF energy in the ISM Industrial Scientific Medical
49. le are not guaranteed to be in chronological order User Management To access the User Management framework in your WNP it is recommended that you use the User Management web pages that are a part of the pre installed de fault application Feel free to modify them as you like in order to make them match the visual design of your own custom application Black Board This chapter describes Black Board component which can write and read data to a RAM buffer It s also possible to store the data to flash with the two functions de scribed below Use the page testPage txt in the default file system to get ac quainted with the component The Black Board is a GBI interface which has the GBI id number 6 It is a byte buffer which contains 8192 bytes It s possible to access these bytes with the fol lowing asp code var id 6 This number refers to Black Board var gbiVar 4 This number points to a byte in the byte array result aspGBIWritel1 id gbiVar value result aspGBIWritel2 id gbiVar value result asoGBIWritel4 id gbiVar value 54 Chapter 5 Creating your custom web pages 5 2 ASP script functions result aspGBIWriteFA id gbiVar value result aspGBlWriteStrid gbiVar value value aspGBlReadl1 id gbiVar value aspGBlReadl2 id gbiVar value aspGBlReadlA id gbiVar value aspGBlReadFA id gbiVar value aspGBlReadStr id gbiVar Note that the byte array is byt
50. le to which the Log Up to 20 charac ger entries shall be written ters ringBufferNumber The number of the ring buffer that 1 2 contains the entries to be stored Return value This function doesn t have a return value Remarks The log file that is created as a result of calling this function contains a list of log entries Each entry is placed on a separate line and consists of a comma separated list of variables in the following format Interface Descriptor ID 53 5 2 ASP script functions Chapter 5 Creating your custom web pages Type Value Time Stamp Below you find a description of what these variables mean Variable Interface Descrip tor ID Type Value Time Stamp Description The GBI bus interface where this log entry comes from The GBI ID that has been logged in this entry The data type for the Value in this log entry The value that has been logged in this entry A timestamp specifying when this Value was logged posible values 1 Bus specific Bit I1Bit DBit I4Bit I1 UN 12 012 14 UI4 Depends on the Type for this entry yy mm dd hh mm ss Example Here is an example of what a log file might look like 1 124 I2 32177 03 05 24 14 48 47 1 124 I2 112 03 05 24 14 49 16 1 130 Bit HIGH 03 06 12 02 52 33 1 80 I4Bit HIGH 03 06 12 05 49 59 Note Since the logger uses a ring buffer that wraps around when it gets full the entries in the log fi
51. lves specifying IP ad dresses configuring the serial port setting the default home page etc In the chapter Creating your custom configuration there is a thorough description of how the configuration of your WNP works along with specifications of all the configurable parameters 2 Creating your custom web pages Once you have created your configuration files the next step is to make the web pages that form the user interface to the industrial equipment for which your WNP was set up In the chapter Creating your custom web pages there is a de scription of how to make such web pages for your WNP 3 Installing your custom application When the configuration and web page files that make up your application are fin ished you must download them to your WNP This can be done in two ways ei ther via FTP or via a utility called the connectBlue Flash Loader that you will find on the CD that comes with your WNP For step by step instructions see the chapter Installing your custom application where both methods are described in detail 4 1 Configuration files Chapter 4 Creating your custom configuration Chapter 4 Creating your custom configuration This chapter describes how to configure your WNP to fit your particular system setup It also specifies all the parameters that are configurable in your WNP The following parts of your WNP has to be configured e Bluetooth e TCP IP Networking e Web server e
52. n is per formed on Return value The result of the bit wise logical operation valueA XOR valueB string aspWaitTime waitTime Description Halts the processing of the current web page for waitTime millisec onds before continuing In parameters Parameter Description Valid values waitTime The number of milliseconds to 0 4294967295 wait before the processing of the web page is resumed 41 5 2 ASP script functions Chapter 5 Creating your custom web pages Return value This function doesn t have a return value string aspGetFirmwareVersion Description Returns a string specifying the firmware version of your WNP In parameters This function doesn t have any in parameter Return value A string specifying the firmware version of your WNP is returned string aspGetSystemStatus Description Returns the current system status of your WNP In parameters This function doesn t have any in parameter Return value The current system status is returned as string holding a status code Below is a list of the status codes that can be returned Status Meaning code 0 Invalid status code Error 1 Your WNP is starting up 2 Your WNP hasn t been able to receive its IP settings for the Ethernet interface from a DHCP server on the LAN yet 3 Your WNP is powered on has started up and is working cor rectly 4 Your WNP is in the process of establishing a Bluetooth link 5 Your WNP is connected to anoth
53. n the picture above As is shown in this picture the WNP incorporates a file system that holds a set of configuration files and web pages These files make up the actual application and the user inter face to your industrial equipment Since each case where the WNP is used tends to be different you will have to create a set of files that match your own certain sys tem setup This gives you full freedom in designing the user interface and configu ration to suit your specific needs How this is done is described in the following chapters TCP IP Fieldbus Ethernet LAN cable Fieldbus cable Chapter 2 Getting started 2 1 Mounting instructions Chapter 2 Getting started This chapter helps you get started using your WNP The following topics will be discussed e How to mount your WNP and connect the electrical interfaces e How to connect to your WNP from a device such as a PDA Laptop or com puter e How to access web pages that are stored in your WNP e How to use the application that is pre installed in your WNP at delivery time 2 1 Mounting instructions Mounting your WNP involves e Connecting the serial cable RS 232 422 485 e Connecting the Ethernet LAN cable e Connecting the power cable Note The WNP cannot be mounted arbitrarily since it uses radio communication The WNP cannot be mounted in a metal enclosure Also if you are going to mount the antenna parallel to a metal ground plane at a distance
54. nections link delete all peers and save Press the Reset link and then the Reset button Go to the other unit s web page and press the Bluetooth link Set PAN role to PANU and save Press the Connections link and press Search Add the device that you would like to connect to check the PAN checkbox and press Save Finally reset so the changes will take effect Make sure that both diodes turn blue within 30 seconds If not it can depend on that the passkeys on the Bluetooth page in both devices doesn t match or that it s the wrong Bluetooth device Setting up a multipoint Network Access Point This setting makes it possible for up to 7 Bluetooth devices to connect to a net work Power up the Access Point that will be the center of the communication Connect it to your PC with an Ethernet cable or via a Direct Connection as de scribed above Enter the configuration page by writing 10 0 0 100 in the address field of the Internet Explorer and press the link named Bluetooth Enter username admin and password admin Change PAN Role to NAP and then press Save Press the Connections link delete all devices and press Save Press the Reset link and press the Reset button Make sure the LED turns green again Your unit is now a Network Access Point that supports up to 7 connections Pair your Bluetooth device with the Access Point Enter the menu Add a
55. new speed was successfully set to 1200 lt BODY gt lt HTML gt 5 2 ASP script functions This section describes the predefined ASP functions that your WNP supports These functions can be called from the script sections of your ASP web pages They perform operations that use the primary functionality of your WNP such as accessing registers on a Modbus device that is attached to your WNP or setting your WNP s system time Please note that these functions have been added to the GoAhead web server by connectBlue and that they are especially designed for the WNP Therefore you won t find any information about these functions on the GoAhead website General functions This section describes the ASP functions that handle general tasks that don t be long to any special function category Typically these functions perform utility op erations such as extracting the value of a CGI variable string aspVarExists variableName Description Checks if a web server or CGI variable with the name variable Name exists In parameters Parameter Description Valid values variableName The name of the variable to A variable name that may check for exist Return value If the variable exists 1 is returned Otherwise 0 is returned string aspGetVar variableName Description Extracts the value of the web server or CGI variable with the name variableName 40 Chapter 5 Creating your custom web pages 5 2 ASP script functions
56. ng null character is reached However if the string is longer than 80 characters it will be truncated string aspGBIWriteStr interfaceDescriptor id textStr Description Writes a text string to GBI Parameter Description Valid val ues interfaceDescriptor Selects which bus interface to use 1 id A bus specific identifier specifying Bus specific which object or property to write to textStr The string to be written Up to 80 charac ters Return value If successfully executed the string OK is returned Otherwise ER ROR is returned string aspGBlReadl1 interfaceDescriptor id string aspGBlReadl2 interfaceDescriptor id string aspGBlReadld interfaceDescriptor id Description Reads an integer from GBI Parameter Description Valid val ues interfaceDescriptor Selects which bus interface to use 1 id A bus specific identifier specifying Bus specific which object or property to read from Return value If successfully executed the value of the read integer is returned as a string Otherwise the string ERROR is returned 47 5 2 ASP script functions Chapter 5 Creating your custom web pages string aspGBlWritel1 interfaceDescriptor id integerData string aspGBlWritel2 interfaceDescriptor id in tegerData string aspGBIWritel4 interfaceDescriptor id integerData Description Writes an integer to GBI Parameter Description Valid values interfaceDescriptor Selects whi
57. o be used by clients connecting via PPP DNS Host Name dns_hostname The DNS Host Name parameter specifies the hostname of your WNP Clients that connect via Bluetooth LAN Profile can use this name instead of the IP address when accessing your WNP providing their terminal has support for DNS name resolution For example the web server of your WNP can be accessed by entering http lt hostname gt instead of http lt ipaddress gt in the address field of the web browser WINS Server wins_server The WINS Server parameter specifies the IP address of a WINS server to be used by clients connecting via PPP The IP address is sent to the clients during the PPP con nection establishment procedure Summary of the entries in the network cfg configuration file Parameter Key name Valid val name ues PPP DHCP 2000 use dhcp yes or no PPP Local IP Ad ppp0 local ipaddr XXX XXX XXX XXX dress PPP Remote IP Ad ppp0 remote ipaddr XXX XXX XXX XXX dress Ethernet DHCP 6010 1486 0102 yes or no Ethernet IP Address eth0 ipaddr XXX XXX XXX XXX Ethernet Subnet eth0 netmask XXX XXX XXX XXX Mask Default Gateway default_gateway XXX XXX XXX XXX Default value ce yes 10 0 0 200 10 0 0 201 ce 7 yes 10 0 0 100 255 255 0 0 The IP address of the Ethernet inter face if an Ethernet interface is present Other wise no default gateway will be used
58. oatData nrDecimals string aspGBIWritel4Dec interfaceDescriptor id floatData nrDecimals Description Multiplies the floating point number stored in floatData with 104nrDecimals converts the result to an integer which then is written to GBI In parameters Parameter Description Valid val ues interfaceDescriptor Selects which bus interface to use 1 id A bus specific identifier specifying Bus specific which object or property to rwrite to floatData The floating point number to be written A floating point number nrDecimals The number of decimals to use 10 10 Return value If successfully executed the string OK is returned Otherwise ER ROR is returned Remarks Please note that the resulting integer that is to be written to GBI must fit within the boundaries of the selected integer size 11 12 or 14 These boundaries are presented below Integer size Boundaries 11 128 127 12 32768 32767 14 2147483648 2147483647 Example floatData 38 423 nrDecimals 2 gt The integer 3842 is written to GBI 49 5 2 ASP script functions Chapter 5 Creating your custom web pages string aspGBlReadl1Scale interfaceDescriptor id minVal maxVal nrDecimals string aspGBlReadl2Scale interfaceDescriptor id minVal maxVal nrDecimals string aspGBIReadl4Scale interfaceDescriptor id minVal maxVal nrDecimals Description Reads an inte
59. ocessed the resulting web page is returned to the client s web browser in a HTTP response 37 5 1 ASP scripts Chapter 5 Creating your custom web pages E 11172 request Web Server in BW EE File system in BWE a lt gt 00006 lt 8 HTTP response 3 Web page 7 Resulting HTML code 4 ASP script dode 6 Possible values returned 5 Calls to the pre defined from calls to the pre defined ASP script functions ASP script functions accessing for example GBI Commands in the GoAhead s JavaScript Inter preter e Variables and variable declarations var e Global functions with support for local JavaScript variables e If then else e For loops e Expressions including amp amp amp lt lt gt gt lt lt gt gt e Statements return braces comma semicolon e Comments Missing from the embedded implementation are arrays objects regular expres sions and object methods The resulting implementation is a 15K Embedded JavaScript interpreter that is highly tuned to the needs of embedded devices rather than a 200K conventional memory footprint Below are two typical examples of how script code can be used Example1 Present data in a web page This is an example where dynamic data that is read from a device is incorporated in a web page Here we use the ASP script function a50G amp Reaail2 to retrieve a tem perature value from a fictive device to which the WNP is suppo
60. on 9 1 Troubleshooting Chapter 9 Additional information 9 1 Troubleshooting This section describes the solutions to some of the most common problems For additional information see the FAQ Frequently Asked Questions for the WNP on connectBlue s website www connectblue se 1 can t connect to my WNP using Bluetooth Make sure that you indeed are trying to connect to your WNP and not an other Bluetooth device This can be done by checking the Bluetooth Local Name and the Bluetooth Device Address of the device you are trying to con nect If your WNP or the Bluetooth device you use to connect to your WNP re quire authentication make sure that the same passkey is used on both de vices If your WNP or the Bluetooth device you use to connect to your WNP re quire authentication make sure that both devices support pairing 2 can t establish a TCP IP connection to my WNP Review the TCP IP settings on your WNP by checking the TCP IP networking configuration file Review your TCP IP network settings on the device you use when trying to connect to your WNP 3 can t access the web pages in my WNP Make sure you are connected to your WNP Make sure you have entered the correct URL Make sure that the web page you are trying to access actually is stored in your WNP You can do this by logging in with an FTP client and view the contents of your WNP s file system Review the TCP IP settings on your
61. on file The key name is written within parenthesis after the parameter name in the head ings below Note The Logger collects its data via the General Bus Interface GBI For a de scription of this interface see the section The General Bus Interface Log List logger_log_list This parameter specifies which data from the industrial equipment to log The Log List has the following format Entry Entry2 EntryN where each entry defines one GBI ID to log from a certain bus interface The entries contain a list of variables in the format Interface Descriptor ID Data Type Hysteresis Ring Buffer Number Bit Number Below is a description of what these variables mean Variable Description Valid values Interface Descriptor The GBI bus interface type to use 1 ID The GBI ID to log on the selected bus Bus specific interface Data Type The data type that shall be logged Bit 1 Bit I2Bit I4Bit 11 UN 12 012 14 UI4 Hysteresis To actually be logged the currently 0 2147483647 polled value must differ by at least the Hysteresis from the previously logged value for this entry The Hysteresis vari able only applies if the data type used is 11 UIL 12 UI2 14 or UI4 For the other data types the currently polled value will always be logged if it differs from the previously logged value for this entry no hysteresis used Example Data Type UI2 Hysteresis 200 Comment Polled value nr 1 3428
62. our WNP Default user id for FTP access is su per and Password is admin1234 To change password via the web interface you must log in as super BWE lt gt Web Server lt HTTP request E FTP Server lt lt FTP command connection request Incoming request from remote terminal The Bluetooth security settings are stored in a configuration file called blue tooth cfg and the User Management data is stored in another configuration file called umconfig txt If umconfig txt is deleted Chapter 3 How to create your custom WNP application 3 1 Creating you own custom application Chapter 3 How to create your custom WNP application The previous chapter described how to mount your WNP and how to use the pre installed application In this chapter we present the basic steps in creating your own WNP application By a WNP application we mean a set of configuration files and web pages that are stored in the file system of your WNP The configuration files set up your WNP to match your specific use case and the web pages make up the actual user interface to your industrial equipment 3 1 Creating you own custom application Creating you own custom application typically means performing the following three steps in sequence 1 Creating your custom configuration The configuration files are used to set up your WNP to match the circumstances under which it shall work in your specific case This invo
63. owing connection setup shall be used BWE T R T R Device 1 p Device 2 Note The definition of R R T T may vary between manufacturers Chapter 2 Getting started 2 3 Status LEDs Power Connector TBD Power 9 30 V DC 2 3 Status LEDs System status LED The color of the LED that s placed next to the sign on the top of your WNP indi cates the system status e Solid green and blue led at the same time means that your WNP is starting up The WNP is not working if it stays in this mode e Blinking green 1 to 5 blinks per second means that your WNP is getting configured The WNP is configured wrong if it stays in this mode e Blinking green 3 times and blue 1 time that your WNP has been configured from the web pages recently and is waiting for a reset The changes are only done after the WNP has been reset e Solid green means that your WNP is powered on has started up success fully and is ready to accept incoming connections e Blinking blue and green with blue for 50 ms and green for 200 ms means that your device is connecting e Blue means that a device is connected to your WNP via a Bluetooth link e Blinking blue once per second means that data is being transferred on the Bluetooth link LAN Valid Link and LAN Link Activity LED This led is placed in the middle of the three leds on top of your WNP The LAN Valid Link status is a yellow light that will be shown as long as your W
64. pecified for this interface in the configuration file will be ignored However if a parameter is missing in the settings that are sent to your WNP from the DHCP server your WNP will fall back to the value that is specified for that pa rameter in the network configuration file If your configuration file doesn t contain an entry for that parameter the default value for the parameter will be used If you have selected to use DHCP for the Ethernet interface but there is no DHCP server reachable on the LAN your WNP will perform automatic retries until there is one that answers During the time your WNP tries to contact a DHCP server your WNP will of course not be reachable from the LAN since it hasn t yet acquired its settings for the Ethernet interface If you have selected to use DHCP for the PPP interface but there is no DHCP server reachable on the LAN when a Bluetooth enabled client connects to your WNP your WNP will perform automatic retries to reach a DHCP server If no DHCP server has answered within 15 seconds your WNP will fall back to using static set tings for the PPP interface during this connection The local DNS server in your WNP Your WNP incorporates a local DNS server capable of resolving its own host name which by default is wnp The IP address that is returned for this URL is the IP ad 26 Chapter 4 Creating your custom configuration 4 3 Parameters in the configuration files dress of the network inte
65. products Wireless Network Platform cB 3013 01 cB 3021 01 cB 3022 01 cB 3023 01 cB 3024 01 cB 3025 01 and cB 3026 01 to which this declaration relates conforms to the following product specifications R amp TTE Directive 1999 5 EC EN 300 328 V1 7 1 2006 10 EMC Directive 89 336 EEC EN 61000 6 2 2005 EN 61000 6 4 2007 17 02 2010 Malm Sweden Mats Andersson CTO of connectBlue AB More information at Atto europa eu invcomm enterprise rtte gener htm 59 8 2 FCC Statement Chapter 8 Regulatory information 8 2 FCC Statement This device complies with Part 15 of the FCC Rules Operation is subject to the fol lowing 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 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 de signed to provide reasonable protection against harmful interference in a residen tial 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 guaran tee that interference will not occur in a particular installation If this equipment does cause harmful interference to radio o
66. ption Valid values time A string holding the time which _ 0 23 0 59 0 59 the RTC shall be set to 52 Chapter 5 Creating your custom web pages 5 2 ASP script functions Return value If successfully executed the string OK is returned Otherwise ER ROR is returned string aspRTCGetDate Description Returns the current date of the RTC in your WNP as a string with the format 20yy mm dd In parameters This function doesn t have any in parameter Return value If successfully executed this function returns the current date of the RTC in your WNP is returned as a string with the format 20yy mm dd If the power to the RTC has been lost the string Power lost is returned If a general error in the RTC has been detected the ERROR is returned string aspRTCSetDate date Description Sets the date of the RTC in your WNP according to the date string specified in the format 20yy mm dd Parameter Description Valid values time A string holding the date 2000 2037VI1 12V 1 31 which the RTC shall be set to Return value If successfully executed the string OK is returned Otherwise ER ROR is returned Logger string aspDumpLogToFile filename ringBufferNumber Description Dumps the entries currently stored in one of the Logger s ring buffers to a file In parameters Parameter Description Valid val ues filename The name of the fi
67. r Management EER Ee ER ESRA ERGER ER AEREA 36 5 Creating your custom web pages 37 5 1 ASPrSChiptS 3 205 EE EE GR arenas et ati AG deer akt os 37 Commands in the GoAhead s JavaScript Interpreter 38 Example1 Present data in a web page ee ee ee ee ee 38 Example2 Set a device parameter see ee ees ee ee Ee Re Re ee ee ee 39 5 2 ASP script FUNCTIONS siisii akar GR AA Re ee ee ee ee GR Re Re ee ee ee ee ee 40 General TUnCtons EE Ee EER deleted SE SR Ge ke Ne ER tt 40 Contents string aspVarExists variableName ii ee ee ee ee ee ee ke ee 40 string aspGetVar variableName ee ee ee ee Re ee ee ee ee 40 string aspAND valueA valueB ees ee ee ke ee ee ee ke ee ee ke ee 41 string aspOR valueA ValUCB cece ee ee ke ee ee ke ee ek ke ee 41 string aspXOR valueA valueB ees ee ee ee ee ke ee ee ke ee 41 string aspWaitTime WaitTiIME eee ee ee ee Re ee ek Re ee 41 string aspGetFirmwareVersiOn ee ee ee ee ee ee ek Ke ee 42 string aspGetSystemStatus ie ee ek ee ek Re ee ek Re ee 42 string aspResetSystemi timeout ees se ee ek ee ek ke ee 42 Configuration Manager ees ee ek ee Ge Re ee ee ke ee ee ke ee 43 string aspCMAvailable cfgFileName ee ee ee ee ee ke ee 43 string aspCMGetKeyValue cfgFileName key ee ee 43 string asoCMSetKeyValue cfgFileName key value ees 43 string aspCMGetParam componentld parameterld 44 Gen
68. r television reception which can be de termined 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 equipment and receiver e Connect the equipment into an outlet on a circuit different from that to which the receiver is connected Consult the dealer or an experienced radio TV technician for help Antenna The end user product will be professionally installed in such a manner that only the authorized antennas are used Caution Any changes or modifications NOT explicitly APPROVED by connectBlue AB could cause the module to cease to comply with FCC rules part 15 and thus void the user s authority to operate the equipment 8 3 IC Compliance 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 This device has been designed to operate with an antenna having a maximum gain of 8 5dBi Having a higher gain is strictly prohibited per regulations of Industry Canada The required antenna impedance is 50 ohms To reduce potential radio interference to other users the antenna type and its gain should be so chosen that the equivalent isotropically radiated power EIRP is not more than that required for s
69. rface of your WNP on which the DNS reguest arrived This is very useful if you connect to your WNP via Bluetooth and you don t know what IP address it has Then you can simply enter http Avnp in the address field of your web browser and press lt ENTER gt in order to get to the default web page of your WNP When connecting to your WNP via Bluetooth the IP address of the local DNS server in your WNP will be sent to your terminal during the PPP connection estab lishment procedure Hence if you for example enter an URL in the address field of the web browser on your terminal and press lt ENTER gt a resolve request will be sent to the local DNS server If the URL is http Awnp the local DNS server will successfully resolve it For all other URL s the it will forward the request to the ex ternal DNS server specified in the network configuration file or received via DHCP and let that DNS server handle the request se BWE Terminal client enabled with Bluetooth TCP IP TCP IP ppp _ppp0remote ppp0_local PPP TCP IP Ethernet l mad Ethernet LAN cable Below is a list of all the entries in this configuration file The key name is written within parenthesis after the parameter name in the headings below PPP use DHCP ppp0_use_dhcp The PPP use DHCP parameter specifies whether or not DHCP is to be used to ac quire the settings for the PPP interface PPP Local IP Address ppp0_local_ipaddr T
70. ry 2 EntryN None Where each Entry Slave Function Starting Virtual Reg ister Starting Slave Register Number Of Registers 25 4 3 Parameters in the configuration files Chapter 4 Creating your custom configuration File example Modbus configuration modbus cfg mb interface RS232 mb parity ODD mb_baud_rate 19200 mb stop bits 1 mb query response hold time 10 mb write list 1 16 1 8000 1 1 16 2 8009 1 mb scan list 1 3 1 1 8000 10 1 3 7 1 8014 7 Network This group of configuration parameters is used to configure the TCP IP Network in terface in your WNP The configuration file that contains these parameters must be named network cfg in your WNP Using DHCP to acquire the TCP IP network settings If the WNP is attached to an Ethernet LAN you can use DHCP to automatically ac quire the TCP IP network settings Assuming that there is a correctly configured DHCP server attached to the same LAN all the network configuration parameters can be acquired in this way This includes the parameters for the Default Gateway and the DNS Server The choice to use DHCP or not is made separately for each interface PPP and Ethernet Hence you can for example chose to have statically assigned settings for the Ethernet interface and use DHCP to acquire the network settings for the PPP interface If you choose to acquire the network settings for an interface via DHCP any pa rameter values s
71. s ES acide RE Gee ea Pe ee be eie 63 9 2 Guidelines for efficient and safe US ie se ee ee ER AR RA ee ee 64 Product Care iS Es ES Ee Ee We De EE ee aeons 64 Radio Frequency Exposure ccccceeeeeeeeececeeeeeeeeeeseesnnaeeeeees 64 Electronic Eduipment esse se se ee ee ee ee ee ee se ke ee ee ee ee ee Ge ke ee ee ee ee 64 Potentially Explosive AfmosphereS iss ee ees ee ee ee se ke ee ee ee ee 65 9 3 Important information ee se ee ee GR EA RA Ee ee ee ee Re Re Re ee ee ee ee ee 65 9 4 Technical Specification ccccccccceceeeeececeeeeeeeeeeeteceaeaeeeeeeeeeeeenaees 65 Bluetooth Interface tse ee ER ed Ga ces Ee Ge ER eg eg ge 65 Bluetooth OualificatiOn sites ss se Rg saaa 65 Serial Interfaces rissie ei Ai oe ge ER dee Hide as Ee ES eed 65 Power current CONSUMPTION eie ee RA Ge Ee RA AR Ge ee ee 66 HS EE ER EE EE hed 66 Configuration File is sels A Ee oe ae ee Ka geed 66 Compatibility sis es RAN SEE oe EG daddies SE eo ee ee geed 66 Environmental sides isi ee bek GM ee ede es EE Pe deed 66 Contents Chapter 1 Introduction 1 1 What is Bluetooth wireless technology Chapter 1 Introduction The Wireless Network Platform in this manual referred to as the WNP works as a Wireless Access Point an Ethernet Port Adapter a Serial Port Adapter and as a Terminal Server that forwards data from a TCP connection to a Bluetooth SPP con nection It can also be used to add
72. s been configured correctly you can power off the NAP device and all other devices shall turn green after a couple of seconds Setting up and using the Terminal Server This setting connects a PC s virtual COM port to a Bluetooth Serial Port Adapter or the local serial port Ethernet to Serial Port Bluetooth Serial Port It is possible to access up to seven Bluetooth serial services plus the local serial port through TCP IP connections When a TCP IP connection is established to a TCP port in the WNP the WNP will try to connect to a remote serial service on a Bluetooth unit If multiple connections are configured to the same port wireless multidrop will be used Do the following to configure the WNP e Set up the device as a Network Access Point as described above e Enter the Connections configuration page and search for devices e Add the devices you want to use check the TS checkbox and enter the TCP port you want to use e Check the Add box for the Serial device you would like to connect to and choose a valid TCP port number 1 65535 for the TCP connection Press Save 2 5 Accessing web pages in your WNP via Bluetooth Chapter 2 Getting started e Press the Reset link and press the Reset button Make sure the LED turns green again e Start your COM Port Redirector program e g comOcom and com2tcp and setup a virtual COM port to this device Make sure that you choose the same TCP port as you conf
73. sed to be attached The ASP script functions that your WNP supports are described in the section ASP script functions temperature asp lt HTML gt lt BODY gt Current Temperature lt var Temp Temp aspGBIReadI2 1 14 write Temp Chapter 5 Creating your custom web pages 5 1 ASP scripts lt BODY gt lt HTML gt When the web server has processed this ASP web page the following result will be returned to the client s web browser assuming the read temperature was 57 de grees lt HTML gt lt BODY gt Current Temperature 57 lt BODY gt lt HTML gt Example2 Set a device parameter In this example we set a device parameter according to a value that is entered by the user This is typically performed in a three step process 1 The first step consists of the user requesting a web page containing a HTML form where the new parameter value can be entered speed form html lt HTML gt lt BODY gt lt FORM action set_new_speed asp gt Please enter new speed lt INPUT type text name new_ speed gt lt INPUT type submit value Set Speed gt lt FORM gt lt BODY gt lt HTML gt 2 In the second step the user views the web page above enters the new speed value and presses the Set Speed button This will trigger his web browser to send a request for the web page set_new_speed asp The n
74. shorter than 50 cm make sure the distance is not a multiple of a half wavelength The length of one half wavelength is 62 5 mm 2 2 Electrical Interfaces RS 232 422 485 serial connector 9 pin DSUB type The meanings of the pins of the DSUB are described below for the RS 232 and RS 422 485 cases respectively RS 232 In the RS 232 case the following pinning is used Pin 1 NC not connected Pin 2 RD input receive data Pin 3 TD output transmit data 2 2 Electrical Interfaces Chapter 2 Getting started Pin 4 NC not connected Pin 5 GND ground Pin 6 NC not connected Pin 7 RTS output reguest to send Pin 8 CTS input dear to send Pin 9 NC not connected RS 422 and RS 485 Note These two options are not mounted as standard In the RS 422 case the following pinning is used Pin 1 R input receiver Pin 2 T output transmitter Pin 3 NC not connected Pin 4 NC not connected Pin 5 NC not connected Pin 6 R input receiver Pin 7 NC not connected Pin 8 T output transmitter Pin 9 NC not connected For four wire RS 422 multi drop cases the following connection setup shall be used T R Ry T Device 1 Device 2 In the case of RS 485 the same pinning as for RS 422 is used except that pins 1 and 2 must be connected externally and pins 6 and 8 must be connected externally to produce the signals T R and T R For two wire RS 485 multi drop cases the foll
75. t used when the ASP script function aspDumpLogToFile is called See chapter Creat 35 4 3 Parameters in the configuration files Chapter 4 Creating your custom configuration ing your custom web pages section ASP script functions sub section Log ger Ring Buffer 1 logger_ring_buffer_1 See description of the Ring Buffer 0 parameter The only difference is that the backup files used are named logbackup1_1 txt and logbackup1_2 txt instead of logbackup0_1 txt and logbackupO_2 txt respectively Summary of the entries in the logger configuration file Parameter Key name Valid values Default name value Log List logger log list Entry1 Entry2 EntryN None Where each Entry In terface Descrip tor ID Data Type Hysteresis Ring Buffer Number Bit Num ber Log Period logger log period 1 4294967295 1 Ring Buffer 0 logger ring buffer 0 1 1000 0 1 2 500 0 Ring Buffer 1 logger ring buffer 1 1 1000 0 1 2 500 0 File example Logger configuration logger cfg logger_log list 1 64 Bit 0 0 0 1 0 UI1 100 0 0 logger log period 4 logger ring buffer 0 100 0 logger ring buffer 1 500 2 User Management To configure the User Management framework in your WNP it is recommended that you use the User Management web pages that are a part of the pre installed default application Feel free to modify them as you like in order to make them mat
76. tParam 7 2 will return your WNP s Bluetooth passkey Note When trying to retrieve the value of a parameter that currently is not avail able from the Network component a space character will be returned This happens for example if you try to get the remote IP address of the PPP interface when no active PPP connection exists General Bus Interface GBI This section describes the ASP functions used to access the General Bus Interface GBI which is described in chapter Creating your custom configuration section The General Bus Interface It s important that you have configured the bus inter face you want to access correctly before calling these functions Note1 Some of these functions that read or write integers come in three different versions Each version works with a different integer size 1 2 or 4 bytes The dif 45 5 2 ASP script functions Chapter 5 Creating your custom web pages ferent versions are recognized by two letters in the function name 11 12 or 14 in dicating which integer size they use Note2 Some of these functions use floating point numbers When this data type is being used numbers must be specified as decimal numbers for example 34 189 or 0 00822 Hence the functions will not accept formats such as 323E 9 or 7541E 2 string aspGBIReadBit interfaceDescriptor id Description Reads the status of a bit from GBI Parameter Description Valid val ues
77. tive FTP Cli ent NOTE The FTP Client must be able to retrieve a file from the FTP server which doesn t exist when listing all files 2 Logon with the ip address of your device 10 0 0 100 as default and the username super and password admin1234 3 Retrieve the file imageAndFileSystem bin In WS_FTP you do this by pressing the arrow pointing to the left without choosing any file and then enter the file name in the dialog box that pops up 4 Now you can use this file to flash another WNP to get the same settings 7 2 Network upgrade This upgrade of the firmware can be done either via the Ethernet network or via Bluetooth 1 Rename the binary firmware file to image bin 2 Connect the WNP with an FTP client The default static ip address is 10 0 0 100 Username is super and password is admin1234 3 Download the image bin file to the WNP 4 Close the FTP connection 5 Wait for the device to reset itself Do not restart it manually If the device doesn t start again or if it keeps restarting then something has went wrong and you must reflash it via the serial port in the DSUB See instructions for serial upgrade 58 Chapter 8 Regulatory information 8 1 Declaration of conformity Chapter 8 Regulatory information Declaration of conformity CEO We connectBlue AB of Norra Vallgatan 64 3V SE 211 22 Malm Sweden declare under our sole responsibility that our
78. uccessful communication The installer of this radio equipment must ensure that the antenna is located or pointed such that it does not emit RF field in excess of Health Canada limits for the 60 Chapter 8 Regulatory information 8 4 Safety general population consult Safety Code 6 obtainable from Health Canada s web site www hc sc gc ca rpb 8 4 Safety The unit must be supplied by a limited power source in according to EN 60950 1 8 5 RF exposure Statement This modular transmitter MUST have a separation distance of at least 20 cm be tween the antenna and the body of the user or nearby persons excluding hands wrists feet and ankles If the radio module is installed in a laptop display transmission MUST be prevented if the lid is closed to ensure that the minimum distance of 20 cm between the user and the transmitting antenna is maintained Any notification to the end user of installation or removal instructions about the in tegrated radio module is NOT allowed 8 6 UL listing information If a customer intends to UL list a product including any of the Bluetooth modules based on the PCB cB 0901 03 this information is useful The printed circuit board if produced according to the following specification e UL recognized ZPMV2 min 105 C flame class V O or better 8 7 Compliance with RoHS directive All products are produced according to the RoHS Restriction of the use of certain Hazardous substances in el
79. ust start a web browser on your computer type in the address of the web page you want to view in the address field and press lt ENTER gt You can for example write 10 0 0 100 or 10 0 0 100 sysoview asp If you can t access the webpage the WNP could have retrieved an ip address from DHCP In order to let the WNP get it s static ip address you need to start the WNP without the network cable Then when the WNP is started you plug in the network cable and try with the static ip address If you have forgotten the ip address there are a few ways to handle this e Connect to the WNP via LAN and enter wnp in the address field Then you ll connect to the web server in the WNP and you ll see the ip addresses e Use Etherreal to listen on Ethernet when the WNP starts The WNP will then do a gratuitous arp that contains the current ip address e Search for Bluetooth devices The IP address of the WNP will be included in the name e Use the Reset to factory defaults procedure e Flash the WNP with a firmware file that contains both the firmware and the default file system The WNP will then contain the default settings with the de fault ip settings See the chapter about Serial upgrade 2 7 The security framework in your WNP Your WNP comes with a framework to manage security and access rights for the connecting users The security framework consists of three different parts 1 Bluetooth security The first time you conne
80. uthorized persons are granted access to your WNP When a Bluetooth device connects to your WNP the user of that de vice will be prompted to enter a passkey The passkey that the user enters must correspond to the one that is stored in your WNP or access will be denied The Passkey may contain 1 to 16 characters Note The Bluetooth Passkey authentication mechanism will only be used if Bluetooth security mode 3 is turned on in your WNP Security Mode bt_security_mode3 The Security Mode parameter is used to turn Bluetooth security mode 3 on or off If it is turned on this will require users connecting to your WNP to enter a Passkey on their terminal in order to be granted access For some PAN devices to be able to connect to this device this parameter must be set to on LAN Access Service Name bt_lan_service_name The LAN Access Service Name parameter specifies the name of the LAN Access service in your WNP When remote Bluetooth units discover the services of your WNP this user friendly name will be used to present the LAN Access service PAN role bt_pan_role This parameter specifies if the device is NAP or PANU If the device is NAP then it can connect to the devices that are specified with the bt_pan_remote_peers parameter Other devices can also connect to this de vice and access the network services If the device has the role as PANU then it can only have one connection because it is always slave PAN NAP service n
81. vice Name Remote PANU servers Remote TS serv ers Field bus type Baud rate Data bits Stop bits Parity Flow control File example Key name bt_local_name bt_passkey bt_security_mode3 bt lan service name bt pan role bt pan nap service name bt pan panu service name bt pan remote peers bt ts remote peers bt fieldbus type bt fieldbus baudrate bt fieldbus databits bt fieldbus stopbits bt fieldbus parity bt fieldbus flowcont rol Bluetooth configuration bt local name My Bluetooth Valid values Up to 80 characters 1 to 16 characters A Z a z 0 9 on or off Up to 100 charac ters NAP or PANU Up to 100 charac ters Up to 100 charac ters RS232 RS422 RS485 9600 719200 38400 57600 115200 230400 460800 6020 HO Efe SR Sa 020 NONE ODD EVEN CTS RTS NONE device Default value WNP off LAN Service NAP NAP Service PANU Service pap ee RS232 57600 ce lige NONE CTS RTS 32 Chapter 4 Creating your custom configuration 4 3 Parameters in the configuration files bt_passkey 0 bt security mode3 on Dt spp service name SPP Service Dt lan service name LAN Service PAN role to use NAP or PANU bt_pan_role NAP

WNP - connectBlue

Contents

Download Pdf Manuals

Related Search

Related Contents