Cypress ModusToolbox Manual

Wiced manufacturing bluetooth test tool

Advertisement

ModusToolbox™
WICED Manufacturing Bluetooth Test Tool
Document Number: 002-14799 Rev. *E
Cypress Semiconductor
198 Champion Court
San Jose, CA 95134-1709
www.cypress.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ModusToolbox and is the answer not in the manual?

Questions and answers

Summary of Contents for Cypress ModusToolbox

  • Page 1 ModusToolbox™ WICED Manufacturing Bluetooth Test Tool Document Number: 002-14799 Rev. *E Cypress Semiconductor 198 Champion Court San Jose, CA 95134-1709 www.cypress.com...
  • Page 2: Table Of Contents

    Contents Introduction ..................................3 Setup ....................................4 Device Configuration ..............................4 Environment Variables ............................... 4 Reset Test ..................................5 reset ................................... 5 reset_highspeed ................................ 5 LE Receiver Test ................................6 LE Transmitter Test ................................7 LE Test End ..................................8 Continuous Transmit Test ..............................
  • Page 3: Introduction

    Introduction The WICED Manufacturing Bluetooth test tool (WMBT) is used to test and verify the RF performance of the Cypress SoC Bluetooth BR/EDR/LE devices. For LE tests, standard procedures from the Bluetooth Core Specification [1] are utilized. For BR/EDR tests a set of vendor specific commands are introduced and described in this document. Each test sends a Host Controller Interface (HCI) or WICED HCI command to the device and then waits for an HCI Command Complete event from the device.
  • Page 4: Setup

    Device Configuration The Cypress Bluetooth device to be tested must expose an HCI UART and that this UART can be connected to a COM port or to a Serial to USB device of a PC. The HCI UART supports HCI Commands and Events described in this document.
  • Page 5: Reset Test

    Description: Sends an HCI Reset command at 115.2 Kbps to the device and processes the HCI Command Complete event (See Reference [1] [Vol 2, Part E], Section 7.3.2 for details). Usage: wmbt reset COMx Example: <ModusToolbox>\tools\wiced-tools-1.0\BT\wmbt\bin> wmbt reset COM23 Opened COM23 at speed: 115200 Sending HCI Command: 0000 < 01 03 0C 00 >...
  • Page 6: Le Receiver Test

    Usage: wmbt le_receiver_test COMx <rx_frequency> Where: ▪ rx_frequency = (2402 - 2480) receive frequency, in MHz The example below starts the LE receiver test on Channel 2 (2406 MHz): <ModusToolbox>\tools\wiced-tools-1.0\BT\wmbt\bin> wmbt le_receiver_test COM23 2406 MBT_BAUD_RATE: 3000000 TRANSPORT_MODE: 0 (HCI) Opened COM23 at speed: 3000000 Sending HCI Command: 0000 <...
  • Page 7: Le Transmitter Test

    LE Transmitter Test The LE Transmitter Test configures the Cypress SoC BT device to send test packets at a fixed interval. External test equipment may be used to receive and analyze the reference packets. The frequency on which the device transmits the packets is passed as a parameter. BLE devices use 40 channels, each of which is 2 MHz wide.
  • Page 8: Le Test End

    The number of packets received during the test is reported by the device and printed out. The value will always be zero if the LE Transmitter Test was active (See Reference [1] [Vol 2, Part E], Section 7.8.30 for details). Usage: wmbt le_test_end COMx The example below stops the active test: <ModusToolbox>\tools\wiced-tools-1.0\BT\wmbt\bin> wmbt le_test_end COM23 MBT_BAUD_RATE: 3000000 TRANSPORT_MODE: 0 (HCI)
  • Page 9: Continuous Transmit Test

    Note: Unlike the LE tests, this test uses 79 frequencies, each 1 MHz wide. This test configures the Cypress SoC BT device to turn the carrier ON or OFF. When the carrier is ON the device transmits according to the specified transmit mode, modulation type, frequency, and power level.
  • Page 10 Continuous Transmit Test To stop the test, send the command a second time to the same COM port with the carrier on/off parameter set to zero (0). <ModusToolbox>\tools\wiced-tools-1.0\BT\wmbt\bin> wmbt tx_frequency_arm COM23 0 2402 1 2 3 MBT_BAUD_RATE: 3000000 TRANSPORT_MODE: 0 (HCI)
  • Page 11: Continuous Receive Test

    Continuous Receive Test This test configures the Cypress SoC BT device to turn ON the receiver in a non-hopping continuous mode. The frequency to be used by the device is passed as a parameter. Usage: wmbt receive_only COMx <rx_frequency> Where: ▪...
  • Page 12: Radio Tx Test

    Radio TX Test This test is the connectionless transmit test that sends Bluetooth packets. The test configures the Cypress SoC BT device to transmit the selected data pattern which is governed by a specified frequency and a specified logical channel at a specified power level.
  • Page 13 Radio TX Test Received HCI Event: 0000 < 04 0E 04 01 51 FC 00 > Success Close Serial Bus The last byte of the HCI Command Complete event is the operation status, where 0 signifies that the operation was successful and the test started to run.
  • Page 14: Radio Rx Test

    10 Radio RX Test This test issues a command to the Cypress SoC BT device to set the radio to camp on a specified frequency. While the test is running, the BT device periodically sends reports about received packets. Usage: wmbt radio_rx_test COMx <bd_addr> <frequency> <modulation_type> <logical_channel>...
  • Page 15 Radio RX Test Success Radio RX Test is running. Press the Enter key to stop the test. WMBT reports connectionless Rx Test statistics every second. The example below shows the Rx Test statistics report: Statistics Report received: [Rx Test statistics] Sync_Timeout_Count: HEC_Error_Count: Total_Received_Packets: 0x31f...
  • Page 16: Bqb Rf Test

    11 BQB RF Test This test issues the commands necessary to configure the Cypress SoC BT device into a test mode for BQB RF testing using a Bluetooth tester, see BQB RF Test Setup [3]. Usage: wmbt enable_bqb_test_mode COMx Before executing this command to configure the device for test mode, you must ensure you application does not have any timers running or any over the air BT activity enabled.
  • Page 17: Read Bd_Addr Command

    12 Read BD_ADDR Command This command reads the BD_ADDR that is currently programmed in the DUT. Usage: wmbt read_bd_addr COMx Example: <ModusToolbox>\tools\wiced-tools-1.0\BT\wmbt\bin wmbt read_bd_addr COM23 > MBT_BAUD_RATE: 3000000 TRANSPORT_MODE: 0 (HCI) Opened COM23 at speed: 3000000 Sending HCI Command: 0000 < 01 09 10 00 >...
  • Page 18: Factory Commit Bd_Addr Command

    To utilize this command, the BD_ADDR must initially be set to all FFs. To set the initial BD_ADDR to all FFs, build and download an example application into the device with ModusToolbox command line make, including the BT_DEVICE_ADDRESS directive in your make command; for example: make -f modus.mk BT_DEVICE_ADDRESS=FFFFFFFFFFFF program...
  • Page 19: References

    References [1] Bluetooth Core Specification, Version 4.2 (see Bluetooth Core Specification 4.2) [2] WICED HCI UART Control Protocol (002-16618) [3] BQB RF Test Setup (002-15369) WICED Manufacturing Bluetooth Test Tool, Document Number: 002-14799 Rev. *E...
  • Page 20: Document History

    Updated in Cypress template 5834940 07/27/2017 Updated logo and copyright 5862775 08/23/2017 Updated template 6306618 08/30/2018 Updated to reflect ModusToolbox Updated Sales and Copyright 6486042 02/202/2019 Updated Factory Commit BD_ADDR Command Updated template WICED Manufacturing Bluetooth Test Tool, Document Number: 002-14799 Rev. *E...
  • Page 21: Worldwide Sales And Design Support

    To the extent permitted by applicable law, Cypress reserves the right to make changes to this document without further notice. Cypress does not assume any liability arising out of the application or use of any product or circuit described in this document.

Table of Contents