Veethree D7 SDK
Loading...
Searching...
No Matches
I/O: Analog, Digital, PWM

< Details index

Purpose

This document serves as a practical reference for developers working with the D7 platform. It provides:

  • Pinout diagrams and connector specifications
  • Connection examples for all supported interface types
  • References to corresponding software API examples

Target I/O Overview

The D7 platform provides multiple I/O interfaces for connecting various sensors and actuators, as shown in the diagram below:

D7 I/O Overview

The diagram shows the primary I/O interfaces:

  • Analog input (VRSNS0-5)
  • 4-20 mA current loop inputs (420MA0-5 -/+)
  • Digital input (DIN0-4)
  • Digital output (DOUT0-5)
  • Frequency/PWM input (FREQIN0-1)
  • Frequency/PWM output (FREQOUT0-1)

Interfaces

The D7 has two I/O related interfaces:

AMPSEAL 35-way Connector
AMPSEAL 23-way Connector

The 35-pin AMPSEAL connector is the primary I/O interface.

You will need TE part number 776164-1 for 16-20 AWG, or 2371885-1 for 20-24 AWG. Plus 1.3mm contacts.

The connector provides access to all digital, analog, and communication interfaces of the D7 device. The pinout is organized to group similar functions together where possible.

Analog

The D7 provides 6 voltage/resistance sensing channels that can be configured for voltage, resistance or temperature measurement.

Board revision differences

Boards v6 and above give more accurate readings. To identify your board version refer to Board Version.

Choosing to use AGND or RREF

There are two options for resistance readings:

  • the sender is connected using one wire to the display (using one of the VRSNS[0:5] pins), and the other wire is connected to the common reference point (e.g. negative rail of power supply, chassis, etc).

    Note: On v6 and above boards, this requires connecting the AGND pin (Ampseal 23 pin 4) to the common reference point as well.

    You must not short the AGND pin to the Battery- pin on the Ampseal 23. Instead, use a thick wire to connect Battery- (Ampseal 23 pin 3) to the negative rail of the power supply and a separate wire to connect AGND to the negative rail.

    On v5 and below boards, no other connection is required.

  • the sender is connected using two wires to the display, with one connected to one of the VRSNS[0:5] pins, and the other connected to the R_REF pin.

The 1-wire method is generally more convenient, but less accurate in the sub-400Ω range.

If higher accuracy in this range is needed, use the 2-wire method.

For 1-wire connections, D7 revisions v6 and above are more accurate than v5 boards.

AGND connection

If you plan to use the RREF pin as a reference instead, AGND can be left floating.

On all board revisions you must use a thick wire for connecting the Battery- pin to the negative power supply rail.

Pin Locations

Channel Pin Number Description
VRSNS_0 6 Voltage/Resistance Sense Channel 0
VRSNS_1 17 Voltage/Resistance Sense Channel 1
VRSNS_2 5 Voltage/Resistance Sense Channel 2
VRSNS_3 16 Voltage/Resistance Sense Channel 3
VRSNS_4 4 Voltage/Resistance Sense Channel 4
VRSNS_5 15 Voltage/Resistance Sense Channel 5

Resistance Measurement

The D7 provides 6 resistance measurement channels that can be configured for 1 or 2-wire sensor connections.

a. 1-wire resistance sensing (using VRSNS pins and AGND pin)

Connect one leg of the resistive sender to any VRSNS pin, connect the other leg to the negative rail on the power supply.

On board revision 6 and above, AGND must also be connected to the negative rail on the power supply, as in the diagram below. On earlier board revisions (v5 and below), no additional connection is needed.

For example, to setup the resistance measurement on VRSNS_0, here is the connection diagram:

Resistance sensing for pin VRSNS_0

After following the connection diagram, the resistance value can be read using the SDK. The function vsdk::io::profile_builder::add_one_wire_resistive_sensor can be used to configure a 1-wire sensor.

b. 2-wire resistance measurement (using VRSNS pins and RREF pin)

Connect any VRSNS pin to the positive pin of the sensor and connect RREF and another VRSNS pin to the negative pin of the sensor, as follows:

2 wire R sensing (VRSNS_0 and RREF)

Similar to the 1-wire resistance sensing, you can use vsdk::io::profile_builder::add_two_wire_resistive_sensor function on your profile builder, and then just read the sensor value.

c. 3-wire/4-wire RTD measurement

3 wire RTD sensing

Follow the same setup for sensing RTD sensor using 3 and 4 wire connection as before, see vsdk::io::profile_builder::add_three_wire_rtd and vsdk::io::profile_builder::add_four_wire_rtd functions.

Refer to the Analog for more information on how to setup and read resistance measurement.

Voltage Measurement (using VRSNS pins and AGND pin)

Here is an example wiring diagram for using the voltage measurement sensor on VRSNS_0:

Voltage sensing for pin VRSNS_0

The relevant example is Analog Read. In the example, to configure for voltage, rather than resistance, change vsdk::io::profile_builder::add_one_wire_resistive_sensor to vsdk::io::profile_builder::add_voltage_sensor.

Temperature measurement

a. Thermocouple sensor

API reference: vsdk::io::profile_builder::add_thermocouple.

