Gryphon : Hardware Information : PIC I/O card

Gryphon Hardware Information: PIC I/O card

External HD-15 connector pinout

Pin #	Channel	Assignment
01	1	Analog Input 1 / Digital Input 1 / Frequency Input
02	1	Analog Input 2 / Digital Input 2
03	1	Analog Input 3 / Digital Input 3 (pseudo)
04	1	Analog Input 4 / Digital Input 4 (pseudo)
05	1	Analog Input 5 / Digital Input 5 (pseudo)
06	1	Analog Input 6 / Digital Input 6 (pseudo)
07	1	Analog Input 7 / Digital Input 7 (pseudo)
08	1	Analog Input 8 / Digital Input 8 (pseudo)
09	1	Variable Programming Voltage (not currently implemented)
10	1	Ground
11	1	Digital Output 1 / PWM Output
12	1	Digital Output 2
13	1	Digital Output 3
14	1	Digital Output 4
15	1	Optional Output Pullup Voltage

Note: This card cannot be used to power the Gryphon.

Event definitions

There are no events specific to this card.

Please also see generic events for non card-specific events.

I/O messages

I/O messages are normal Gryphon Protocol FT_DATA messages sent to or received from the card. The header is a single byte which specifies which value is to be read or written. Any data required for a given header byte should be placed in the data portion of the FT_DATA message.

NOTE: Multi-byte data values for reads and writes of Data Messages should be in little endian format which is normal for x86 computers.

Read Data Messages

The header byte determines the value to be read as shown below. An FT_DATA message with no data bytes is used as a read request. The card will respond with an FT_DATA having the same header as the request and the requested data.

Header	Description	Returned Data
GET_CAP_VAL_1 (0x81)	Get first capture value (period)	Signal period from input on pin 1 in tenths of microseconds. The value is returned as a long value of four bytes.
GET_DIGITAL_IN (0x82)	Read digital inputs	The eight digital inputs on pins 1 through 8 are returned in bits 0 and 1 respectively of a single byte. The inputs on pins3 through 8 are read as analog values and converted to a 0 or 1 based on whether the value is less than or greater than or equal to 2.00 volts.
GET_DIGITAL_OUT (0x83)	Read digital outputs	The four digital outputs on pins 14 through 11 are returned in bits 0 through 3 respectively of a single byte.
GET_ANALOG_IN1 (0x90)	Read analog input 1	The voltage on pin 1 in floating point format (four bytes).
GET_ANALOG_IN2 (0x91)	Read analog input 2	The voltage on pin 2 in floating point format (four bytes).
GET_ANALOG_IN3 (0x92)	Read analog input 3	The voltage on pin 3 in floating point format (four bytes).
GET_ANALOG_IN4 (0x93)	Read analog input 4	The voltage on pin 4 in floating point format (four bytes).
GET_ANALOG_IN5 (0x94)	Read analog input 5	The voltage on pin 5 in floating point format (four bytes).
GET_ANALOG_IN6 (0x95)	Read analog input 6	The voltage on pin 6 in floating point format (four bytes).
GET_ANALOG_IN7 (0x96)	Read analog input 7	The voltage on pin 7 in floating point format (four bytes).
GET_ANALOG_IN8 (0x97)	Read analog input 8	The voltage on pin 8 in floating point format (four bytes).

Write Data Messages

The header byte determines the value to be written as shown below. An FT_DATA message with one or more data bytes is used as a write request. If the write is successful, no response occurs.

Header	Description	Sent Data
SET_PWM_VAL_1 (0x02)	Set the first PWM output value.	The percentage of on time for a cycle of of output of the first PWM output in 0.01%. Valid values range from 0.00% to 100.00% (0 to 10000) The data field is two bytes long.
SET_DIGITAL_OUT (0x04)	Set one or more digital outputs.	Each set bit in the single data byte causes the corresponding digital output to be set. All reset bits in the single data byte are ignored.
CLR_DIGITAL_OUT (0x05)	Clear one or more digital outputs.	Each set bit in the single data byte causes the corresponding digital output to be reset. All reset bits in the single data byte are ignored.
TOG_DIGITAL_OUT (0x06)	Toggle one or more digital outputs.	Each set bit in the single data byte causes the corresponding digital output to be toggled. All reset bits in the single data byte are ignored.
CLR_DIGITAL_OUT (0x05)	Clear one or more digital outputs.	Each set bit in the single data byte causes the corresponding digital output to be reset. All reset bits in the single data byte are ignored.

Card-specific IOCTL definitions

These values are used with the CMD_CARD_IOCTL command.
Please see the include files dev_iopic.h for numeric values of IOCTLS and data field bit assignments.

NOTES:

Multi-byte data values should be in little endian format which is normal for x86 computers. The four byte field that contains the IOCTL value, however, is in big endian format (network byte order)

At 0% and 100% the PWM output is constant. The PWM output may disabled by setting the mode parameter of the GDGIOSETPWM1 IOCTL to zero. The variable output voltage mode of the PWM output is not currently implemented.

The second parameter of the GDGIOSETCAP1 IOCTL, the number of triggers per cycle or revolution, allows the period measurement to encompass from 1 to 16 triggers. In the case of unevenly spaced multiple triggers per cycle, this allows all of the time periods of a cycle to be added together. It can also be used as a averaging mechanism if there is only one trigger per revolution. The periods are still added together so that the value read via GET_CAP_VAL_1 must be divided by the number of triggers per cycle to get the correct period.

To stop a periodic transmission that has been started with the GDGIOSETPERn IOCTL, use the same IOCTL but set the number of messages to transmit to zero. In this case the additional bytes (4 through 15) are not needed.

