ST AN3311 Manuale utente

December 2010 Doc ID 18209 Rev 1 1/58

AN3311

Application note

In-home display for ZigBee® smartplug

Introduction

This application note describes the demonstration firmware running on the STM3210C-

EVAL for the STM32F107VC to manage a smartplug network system.

An embedded graphical user interface (GUI) based on the “multi-input embedded GUI

library 2.0 for STM32F10xxx” described in the AN3128 application note, and working on an

LCD TFT 320 x 240 display and 5-position joystick, allows the user to interact with the

smartplug system made up of one coordinator and two smartplugs connected.

Section 1 describes the document and library rules.

Section 2 highlights the features of the ZigBee smartplug and explains its hardware

interface with a device microcontroller (STM32).

Section 3 describes briefly the “multi-input embedded GUI library”.

Section 4 describes the relevant blocks of the STM3210C-EVAL demonstration board.

Section 5 shows the demonstration firmware/board system setup.

Section 6 describes, in detail, how the “in-home display” firmware is structured, its

architecture and its exported APIs.

Section 7 explains how to get started with the system, how to configure and use the IAR

workspace, and contains an example application source code.

Section 8 illustrates how the “in-home display” GUI application works.

Section 9 illustrates the hardware schematics.

www.st.com

Contents AN3311

2/58 Doc ID 18209 Rev 1

Contents

1 Document and library rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1.1 Acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2 ZigBee smartplug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.1 Smartplug description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.2 ZigBee module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3 Multi-input embedded GUI library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.1 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4 STM3210C-EVAL demonstration board . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.2 STM32 peripherals mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.3 Power supply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

4.4 Boot option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.5 Clock source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4.6 Reset source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4.7 Joystick . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.8 Pushbuttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.9 Storage memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.10 Development and debug support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.11 Display and input devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.12 JTAG debugging connector CN13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4.13 Daughterboard extension connector CN8 and CN9 . . . . . . . . . . . . . . . . . 19

4.14 TFT LCD connector CN14 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

4.15 Power connector CN18 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5 Demonstration firmware system setup . . . . . . . . . . . . . . . . . . . . . . . . . 24

5.1 Hardware requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

5.2 STM3210C-EVAL demonstration board setup . . . . . . . . . . . . . . . . . . . . . 24

5.3 STM3210C-EVAL and ZigBee adapter with M24LR62-r memory . . . . . . 24

5.4 How to navigate the demo menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

AN3311 Contents

Doc ID 18209 Rev 1 3/58

6 In-home display firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

6.1 Firmware architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

6.2 main.c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

6.2.1 vSmartPlugSamplingTask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

6.2.2 vGraphicLibraryTask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

6.2.3 prvApplicationTask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

6.2.4 prvSetupHardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

6.2.5 vBoardInit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

7 Getting started with the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

7.1 Configure IAR tool for building, debugging, and programming the application

7.2 Example application - main.c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

8 In-home display GUI application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

9 Schematics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

9.1 Smartplug board schematics and layout . . . . . . . . . . . . . . . . . . . . . . . . . 45

9.2 ZigBee/RF adapter for smartplug and dual interface memory . . . . . . . . . 46

9.3 STM3210C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

9.4 MCU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

9.5 LCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

9.6 I/O expander . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

9.7 I/O peripherals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

9.8 Extension connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

9.9 JTAG and trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

9.10 Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

9.11 LCD 3.2" module with SPI and 16-bit interface 1 . . . . . . . . . . . . . . . . . . . 55

10 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

11 Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

List of tables AN3311

4/58 Doc ID 18209 Rev 1

List of tables

Table 1. List of acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Table 2. Power related jumpers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Table 3. Boot related switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Table 4. Reset related jumper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Table 5. LCD module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Table 6. JTAG debugging connector CN13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Table 7. Daughterboard extension connector CN8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Table 8. Daughterboard extension connector CN9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Table 9. ZigBee adapter pin description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Table 10. Function description format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Table 11. vSmartPlugSamplingTask task. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Table 12. vGraphicLibraryTask task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Table 13. prvApplicationTask task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Table 14. prvSetupHardware function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Table 15. vBoardInit function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Table 16. Document revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

AN3311 List of figures

Doc ID 18209 Rev 1 5/58

List of figures

Figure 1. STM3210C-EVAL block scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Figure 2. Block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Figure 3. I/O expander hardware configuration on the STM3210C-EVAL . . . . . . . . . . . . . . . . . . . . . 10

Figure 4. STM3210C-EVAL demonstration board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Figure 5. Hardware block diagram - STM32 peripherals mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Figure 6. STM3210C-EVAL demonstration board layout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Figure 7. JTAG debugging connector CN13 viewed from above the PCB . . . . . . . . . . . . . . . . . . . . 18

