LS Research, LLC.
About This Manual This document provides the user with details in setting up and using the Matrix evaluation kits [Part#: MTX10-KIT1 (10mW) and MTX12-KIT1 (100mW)]. The document also provides information and references for software developers to write applications for use with the Matrix modules [Part#: MTX10 (10mW) and ZMXM-401-1-ES (100mW)].
Index CHAPTER 1......................................................................................................................................................... 4 MATRIX EVALUATION KIT OVERVIEW ............................................................................................................... 4 CHAPTER 2......................................................................................................................................................... 5 QUICK START ...................
CHAPTER 1 Matrix Evaluation Kit Overview 1.1 Description The evaluation kit provides the end user the ability to quickly become familiar with the Matrix module. Included in the kit are two Matrix modules and a quick start guide to demonstrate the communication link between the two modules. Also included is a GUI interface referred to as the Matrix Evaluation Test Tool (TT) to quickly communicate with the RF modules. The Evaluation software demonstration is presented in Chapter 4.
CHAPTER 2 Quick Start 2.1 Board Description The Matrix module is a 2.4GHz 802.15.4 data transceiver module based on the Chipcon CC2430 Low Power 8051/Transceiver device. It provides enhanced range performance with either a 10mW or 100mW* power amplifier. The module also contains an integrated PCB trace antenna. Power is supplied by the host device through the interface connection in accordance to the operating voltage requirements with a nominal operating voltage of +3.3V.
2.2 Operational Overview The quick start demonstration presented in this chapter is referred to as the ping pong test. The ping pong test allows an end user to easily verify communication between two transceivers and get a feel for the quality of the link via feedback of the flashing LEDs. Operation involves two boards, with one designated as a master device and the other as a slave device. The master periodically transmits packets to the slave.
2.2.2 Master/Slave Selection Master device setup: 1. Press reset button (S1), see Figure 3-1 location 5, and user button (S3), see Figure 3-1 location 6, on Interface Board simultaneously. 2. Release reset button (S1) on Interface Module. 3. Wait until yellow LED (LED2) is lit, then release reset button (S1). Slave device setup: 1. Press reset button (S1) and user button (S3) on Interface Board simultaneously. 2. Release reset button (S1) on Interface Module. 3.
2.2.5 Channel Changing (can only be peformed if boards have been associated) While in the ping pong mode, the current channel can be changed to one of four other unique channels (four channels total). This is accomplished by holding the push button for approximately two seconds, at which point the yellow LED (LED2) will be lit steady. Once the push button is released, the current channel option number (one through four) is displayed by a series of flashes on the red LED (LED3).
CHAPTER 3 Matrix Interface Module 3.1 Interface Module Overview (See Figure 3 – 1 for Photo) The interface module provides the user the ability to quickly assess the functions of the Matrix module such as I/O and the mobility to verify operation of a wireless link in any environment of the user’s choosing. This chapter describes in detail the functions of the Matrix interface board that can be verified using the Matrix evaluation software provided in this kit.
Programming/Debugging PC Connector (location 3) • Location 3 refers to the programming/debugging PC connector. Via this USB connector it is possible to either program the Matrix Module or debug when developing custom firmware for the module. • For programming the Matrix Module with custom firmware, the suggested programming software tool is the “Chipcon SmartRF04 Flash Programmer”. This tool is available from TI/Chipcon.
Analog Input Select Header (location 9) • Location 9 shows 2 yellow variable analog potentiometers. With the jumpers installed as shown in location 9 (at locations J3 3-4 and J3 5-6) on the ANALOG I/O header, the onboard potentiometers may be utilized to demonstrate the analog capabilities of the Matrix Module. • Remove the two jumpers to utilize external analog or digital peripherals on pins P0_6 and P0_7.
Power Supply Circuitry (location 10) • Location 10 encompasses the power supply circuitry. • As shown in Figure 3-2 below, the jumper is set for bench power supply (3.5 – 5VDC). Bench power supply may be connected to the white header (note positive and negative terminals). • To use battery power, place the jumper as shown in Figure 3-3 below and insert 2 AA batteries in power pack onboard the interface board. • To use USB power, place the jumper as shown in Figure 3-4 below.
Figure 3-4. Jumper Set For USB Supply RS-232 Communication and USB Communication Circuitry (location 11) • Location 11 encompasses the circuitry for communicating with the module via either RS-232 serial or USB. Only one of the interfaces (RS-232 or USB) can be used at a time. Either of these interfaces allows communications with the supplied evaluation test tool software. • To use the RS-232 serial interface with the test tool, jumper J40 2-3 should be installed as shown in Figure 3-5 below.
Figure 3-6. Jumper Set For USB Communications Current Monitor Header (location 12) • Provides user quick access to monitor current supplied to the RF Module. Useful in determining current used by device when in normal or sleep mode. • To utilize this feature the user must remove the jumper and attach current monitor between the two header pins.
CHAPTER 4 Software Overview 4.1 Software Description The Matrix evaluation software was designed to give the developer an ability to quickly test the features built into the Matrix module. The evaluation software is described in the following sections. A screen shot of the evaluation software is shown in Figure 4-1. Developers please refer to Chapter 5 for information on building custom applications for use on the Matrix module. Figure 4-1.
4.2 Software Setup Prior to installing the test tool, power the Matrix module and connect up either the RS-232 serial communications or USB communications cable.
4.2.1 Main Section of Test Tool (Upper left portion of the Test Tool as shown in Figure 4-1) RF Data • Data - Text box to allow user to transmit desired messages to other modules or view messages from another module. • Ascii/Hex (Radio Buttons) – Gives user ability to view or enter messages in Hex or Ascii format • Show Received (Check Box) – If checked the RF Data text box displays received data in selected format.
4.2.3 Getting Supply Voltage (See Figure 4-1) Supply Voltage • Get Supply Voltage – Gets the voltage that is applied to the Matrix module. • The value returned is a single byte. To determine the voltage from the reading that is returned use the following formula. Supply Voltage = (Reading / 255) x 3.75 4.2.4 Getting CC2430 Chip Revision (See Figure 4-1) Chip Revision • Query CC2430 Chip Revision – Gets the revision number of the CC2430 RF transceiver.
RF Power Level Setting 0-6 7-16 17-21 22-24 25-26 27-28 29-30 31 Module Output Power Without PA -25dBm -15dBm -10dBm -7dBm -5dBm -3dBm -1dBm 0dBm Module Output Power With 10mW PA -14.5dBm -5dBm 0dBm 3dBm 5.5dBm 7.5dBm 9dBm 10dBm Module Output Power With 100mW PA 1.5dBm 11dBm 15dBm 17dBm 18dBm 18.5dBm 19dBm 20dBm Table 4-1. RF Power Level Figure 4-3.
4.2.6 Options (See Figure 4-4) The Options page can be accessed by selecting the Options tab in the software, and is shown in Figure 4-4. The following features are provided in the Options page. Host Serial Baudrate • Allows the user to change the serial baudrate to be either 1.2k, 2.4k, 4.8k, 9.6k, 19.2k, 38.4k, 57.6k, or 115.2k.
Figure 4-4.
4.2.7 I/O Configuration (See Figure 4-5) The I/O Configuration page can be accessed by clicking the I/O Config tab in the software, and is shown in Figure 4-5. The I/O Configuration page can be used to configure select I/O pins for digital or analog operation. Refer to Table 4-2 for information on the I/O pin capabilities. Figure 4-5.
Pin Pull-up Available Analog LED Output Input Pull-down To User Input Function Notes P0_0 X X X X X X If LED functionality is enabled on this pin, then the functionality is automatically disabled from pin P0_2 and P0_3. P0_1 X X X X X X If LED functionality is enabled on this pin, then the functionality is automatically disabled from pin P0_2 and P0_3.
4.2.8 Analog Configuration (See Figure 4-6) The Analog Configuration page can be accessed by clicking the Analog Config tab in the software, and is shown in Figure 4-6. The Analog Configuration page can be used to configure the pins set as analog inputs (Refer to Section 4.2.7) for their analog-to-digital converter settings. Figure 4-6. Analog Input Configuration Analog Input ADC Settings • Reference Voltage – Gives user the ability to select the voltage reference that will be used for the conversion.
4.2.9 I/O Control (See Figure 4-7) The I/O Control page can be accessed by clicking the I/O Control tab in the software, and is shown in Figure 4-7. The I/O Control page can be used to read analog and digital inputs and set digital outputs. Figure 4-7. I/O Control Digital I/O • Set Output – Sets pins configured as digital outputs to the selected level (0 or 1). • Query Input – Gets the input level (0 or 1) for pins configured as digital inputs.
4.2.10 Statistics (See Figure 4-8) The Statistics page can be accessed by clicking the Statistics tab in the software, and is shown in Figure 4-8. The Statistics page can be used to evaluate the wireless link for packet error rates and throughput. Figure 4-8.
“Transceiver” Statistics • Packets Sent - Number of packets transmitted. • Acknowledgements (Acks) Sent – Number of acknowledgements sent by receiver. • Packets Received – Number of packets received. • Acks Received – Number of acknowledgements received by the transmitter. “Evaluation Program” Statistics The window toward the bottom the page labeled “Evaluation Program” contains information about the integrity of the link between the host computer and the radio board. 4.2.
Debug Mode • Mode 0 – No debug pulses on pins. • Mode 1 – Refer to Host Protocol Document for Information. LED Functionality (Refer to Host Protocol Document for Information) • Depending on the I/O Configuration for the pins that can have LED outputs enabled (refer to Section 4.2.7), and whether or not the specific LED functionality is enabled, the LEDs will momentarily flash when serial activity, RF activity, or heartbeat activity occurs. • Refer to Table 4.
4.3 Setting Up and testing a Wireless Link Operational testing of the Matrix RF module requires at least 2 units in order to establish a link. One unit will be the initiator and the other will be the responder. In order for a link to be established it is necessary to setup the transceiver’s RF Channel, long or short address, and PAN ID. Link testing may be performed in either a single ended or a round trip fashion.
Device 2 (Refer to Figures 4-11 and 4-12) 1. Set PAN ID to 100 (IDs Page). 2. Set short address to 2 (IDs Page). Note to use long addressing set short address to 65,535. 3. Disable Acknowledgements/Retries (RF Settings Page). 4. Disable Receive All RF Messages (RF Settings Page). 5. Set to RF Channel 23 (RF Settings Page). 6. Set transmitter power setting to 31 (RF Settings Page). 7. Set Short Destination address to 1 (Located Upper left corner of TT). 8.
Figure 4-11. ID Settings for Device 2. Figure 4-12.
Operational Description Place the 2 units in physically separate locations and apply power to them. The statistics will clear when power is cycled, but they will need to be cleared manually after each test if power is not cycled. Connect each individual PC serial port to each of the units and verify the correct destination address is typed in the address field on the top of the test tool. Type a short message into the “RF Data” window of the initiating device. The message can be any text or numbers.
CHAPTER 5 Matrix/Zigbee Ready Module Input/Output 5.1 Overview There are a total of 12 user input/output pins on the Matrix module, all of which can be configured as digital inputs or outputs. Of the 12 configurable digital I/O pins, 8 of them can also be configured as analog inputs. 5.2 Digital Inputs/Outputs There are 12 configurable digital input/output pins that can be programmed to be either inputs or outputs.
5.3 Analog Inputs There are 8 pins that can be configured as analog inputs. Refer to Table 4-2 for the specific I/O pin capabilities. Using the analog input pins consists of the following: Configuring the pins Select direction as analog input. Select the analog-to-digital converter settings for each specific pin configured as an analog input (refer to Section 4.2.7).
CHAPTER 6 Matrix Application Guide 6.1 Overview This Chapter describes the essentials for using the host protocol to configure and use a Matrix module in an application. Please refer to Host Protocol Document for Further Details on messaging. 6.1.1 Host Protocol The host protocol that is used to communicate with a Matrix module is a simple binary based protocol.
Communication Parameters There are six configuration parameters used to setup the Matrix module for communications, which are outline below. 1. Set PAN ID – The Personal Area Network (PAN) ID is used to establish networks of transceivers. Only devices with the same PAN ID will communicate with one another. 2. Set Transceiver Address – The Transceiver Address is used to differentiate transceivers within a network. Each transceiver should be configured with a different address.
2. Set I/O Sleep State – This message defines the state that the I/O pins will be put into when the low power sleep mode of operation is requested for the module. Similar to the “Set I/O Configuration” message, the direction of the pin, whether or not the pull-up or pulldown resistors are enabled for input pins, and the output value for output pins can be configured. Upon exiting sleep mode the pins will be configured back to the state they were in prior to entering sleep mode. 3.
Diagnostics and Feedback Parameters There are two configuration parameters used to setup diagnostics and user LED feedback which are outlined below. 1. Set Debug Mode – Setting the debug mode allows the host application to configure what debug information gets displayed on the three mode pins when the mode pins are in their default state. The default state for the mode pins is that none of the pins are externally pulled-down.
Host Messages 1. Set PAN ID < 0x07 0x01 0x07 0x01 0x64 0x00 0x6D 0x04 > 2. Set Transceiver Address < 0x0F 0x01 0x0F 0x03 0xF4 0x01 0x00 0x00 0x00 0x00 0x00 0x00 0xFF 0xFF 0x06 0x04> 3. Set RF Channel < 0x06 0x01 0x06 0x05 0x12 0x1E 0x04 > 4. Disable Receive All RF Messages < 0x06 0x01 0x06 0x07 0x00 0x0E 0x04 > 5. Enable Acknowledgements and Retries < 0x06 0x01 0x06 0x09 0x01 0x11 0x04 > 6. Set Transmit Power Level < 0x06 0x01 0x06 0x0F 0x1F 0x35 0x04 > 7.
6.1.3 RF Messaging Overview The Matrix module provides a versatile command set for communications between modules. Depending on the application’s requirements, either short or long address modes can be used. Short addressing mode uses a two byte transceiver address, while long addressing mode uses eight byte transceiver addresses.
Receive All (Feature Currently Not Available) Receive all mode is used as a diagnostic mode in which a transceiver can listen to and receive all of the messages from any device that is communicating on the same PAN ID and RF channel. Messages with long and short addressing types will be received, and when a message is received it is sent out the host serial port with a message type of 0xA9. In receive all mode it is not possible to transmit messages to other transceivers.
Host Send Mode (Host -> Txcvr A) Short Short Short Short Long Long Long Long Addressing Mode (Txcvr A -> Txcvr B) Txcvr A Txcvr B Short Short Long Long Short Short Long Long Short Long Short Long Short Long Short Long Host Receive Mode (Txcvr B -> Host) Source Destination Short - (Note 1) Long - (Note 1) - (Note 2) Short - (Note 2) Long Short - (Note 1) Short - (Note 1) - (Note 2) Long - (Note 2) Long Broadcast Ok Ok Ok Ok - Table 6-1.
6.1.4 Example Messaging For all of the following examples it is assumed that the PAN ID and RF channel are set to be the same on both Matrix modules. Also the messages will originate in the host connected to transceiver A and they will be sent to transceiver B. The data contained in the message will be 0x01, 0x02, 0x03. All received messages have a Link Quality Indication (LQI) of 200 (0xC8).
Short To Long Addressing The following example will show details of communications between two Matrix modules with transceiver A configured to use short addressing and transceiver B configured to use long addressing.
Long To Long Addressing The following example will show details of communications between two Matrix modules both configured to use long addressing.
configured as digital inputs contain any meaningful information. A zero indicates a low signal is applied to the input, while a one indicates a high signal is applied. Example: Digital Inputs = P0_6, P0_5, P1_7, and P1_1.
Appendix A Range Test Results A.1.
Appendix B Agency Statements Compliance Statement (Part 15.19) This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: 1. This device may not cause harmful interference, and 2. This device must accept any interference received, including interference that may cause undesired operation. Warning (Part 15.21) Changes or modifications not expressly approved by the party responsible for compliance could void the user’s authority to operate the equipment.
OEM Responsibility to the FCC Rules and Regulations The Matrix 100mW Module has been certified per FCC Part 15 rules for integration into products without further testing or certification. To fulfill the FCC certification requirements the OEM of the Matrix 100mW Module must ensure that the information provided on the Matrix 100mW Module label is placed on the outside of the final product. The Matrix 100mW Module is labeled with its own FCC ID Number.