IOCTL name Function Data field length/purpose

GDGIOSETPWM1 Setup the first PWM output Seven data bytes

Bytes 1 thru 4: Frequency in 0.1Hz increments

Bytes 5 and 6: Initial value in 0.01% increments

Byte 7: Mode
0 -> off
1 -> PWM output to digital output 1 (pin 1)
2 -> PWM output to variable voltage (pin 9)
3 -> PWM output to both of above

GDGIOSETCAP1 Setup the first frequency input Four data bytes

Byte 1: Rising/Falling edge trigger (0/1)

Byte 2: Triggers per cycle/revolution (1 to 16)

Bytes 3 and 4: Maximum time in milliseconds between triggers. If this time is exceeded, the frequency is set to zero.

GDGIOSETPER1 Setup the first periodic transmission Variable number of data bytes

Bytes 1 and 2: The number of milliseconds between each transmission.

Byte 3: The number of messages to transmit. Must be between 1 and 12.

Bytes 4 through 15: The ID (header) codes for the data to be periodically transmitted by the card.

GDGIOSETPER2 Setup the second periodic transmission Variable number of data bytes

Bytes 1 and 2: The number of milliseconds between each transmission.

Byte 3: The number of messages to transmit. Must be between 1 and 12.

Bytes 4 through 15: The ID (header) codes for the data to be periodically transmitted by the card.

GDGIOSETPER3 Setup the third periodic transmission Variable number of data bytes

Bytes 1 and 2: The number of milliseconds between each transmission.

Byte 3: The number of messages to transmit. Must be between 1 and 12.

Bytes 4 through 15: The ID (header) codes for the data to be periodically transmitted by the card.

GDGIOSETPER4 Setup the fourth periodic transmission Variable number of data bytes

Bytes 1 and 2: The number of milliseconds between each transmission.

Byte 3: The number of messages to transmit. Must be between 1 and 12.

Bytes 4 through 15: The ID (header) codes for the data to be periodically transmitted by the card.

GDGIOGETGAIN Get the gain of the specified analog channel Two data bytes

Byte 1: The analog channel number (0 through 7).

Byte 2: The channel's current gain value.

GDGIOSETGAIN Set the gain of the specified analog channel Two data bytes

Byte 1: The analog channel number (0 through 7).

Byte 2: The channel's new gain value. Must be 1, 2, 4, 5, 8, 10 or 16. The default value is 1.

GDGIOGETSTATE Get the scan state of the requested analog channel Two data bytes

Byte 1: The analog channel number (0 through 7).

Byte 2: The channel's current scan state, 0 = off (not scanning); 1 = on (scanning).

GDGIOSETSTATE Set the scan state of the requested analog channel Two data bytes

Byte 1: The analog channel number (0 through 7).

Byte 2: The channel's new scan state, 0 = off (not scanning); 1 = on (scanning). Defaults to off.

IOCTL name	Function	Data field length/purpose
GDGIOSETPWM1	Setup the first PWM output	Seven data bytes Bytes 1 thru 4: Frequency in 0.1Hz increments Bytes 5 and 6: Initial value in 0.01% increments Byte 7: Mode 0 -> off 1 -> PWM output to digital output 1 (pin 1) 2 -> PWM output to variable voltage (pin 9) 3 -> PWM output to both of above
GDGIOSETCAP1	Setup the first frequency input	Four data bytes Byte 1: Rising/Falling edge trigger (0/1) Byte 2: Triggers per cycle/revolution (1 to 16) Bytes 3 and 4: Maximum time in milliseconds between triggers. If this time is exceeded, the frequency is set to zero.
GDGIOSETPER1	Setup the first periodic transmission	Variable number of data bytes Bytes 1 and 2: The number of milliseconds between each transmission. Byte 3: The number of messages to transmit. Must be between 1 and 12. Bytes 4 through 15: The ID (header) codes for the data to be periodically transmitted by the card.
GDGIOSETPER2	Setup the second periodic transmission	Variable number of data bytes Bytes 1 and 2: The number of milliseconds between each transmission. Byte 3: The number of messages to transmit. Must be between 1 and 12. Bytes 4 through 15: The ID (header) codes for the data to be periodically transmitted by the card.
GDGIOSETPER3	Setup the third periodic transmission	Variable number of data bytes Bytes 1 and 2: The number of milliseconds between each transmission. Byte 3: The number of messages to transmit. Must be between 1 and 12. Bytes 4 through 15: The ID (header) codes for the data to be periodically transmitted by the card.
GDGIOSETPER4	Setup the fourth periodic transmission	Variable number of data bytes Bytes 1 and 2: The number of milliseconds between each transmission. Byte 3: The number of messages to transmit. Must be between 1 and 12. Bytes 4 through 15: The ID (header) codes for the data to be periodically transmitted by the card.
GDGIOGETGAIN	Get the gain of the specified analog channel	Two data bytes Byte 1: The analog channel number (0 through 7). Byte 2: The channel's current gain value.
GDGIOSETGAIN	Set the gain of the specified analog channel	Two data bytes Byte 1: The analog channel number (0 through 7). Byte 2: The channel's new gain value. Must be 1, 2, 4, 5, 8, 10 or 16. The default value is 1.
GDGIOGETSTATE	Get the scan state of the requested analog channel	Two data bytes Byte 1: The analog channel number (0 through 7). Byte 2: The channel's current scan state, 0 = off (not scanning); 1 = on (scanning).
GDGIOSETSTATE	Set the scan state of the requested analog channel	Two data bytes Byte 1: The analog channel number (0 through 7). Byte 2: The channel's new scan state, 0 = off (not scanning); 1 = on (scanning). Defaults to off.