E-TC

The E-TC supports the following features.

Temperature input

Functions

UL: cbTIn(), cbTInScan()

UL for .NET: TIn(), TInScan()

Python for Windows: t_in(), t_in_scan()

Options

WAITFORNEWDATA

Scale

CELSIUS, FAHRENHEIT, KELVIN, NOSCALE*, VOLTS*

*Refer to Scaling section in the Hardware considerations section for more information on these options.

HighChan

0 to 7

Digital I/O

Configuration

Functions

UL: cbDConfigBit(), cbDConfigPort()

UL for .NET: DConfigBit(), DConfigPort()

Python for Windows: d_config_bit(), d_config_port()

PortNum

AuxPort

PortType

AuxPort

Port I/O

Functions

UL: cbDIn(), cbDOut()

UL for .NET: DIn(), DOut()

Python for Windows: d_in(), d_out()

PortNum

AuxPort

DataValue

0 to 255

Bit I/O

Functions

UL: cbDBitIn(), cbDBitOut()

UL for .NET: DBitIn(), DBitOut()

Python for Windows: d_bit_in(), d_bit_out()

PortType

AuxPort

BitNum

0 to 7

Counter I/O

UL: cbCClear(), cbCIn(), cbCIn32(), cbCLoad(), cbCLoad32()

UL for .NET: CClear(), CIn(), CIn32(), CLoad(), CLoad32()

Python for Windows: c_clear(), c_in(), c_in_32(), c_load(), c_load_32()

Note: Counters on these boards are zero-based (the first counter number is "0").

CounterNum

Count

2³² when reading the counter.

LoadValue

0 when loading the counter.

cbCLoad() and cbCLoad32()CLoad() and CLoad32() are only used to reset the counter to 0. No other values are valid.

The Visual Basic signed integers guidelines apply when using cbCIn() or CIn() for values greater than 32,767 and when using cbCIn32() or CIn32() for values greater than 2,147,483,647.

RegNum

LOADREG0

Miscellaneous

Functions

UL: cbFlashLED()

UL for .NET: FlashLED()

Python for Windows: flash_led()

Causes the LED on a device to blink. When you have several devices connected, use this function to identify a particular device.

Configuration

This hardware supports device detection with the API. Refer to the InstaCal, API Detection, or Both? section for information about whether to use InstaCal or the API to detect and configure hardware.

InstaCal

MAC address

Listed as MAC Address (read only)

Factory serial number

Listed as Factory Serial No. (read only)

Identifier

Device Identifier text box

Calibration date

Listed as Calibrated (read only)

Hardware version

Listed as Firmware Version (read only)

Calibration coefficients table

Calibration Coefficients drop-down combo box

Detect open thermocouples

Detect Open TC checkbox

Thermocouple type

Chan 0: through Chan 7: drop-down combo box

Connection code

Listed as Connection Code

Note: Alarm and network settings are stored on the device, and can only be changed through InstaCal, except for the network connection code which can be changed with the API. Additional information is specified in the Hardware Considerations section below.

Programmable API Functions

MAC Address

UL: cbGetConfigString()

ConfigItem = BIDEVMACADDR

UL for .NET: GetDeviceMacAddress()

Python for Windows:

Python for Windows: get_config_string()

config_item = DEVMACADDR

Factory serial number

UL: cbGetConfigString()

ConfigItem = BIDEVSERIALNUM

UL for .NET: GetDeviceSerialNum()

Python for Windows: get_config_string()

config_item = DEVSERIALNUM

Identifier

UL: cbGetConfigString(), cbSetConfigString()

ConfigItem = BIUSERDEVID

maxConfigLen = up to 64 characters

UL for .Net: GetUserDeviceId(), SetUserDeviceId()

Python for Windows: get_config_string(), set_config_string()

config_item = USERDEVID

max_config_len = up to 64 characters

Hardware version

UL: cbGetConfigString()

ConfigItem = BIDEVVERSION

DevNum = VER_FW_MAIN

UL for .NET: GetDeviceVersion()

Type = VersionType.FW_MAIN

Python for Windows: get_config_string()

config_item = DEVVERSION

dev_num = MAIN

Calibration coefficients table

UL: cbGetConfig(), cbSetConfig()

ConfigItem = BICALTABLETYPE

ConfigVal = CAL_TABLE_FACTORY, CAL_TABLE_FIELD

UL for .NET: GetCalTableType(), SetCalTableType()

Python for Windows: get_config(), set_config()

config_item = CALTABLETYPE

config_val = FACTORY, FIELD

Detect open TC

UL: cbGetConfig(), cbSetConfig()

ConfigItem = BIDETECTOPENTC

ConfigVal = 0 (disable), 1 (enable)

DevNum = the channel number

UL for .NET: GetDetectOpenTc(), SetDetectOpenTc()

