Lesson 1 – Multi-Site Test
521
Controlling the Setup/
Query-Focus State of
Site Manually
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.
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:
Getting the Site
Numbers
The site number information can be got by using the following APIs during
execution of your test method program:
• 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.
ARRAY_I sites;
ON_FIRST_INVOCATION_BEGIN();
:
GET_TEST_FOCUS(sites); //Get setup-focused sites
SET_TEST_FOCUS(1); //Set only site 1
AWG("Ain").vOffset(5 V);
FLUSH();
SET_TEST_FOCUS(sites); //Restore setup-focused sites
:
ON_FIRST_INVOCATION_END();
• 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