Würth ANR020 How-To Download Page 25

5. Pressing this button sends a

CMD_GPIO_REMOTE_WRITECONFIG_REQ

message (02 28 03

01

01

01

/ configured GPIO with

GPIO_ID 1

to

input

pull down

) to the radio module,

which responds with a

CMD_GPIO_REMOTE_WRITECONFIG_CNF

message (02 68 02

01

00

/ configured GPIO with

GPIO_ID 1

successfully

).

6. On the radio module side, the Proteus-III outputs the corresponding indication mes-

sage

Info

Module 1

Indication

CMD_GPIO_REMOTE_WRITECONFIG_IND

: The

GPIO with

GPIO_ID 1

has been configured to

input

pull

down

by the remote device

02 A8 04 00 03

01

01

01

AC

7. Now, go to the sub menu "GPIO read/write" and press the refresh button to read all

GPIO states.

ANR020 Proteus-III version 1.0

© July 2020

www.we-online.com/wireless-connectivity

24

Summary of Contents for ANR020

Page 1: ...ANR020 PROTEUS III REMOTE GPIO CONTROL HOW TO VERSION 1 0 JULY 10 2020 ...

Page 2: ...Revision history Manual version Notes Date 1 0 Initial version July 2020 ANR020 Proteus III version 1 0 July 2020 www we online com wireless connectivity 1 ...

Page 3: ...age in a frame package RF Radio frequency Describes wireless transmission UART Universal Asynchronous Receiver Transmitter Allows the serial communication with the module HEX 0xhh Hexadecimal All numbers beginning with 0x are hexadecimal numbers All other numbers are decimal unless stated otherwise ANR020 Proteus III version 1 0 July 2020 www we online com wireless connectivity 2 ...

Page 4: ...stomer responsibility 27 4 2 Customer responsibility related to specific in particular safety relevant ap plications 27 4 3 Best care and attention 27 4 4 Customer support for product specifications 27 4 5 Product improvements 28 4 6 Product life cycle 28 4 7 Property rights 28 4 8 General terms and conditions 28 5 Legal notice 29 5 1 Exclusion of liability 29 5 2 Suitability in customer applicati...

Page 5: ...lication note describes which steps have to be run to switch a GPIO and how to read the pin level of a GPIO via remote connection First or all a general description fol lows then in the Examples section it is demonstrated how the GPIOs can be controlled by a second Proteus III radio module or by smart phone 1 1 Supported GPIOs The supported GPIOs are identified by so called GPIO_IDs that are used ...

Page 6: ...anual where the radio commands are described in detail in the application note ANR009 Proteus III Advanded Developer Guide 2 1 Remote GPIO configuration To use the remote GPIO control feature of the Proteus III Module 1 the GPIOs of interest must be configured first This configuration defines the GPIO function of the pin Either an output pin or an input pin with without pull resistor To do so the ...

Page 7: ...ECONFIG_IND Figure 1 Configure the local GPIOs via remote device host Module 1 Host 1 Module 2 Host 2 CMD_GPIO_REMOTE_READCONFIG_CNF CMD_GPIO_REMOTE_READCONFIG_REQ CMD_GPIO_REMOTE_READCONFIG_CNF CMD_GPIO_REMOTE_READCONFIG_REQ GPIO 1 0 Wire Radio Figure 2 Read the configuration of the local GPIOs via remote device host ANR020 Proteus III version 1 0 July 2020 www we online com wireless connectivity...

Page 8: ...the commands CMD_GPIO_LOCAL_WRITECONFIG_REQ and CMD_GPIO_LOCAL_READCONFIG_REQ see figure 3 and figure 4 In this case the host controller of Module 1 must send the respective commands via UART to the Module 1 Module 1 Host 1 Module 2 Host 2 GPIO 1 0 CMD_GPIO_LOCAL_WRITECONFIG_REQ Wire Radio CMD_GPIO_LOCAL_WRITECONFIG_CNF Figure 3 Configure the local GPIOs via local host ANR020 Proteus III version 1...

