agilent_mxa_v0.92.mdd

Agilent 仪器与MATLAB互联

               <Name>Trigger</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>InstrumentCommand</Type>
               <Code>
                  <Commands>
                     <ConfigureCommand>:TRIG:SOUR</ConfigureCommand>
                     <QueryCommand>:TRIG:SOUR?</QueryCommand>
                  </Commands>
               </Code>
               <PermissibleType>
                  <Type>String</Type>
                  <Constraint>enum</Constraint>
                  <ConstraintValue>
                     <Enum Name="freerun" Value="IMM"/>
                     <Enum Name="video" Value="VID"/>
                     <Enum Name="line" Value="LINE"/>
                     <Enum Name="external1" Value="EXT1"/>
                     <Enum Name="external2" Value="EXT2"/>
                     <Enum Name="RFburst" Value="RFB"/>
                  </ConstraintValue>
               </PermissibleType>
               <DefaultValue>freerun</DefaultValue>
               <ReadOnly>never</ReadOnly>
               <Description>Sets or queries the trigger source</Description>
            </Property>
            <Property>
               <Name>VidBW</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>InstrumentCommand</Type>
               <Code>
                  <Commands>
                     <ConfigureCommand>:BAND:VID</ConfigureCommand>
                     <QueryCommand>:BAND:VID?</QueryCommand>
                  </Commands>
               </Code>
               <PermissibleType>
                  <Type>Double</Type>
                  <Constraint>bounded</Constraint>
                  <ConstraintValue>
                     <Range Max="5.0E7" Min="1.0"/>
                  </ConstraintValue>
               </PermissibleType>
               <DefaultValue>3e6</DefaultValue>
               <ReadOnly>never</ReadOnly>
               <Description>Sets or queries the video bandwidth</Description>
            </Property>
            <Property>
               <Name>VidBWAuto</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>InstrumentCommand</Type>
               <Code>
                  <Commands>
                     <ConfigureCommand>:BAND:VID:AUTO</ConfigureCommand>
                     <QueryCommand>:BAND:VID:AUTO?</QueryCommand>
                  </Commands>
               </Code>
               <PermissibleType>
                  <Type>String</Type>
                  <Constraint>enum</Constraint>
                  <ConstraintValue>
                     <Enum Name="on" Value="1"/>
                     <Enum Name="off" Value="0"/>
                  </ConstraintValue>
               </PermissibleType>
               <DefaultValue>on</DefaultValue>
               <ReadOnly>never</ReadOnly>
               <Description>Sets or queries the resolution bandwidth auto mode</Description>
            </Property>
            <Property>
               <Name>YAxisUnits</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>InstrumentCommand</Type>
               <Code>
                  <Commands>
                     <ConfigureCommand>:UNIT:POW</ConfigureCommand>
                     <QueryCommand>:UNIT:POW?</QueryCommand>
                  </Commands>
               </Code>
               <PermissibleType>
                  <Type>String</Type>
                  <Constraint>enum</Constraint>
                  <ConstraintValue>
                     <Enum Name="dBm" Value="DBM"/>
                     <Enum Name="dBmV" Value="DBMV"/>
                     <Enum Name="dBuV" Value="DBUV"/>
                     <Enum Name="V" Value="V"/>
                     <Enum Name="W" Value="W"/>
                  </ConstraintValue>
               </PermissibleType>
               <DefaultValue>dBm</DefaultValue>
               <ReadOnly>never</ReadOnly>
               <Description>Sets or queries the vertical scale units</Description>
            </Property>
         </PropertyInfo>
         <MethodInfo>
            <Method>
               <Name>getIQ</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function iq=getIQ(obj)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.
% Get the interface object
interface=get(obj,'interface');

% Change instrument mode to Basic
fprintf(interface,':INST:NSEL 8');

% Tell it the precision
fprintf(interface,':FORM:DATA REAL,32');

fprintf(interface,':READ:WAV0?');

% Get the data back
data=binblockread(interface,'float');

% data is interleaved inphase, quad
inphase=data(1:2:end);
quad=data(2:2:end);

% final complex vector
iq=inphase+j*quad;

</MCode>
               </Code>
               <Description>getIQ gets IQ data from the instrument

Input parameters: none
Output parameters: complex column vector with IQ data</Description>
            </Method>
            <Method>
               <Name>getPeakMax</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function [freq, amp] = getPeakMax(obj)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.

% Get the interface object
interface=get(obj,'interface');

% Change instrument mode to spectrum analyzer
fprintf(interface,':INST:NSEL 1');

% Set the analyzer into single sweep mode
fprintf(interface,':INIT:CONT OFF');

% Trigger the sweep and wait for it to complete
fprintf(interface,':INIT:IMM;*WAI');

% Get the peak data back
fprintf(interface,':CALC:MARK:MAX')
freq = str2double(query(interface,':CALC:MARK:X?'));
amp = str2double(query(interface,':CALC:MARK:Y?'));

