Agilent Technologies 93000 SOC Series Training Manual page 521

Controlling the Setup/
Query-Focus State of
Site Manually
Getting the Site
Numbers
In addition to auto-controlling the setup/query-focus state of sites, you can
also control the state of setup-focus in the currently-active sites by using the
following APIs. The first two APIs specify which sites are addressed by
Setup APIs which follow, for performing the site-specific setup.
• SET_TEST_FOCUS()
Sets the specified site(s) in the currently-active site(s) to setup-focus state.
This can also set all active sites except for the specified site(s) to non setup-
focus state simultaneously.
• UNSET_TEST_FOCUS()
Sets the specified site in the currently setup-focused site(s) to non setup-
focus state.
• GET_TEST_FOCUS()
Returns the number of the setup-focused sites and the site numbers.
These APIs are meaningful in the first invocation block except for the each
site loop blocks.
The following shows an example program for the site-specific execution
using the multi-site APIs:
ARRAY_I sites;
ON_FIRST_INVOCATION_BEGIN();
:
GET_TEST_FOCUS(sites);
SET_TEST_FOCUS(1);
AWG("Ain").vOffset(5 V);
FLUSH();
SET_TEST_FOCUS(sites);
:
ON_FIRST_INVOCATION_END();
The site number information can be got by using the following APIs during
execution of your test method program:
• CURRENT_SITE_NUMBER()
Returns the site number of the current site under test.
• GET_CONFIGURED_SITES()
Returns the number of sites which were set up in the pin configuration, and
the site numbers
Lesson 1 – Multi-Site Test
//Get setup-focused sites
//Set only site 1
//Restore setup-focused sites
521