icdevice

Crear objeto de dispositivo

expandir todo en la página

    Descripción

    Utilice icdevice para crear un objeto de dispositivo MATLAB®.

    Creación

    Sintaxis

    obj = icdevice(driver,hwobj)
    obj = icdevice(driver,rsrcname)
    obj = icdevice(driver)
    obj = icdevice(___,Name,Value)

    Descripción

    obj = icdevice(driver,hwobj) crea el objeto de dispositivo obj. La información específica del instrumento se define en el controlador del instrumento de interfaz MATLAB, driver, que se especifica como una cadena. La comunicación con el instrumento se realiza a través del objeto de interfaz, hwobj. El objeto de interfaz puede ser un puerto serie, GPIB, VISA, TCPIP o un objeto UDP. Si driver no existe o si hwobj no es válido, el objeto del dispositivo no se crea.

    Los objetos de dispositivo también se pueden utilizar con controladores VXIplug&play y de instrumentos virtuales intercambiables (IVI®). Para utilizar estos controladores, primero debe tener un contenedor de controlador de instrumento MATLAB para el controlador VXIplug&play o IVI subyacente. Si el contenedor del controlador del instrumento MATLAB aún no existe, se puede crear utilizando makemid o midedit. Tenga en cuenta que makemid o midedit solo deben usarse una vez para crear el contenedor del controlador del instrumento MATLAB.

    ejemplo

    obj = icdevice(driver,rsrcname) crea un objeto de dispositivo obj, utilizando el controlador de instrumento MATLAB, driver. El driver especificado debe ser un controlador de instrumento MATLAB VXIplug&play o un controlador de instrumento MATLAB IVI y se especifica como una cadena. La comunicación con el instrumento se realiza a través del recurso especificado por rsrcname como una cadena. Por ejemplo, todos los controladores VXIplug&play y muchos controladores IVI requieren nombres de recursos VISA para rsrcname.

    ejemplo

    obj = icdevice(driver) construye un objeto de dispositivo obj, utilizando el controlador de instrumento MATLAB, driver. El driver especificado debe ser un controlador de instrumento MATLAB IVI y el controlador IVI subyacente debe estar referenciado mediante un nombre lógico.

    obj = icdevice(___,Name,Value) construye un objeto de dispositivo obj utilizando uno o más argumentos de nombre-valor además de los argumentos de entrada en las sintaxis anteriores. Los argumentos de nombre-valor pueden estar en cualquier formato admitido por la función set: pares de vectores de caracteres de nombre-valor, estructuras y pares de matrices de celdas de nombre-valor. También puede especificar nombres de propiedades sin tener en cuenta mayúsculas y minúsculas, y puede utilizar la función de completar nombres de propiedades. Por ejemplo, estos comandos son todos válidos y equivalentes:

    d = icdevice('tektronix_tds210',g,'ObjectVisibility','on');
d = icdevice('tektronix_tds210',g,'objectvisibility','on');
d = icdevice('tektronix_tds210',g,'ObjectVis','on');

    Nota

    Al implementar código utilizando controladores IVI-C o VXIplug&play, la ejecución de su código generará archivos adicionales en la carpeta especificada al ejecutar el siguiente código en el indicador MATLAB:

    fullfile(tempdir,'ICTDeploymentFiles',sprintf('R%s',version('-release')))

    En todas las plataformas compatibles, se genera un archivo con el nombre MATLABPrototypeFor<driverName>.m, donde <driverName> es el nombre del controlador IVI-C o VXIplug&play. Con MATLAB de 64 bits en Windows®, se genera un segundo archivo con el nombre <driverName>_thunk_pcwin64.dll. Al crear su aplicación implementada o biblioteca compartida, incluya manualmente estos archivos generados. Si utiliza la función icdevice, recuerde también incluir manualmente el archivo MDD en la aplicación implementada o en la biblioteca compartida. Para obtener más información sobre cómo incluir archivos adicionales, consulte la documentación de MATLAB Compiler™_.

    Ejemplos

    contraer todo

    Cree un objeto de dispositivo para un osciloscopio TDS 210 Tektronix® que esté conectado a una placa MCC GPIB, utilizando un objeto de interfaz MATLAB y un controlador de instrumento de interfaz MATLAB.

    g = gpib('mcc',0,2);
d = icdevice('tektronix_tds210',g);

    Conectarse al instrumento.

    connect(d);

    Enumere las configuraciones del osciloscopio que se pueden configurar.

    props = set(d);

    Obtenga la configuración actual del osciloscopio.

    values = get(d);

    Desconecte del instrumento y limpie.

    disconnect(d);
delete([d g]);

    Cree un objeto de dispositivo para un osciloscopio Tektronix TDS 210 utilizando un controlador de instrumento MATLAB VXIplug&play.

    Este ejemplo supone que el controlador 'tktds5k' VXIplug&play está instalado en su sistema.

    Este primer paso es necesario solo si no existe un controlador de instrumento MATLAB VXIplug&play para el tktds5k en su sistema.

    makemid('tktds5k','Tktds5kMATLABDriver');

    Construya un objeto de dispositivo que utilice el controlador VXIplug&play. Se supone que el instrumento está ubicado en la dirección principal GPIB 2.

    d = icdevice('Tktds5kMATLABDriver','GPIB0::2::INSTR');

    Conectarse al instrumento.

    connect(d);

    Enumere las configuraciones del osciloscopio que se pueden configurar.

    props = set(d);

    Obtenga la configuración actual del osciloscopio.

    values = get(d);

    Desconecte del instrumento y limpie.

    disconnect(d);
delete(d);

    Sugerencias

    En cualquier momento, puede utilizar la función instrhelp para ver una lista completa de propiedades y funciones asociadas con los objetos del dispositivo.

    instrhelp icdevice

    Cuando se crea un objeto de dispositivo, estos valores de propiedad se configuran automáticamente:

    • Interface especifica la interfaz utilizada para comunicarse con el instrumento. Para los objetos de dispositivo creados mediante objetos de interfaz, es ese objeto de interfaz. Para VXIplug&play e IVI-C, este es el identificador de sesión para la sesión del controlador. Para los controladores de instrumentos MATLAB, este es el identificador de la interfaz COM predeterminada del controlador.

    • LogicalName es un nombre lógico IVI. Para los conductores que no son IVI, está vacío.

    • Name se obtiene concatenando el tipo de instrumento con el nombre del controlador del instrumento.

    • RsrcName es el nombre completo del recurso VISA para los controladores VXIplug&play y IVI. Para los controladores de interfaz MATLAB, RsrcName es un vector de caracteres vacío.

    • Type es el tipo de instrumento, si se conoce (por ejemplo, scope o multimeter).

    Para comunicarse con el instrumento, el objeto del dispositivo debe estar conectado al instrumento con la función connect. Cuando se construye el objeto del dispositivo, la propiedad Status del objeto es closed. Una vez que el objeto del dispositivo está conectado al instrumento con la función connect, la propiedad Status se configura como open.

    Nota

    ICDEVICE no puede abrir MDD con caracteres que no sean ASCII ni en su nombre ni en su ruta en plataformas Mac.

    Nota

    Para obtener una lista de opciones que puede usar en una función, presione la tecla Tab después de ingresar una función en la línea de comando MATLAB. La lista se expande y usted puede desplazarse para elegir una propiedad o valor. Para obtener información sobre el uso de esta función avanzada de completar tabulaciones, consulte Using Tab Completion for Functions.

    Historial de versiones

    Introducido antes de R2006a

    Consulte también

    |