Agilent Technologies N5340A, Installation Manual

Page: 32 / 34

32 Installation Guide
4
Getting Started
Using OBSAI API - Example
Once you have created and joined a session, you can start to use the
OBSAI api.
In this section, you will learn:
• Creating a trigger on RP1 range and type
Creating a trigger on RP1 range and type
Consider that you want to trigger when one of the following condition is
true:
• When RP1 range is between 1000 and 2000
• When RP1 type is AGT_OBSAI_RP1_TYPE_RP3_FDD or
AGT_OBSAI_RP1_TYPE_CDMA_2000
In the following, use case:
• PORT = Port Id returned by the AddPort method
• LINK_MAP = 1 (assuming to use only one link)
To create a trigger on RP1 range and type
1
Set the trigger properties, as shown below:
AgtInvoke AgtObsaiExerciser SetRP1TriggerProperties PORT
LINK_MAP 1000 0 2000 0 AGT_OBSAI_RP1_TYPE_RP3_FDD |
AGT_OBSAI_RP1_TYPE_CDMA_2000 0
The above statement sets the range for RP1 between 1000 and 2000,
and alo sets RP1 type to
AGT_OBSAI_RP1_TYPE_RP3_FDD
and
AGT_OBSAI_RP1_TYPE_CDMA_2000
.
2
Specify which property to use for trigger from the above statement:
AgtInvoke AgtObsaiExerciser TriggerControl PORT LINK_MAP
AGT_OBSAI_TRIG_CTL_RP1_RANGE |
AGT_OBSAI_TRIG_CTL_RP1_TYPE
3 Start capturing on Rx side:
AgtInvoke AgtObsaiExerciser RxControl PORT
AGT_OBSAI_RX_CONTROL_START_CAPTURE
As a consequence of above statement, OBSAI exerciser triggers when
the trigger condition is true.