fprintf(interface,':INIT:CONT ON');
</MCode>
               </Code>
               <Description>getPeaks queries the peak list the meets the peak threshold and peak excursion criteria.

Iutput parameters: none
Output parameters: two column vectors, the first is the frequency points an the second is the amplitude peak values.

 example: [freq amp] = invoke(mxa_handle, 'getPeaks')</Description>
            </Method>
            <Method>
               <Name>getPeaks</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function [freq,amp] = getPeaks(obj)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.

% Get the interface object
interface=get(obj,'interface');

% Change instrument mode to spectrum analyzer
fprintf(interface,':INST:NSEL 1');

% Set the analyzer into single sweep mode
fprintf(interface,':INIT:CONT OFF');

% Trigger the sweep and wait for it to complete
fprintf(interface,':INIT:IMM;*WAI');

% Get the data back
peaks = str2num(query(interface,':TRAC:MATH:PEAK?'));

freq = peaks(1:2:end-1)';
amp = peaks(2:2:end)';

fprintf(interface,':INIT:CONT ON');
</MCode>
               </Code>
               <Description>getPeaks queries the peak list the meets the peak threshold and peak excursion criteria.

Iutput parameters: none
Output parameters: two column vectors, the first is the frequency points an the second is the amplitude peak values.

 example: [freq amp] = invoke(mxa_handle, 'getPeaks')</Description>
            </Method>
            <Method>
               <Name>getTrace</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function data=getTrace(obj)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.

% Get the interface object
interface=get(obj,'interface');

% Change instrument mode to spectrum analyzer
fprintf(interface,':INST:NSEL 1');

% Tell it the precision
fprintf(interface,':FORM:DATA REAL,32');

% Set the analyzer into single sweep mode
fprintf(interface,':INIT:CONT OFF');

% Trigger the sweep and wait for it to complete
fprintf(interface,':INIT:IMM;*WAI');

% Get the data back
fprintf(interface,':TRACE:DATA? TRACE1');
data=binblockread(interface,'float');
fprintf(interface,':INIT:CONT ON');


</MCode>
               </Code>
               <Description>getTrace method gets the swept SA trace data

Iutput parameters: none
Output parameters: one column vector with trace data</Description>
            </Method>
            <Method>
               <Name>initRestart</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function initRestart(obj)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.

interface = get(obj, 'Interface');
fprintf(interface, ':INIT:REST');</MCode>
               </Code>
               <Description>initRestart aborts the curent trace and restarts a sweep
(SCPI command: :INIT:REST)</Description>
            </Method>
            <Method>
               <Name>measCHP</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function data=measCHP(obj)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.

% Get the interface object
interface=get(obj,'interface');

% Change instrument mode to spectrum analyzer
fprintf(interface,':INST:NSEL 1');

% Tell it the precision
fprintf(interface,':FORM:DATA REAL,32');

% Set the Channel Power Meas Mode
fprintf(interface,':READ:CHP?');

% Get the data back
data=binblockread(interface,'float');</MCode>
               </Code>
               <Description>no help available</Description>
            </Method>
            <Method>
               <Name>measOBW</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function data=measOBW(obj)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.

% Get the interface object
interface=get(obj,'interface');

% Change instrument mode to spectrum analyzer
fprintf(interface,':INST:NSEL 1');

% Tell it the precision
fprintf(interface,':FORM:DATA REAL,32');

% Set the Occupied Bandwidth Meas Mode
fprintf(interface,':READ:OBW?');

% Get the data back
data=binblockread(interface,'float');
</MCode>
               </Code>
               <Description>no help available</Description>
            </Method>
            <Method>
               <Name>querySCPI</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function res=querySCPI(obj,cmd)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.
interface=get(obj,'interface');

res=query(interface,cmd);</MCode>
               </Code>
               <Description>querySCPI sends an SCPI string to the instrument and returns its response.

Input parameters: SCPI string
Output parameters: response string from the instrument</Description>
            </Method>
            <Method>
               <Name>sysPreset</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function sysPreset(obj,type)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.


interface = get(obj, 'Interface');
fprintf(interface, ':SYST:PRES');</MCode>
               </Code>
               <Description>sysPreset presets the instrument according to the curent preset mode
(SCPI command: :SYST:PRES)</Description>
            </Method>
            <Method>
               <Name>writeSCPI</Name>
               <Location>parent</Location>
               <CapabilityGroup>Base</CapabilityGroup>
               <Type>MCode</Type>
               <Code>
                  <MCode>function writeSCPI(obj,cmd)
% For group functions, OBJ is the group object. For
% base device functions, OBJ is the device object.
interface=get(obj,'interface');

fprintf(interface,cmd);</MCode>
               </Code>
               <Description>writeSCPI sends an SCPI string to the instrument

Input parameters: SCPI string
Output parameters: none</Description>
            </Method>
         </MethodInfo>
      </Group>
   </GroupInfo>
</MATLABInstrumentDriver>