Page 9: ... 2 GPIO 1 0 CMD_GPIO_LOCAL_READCONFIG_REQ Wire Radio CMD_GPIO_LOCAL_READCONFIG_CNF Figure 4 Read the configuration of the local GPIOs via local host ANR020 Proteus III version 1 0 July 2020 www we online com wireless connectivity 8 ...

Page 10: ...he local host is informed using a CMD_GPIO_REMOTE_WRITE_IND mes sage Module 1 Host 1 Module 2 Host 2 CMD_GPIO_REMOTE_WRITE_CNF CMD_GPIO_REMOTE_WRITE_REQ CMD_GPIO_REMOTE_WRITE_CNF CMD_GPIO_REMOTE_WRITE_REQ GPIO 1 0 Wire Radio CMD_GPIO_REMOTE_WRITE_IND Figure 5 Set the output value of a GPIO via remote device Module 1 Host 1 Module 2 Host 2 CMD_GPIO_REMOTE_READ_CNF CMD_GPIO_REMOTE_READ_REQ CMD_GPIO_...

Page 11: ...tten to via local host the connected remote device is informed using a CMD_GPIO_LOCAL_WRITE_ IND message Module 1 Host 1 Module 2 Host 2 CMD_GPIO_LOCAL_WRITE_IND CMD_GPIO_LOCAL_WRITE_IND GPIO 1 0 CMD_GPIO_LOCAL_WRITE_REQ Wire Radio CMD_GPIO_LOCAL_WRITE_CNF Figure 7 Set the output value of a GPIO via host controller Module 1 Host 1 Module 2 Host 2 GPIO 1 0 CMD_GPIO_LOCAL_READ_REQ Wire Radio CMD_GPI...

Page 12: ... 1 is the one whose GPIOs are switched via radio It can run without host controller Module 2 is the one whivh must be connected to a host controller Host 2 to send the corresponding configuration and control commands For demonstration purpuses two Proteus III evaluation boards are appropriate As host a Windows computer including the terminal program hterm can be taken The USB connector of the Prot...

Page 13: ...dule 1 started in ACTION_IDLE mode 02 41 02 00 01 01 41 Response CMD_GETSTATE_CNF Module 2 started in ACTION_IDLE mode 02 41 02 00 01 01 41 2 Request the MAC address FS_BTMAC of both modules Info Module 1 Module 2 Request CMD_GET_REQ with settings index 4 02 10 01 00 04 17 Response CMD_GET_CNF FS_BTMAC of Module 2 is 0x55 0x00 0x00 0xDA 0x18 0x00 02 50 07 00 00 55 00 00 DA 18 00 C2 Request CMD_GET...

Page 14: ...00 and maximum payload size of 0xF3 243 Bytes per packet 02 C6 08 00 00 55 00 00 DA 18 00 F3 A7 4 Now the Bluetooth LE connection is open and the configuration and control of the GPIOs of Module 1 can be done 3 1 2 Configure and control a GPIO as output If the Bluetooth LE connection has been setup as shown in chapter 3 1 1 the following steps can be run to configure the GPIO B1 with GPIO_ID 1 as ...

Page 15: ...quest CMD_GPIO_REMOTE_READ_REQ Read the state of GPIO B1 GPIO_ID 1 02 2A 02 00 01 01 2A Response CMD_GPIO_REMOTE_READ_CNF GPIO with GPIO_ID 1 is HIGH 02 6A 04 00 00 02 01 01 6E 5 Switch the GPIO B1 with GPIO_ID 1 again to LOW Info Module 1 Module 2 Request CMD_GPIO_REMOTE_WRITE_REQ Set the GPIO B1 GPIO_ID 1 to LOW 02 29 03 00 02 01 00 2B Response CMD_GPIO_REMOTE_WRITE_CNF GPIO with GPIO_ID 1 has b...

