Demo Kit Manual DN[Document ID] GP30 Reference Board GP30-DEV-KIT ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 1 Document Feedback GP30 Reference Board Content Guide 1 Introduction .......................................................................................................................... 3 2 Quick Start Guide ................................................................................................................. 4 2.1 Install the Software............................................................................................................... 4 2.2 Install the Hardware: ............................................................................................................ 4 2.3 Quick Start for Initial Measurements .................................................................................... 4 3 Hardware Description........................................................................................................... 6 3.1 Introduction .......................................................................................................................... 6 3.2 Communication Interface ..................................................................................................... 6 4 Software Description ............................................................................................................ 7 4.1 Measurement ....................................................................................................................... 7 4.1.1 First step with measurement control elements .................................................................... 7 4.1.2 Time of Flight Measurement Results ................................................................................... 8 4.1.3 2-Wire Temperature Measurement Results ......................................................................... 9 4.2 Ultrasonic Measurement Control ....................................................................................... 10 4.3 Temperature Measurement Control ................................................................................... 11 4.4 General Control .................................................................................................................. 12 4.5 Interfaces ........................................................................................................................... 13 4.6 Interrupt & Error Handling .................................................................................................. 14 5 Software Menu ................................................................................................................... 15 5.1 File...................................................................................................................................... 15 5.2 Tools .................................................................................................................................. 15 5.3 Firmware ............................................................................................................................ 18 5.4 Help .................................................................................................................................... 21 6 Schematics, Layers and BOM ........................................................................................... 22 7 Ordering & Contact Information ......................................................................................... 25 8 Copyrights & Disclaimer ..................................................................................................... 26 9 Revision Information .......................................................................................................... 27 ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 2 Document Feedback GP30 Reference Board 1 Introduction The GP30-DEV-KIT is a platform for a quick and easy start-up and evaluation of the TDC-GP30 ultrasonic flow converter (UFC). It supports the QFN32 package, which offers the functionality need for standard water and heat meters. The development kit offers user-friendly configuration and extensive testing of the TDC-GP30, but also the complete assembler environment for programming the device. For a proper use of the evaluation system, we strongly recommend to refer to the latest TDC-GP30 datasheets. Figure 1: Kit Content 3 1 2 Pos. Item Comment 1 PICOPROG V3.0 Programmer and interface 2 GP30-DEMO MODULE Based on TDC-GP30 in QFN32 package 3 USB cable Connects PicoProg V3.0 to PC Please download the latest software for the kit from http://www.acam.de/download-center/ultrasonicflowconverter/ ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 3 Document Feedback GP30 Reference Board 2 Quick Start Guide This section describes how to quickly set up the GP30-DEV-KIT, establish basic operation and make measurements. 2.1 Install the Software It is crucial to install the software before connecting the evaluation kit to your computer. A default driver loading of your OS may interfere with correct installation. 2.2 2.3 Download the latest zipped software installation package to the desired directory. Unzip the package to the desired directory. Open "setup.exe" from the unzipped directory. Follow the instructions on the screen. Install the Hardware: Make sure software is installed correctly before proceeding with this step! Connect your computer with the PicoProg V3.0 using USB cable. Connect PicoProg V3.0 and the evaluation kit motherboard using the DB15 interfaces The green LED on the evaluation kit should be on. Connect your spool piece to US_UP and US_DOWN Quick Start for Initial Measurements From the "Start" menu, go to "All Programs" and then to the "acam" directory. Double click the "GP30_v1_5_3" icon (or newer versions, if available) to begin execution of the evaluation software. The following screen should appear: Figure 2: Measurement Page ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 4 Document Feedback GP30 Reference Board 1. Click the "Verify Interface" button to confirm communication between PicoProg V3.0 and TDC-GP30 is working. Both fields, "Pico Prog FW version " and "Comm. With GP30 OK?" should become green. 2. Next, open our configuration GP30Y_config_default_A1.A2.11.03 and download it into the chip, pressing "Write Config". 3. Connect your spool piece to pins US_UP and US_DOWN. 4. Press "Start Measurement" to begin measuring. At this point, after successful completion of the above steps, a basic operation of the EVA kit should be possible. The following sections provide a detailed description of the hardware and software for advanced operation. Figure 3: PICOPROG registry If PICOPROG is not displayed correctly then go to the drivers folder , e.g. C:\Program Files (x86)\acam-messelectronic\GP30\drivers\Win7_8 and install the driver for your operating system manually. In case of an upgrade of the software to a newer version please make sure that the software uses the latest driver. For manual installation open the USB communications window and check the firmware version of the PICOPROG. It should be version PicoProg_GP30_v21.hex or higher: Figure 4: PICOPROG manual installation ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 5 Document Feedback GP30 Reference Board 3 Hardware Description 3.1 Introduction The GP30-EVA MODULE board, shown in figure 3, s the front-end for a water or heat meter. The transducers and temperature sensors can be connected directly to this board. It comes with a 32,768 kHz quartz (X2) and a 4 MHz ceramic oscillator (X1). All ports of TDC-GP30 are available. Additional patch fields allow an easy extension with additional circuits. Those can be amplifiers or analog switches for operation in gas meter mode. Figure 5: GP30-DEV MODULE Piezo D U PT1000 C H INTN MISO / TXD SCK / RXD MOSI SSN VCC_LEVEL Pulse Interface 3.2 GND VCC Communication Interface The PICOPROG device is a USB-to-SPI converter box that interfaces all UFC evaluation systems. With version 3.0, the PICOPROG also supports the USB-to-UART conversion of TDC-GP30. The PICOPROG is registered by the operating system initially as "picoprog v3.0 unprogrammed". As soon as the GP30 evaluation software starts, a special firmware is written into the PICOPROG to handle the SPI or UART communication with the TDC-GP30. The PICOPROG is now listed as "UNIPRO" in the device manager. For SPI communication only, PICOPROG version 2.0 is sufficient. Figure 4 shows the connection between the PICOPROG and the GP30 board. The flat connector includes the power lines and the SPI or UART communication lines. On the demo board the communication interface is initially selected to SPI (by solder bridge LJ2). VCC_LEVEL is the voltage feedback for the PICOPROG level shifters. Figure 6: SUBD15 Connector 5 15 10 1 13 8 12 11 6 14 INTN MISO / TXD SCK / RXD MOSI SSN VCC_LEVEL 3 15 GND VCC GP30 DEMO 11 6 ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 6 Document Feedback GP30 Reference Board 4 4.1 Software Description Measurement When started, the software comes up with the main window, showing the "Measurements" tab. Figure 7 Main window 4.1.1 First step with measurement control elements A good first step is to load a working configuration and make measurements in frontend mode (without using the internal 32-Bit P). ams provides a sample configuration file named GP30Y_config_default_A1.A2.11.03 which typically works well with DN20 spool pieces. Load configuration file: File menu Open Config choose appropriate configuration file Next step: Press "System Reset" button. Now the PicoProg FW version field should get green and the appropriate version should be displayed (20 or higher). Further, "Comm GP30 OK?" should get green to show that communication with TDC-GP30 works. Next step: If watchdog is not disabled by "System Reset" button press "Disable Watchdog" button. Next step: Press "Write Config" button to download the configuration settings into TDCX-GP30. Next step: Press "Start measurement" button. Now the chip starts to measure and the software displays the results in the table "Time of Flight Measurements". The user can now modify the configuration to fit it to his needs. Having done this, the user can store his own configuration files. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 7 Document Feedback GP30 Reference Board 4.1.2 Time of Flight Measurement Results GP30 stores the first 8 hits of every TOF direction separately and also the sum of all measured hits. These 9 results are displayed for both directions, as we call them up and down. The evaluation software additionally calculates the difference between up and down stream, DIFF-TOF. In total, all 27 results are displayed in the "Results" column. In the "Average" column the user can set the sample size for the averaging (<1000). The software calculates the rolling average of the results accordingly. In "Std. Dev." column the standard deviation, calculated over a variable sample size, is displayed. The number of samples can be chosen (e.g. 100). The same is done with the amplitude values of the receiving signals and the pulse width ratio between first hit and start hit. The values for both directions are displayed. Note: The high speed calibration is by default off. This is more convenient when comparing measurement data. But when collecting data for calibration it is strongly recommended to have this active. Figure 8 HS Clock calibration A graph to display TOF measurement results opens in a separate window by pressing "TOF Graph" button It is possible to activate up to four plots. Each plot has various selections, e.g. TOF1UP, TOF2UP etc.. Always averaged values are displayed. Figure 9 TOF Graph The measurement data can be exported into text files, either the main values for calibration only, or the full data. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 8 Document Feedback GP30 Reference Board Figure 10 Data export for calibration Figure 11 Dat export complete 4.1.3 2-Wire Temperature Measurement Results A graph to display temperature measurement results opens in a separate window by "Temperature Graph" button, similar to TOF graph. Figure 12 ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 9 Document Feedback GP30 Reference Board 4.2 Ultrasonic Measurement Control In this tab the user makes all settings for an appropriate ultrasonic measurement. They group as follows: Time of Flight Sequence Control Time of Flight Hit Control Amplitude Measurement Control Transducer Interface Options Figure 13 The meanings of the various settings are displayed in clear text. For more details about the register settings please refer to the GP30 manual. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 10 Document Feedback GP30 Reference Board 4.3 Temperature Measurement Control All settings for an appropriate temperature measurement are done in this tab, which are grouped as follows: Sequence Control Measurement Control Temperature Measurement Cycle Time Figure 14 The meanings of the various settings are displayed in clear text. For more details about the register settings please refer to the GP30 manual. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 11 Document Feedback GP30 Reference Board 4.4 General Control The "General Control" tab covers configuration settings for Task sequencer High speed clock control Voltage measurement CPU handling Timer Settings Figure 15 The meanings of the various settings are displayed in clear text. For more details about the register settings please refer to the GP30 manual. Firmware In case the TDC-GP30 has firmware, setting flag "Enable post processing" turns on the CPU (flow meter mode). Having this not set, the GP30 runs as front-end in time conversion mode. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 12 Document Feedback GP30 Reference Board 4.5 Interfaces The "Interfaces" tab covers configuration settings for Pulse interface including test option EEPROM interface GPIO Control UART remote interface. Figure 16 The meanings of the various settings are displayed in clear text. For more details about the register settings please refer to the GP30 manual. Pulse Interface The pulse interface needs an appropriate firmware in the chip. This settings in the evaluation software only generate an artificial pulse to test the general functionality. But it is not related to any measurement. UART The UART is not supported in this software version. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 13 Document Feedback GP30 Reference Board 4.6 Interrupt & Error Handling On this tab error indicators and interrupt sources for remote interface can be selected. Figure 17 The meanings of the various settings are displayed in clear text. For more details about the register settings please refer to the GP30 manual. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 14 Document Feedback GP30 Reference Board 5 Software Menu Beside main window, the software menu allows the opening of other windows. There are some menu items which are redundant to available buttons of main window. 5.1 File Open Config This dialog box allows the path selection of a configuration file, covering the register settings, necessary for a proper configuration of the GP30. After opening this file, the control settings are updated in the GUI. Save Config This menu item allows the saving of the current GUI control settings into a configuration file Close Close all open windows of the GP30 Evaluation software. 5.2 Tools Run Measurement Same function as "Start/Stop Measurement" button in "Measurement" tab of main window. TOF Graph Same function as "Open TOF Graph" button in "Measurement" tab of main window. Temperature Graph Same function as "Open Graph" button for temperature measurement in "Measurement" tab of main window. RAM Memory Figure 18 Opens a window which allows single write and read accesses to random access area for addresses 0x000 - 0x0FF. The random access area from 0x100 - 0x17F, containing the firmware data, can be accessed separately by "Firmware Download" window. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 15 Document Feedback GP30 Reference Board Registers Figure 19 Opens a window which shows the registers important for a proper configuration setting of the GP30. In the left column, the register contents correspond to the settings done in tabs of GUI main window. If the button "Read GP30 Register Settings" is pressed, the configuration settings located in GP30 registers are displayed in the right column,. By pressing "Read and Transfer" button, the register settings in the tabs of main window and in the left column of this window are updated with the register settings from right column. Remote Commands This window summarizes some additional commands which can be executed via remote interface. System Reset: Executes a complete system reset of GP30. Same function as "System Reset" button in "Measurement" tab of main window. System Init: Same function as "System Reset" without clearing the configuration (CR_...) and the system handling (SHR_...) register. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 16 Document Feedback GP30 Reference Board Figure 20 CPU Init: Clears the CPU block in GP30 SV Init: Clears the supervisor block in GP30 FEP Init: Clears the frontend processing block in GP30 Request/Release Bus Master: Allows the request of the bus master in GP30, e.g. if the random access bus is blocked by a deadlock, caused by an improper firmware download. Measure Cycle Timer Off/On: Stop & start of the measure cycle timer. Clear Interrupt Flags: Clears all bits in SRR_IRQ_FLAG register Communication Request: Allows an asynchronous demand by remote controller to get an interrupt by GP30, signalizing the time for remote communication General Purpose Request: Allows an asynchronous request by remote controller to initiate a general purpose handling in in firmware of integrated GP30 CPU. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 17 Document Feedback GP30 Reference Board 5.3 Firmware Assembler The TDC-GP30 assembler is integrated into the GP30 evaluation software. It is opened in the Firmware menu of the main program: Figure 21 The following window comes up: Figure 22 This is a comfortable editor with syntax highlighting, search and replace, copy and paste functions. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 18 Document Feedback GP30 Reference Board Under menu item "Assembler" the user finds the compile and download options. The download option effects, that "Firmware Download" window is opened (see also below). Whether the call of these functions was successful or not is indicated by the messages at the bottom of the assembler window. Download This window allows the download of the firmware which is typically handeld by 2 files, one for the "Firmware User Code" and one for the "Firmware Data". Figure 23 With "Check Status Flag", the watchdog and the lock state of the GP30 can be checked. Please make sure that the watchdog is disabled before starting a download or other transactions in this window. In the "Firmware User Code" section, a firmware user code file (*.hex), which is typically generated by the assembler tool and intended for the user part of 4kx8 Program NVRAM, can be loaded by pressing "Open File". In the "Firmware Data" section, a firmware data file (*.dat), which is intended for the 128x32 Data NVRAM, can be loaded by pressing "Open File". This section also contains some additional transfer options from GUI to FW Data 2 fields and from GP30 back to FW Data 2 fields. By pressing "Download FW Code & Data" both files are stored in the corresponding NVRAMs. This action takes a few seconds. After the download, both files are located in the volatile as well in the non-volatile part of the appropriate NVRAMs. The download can be combined with a lock option of the firmware. When pressing "Download FW Code & Data" a possible auto running firmware program is stopped. If a new proper auto running firmware program is downloaded, this firmware can be started again by performing a system reset. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 19 Document Feedback GP30 Reference Board The last 4 addresses of FW Data 2 section contains the fields for the checksums which are stored to GP30 when downloading firmware to GP30. These fields are directly updated, when firmware files are loaded or contents of firmware data fields are changed. If pressing the "Verify FW" button after downloading, the content of the NVRAMs can be compared with the given files by their checksums. The software calculates the checksum of the given files and reads the calculated checksums of GP30 as well as the stored checksums at the end of FWD2 section. Then the checksums of every section are compared to each other. In case of a successful programming all indicators have to be green. In the "Firmware Acam Code" section, the checksums for the firmware acam code are also checked and displayed after a "Verify FW". The firmware acam code cannot be modified by user. Therefore a checksum calculated by software filed is missing in this section. A lock state of GP30 or a hang-up, caused by a faulty firmware user code can be dissolved by pressing "Erase FW" button. After that, a new firmware (user code & data) need to be downloaded again. CPU Values This tab is only for customer who uses the acam firmware for flow calculation. It reads out some important CPU values like water temperature, flow, velocity, etc. To enable the readout the "Read calculated values" checkbox has to be set. Figure 24 Set for using on-chip firmware ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 20 Document Feedback GP30 Reference Board 5.4 Help When moving the cursor over the values in tabs of main window, the parameter name (used in the GP30 manual) is displayed. By right-click and selection of "Description and Tip", a window is opened showing additional description of the value. Help Contents Not supported in this software revision USB Communication As described in chapter "Software Installation". About Displays software version number together with general information about software and acam. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 21 Document Feedback GP30 Reference Board 6 Schematics, Layers and BOM Figure 25: GP30-DEMO MODULE Schematics ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 22 Document Feedback GP30 Reference Board Figure 26: GP30-DEMO MODULE Layout (200% size) Top layer Bottom layer Assembly ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 23 Document Feedback GP30 Reference Board Figure 27: Bill of Materials for GP30-DEMO MODULE Item Qty Reference Part Name PART DESC TYPE 1 1 U1 GP30 QFN32 TDC GP30 U2 3.0 V XC6206 Voltage Regulator 2 3 1 X1 4 MHz CSTR_G Ceramic Resonator 4 1 X2 32.768 kHz KX-327XS Quartz Crystal 5 1 C1 4u7 C805 Chip Capacitor 6 2 C2, C3 100u F95_P Solid Tantalum 7 1 C4 100n CC603 Chip Capacitor 8 1 C5 680n C805 Chip Capacitor 9 1 C6 nc C805 Chip Capacitor 10 1 C8 100n C1206 Chip Capacitor 11 2 C10, C11 10p CC603 Chip Capacitor 12 1 R1 47R R805 Chip Resistor 13 2 R2, R3 4R7 R603 Chip Resistor 14 1 R4 3M3 R603 Chip Resistor 15 1 R8 10M R805 Chip Resistor 16 1 R9 1k R805 Chip Resistor 17 1 R10 560k R805 Chip Resistor 18 1 J13 2 pol. ST/254_2 Connector for power supply (combined with J22) 19 1 J22 7 pol. ST/254_7_1R Connector for SPI interface (combined with J13) 20 1 J20 2 pol. ST/254_2 Jumper for current measurement of Vcc 21 1 LJ2 3 pol. ams Demo Kit Manual [v1-00] 2016-Aug-08 Solder bridge to select between SPI & UART Page 24 Document Feedback GP30 Reference Board 7 Ordering & Contact Information Ordering Code Part Number Description GP30-DEV-KIT 220260003 GP30 Demo Kit for QFN32 version including PICOPROG and cables GP30-DEMO-KIT-F01 220260006 GP30 Demo Kit with firmware for QFN32 version including PICOPROG and cables GP30-DEMO MODULE 220260002 GP30 demo board for QFN32 version GP30-DEV-F01 MODULE 220260005 GP30 demo board with firmware for QFN32 version Buy our products or get free samples online at: www.ams.com/ICdirect Technical Support is available at: www.ams.com/Technical-Support Provide feedback about this document at: www.ams.com/Document-Feedback For further information and requests, e-mail us at: ams_sales@ams.com For sales offices, distributors and representatives, please visit: www.ams.com/contact Headquarters ams AG Tobelbaderstrasse 30 8141 Premstaetten Austria, Europe Tel: +43 (0) 3136 500 0 Website: www.ams.com ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 25 Document Feedback GP30 Reference Board 8 Copyrights & Disclaimer Copyright ams AG, Tobelbader Strasse 30, 8141 Premstaetten, Austria-Europe. Trademarks Registered. All rights reserved. The material herein may not be reproduced, adapted, merged, translated, stored, or used without the prior written consent of the copyright owner. Demo Kits, Evaluation Kits and Reference Designs are provided to recipient on an "as is" basis for demonstration and evaluation purposes only and are not considered to be finished end-products intended and fit for general consumer use, commercial applications and applications with special requirements such as but not limited to medical equipment or automotive applications. Demo Kits, Evaluation Kits and Reference Designs have not been tested for compliance with electromagnetic compatibility (EMC) standards and directives, unless otherwise specified. Demo Kits, Evaluation Kits and Reference Designs shall be used by qualified personnel only. ams AG reserves the right to change functionality and price of Demo Kits, Evaluation Kits and Reference Designs at any time and without notice. Any express or implied warranties, including, but not limited to the implied warranties of merchantability and fitness for a particular purpose are disclaimed. Any claims and demands and any direct, indirect, incidental, special, exemplary or consequential damages arising from the inadequacy of the provided Demo Kits, Evaluation Kits and Reference Designs or incurred losses of any kind (e.g. loss of use, data or profits or business interruption however caused) as a consequence of their use are excluded. ams AG shall not be liable to recipient or any third party for any damages, including but not limited to personal injury, property damage, loss of profits, loss of use, interruption of business or indirect, special, incidental or consequential damages, of any kind, in connection with or arising out of the furnishing, performance or use of the technical data herein. No obligation or liability to recipient or any third party shall arise or flow out of ams AG rendering of technical or other services. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 26 Document Feedback GP30 Reference Board 9 Revision Information Changes from previous version to current revision 1-00 (2016-Aug-08) Page New Layout Note: Page numbers for the previous version may differ from page numbers in the current revision. Correction of typographical errors is not explicitly mentioned. ams Demo Kit Manual [v1-00] 2016-Aug-08 Page 27 Document Feedback