IQRF CATS-01 User manual

CATS-01
IQRF Service tool
Firmware v0.56
User's guide
© 2011MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 1

CATS-01
Parts and controls
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 2
Description
CATS-01 is a service an ebug tool to analyze RF
signal. It allows to scan an monitor RF
communication. General RF is etecte , not only
IQRF packets.
CATS-01 is a fixe non-generic evice. No parts can
be programme by the user. Functionality can be
exten e by future firmware upgra es.
Applications
• IQRF application ebug an evelopment
• RF scanner
• Network installation hints for channel choice
Key features
• Base of the GW-QVGE-01 gateway
• 868 MHz an 916 MHz ISM ban scanner
• Displaying activity in in ivi ual channels
• SD Flash memory car insi e
• USB connectivity
• Ethernet connectivity (reserve for future firmware versions)
• Firmware upgra e supporte

CATS-01
Hardware
Main unit is base on the touchscreen oriente GW- VGE-01 gateway with TR mo ule TR-52BA insi e.
For electrical specifications and more information about the GW refer to the GW-QVGE-01 User's guide.
Power supply indication
Power supply an internal accumulator con ition is in icate by ual color LED insi e the case an a buzzer. Following
states are recognize :
•Green LED flash in 3 s perio Supplie from external power source, internal accumulator is charge .
•Re LED flash in 3 s perio Supplie from internal accumulator, voltage is higher than 3.5 V.
•Re LED flash in 0.5 s perio
Warning soun in 10 s perio Supplie from internal accumulator, voltage is lower than 3.5 V.
•Warning screen for 3 s Voltage roppe un er 3.45 V. Device is just switche to sleep then.
When powere from accumulator, battery icon on the top of main screen isplays battery status (inner blue bar length
correspon s to exhausting level).
Reset pushbutton
Press (by a pin) uring operation or Sleep invokes restart of the evice. The bootloa er is activate first. If there is a
ifferent application program on SD car insi e it is uploa e an execute otherwise the original program is run. See
Firm are upgrade below.
SD card
•CATS-01 must be operate with inserte SD car containing original ata from the factory. If it is missing or ata is
corrupte only System is available in the Main menu.
•A itional files can be possibly a e :
•License keys to access possible optional firmware parts for given evice, see Functionality extension.
•Free space on the SD car can be use to store screenshots create by the user, see System / Display.
•SD car can be use to upgra e firmware, see Firm are upgrade.
•SD car insi e the evice is accessible by a PC via USB as a stan ar external isk unit.
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 3

CATS-01
Control and indication
Control pushbutton
Condition Press duration Function
Operation
Less than 1 s Return to main menu
1 s to 2.5 s Screenshot save to SD car (if enable )
2.5 s to 10 s Switch to Sleep mo e (confirmation require )
More than 10 s Factory settings restore for some parameters (Beep enable an Backlight times,
see System / Sound an System / Display). Touchscreen calibration invoke .
Sleep Any Wake-up, invoking the application
Control and navigation via touchscreen
Besi es of physical control parts there are also control objects accessible from the touchscreen. Han ling is the same
whenever they are isplaye .
Arrow keys – navigation buttons (1), (2) an (3):
•Up (1) Next item, increment of a numeric value
•Down (2) Previous item, ecrement of a numeric value
•Back (3) Return to previous screen (an confirm possible changes)
E it boxes (4) for numeric parameters. Two metho s are available to setup values:
•Click the e it box to highlight the parameter an make it accessible for change via arrow keys Up (1) an Down (2).
•Doubleclick the e it box to change the parameter via numeric keypa .
Ra iobuttons (5) are inten e to choose only one of a pre efine set of options.
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 4

CATS-01
Main menu
Main screen menu items: Scanner (1) an System (2). Other functions may be a e optionally, see Functionality
extension.
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 5

CATS-01
Scanner
Scanner is inten e to monitor RF communication with respect to RF channels. See IQRF OS User's gui e for more
information about isplaye parameters.
Scanner main screen
Activity in in ivi ual channels an parameters of RF signal in selecte channel are monitore . All 62 channels (0 to 61) of
868 MHz ban can be monitore at the same time but 186 channels of the 916 MHz ban must be separate to three
groups an the user selects just one of them to be scanne an currently isplaye .
A itionally, selecte group can be re uce by the user. Channels are scanne one by one. Scanning of one channel
takes about 0.4 ms. Thus, to get higher resolution, number of scanne channels can be re uce by Low/High channel
limits. See Scanner settings.
The screen is separate to following parts:
•RF activity in in ivi ual channels (1). The following information is isplaye :
•Whether a communication is running in in ivi ual channels. Active channels are isplaye by bars.
•Signal strength (current as well as the maximal etecte one). Heights of bars are proportional to signal strengths.
•Dark blue Current RSSI in the channel
•Light blue Max. RSSI etecte in the channel
•Dark re Current RSSI in currently selecte channel
•Light re Max. RSSI etecte in currently selecte channel
•Black horizontal line RF level efining minimal incoming signal strength to be etecte . See RF filter.
•Re vertical line Currently selecte channel
•Details about currently selecte channel (2).
•RF Ban Selecte RF ban
•Channel Selecte RF channel
•RF Filter Specifie RF level to filter incoming signal.
•RSSI Current RSSI value in selecte channel.
•Max. RSSI Maximal RSSI value etecte in selecte channel
•Scan CH Selecte group of scanne channels (3)
•Area with four control buttons (4):
•"<" an ">" Channel selection (to isplay etails)
•Clr To clear Max. RSSI values scanne an isplaye up to now. The same can be achieve
by ouble click to the fiel (1).
•Set Switch to the Scanner settings screen for setting of scanning parameters.
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 6