Page 16: ...been configured to input with pulldown GPIO_ID 2 6 are not configured 02 6C 14 00 00 03 01 01 01 02 02 00 02 03 00 02 04 00 02 05 00 02 06 00 7C 3 Leave the GPIO B1 open and read the current state of the GPIO B1 with GPIO_ID 1 Info Module 1 Module 2 Request CMD_GPIO_REMOTE_READ_REQ Read the state of GPIO B1 GPIO_ID 1 02 2A 02 00 01 01 2A Response CMD_GPIO_REMOTE_READ_CNF GPIO with GPIO_ID 1 is LOW...

Page 17: ... program hterm Instead of Module 2 we here use an Android smart phone including the app Proteus Connect which allows the operation with all radio modules from the Proteus series Besides the functions for connection setup and data transmission this app contains the functions of GPIO configuration and control which we will focus on in this chapter 3 2 1 Boot up and connection setup Connect the Prote...

Page 18: ...n the Proteus Connect app and press Scan As soon as the Proteus III appears in the scan list click on it to start the connection setup In the app a new window pops up which shows the connection setup steps in its log window ANR020 Proteus III version 1 0 July 2020 www we online com wireless connectivity 17 ...

Page 19: ...etooth LE connection is open and the configuration and control of the GPIOs of Module 1 can be done 3 2 2 Configure and control a GPIO as output If the Bluetooth LE connection has been setup as shown in chapter 3 2 1 the following steps can be run to configure the GPIO B1 with GPIO_ID 1 as output pin 1 First of all configure the GPIO B1 with GPIO_ID 1 as output pin with default level LOW To do so ...

Page 20: ...h GPIO_ID 1 to 6 are not configured Please note that the format of the radio commands differs from the formnat of the UART commands The documentation of the radio command format for configuration and control of the GPIOs can be found in application note ANR009 Proteus III Advanded Developer Guide 4 Now select pin B1 with output LOW in the app and press CONFIG PIN ANR020 Proteus III version 1 0 Jul...

Page 21: ... GPIO_ID 1 successfully 6 On the radio module side the Proteus III outputs the corresponding indication mes sage Info Module 1 Indication CMD_GPIO_REMOTE_WRITECONFIG_IND The GPIO with GPIO_ID 1 has been configured to output LOW by the remote device 02 A8 04 00 03 01 02 00 AE 7 Now go to the sub menu GPIO read write and press the refresh button to read all GPIO states ANR020 Proteus III version 1 0...

Page 22: ...2 06 FF which states that the GPIO with GPIO_ID 1 is LOW but the GPIOs with GPIO_ID 2 to 6 are not configured 9 Next press B1 move the slider to HIGH and press WRITE PIN to set the GPIO with GPIO_ID 1 to HIGH 10 Pressing these buttons sends a CMD_GPIO_REMOTE_WRITE_REQ message 02 29 02 01 01 set the GPIO with GPIO_ID 1 to HIGH to the radio module which responds with ANR020 Proteus III version 1 0 J...

Page 23: ... and control a GPIO as input If the Bluetooth LE connection has been setup as shown in chapter 3 2 1 the following steps can be run to configure the GPIO B1 with GPIO_ID 1 as input pin 1 First of all configure the GPIO B1 with GPIO_ID 1 as input pin with pull down resistor To do so press the menu button and then GPIO config 2 A menu opens which allows the configuration of the GPIOs First of all pr...

Page 24: ...th GPIO_ID 1 to 6 are not configured Please note that the format of the radio commands differs from the UART com mand format The documentation of the radio command format for configu ration and control of the GPIOs can be found in application note ANR009 Proteus III Advanded Developer Guide 4 Now select pin B1 with input pull down in the app and press CONFIG PIN ANR020 Proteus III version 1 0 July...

