Function
Sets the analog output range for each channel.
Format
Ret = AioSetAoRange ( Id , AoChannel , AoRange )
Parameters
Id
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the Device ID retrieved from AioInit function.
AoChannel
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the channel for that the analog output range is set.
AoRange
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the analog output range from the following range with macro or
value.
The available value differs by the device.
Range |
Macro |
Value |
-10 to 10V |
PM10 |
0 |
-5 to 5V |
PM5 |
1 |
-2.5 to 2.5V |
PM25 |
2 |
-1.25 to 1.25V |
PM125 |
3 |
0 to 10V |
P10 |
50 |
0 to 5V |
P5 |
51 |
0 to 2.5V |
P25 |
53 |
0 to 1.25V |
P125 |
54 |
0 to 20mA |
P20MA |
100 |
4 to 20mA |
P4TO20MA |
101 |
1 to 5V |
P1TO5 |
150 |
Return value
Ret [ C, C++ : long ] [ Python : ctypes.c_long ]
Return values |
Content |
0 |
Normality completion |
7 |
Execute AioResetDevice function because the device has recovered from standby mode |
10001 |
Invalid
Id was specified |
10002 |
AIO
driver can't be called |
13100 |
The
value of AoChannel is outside the designated range of the function |
13101 |
The value of AoRange is outside the designated range of the function |
20001 |
This function can't be used by this device |
20002 |
Can
not use while by another device works |
23100 |
The value of AoChannel is outside the designated range of the device being used |
23101 |
The value of AoRange is outside the designated range of the device being used |
Initial value
It differs by the device type.
If the range is set by software, the initial value is the status when each
device is powered on.
If the range is set by jumper, the initial value is the factory settings.
Remarks
For the devices that cannot be set for each
channel individually, the range is set to all channels.
This function cannot be used on devices without the analog output function.
If the device is in operation, the function cannot be performed.
Specifications based on devices
AIO-163202G-PE |
The range is only
changed by performing the function. Also, the output value becomes
0V when this function is executed. |
AIO-163202F-PE |
The range is only
changed by performing the function. |
AIO-160802L-LPE |
-10 to 10V is fixed. |
AO-1604L-LPE |
-10 to 10V is fixed. |
DA12-16(PCI) |
The range is only changed by performing the
function. |
AO-1604CI3-PCI |
The range is only changed by the JP settings. |
AD12-16(PCI)EV |
The range is only changed by the JP settings. |
AD16-16(PCI)EV |
The range is only changed by the JP settings. |
AIO-160802AY-USB |
-10 to 10V is fixed. |
AIO-163202FX-USB |
The range is only changed by performing the
function. |
AIO-121602LN-USB |
The range is only changed by performing the
function. |
AO-1604LX-USB |
-10 to 10V is fixed. |
CPS-AO-1604LI |
0 to 20mA is fixed. |
CPS-AO-1604VLI |
-10 to 10V is fixed. |
AO-1604VIN-USB |
-10 to 10V is fixed. |
AO-1604AIN-USB |
0 to 20mA is fixed. |
CPSN-AO-1602LC |
The range is only changed by performing the
function. |
CPI-AO-1602LC |
The range is only changed by performing the
function. |
AIO-16256256-DEMO |
All ranges can be set. Initial value is AoRange
= 0. |
Example
The range of Channel 0 is set to -10 to 10V.
C, C++ |
long
Ret; |
Python |
Ret
= ctypes.c_long() |
See also
AioSetAoRangeAll AioGetAoRange