Figure 8. Power supply connector CN18 viewed from the front. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Figure 9. In-home display firmware architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Figure 10. Application project files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Figure 11. IAR embedded workbench main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Figure 12. IAR embedded workbench debugger options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Figure 13. ZigBee dongle connection problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Figure 14. Main menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Figure 15. Searching plugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Figure 16. No plug detected. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Figure 17. Plugs detected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Figure 18. Label changing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Figure 19. TRIAC smartplug management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Figure 20. Relay smartplug management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Figure 21. Smartplug statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Figure 22. Energy consumption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Figure 23. Global energy consumption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Figure 24. Power consumption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Figure 25. Global power consumption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Figure 26. ZigBee and dual interface EEPROM adapter schematic for STM3210C-EVAL . . . . . . . . . 45

Figure 27. ZigBee and dual interface EEPROM adapter layout for STM3210C-EVAL . . . . . . . . . . . . 46

Figure 28. STM3210C main schematic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Figure 29. MCU schematic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Figure 30. LCD schematic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Figure 31. I/O expander schematic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Figure 32. I/O peripherals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Figure 33. Extension connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Figure 34. JTAG and trace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Figure 35. Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Figure 36. LCD 3.2" module with SPI and 16-bit interface 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Document and library rules AN3311

6/58 Doc ID 18209 Rev 1

1 Document and library rules

This document uses the conventions described in the sections below.

1.1 Acronyms

Table 1 lists the acronyms used in this document.

Table 1. List of acronyms

Acronym Meaning

API Application programming interface

HAL Hardware abstraction layer

MCU Microcontroller unit

I2C Inter-integrated circuit

SPI Serial to parallel interface

OOP Object oriented programming

AN3311 ZigBee smartplug

Doc ID 18209 Rev 1 7/58

2 ZigBee smartplug

2.1 Smartplug description

The smartplug coordinator is connected via an SPI to the STM3210C-EVAL through an “Ad-

Hoc” adapter.

In Figure 1 it is possible to take a quick look at the STM3210C-EVAL board and a smartplug

node block diagram.

Figure 1. STM3210C-EVAL block scheme

An adapter is connected to the extended connectors CN8 and CN9 on the STM3210C-

EVAL (for more detailed information please refer to the UM0600 user manual), it allows the

connection of a ZigBee smartplug coordinator and the I2C/RF dual interface EEPROM

M24LR64-r. The Gerber files of the adapter board are included in the setup package of this

project.

The ZigBee smartplug board can be used as a guide to build a home/building automation

subsystem for energy management. In a typical application, the board is plugged into an

electrical wall socket and supplies an electrical load, monitoring the energy consumption;

using several smartplugs it is possible to monitor and control the home/building energy

consumption socket by socket. The board includes the following functions, shown in the

block diagram of Figure 2:

●Energy measurement

●Load differential current

●Load driving by relay or TRIAC (dimming)

●ZigBee communication capability.

ZigBee smartplug AN3311

8/58 Doc ID 18209 Rev 1

Figure 2. Block diagram

The STEVAL-IHP001V3 is a smartplug board based on an STM32F10x microcontroller, a

SPZB260 ZigBee module, and an STPM01 energy metering IC.

It implements a ZigBee metering node which allows the final user to monitor and manage

energy consumption.

The board has been developed as a guide to build a home/building automation subsystem

for energy management. In a typical home system implementation, the board is plugged into

an electrical wall socket and supplies a home appliance or other generic electrical load.

The current, power, energy, and other information, related to the electrical load connected to

the smartplug board, can be displayed locally on an LCD screen, and are sent to a ZigBee

data concentrator through the home/building ZigBee network.

2.2 ZigBee module

ZigBee smartplug communication is based on the SPZB260 module with a DIL adapter. The

module is FCC compliant (FCC ID:S9NZB260A). The module is based on the SN260

ZigBee network processor which integrates a 2.4 GHz, IEEE 802.15.4 compliant

transceiver, as well as IEEE 802.15.4 PHY and MAC. The main features are:

●0dBm nominal TX output power

●-92dBm RX sensitivity

●+2dBm TX output power in boost mode

●RX filtering for co-existence with IEEE 802.11g and Bluetooth®devices.

For further details please refer to the SPZB260 module and the SN260 network processor

datasheet.

Note: For more information, see the UM0608 user manual, STEVAL-IHP001V3 schematics

diagram, and AN2993 application note.

AN3311 Multi-input embedded GUI library

Doc ID 18209 Rev 1 9/58

3 Multi-input embedded GUI library

3.1 Description

This solution enables users, comfortable with the use of standard microcontrollers, to create

higher-end “look and feel” human interfaces by replacing conventional electromechanical

