
PicoScope 3000A Series Prog rammer's Guide
59
Copyright © 2011-2013 Pico Technology Limited. All rights reserved.
ps3000abpg.en r9
2.12.33 ps3000aOpenUnit
PICO_STATUS ps3000aOpenUnit
(
short * handle,
char * serial
)
This function opens a PicoScope 3000A scope attached to the computer. The maximum
number of units that can be opened depends on the operating system, the kernel driver
and the computer. If
is called without the power supply connected,
the driver returns
PICO_POWER_SUPPLY_NOT_CONNECTED.
Applicability
All modes
Arguments
* handle
, on exit, the result of the attempt to open a scope:
-1 : if the scope fails to open
0
: if no scope is found
> 0 : a number that uniquely identifies the scope
If a valid handle is returned, it must be used in all subsequent calls to
API functions to identify this scope.
* serial,
on entry, a null-terminated string containing the serial
number of the scope to be opened. If
serial
is NULL then the
function opens the first scope found; otherwise, it tries to open the
scope that matches the string.
PICO_OK
PICO_OS_NOT_SUPPORTED
PICO_OPEN_OPERATION_IN_PROGRESS
PICO_EEPROM_CORRUPT
PICO_KERNEL_DRIVER_TOO_OLD
PICO_FPGA_FAIL
PICO_MEMORY_CLOCK_FREQUENCY
PICO_FW_FAIL
PICO_MAX_UNITS_OPENED
PICO_NOT_FOUND
(if the specified unit was not found)
PICO_NOT_RESPONDING
PICO_MEMORY_FAIL
PICO_ANALOG_BOARD
PICO_CONFIG_FAIL_AWG
PICO_INITIALISE_FPGA
PICO_POWER_SUPPLY_NOT_CONNECTED