User manual

Programming with the PicoScope 6000 Series50

3.9.27

ps6000OpenUnit

PICO_STATUS ps6000OpenUnit

(

short * handle,

char * serial

)

This function opens a PicoScope 6000 Series 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.

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.

Returns

PICO_OK

PICO_OS_NOT_SUPPORTED

PICO_OPEN_OPERATION_IN_PROGRESS

PICO_EEPROM_CORRUPT

PICO_KERNEL_DRIVER_TOO_OLD

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