switches with touch-sensing controls.

Users can combine touch-sensing functions using multiple configurations (touchscreen,

joystick, and keys) with traditional MCU features (communication, beeper, LCD control, etc.).

The E-multi-input graphic library is part of the application firmware.

The graphic objects are a set of controls that can be printed on the screen and associated to

an action when pressed.

The library has been developed and tested on an LCD panel of QWGA resolution (320x240)

which is the default, but the library is independent of the LCD resolution, although it has not

been tested with others.

The library supports touchscreen features and includes a low level driver which handles the

analog input (for 12-bit ADC), and a function for the touchscreen calibration based on an

algorithm that uses 5 points.

The multi-input embedded GUI firmware library is fully developed in 'ANSI-C' following an

OOP approach. This means that the final application uses instances of page and graphic

objects according to their public methods and properties. In the end, the PageObj is a

structure containing public properties (data fields) and methods (functions pointers). The

OOP encapsulation feature is assured. The library has been developed and tested on the

“STM3210C” STMicroelectronics demonstration board.

The library can be included in the final application as a library file (multi-input embedded

GUI library.a) and used as a black box through its exported public API, or can be included in

the final application as source files (.c and .h), if the user wants to debug the library itself, or

to change the HAL functions in order to port the library on a different LCD (in model and

resolution) from the one attached to STM3210C-EVAL.

For more information on the graphic library see the AN3128, rev. 2, application note.

The calibration process is part of the post-processing layer. The touchscreen must be

calibrated at first power-on and/or upon user request.

Once the calibration is done, final adjustments on future power-on of the board are not

necessary because the calibration parameters are saved on the Flash memory.

The touchscreen and the joystick are controlled by the STMPE811 devices.

The STMPE811 has a simple 2-wire I2C digital serial interface which allows the user to

access the data in the touchscreen controller register at any time. It communicates via the

serial interface with a master controller.

Figure 3 shows how the STM32F10xxx microcontroller (master device) must be connected

to the STMPE811 device.

Refer to the STMPE811 datasheet for more information on the register concerning the data

of the touched points on the touchscreen.

Multi-input embedded GUI library AN3311

10/58 Doc ID 18209 Rev 1

Figure 3. I/O expander hardware configuration on the STM3210C-EVAL

AM08449v1

Y- 1

INT

A0/Data

Out

VCC

Data

Data in

IN0 8

IN1 9

GND

IN2

IN3

X+

Vio

Y+

X-

STMPE

811

Y- 1

INT

A0/Data

Out

VCC

Data

Data in

IN0 8

IN1 9

GND

IN2

IN3

X+

Vio

Y+

X-

STMPE

811

R56

10K

+3V

+3V3

I2C

devic

device

address:0x8

address:0x8 2

I2C

devic

device

address:0x8

address:0x88

+3V

+3V3

+3V

+3V3

R57

100

100K

R58

100

100K

TouchScreen_X+

TouchScreen_X-

TouchScreen_Y+

TouchScreen_Y-

EXP

_IO2

EXP

_IO3

EXP

_IO4

EXP

_IO5

EXP

_IO6

EXP

_IO7

EXP

_IO8

EXP

_IO9

EXP

O10

EXP

O11

EXP

O12

EXP

_IO1

R160

10K

R15

R159 0

+3V

+3V3

R37

10K

R164

10K

+3V

+3V3

C89

100n

100nF

C90

100n

100nF

PB6

PB7

B14

IO_Expander_SCK

IO_Expander_SDA

IO_Expander_INT

SCLK

SDAT

SCLK

SDAT

Indice

Altri manuali ST Monitor

ST UM0767 Manuale utente

Manuali Monitor popolari di altre marche

Linear Acoustic

Linear Acoustic LQ-1000 Manuale utente

AOC

AOC I2579V Manuale utente

Gateway

Gateway FPD1520 Manuale utente

Furuno

Furuno Mu 120c Manuale utente

Asus

Asus VB171D - 17" LCD Monitor Manuale utente

Dell

Dell S2230MX Istruzioni utente

Philips

Philips 107C64 Manuale utente

Dell

Dell S2409WFP Manuale utente

EverFocus

EverFocus EN-7517E Manuale utente

Panasonic

Panasonic TH152UX1 - 152" PLASMA TV Manuale utente

Dell

Dell Precision 7680 Manuale di istruzioni

LG 50PM1M - - 50" Plasma Panel Manuale utente

Bosch

Bosch DDU 9 Manuale utente

Acer

Acer A231HL Manuale utente

Philips

Philips 86BDL4152T Manuale utente

NEC

NEC AccuSync LCD5V Manuale utente

Emay

Emay SleepO2 Manuale utente

IBM

IBM 6360 Istruzioni per l'installazione