CATS-01
Scanner settings
The following parameters can be selecte here:
•Low channel limit (1) Channels with lower numbers will be not monitore
•High channel limit (2) Channels with higher numbers will be not monitore
•RF Filter (3) RF level to filter incoming signal (0 to 64). Weaker signals are ignore .
•Select channel Channel for isplaying etails (from Lo channel limit to High channel limit)
•Ch (4) RF ban an group of channels
•channels 0 to 61 for 868 MHz
•channels 0 to 61, 62 to 123 or 124 to 185 for 916 MHz
Typical usage of the Scanner
Watching activity in a channel
To evaluate a specifie channel (e.g. to eci e whether it is suitable for current communication in given network), re uce
scanne channels for about ± 5 channels aroun .
Choosing a free channel
To choose a free channel (before a network installation etc.), let the Scanner run for an appropriate time an watch Max.
RSSI (the light blue bars) then.
Hints for I MESH design
Experience from usage of CATS-01 scanner can be utilize for esign of user IQRF applications. To manage channels
effectively either in point-to-point or in IQMESH applications, scanning metho s escribe here can be applie in TR
mo ules by users. Robust communication shoul be esigne to allow switching RF channels with respect to current RF
traffic an noise.
Example – scanning channels in an infinite loop
...
i = 0;
while(1)
{
clrwdt();
setRFchannel(i);
if (checkRF(RF_FILTER)) // I nore si nals with lower level
{
pulseLEDR(); // LED flash if a si nal is detected in the channel
}
++i;
if (i > 61)
i = 0;
}
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 7

CATS-01
System
This screen is inten e for control an information functions regar ing the evice. Submenu items: About, TR module, GW
Status, Date Time, Sound an Display.
About
Detaile ata concerning the evice an the manufacturer:
•Item (1) Device type an firmware version
•Item (2) MAC a ress (unique for each evice)
•Item (3) Manufacturer
TR module
Detaile ata concerning TR mo ule insi e:
•Item (1) Version of operating system built-in the TR mo ule
•Item (2) TR mo ule i entification (TR Mo ule info, unique for each TR)
•Item (3) MCU type insi e the TR
•Item (4) Type an version of firmware currently uploa e in TR mo ule. It epen s on the last selecte function
of CATS-01 (in case of optional CATS-01 functions). See Functionality extension.
Button (5) shoul be use to return to menu System.
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 8

CATS-01
GW Status
•Temp (1) Internal temperature sensor (optional): Available / Not available
•Power (2) Supplie from external power source or from battery
•Accu (3) Accumulator voltage
•Acc (4) Inertial sensor outputs (x, y an z values)
•SD car (5) Inserte / Not inserte
Date Time
Internal real-time clock/calen ar ata is isplaye an can be change in a stan ar way. This menu item can be invoke
also by click to the area where time an ate is isplaye on main screen.
•Item (1) Month
•Item (2) Day
•Item (3) Year
•Item (4) Hour
•Item (5) Minute
•Item (6) Secon
Sound
Acoustic in ication can be enable / isable by checbox Beep.
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 9

CATS-01
Display
•Backlight Perio to switch the isplay off after last comman issue by the operator. It can be setup
separately if powere externally or from the accumulator: 10 s / 30 s / 1 min / 2 min / always.
• (external power) If powere externally
• (battery power) If powere from the battery
•Screenshot enable There is a possibility to create screenshots. If enable , current screenshot is store to SD car to
the S_SHOTS irectory when control pushbutton is presse for 1 s to 2.5 s. It takes several
secon s. Starting an finishing is in icate by beeps. This option is always isable after evice
restart.
Firmware upgrade
CATS-01 firmware can be upgra e by the user with a new version release by the manufacturer. To accomplish this,
follow the steps below:
•Downloa a new firmware version (the wapl_fw.hex file) from the pro uct web page.
•Connect CATS-01 to PC via micro USB cable. Internal SD car shoul be etecte as a isk unit.
•Copy the firmware to the SD car to the GWSYSTEM irectory. The file name must remain unchange .
•Disconnect CATS-01 from the PC an reset the evice. New FW shoul be etecte an upgra e automatically.
Functionality extension
CATS-01 is esigne to support various functionality epen ing on the license. Thus, if there are any optional parts in
given firmware available it is possible to make it accessible by exten ing the license keys.
To accomplish this, follow the steps below:
•Ask the manufacturer for license keys to chosen option for your evice (specifie by the MAC a ress).
•Connect CATS-01 to PC via micro USB cable. Internal SD car shoul be etecte as a isk unit.
•Copy the license keys to the SD car to the GWSYSTEM irectory.
•Disconnect CATS-01 from the PC an reset the evice. New functionality shoul be ma e accessible automatically.
© 2011 MICRORISC s.r.o. www.iqrf.org CATS01_110801 Page 10