AN11211 Quick Start Up Guide RC663 Blueboard Rev. 1.9 — 1 December 2014 226219 Application note COMPANY PUBLIC Document information Info Content Keywords RC663, Blueboard, LPCXpresso, MCU, Code Red, eclipse, LPC1769, LPC1227, NFC Reader Library, CLEV663B Abstract This application note is related to the installation procedures of the RC663 Blueboard. It describes the actions to be done to become acquainted with the demo reader.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Revision history Rev Date Description 1.9 20141201 Added a note about RAM limitation of LPC1227 in section 5.3 1.8 20140721 Updates in the description regarding the TUSA board. 1.7 20140519 Removed the note about the version of the LPCXpresso IDE. Some small corrections. Changed the description and pictures of the projects Polling and, Classic Changed the description of the P2P description due to a software update.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 1. Introduction This application note gives a detailed overview of the hardware for working with the RC663 contactless reader - we use the LPCXpresso LPC1769 and the Blueboard (Chapter 2) – the installation procedures of the Development Environment (Chapter 4.1) and the handling of the reader projects using the NFC Reader Library (Chapter 4.2). Detailed information on the RC663 in connection with the NFC Reader Library can be obtained at [1].
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 2. Hardware overview of the Demo Reader The demo reader is made up of 2 separate boards: • A CLEV663B demo board (called Blueboard) provided by NXP. This board has connectors which are designed to exactly fit the ones of the companion, the LPCXpresso LPC 1227 and the LPCXpresso LPC 1769 development boards.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 2. Picture of solder bridges 2.1.1 Derivates of the RC663 demo board (Blueboard) To meet the interests of the market, we also offer Blueboards with a slightly modified RC663 on it. The four versions are as follows: • RC663 Blueboard This Blueboard with the RC663 offers the full functionality. It supports the modes described above. In the following text we always relate to the RC663 Blueboard. If not, this will be indicated by a note.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide derivate (except for the one described above). If one, for example, executes code for ICODE tags and has a MFRC631 Blueboard, this code will have no effect at all. It will behave as if there was no tag in the field. 2.2 CE certification of the Blueboard The current version of the Blueboard (v.3.0) is CE (European Conformity) compliant. 2.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 4. Multipoint Connectors we used One may buy these connectors at any electronic store. Here are some examples [5]. After soldering the connectors connect the boards as shown on the following figures. Fig 5. LPCXpresso with the Multipoint Connectors Now the hardware is ready for use. Please connect the LPCXpresso board to the Blueboard. Fig 6.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 7. Picture of RC663 demo board with the connectors joined alternatively Fig 8. LPCXpresso with the Multipoint Connectors used in the alternative way Fig 9. Connect the two boards the alternative way 2.6 Interesting points of measurement Although the Blueboard is not designed to do extended measurements, there are some points of measurement one might be interested in.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 2.6.1 RXP - receiver input pin for the received RF signal RC663 – Pin 12 Fig 10. Pin RXP 2.6.2 RXN - receiver input pin for the received RF signal RC663 – Pin 13 Fig 11. Pin RXN AN11211 Application note COMPANY PUBLIC All information provided in this document is subject to legal disclaimers. Rev. 1.9 — 1 December 2014 226219 © NXP Semiconductors N.V. 2014. All rights reserved.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 2.6.3 TVDD - transmitter voltage supply RC663 – Pin 18 Fig 12. Pin TVDD 2.7 Preparing the Blueboard for the use with SPI or I2C The Blueboard is generally delivered in I²C configuration, for this reason one only needs to change the configuration if the use of the board in SPI configuration is desired. From Blueboard version 3.0 on the layout slightly changed. So we provide two different descriptions for changing the interface between I²C to SPI.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 13. Blueboard in SPI configuration To use the Blueboard in I²C configuration with the provided software projects, one has to execute two small adaptations in the code, which are described in section 7.6. 2.7.2 Blueboard version 3.0 and above These boards are delivered in SPI configuration. To change that to I²C, one needs to change six solder bridges. 1. Open the bridge at R15 2. Open the bridge at R21 3. Open the bridge at R26 4.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 2.8 Other supported system architectures The projects described in this guide are also available on Linux. The projects are preconfigured for the use on the Raspberry Pi with the Raspbian image. The SPI interface is used for the communication between the application and the NFC controller. The software and the start guide can be downloaded at the product page of the EXPLORE-NFC [13].
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 4. Managing the Demo Reader project with LPCXpresso IDE The demo reader project is delivered in a zip package. It can be extracted, edited, compiled and linked with LPCXpresso IDE. LPCXpresso is a new, low-cost development platform available at NXP. It supports NXP's ARM-based LPC microcontrollers. The platform is comprised of a simplified Eclipse-based IDE and low-cost target boards which include an attached JTAG debugger.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 17. Windows Security dialog After the setup wizard has finished one can launch the newly installed IDE. Fig 18. LPCXpresso IDE Directly after the first start of the Eclipse IDE one will see an info dialogue that this is only an unregistered copy of LPCXpresso IDE. Just confirm the dialog and follow the instructions on the Welcome Screen to get a registered version without the debug limit of 8k.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 19. Product activation Fig 20. Product activation If one doesn’t already have an account at Code Red, please sign up to get an activation code. The code will be sent to the provided e-mail address. AN11211 Application note COMPANY PUBLIC All information provided in this document is subject to legal disclaimers. Rev. 1.9 — 1 December 2014 226219 © NXP Semiconductors N.V. 2014. All rights reserved.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 21. Product activation Once the activation code arrives please open the activation window by pointing to Help Product activation Enter Activation code, and enter the code. The success of the product activation will be confirmed by an info dialogue. 4.2 Extraction of the demo reader project All demo reader projects are divided into three sub projects.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 22. Importing a project into the LPCXpresso IDE In the Quick Panel on the left hand side, choose “Import projects(s)”. Fig 23. Importing a project into the LPCXpresso IDE Browse the desired package and click “Next”. AN11211 Application note COMPANY PUBLIC All information provided in this document is subject to legal disclaimers. Rev. 1.9 — 1 December 2014 226219 © NXP Semiconductors N.V. 2014. All rights reserved.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 24. Importing a project into the LPCXpresso IDE For a working demo project you need to import at least three sub projects. One application project (Classic or Polling), the NFC Reader Library and one MCU library (LPC1227 or LPC1769). When the import process has finished one can start browsing the code. Before one can run the project, the LPCXpresso board containing the RC663 Blueboard needs to be connected to the computer.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 25. Run the project Choose the project that contains the user application and click the Debug Button on the left hand side as shown in the example picture. Make sure, the name of the build configuration as well as the selected MCU matches the name of the used microcontroller. See sections 7.2 and 7.3 for further information. Fig 26.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide After the build process one can see the size of the image in the console window. Fig 27. Run the project After the software upload, the execution of the project starts immediately, but might halt at the initial breakpoint. To resume execution, just click onto the resume button. Fig 28. Debugging controls Fig 29. Run the project AN11211 Application note COMPANY PUBLIC All information provided in this document is subject to legal disclaimers.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide In the console window at the bottom one will see the debug output of the execution. After the execution has reached the end of the main function please click the Terminate button to stop the execution. Otherwise one won’t be able to rerun the project. One can now do the following with the buttons near the top of the “Debug” view: Run the program. Step over C/C++ line. Step into a function. Stop the debugger. Pause execution of the running program.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 5. Associated Projects All example projects are available for download at the product page of the CLEV663B [8] in the documents section and are being distributed in one single file. All projects are packaged into a single installer file. After downloading the zip file please extract it and run the installer. The installer just copies everything you need to get started to your hard disk.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 6. Other supported hardware by the projects It’s also possible to use the provided projects with the TUSA Board (Manufacturer: Silica). This board is a 3d party alternative to the CLEV663B Blueboard. It also uses the RC663 reader IC. Fig 31. TUSA Board To get this board to work with the LPC1227 or LPC1769 controller boards you will have to do a small hardware modification.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 33. Combine the TUSA Board and the LPCXpresso Board For information about the needed changes in the projects to work with the TUSA board, please see section 7.9. AN11211 Application note COMPANY PUBLIC All information provided in this document is subject to legal disclaimers. Rev. 1.9 — 1 December 2014 226219 © NXP Semiconductors N.V. 2014. All rights reserved.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 7. Supplementary Notes 7.1 Software architecture The software of the reference reader is based on the NFC Reader Library [6]. It intends to be simple, modular, easily readable and quickly portable by all the customers. This philosophy is reflected in its architecture which is divided into 4 layers: • BAL (Bus Abstraction Layer), • HAL (Hardware Abstraction Layer) • PAL (Protocol Abstraction Layer) • AL (Abstraction Layer) Fig 34.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide physical media I2C/SPI can be easily designed. These drivers are specific for the LPC1XXX family and therefore cannot be ported to other microcontrollers. 7.1.2 Hardware abstraction layer This layer offers functions to abstract the hardware parts of the transceiver CLRC663. 7.1.3 Protocol abstraction layer Every PAL function is a low level function realizing a single functionality.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide • ReleaseLPC1769 The build configuration can be selected as follows: • Click on the project in the project window of the LPCXpresso IDE, • Right click of the mouse Select Build Configuration, • Set active DebugLPC1227 build (or ReleaseLPC1227 build) for LPC 1227. Fig 35. Select the build configuration Note: When switching from one MCU to another, please take care to also switch to the correct MCU setting within the LPCXpresso IDE.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 36. Selection of the LPC1769 MCU 7.4 Level of compiler optimization When the code size at the current compiler level overloads the FLASH size of the target board (128K for the ARM-based microcontroller LPC1227), a higher compiler optimization level can be selected to reduce the code size of the project.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 37. Select the level of optimization 7.4.1 Optimization issues When optimization is enabled, it will reorder code. What this means is that the code from multiple C lines will be intermingled. In addition, assignments and initializations might be pulled out of loops so they are only executed once. Changes like these will make the code confusing to debug.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide a. Uncomment the line #define I2C_USED. b. Comment the line #define SPI_USED. 7.7 Removing the initial breakpoint on debug startup When the debugger starts, it automatically sets a breakpoint at the first statement in the main() function. One can remove this breakpoint as follows: 1. Right click on the project and choose Launch Configurations Edit current… Fig 38. Open Current Launch Configuration 1. Choose the Debug configuration 2.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 7.8 Using the Blueboard with the Raspberry Pi Detailed instructions about how to run the NFC Reader Library on the Raspberry Pi can be found in the Start Guide linked at the product page of the EXPLORE-NFC [13]. This sub chapter only describes some information that is not included in the start guide of the EXPLORE-NFC. 7.8.1 Preparing the hardware a. Connector for the Blueboard b. Connector for the Raspberry Pi Fig 39. BluePi adaptor 1.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide Fig 40. CLEV663B Blueboard connected to the Raspberry Pi 7.8.2 Preparing the software In order to use the provided software with the CLEV663B there need to be two lines changed within the source code. 1. Open the file ../card_polling/source/NXP-Reader-Library/types/ph_NxpBuild.h 2. Comment #define NXPBUILD__PHHAL_HW_RC523 3. Uncomment #define NXPBUILD__PHHAL_HW_RC663 7.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 8. References [1] RC663 and NFC Reader Library http://www.nxp.com/documents/application_note/AN11021.pdf [2] LPCXpresso website http://www.lpcware.com/lpcxpresso/download [3] RC663 data sheet http://www.nxp.com/documents/data_sheet/CLRC663.pdf [4] LPC176x/5x User manual http://www.nxp.com/documents/user_manual/UM10360.pdf [5] Multipoint Connectors we used: Grid Dimension: 2.54mm, at least 27 pins http://www.conrad.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 9. Legal information 9.1 Definitions Draft — The document is a draft version only. The content is still under internal review and subject to formal approval, which may result in modifications or additions. NXP Semiconductors does not give any representations or warranties as to the accuracy or completeness of information included herein and shall have no liability for the consequences of use of such information. 9.
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 10. List of figures Fig 1. Fig 2. Fig 3. Fig 4. Fig 5. Fig 6. Fig 7. Fig 8. Fig 9. Fig 10. Fig 11. Fig 12. Fig 13. Fig 14. Fig 15. Fig 16. Fig 17. Fig 18. Fig 19. Picture of RC663 demo board........................... 4 Picture of solder bridges ................................... 5 Picture of LPCXpresso LPC1769 development board ................................................................. 6 Multipoint Connectors we used .....................
AN11211 NXP Semiconductors Blueboard Quick Startup Guide 11. Contents 1. 2. 2.1 2.1.1 2.2 2.3 2.4 2.5 2.6 2.6.1 2.6.2 2.6.3 2.7 2.7.1 2.7.2 2.8 3. 4. 4.1 4.2 4.3 5. 5.1 5.2 5.3 6. 7. 7.1 7.1.1 7.1.2 7.1.3 7.1.4 7.2 7.3 7.4 7.4.1 7.5 7.6 Introduction ......................................................... 3 Hardware overview of the Demo Reader ........... 4 RC663 demo board (Blueboard) ........................ 4 Derivates of the RC663 demo board (Blueboard) .............................................