Page 25: ... GPIO_ID 1 successfully 6 On the radio module side the Proteus III outputs the corresponding indication mes sage Info Module 1 Indication CMD_GPIO_REMOTE_WRITECONFIG_IND The GPIO with GPIO_ID 1 has been configured to input pull down by the remote device 02 A8 04 00 03 01 01 01 AC 7 Now go to the sub menu GPIO read write and press the refresh button to read all GPIO states ANR020 Proteus III versio...

Page 26: ... which states that the GPIO with GPIO_ID 1 is LOW but the GPIOs with GPIO_ID 2 to 6 are not configured 9 Apply a HIGH signal to the pin by connecting VCC to it Then press B1 and press READ PIN to read the GPIO with GPIO_ID 1 10 Pressing these buttons sends a CMD_GPIO_REMOTE_READ_REQ message 02 2A 01 01 read the GPIO with GPIO_ID 1 to the radio module which responds with a ANR020 Proteus III versio...

Page 27: ...CMD_GPIO_REMOTE_READ_CNF message 02 6A 02 01 01 which states that the GPIO with GPIO_ID 1 is HIGH ANR020 Proteus III version 1 0 July 2020 www we online com wireless connectivity 26 ...

Page 28: ...ed in the current state of the art even if the products are operated within the range of the specifications The same statement is valid for all software sourcecode and firmware parts contained in or used with or for products in the wireless connectivity and sensor product range of Würth Elektronik eiSos GmbH Co KG In certain customer applications requiring a high level of safety and especially in ...

Page 29: ...efore it needs to be verified with the field sales engineer or the internal sales person in charge about the current product availability expectancy before or when the product for application design in disposal is con sidered The approach named above does not apply in the case of individual agreements deviating from the foregoing for customer specific products 4 7 Property rights All the rights fo...

Page 30: ... of systems or units in which Würth Elektronik eiSos GmbH Co KG products are integrated with applicable legal regulations Customer acknowledges and agrees that it is solely responsible for compliance with all le gal regulatory and safety related requirements concerning its products and any use of Würth Elektronik eiSos GmbH Co KG components in its applications notwithstanding any applications rela...

Page 31: ...l transportation signal disaster prevention medical public information network etc Würth Elektronik eiSos GmbH Co KG must be informed about the intent of such usage before the design in stage In addition sufficient reliability evaluation checks for safety must be performed on every electronic component which is used in electrical circuits that require high safety and reliability function or perfor...

Page 32: ...rior written consent of Würth Elektronik eiSos You are not allowed to reproduce translate reverse engineer decompile disassemble or create derivative works of the incorporated Software and the source code in whole or in part No more extensive rights to use and exploit the products are granted to you 6 2 Usage and obligations The responsibility for the applicability and use of the Würth Elektronik ...

Page 33: ...est The upload of firmware updates falls within your responsibility e g via ACC or another software for firmware updates Firmware updates will not be communicated automatically It is within your responsibility to check the current version of a firmware in the latest version of the product manual on our website The revision table in the product manual provides all necessary information about firmwa...

Page 34: ... office 6 8 Severability clause If a provision of this license terms is or becomes invalid unenforceable or null and void this shall not affect the remaining provisions of the terms The parties shall replace any such provisions with new valid provisions that most closely approximate the purpose of the terms 6 9 Miscellaneous Würth Elektronik eiSos reserves the right at any time to change this term...

Page 35: ...he output value of a GPIO via remote device 9 6 Read the input value of a GPIO via remote device 9 7 Set the output value of a GPIO via host controller 10 8 Read the input value of a GPIO via host controller 10 9 The terminal program hterm 11 10 The Würth Elektronik eiSos s tool Smart Commander 12 11 The terminal program hterm 16 List of Tables 1 Supported GPIO_IDs 4 ANR020 Proteus III version 1 0...

Page 36: ... Internet of Things more than you expect Contact Würth Elektronik eiSos GmbH Co KG Division Wireless Connectivity Sensors Max Eyth Straße 1 74638 Waldenburg Germany Tel 49 651 99355 0 Fax 49 651 99355 69 www we online com wireless connectivity ...

Reviews: