# WEB-TEMP and WEB-TC

The WEB-TEMP and WEB-TC support the following features.

## Temperature input

Functions

UL: cbTIn(), cbTInScan()

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

Python for Windows: t_in(), t_in_scan()

Scale

CELSIUS, FAHRENHEIT, KELVIN, NOSCALE*

*Refer to NOSCALE in the Hardware considerations section below for more information on this option.

HighChan

0 to 7

## Digital I/O

Configuration

UL: cbDConfigBit(), cbDConfigPort()

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

Python for Windows: d_config_bit(), d_config_port()

PortNum

AUXPORT

PortType

AUXPORT

Port I/O

UL: cbDIn(), cbDOut()

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

Python for Windows: d_in(), d_out()

PortNum

AUXPORT

DataValue

0 to 255 on AUXPORT

Bit I/O

UL: cbDBitIn(), cbDBitOut()

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

Python for Windows: d_bit_in(), d_bit_out()

PortType

AUXPORT

BitNum

0 to 7 on AUXPORT

## Configuration

Functions

UL: cbGetConfig(), cbSetConfig(), cbGetConfigString(), cbSetConfigString()

Python for Windows: get_config(), set_config(), get_config_string(), set_config_string()

ConfigItem

BIUSERDEVID, BINETIOTIMEOUT, BIHIDELOGINDLG

Device Number

0

maxConfigLen

Up to 48

## Miscellaneous

Functions

UL: cbDeviceLogin(), cbDeviceLogout(), cbFlashLED()

UL for .NET: DeviceLogin(), DeviceLogout(), FlashLED()

Python for Windows: device_login(), device_logout(), flash_led()

Call cbFlashLED()/FlashLED()/flash_led() to flash the POWER/COMM LED on a WEB device. This is useful if you have multiple devices connected and you want to identify a particular device.

## Hardware considerations

##### Web based

If the user name and password have changed from the default, log in with the new user name and password to change configuration settings. Only one user can be logged in at a time. The log in session times out after five minutes of inactivity. Log in is not required to view the current configuration in InstaCal.

Hardware options are configurable on the web browser or with InstaCal. If hardware options are changed on the web browser while InstaCal is open, restart or refresh InstaCal to update its configuration pages with the settings stored on the device. Network parameters and some configuration settings for resistance measurement are configurable with InstaCal only.

Configuration options are stored in non-volatile memory in EEPROM, and are loaded on power up.

##### Network parameters

The following network parameters are configurable with InstaCal. Configurable network options are enabled when you start InstaCal if the default user name and password are assigned. If a custom user name and password are assigned, the configurable network options are enabled after you log in.

- Identifier: Text that identifies the device. This value is optional, and is not set by default. You can enter up to 48 alpha-numeric characters. To set this value in code, use the UL ConfigItem option BIUSERDEVID with cbSetConfigString().
- DHCP: Enables automatic configuration of the IP address for a device by a DHCP Server. When a DHCP-enabled server is available, an IP address is automatically assigned to the device when it is detected on the network. This value is set to Enabled by default. Disable this option when the server is not DHCP-enabled, or when you want to enter a static IP address.
- IP: The IP address that is currently stored on the device is displayed in the Current Settings frame on the InstaCal Board Configuration dialog. By default, this address is set automatically when a DHCP server is available. If you are setting a static IP address manually, enter it in the IP text box on the Default Settings frame. Every device connected to the network must have a unique IP address. This value is set to 192.168.0.101 by default.
- Subnet: The Subnet Mask that is currently stored on the device is displayed in the Current Settings frame on the InstaCal Board Configuration dialog. The Subnet Mask is the part of the IP address that denotes the local Subnet. By default, the Subnet Mask is set automatically when a DHCP server is available. If you are setting a static IP address manually, enter the Subnet Mask in the Subnet text box on the Default Settings frame.
- This value is set to 255.255.255.0 by default. The first three groups of numbers indicate the network number to which the device is connected, and the last group indicates the node number within the network that identifies the device.
- Gateway: The Gateway IP address that is currently stored on the device is displayed in the Current Settings frame on the InstaCal Board Configuration dialog. By default, the Gateway IP address is set automatically when a DHCP server is available. If you are setting a static IP address manually, enter the Gateway in the Gateway text box on the Default Settings frame. This value is set to 192.168.0.1 by default. The Gateway parameter is used for communication between devices on different networks.
- Server: Enables or disables the device web page server. This value is set to Enabled by default. When enabled, you can view the device web page with a web browser. When disabled, you can only access the device with InstaCal or the Universal Library. Disable when you want to restrict access to the device web page. Changes to this setting take affect the next time you power up the device.
- Change Login button: Opens a dialog to change the user name and password used to log in to a device session. Once changed, log in is required to change configurable options on the device. The user name and password are not stored on the host computer, and must be entered each time you start the application. Refer to Logging in to a device session below for more information.
- Login button: This button is enabled when login is required.

The InstaCal configuration page also lists the unique 64-bit physical (MAC) address assigned to the device. You cannot change this address.

##### Logging in to a device session