Python for Windows: get_config(), set_config()

config_item = DETECTOPENTC

config_val = State enum

Thermocouple type

UL: cbGetConfig(), cbSetConfig()

ConfigItem = BICHANTCTYPE

ConfigVal = TC_TYPE_J, TC_TYPE_K, TC_TYPE_R, TC_TYPE_S, TC_TYPE_B, TC_TYPE_E, TC_TYPE_T, TC_TYPE_N

UL for .NET: GetChanTcType(), SetChanTcType()

Python for Windows: get_config(), set_config()

config_item = CHANTCTYPE

config_val = TcType enum

Connection code

UL: cbGetConfigString(), cbSetConfigString()

ConfigItem = BINETCONNECTIONCODE

UL for .Net: GetNetConnectionCode(), SetNetConnectionCode()

Python for Windows: set_config()

config_item = NETCONNECTIONCODE

Note: Alarm and network settings are stored on the device, and can only be changed through InstaCal (except for the network connection code, which can be changed with the API). Additional information is specified in the Hardware Considerations section below.

Configuring temperature alarms

The digital port is multiplexed – each bit can be used as either a digital bit or temperature alarm. Each alarm controls an associated digital I/O line as an alarm output. When an alarm is activated, the associated digital channel is driven to the output state defined by the alarm configuration. Use InstaCal to set the temperature conditions used to activate an alarm, and the output state of the channel when activated (active high or low). Alarm configurations are stored in non-volatile memory on the device and are loaded on power up.

If the alarm is configured to latch, call cbDClearAlarm()/DClearAlarm()/d_clear_alarm() to clear the alarm state once the condition is resolved.

Pacing temperature readings

The internal update rate for temperature measurement is a fixed value. If the UL reads the device faster than the internal update rate, temperature readings "repeat." For example, if using cbTIn()/TIn()/t_in() in a loop to measure a rapidly changing temperature, readings do not change for several iterations of the loop, then "jump" when the update occurs internally.

Use the WAITFORNEWDATA option to retrieve data only when new, unique data is available.

Scaling

Specify the NOSCALE option to retrieve uncalibrated ADC code from the device.
Specify the VOLTS option to read the voltage input of a thermocouple.

Saving configuration settings

Use InstaCal to save device configuration settings to a file, or to load a configuration from a previously saved file.
Each temperature channel can be configured to measure temperature data collected by one of eight thermocouple types (J, K, R, S, B, E, T, and N.)

Recommended warm-up time

Allow the device to warm-up for 20 minutes before taking measurements. This warm-up time minimizes thermal drift and achieves the specified rated accuracy of measurements.

Error temperature values

–6666 is returned when a value is out of range.
–9999 is returned when an open connection is detected.
–11111 is returned when the channel is disabled.

Adding an Ethernet device to InstaCal

To add an Ethernet device to InstaCal, click the Add Board toolbar button and select the ENET tab.

All devices within the local subnet will be detected and displayed. Select each device that you want to add to the InstaCal configuration file and click Add.
A device that is not within the local subnet must be manually added to InstaCal: in the Detection type list select Manual, and enter the IP address. For a remote network also enter the port. Click Add to add the device to the InstaCal configuration file.

Network parameters

Set network parameters with InstaCal on the Network Settings tab of the Board Configuration dialog box. Configuration options are stored in non-volatile memory in EEPROM, and are loaded on power up.

MAC Address: The unique 64-bit physical (MAC) address assigned to the device. This value cannot be changed.
NetBIOS Name: A unique 16-byte address used to identify a NetBIOS resource on the network. This value cannot be changed.
Connection Code: A value (between 0 and 999999999) that prevents other users from connecting to the device. The device is visible to other users, but connection by another user is not allowed.

The Current Settings area lists the network parameters currently set for the device:

Configure IPv4 address: The IP address configuration. Select DHCP or Link Local, Link Local Only, DHCP Local Only, or Static.
Subnet Mask: The Subnet Mask that is currently stored on the device.
The Subnet Mask is the part of the IP address that denotes the local Subnet. It is set automatically by default when a DHCP server is available. When manually setting a static IP address, enter the value in the Default Settings area Subnet Mask field.
Gateway: The Gateway IP address that is currently stored on the device.
The Gateway parameter is used for communication between devices on different networks. It is set automatically by default when a DHCP server is available. When manually setting a static IP address, enter the value in the Default Settings area Gateway field.

The Default Settings area list the default network parameters for the device. You can change these values when manually configuring the network settings.

IP4V Address: Enter a static IP address if DHCP is not enabled, or if you want to manually configure a device.
Subnet Mask: Enter the Subnet Mask value when using a static IP address.
Gateway: Enter the Gateway value when using a static IP address.

Factory default reset

To restore the network configuration settings to the factory default values, press and hold the device reset button until the device LED blinks once (approximately 4 seconds).