The D7 supports thermocouple sensors using the following block wiring diagram:

Thermocouple sensor block wiring

Only some pins can be used as the positive pin in the thermocouple sensor configuration, with the other ones being reserved for the negative pin.

Positive Pins Negative Pins
VRSNS_1 VRSNS_0
VRSNS_3 VRSNS_2
VRSNS_5 VRSNS_4

The D7 supports the following types of thermocouple sensors:

  • Type B
  • Type E
  • Type J
  • Type K
  • Type N
  • Type R
  • Type S
  • Type T

b. 2-wire Pt100 resistive thermal detector

API reference: vsdk::io::profile_builder::add_two_wire_rtd.

The D7 supports 2-wire Pt100 RTD sensors using the following block wiring diagram:

2 wire Pt100 RTD sensor

The positive pin is restricted to the same 3 pins as the thermocouple sensor:

  • VRSNS_1
  • VRSNS_3
  • VRSNS_5

The 2-wire RTD sensor is more accurate than the thermocouple sensor.

c. 3-wire Pt100 resistive thermal detector

API reference: vsdk::io::profile_builder::add_three_wire_rtd.

The D7 supports 3-wire Pt100 RTD sensors using the following block wiring diagram:

3 wire Pt100 RTD sensor

The same restrictions apply on the pins as for the thermocouple sensor.

The 3-wire RTD sensor is more accurate than the 2-wire RTD sensor, but less accurate than the 4-wire one.

d. 4-wire Pt100 resistive thermal detector

API reference: vsdk::io::profile_builder::add_four_wire_rtd.

The D7 supports 4-wire Pt100 RTD sensors using the following block wiring diagram:

4 wire Pt100 RTD sensor

The 4-wire RTD sensor is the most accurate temperature sensor on the D7.

The following pins can be used for the following terminals:

Pin\Terminal Positive A Positive B Negative B
VRSNS_0 ✅ ✅
VRSNS_1 ✅ ✅
VRSNS_2 ✅ ✅
VRSNS_3 ✅ ✅
VRSNS_4 ✅ ✅
VRSNS_5 ✅ ✅

Note: One physical pin can only be assigned to one terminal (one of Positive A, Positive B, Negative B) at any given moment. For instance, VRSNS_0 cannot be used for Positive A and Positive B at the same time.

4-20 mA

4-20 mA Inputs

The D7 provides 6 current loop channels that can be configured for 4-20mA sensor connections.

Pin Locations

Channel Pin Number Description
420MA_0+ 12 4-20mA Channel 0
420MA_0- 23 4-20mA Channel 0
420MA_1+ 11 4-20mA Channel 1
420MA_1- 22 4-20mA Channel 1
420MA_2+ 10 4-20mA Channel 2
420MA_2- 21 4-20mA Channel 2
420MA_3+ 9 4-20mA Channel 3
420MA_3- 20 4-20mA Channel 3
420MA_4+ 8 4-20mA Channel 4
420MA_4- 19 4-20mA Channel 4
420MA_5+ 7 4-20mA Channel 5
420MA_5- 18 4-20mA Channel 5

Connect your signal source (example: 4-20mA sensor) to the appropriate 420MA pin and use the 4-20mA input example code to read the values of any of the configured pins. Also see vsdk::io::i420_input.

Digital

Digital Input (DIN0-DIN4)

The D7 provides 5 digital input channels that can be configured for active-high or active-low operation.

Pin Locations

Channel Pin Number Description
DIN0 35 Digital Input Channel 0
DIN1 34 Digital Input Channel 1
DIN2 33 Digital Input Channel 2
DIN3 32 Digital Input Channel 3
DIN4 31 Digital Input Channel 4

Connect your signal source to the appropriate DIN pin and use the digital input example code to read the input status.

Digital Output (DOUT0-DOUT5)

The D7 provides 6 digital output channels that can be configured for active-high or active-low operation.

Pin Locations

Channel Pin Number Description
DOUT0 25 Digital Output Channel 0
DOUT1 24 Digital Output Channel 1
DOUT2 13 Digital Output Channel 2
DOUT3 1 Digital Output Channel 3
DOUT4 2 Digital Output Channel 4
DOUT5 3 Digital Output Channel 5

Connect your signal source to the appropriate DOUT pin and use the digital output example code to control the output status (like, for instance, an LED indicator).

PWM

PWM Input (FREQIN0, FREQIN1)

The D7 provides 2 PWM input channels that can be configured for frequency measurement or RPM sensor connection.

Pin Locations

Channel Pin Number Description
FREQIN0 29 PWM Input Channel 0
FREQIN1 28 PWM Input Channel 1

Connect the PWM signal source ground to BATT- and connect signal positive to the appropriate FREQIN pin. To use the PWM input, refer to PWM I/O to read the input status on the connected channel.

PWM Output (FREQOUT0, FREQOUT1)

The D7 provides 2 PWM output channels.

Pin Locations

Channel Pin Number Description
FREQOUT0 27 PWM Output Channel 0
FREQOUT1 26 PWM Output Channel 1

Connect the PWM load ground to BATT- and the positive to the appropriate FREQOUT pin. To use the PWM output, refer to PWM I/O to control the output signal.