You must be logged in to a device session in order to change the configuration settings of a device or change the state of the digital outputs. A user name and password are required to log in if they are not set to the default values. For security, it is recommended that you change the login values from the defaults. The log in session times out after five minutes of inactivity.

The default user name is set to webtemp for the WEB-TEMP, and webtc for the WEB-TC. The default password is mccdaq for both devices. You can change these values in InstaCal with the Change Login button after you are logged in to a device session.

When the user name and password have changed from the default values, the configuration page opens with configurable items disabled and the Login button enabled. Click the Login button and then enter the values. The INVALIDLOGIN error is returned if the login information is not valid. The SESSIONINUSE error is returned if you attempt to log in when a session is currently open by another user. Only one user can be logged in to a session at a time.

Similarly, applications written with the Universal Library perform a background login when required, if the login parameters are set to the default values. If custom values are set, either allow the default login dialog to pop up when required, or disable the default dialog and handle login in your code.

To disable the default login dialog with the Universal Library, select the Show Login dialog prompt checkbox in InstaCal. For a more permanent result, disable the default dialog using cbSetConfig() with the BIHIDELOGINDLG ConfigItem argument within your application code.

##### Factory default reset

To restore the network parameters (including the user name and password) to the factory default settings, press and hold the device reset button for three seconds. You do not have to be logged in to restore the default network settings.

##### Manually adding devices to InstaCal

If a device is not yet connected to the local network, or if it is connected remotely to a different LAN, InstaCal will be unable to detect it. If autodetection fails, you can manually add the device to InstaCal using the E/WEB tab on the Board Selection List dialog, and specify the IP address and port to use in the broadcast.

The default IP address and port add a placeholder to the configuration of a WEB device detected on the network. The default IP address broadcasts to all devices detected on the local subnet. The default port lists the default port number that is used to interface with the UL.

Any instance of the device type responding to the broadcast will attach to the placeholder. You can specify the device to attach to the placeholder by clicking the MAC check box and entering the device type and instance ID. Enter C0 to locate a WEB-TC, or C2 to locate a WEB-TEMP. Enter any value from 0x00000 to 0x2FFFE (except 0x1FFFF) for the instance ID. The first three octets of a MAC address indicate the vendor ID and cannot be changed.

##### Configuring the DIO channels to generate alarms

The WEB-TEMP and WEB-TC provide eight independent temperature alarms. Each alarm controls an associated digital I/O channel as an alarm output. The input to each alarm is one of the temperature input channels. You set up the temperature conditions to activate an alarm, and the output state of the digital channel (active high or low) when activated. You can view the alarm status on the web browser.

Digital channels that are configured as alarms will power up in an output state. When an alarm is activated, the associated DIO channel is driven to the output state defined by the alarm configuration. Alarm configurations are stored in non-volatile memory on the device and are loaded on power up. Alarm settings can be configured using the device web browser or InstaCal.

##### Pacing temperature readings

The internal update rate for temperature measurement is a fixed value for these devices. If the UL reads the device faster than the internal update rate, temperature readings "repeat." For example, if using cbTIn() 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.

##### Using single sensors with cbTInScan() (WEB-TEMP only)

When using single sensors for RTD or thermistor sensors, you should ignore the data for channels that do not have sensors attached. It is best to use cbTIn() for these configurations, since you can select which channels to read. If you use cbTInScan(), however, data for all channels over the entire range of channels are returned. Since some channels are not populated in this configuration, filter out the data for channels without sensors.

##### NOSCALE

Specify the NOSCALE option to retrieve raw data in volts or resistance from the device. When NOSCALE is specified, calibrated data is returned, although a cold junction compensation (CJC) correction factor is not applied to the returned values.

##### Channel names

You can specify a custom name for each of the device channels with InstaCal. Enter up to 10 alpha-numeric characters in the Name text box on each channel configuration page.

##### Saving configuration settings

InstaCal allows you to save hardware configuration settings to a file, or load a configuration from a previously saved file.

Each WEB-TEMP channel can be configured to measure temperature data collected by one of five categories of temperature sensors: thermistors, thermocouples, RTDs, semiconductors, and Disabled. Each WEB-TC channel can be configured to measure temperature data collected by one of eight types of thermocouples.

##### Recommended warm-up time

Allow the device to warm-up for 30 minutes before taking measurements. This warm-up time minimizes thermal drift and achieves the specified rated accuracy of measurements. For RTD or thermistor measurements, this warm-up time is also required to stabilize the internal current reference.

##### Calibration

You can manually calibrate the device using InstaCal or the web interface.

The WEB-TEMP is automatically calibrated any time the sensor category is changed in the configuration. If the device is not warmed up when this occurs, re-calibrate after the specified warm-up time.

##### Timeout errors

In some cases, there can be delays in obtaining the data from the WEB device, causing a NOREMOTEACK error to be generated. This can be caused by other users making configuration changes on the device, or by slow or busy network connections.

You can use the ConfigItem option BINETIOTIMEOUT with cbSetConfig() to set the time (in mS) to wait for a device to acknowledge a command or query made via the network connection.