background image

Errorcode

Name

Description

-2

LJE_UNABLE_TO_READ_CALDATA

Warning: Defaults used instead.

-1

LJE_DEVICE_NOT_CALIBRATED

Warning: Defaults used instead.

0

LJE_NOERROR

2

LJE_INVALID_CHANNEL_NUMBER

Channel that does not exist (e.g. DAC2 on a
UE9), or data from stream is requested on a
channel that is not in the scan list.

3

LJE_INVALID_RAW_INOUT_PARAMETER

4

LJE_UNABLE_TO_START_STREAM

5

LJE_UNABLE_TO_STOP_STREAM

6

LJE_NOTHING_TO_STREAM

7

LJE_UNABLE_TO_CONFIG_STREAM

8

LJE_BUFFER_OVERRUN

Overrun of the UD stream buffer.

9

LJE_STREAM_NOT_RUNNING

10

LJE_INVALID_PARAMETER

11

LJE_INVALID_STREAM_FREQUENCY

12

LJE_INVALID_AIN_RANGE

13

LJE_STREAM_CHECKSUM_ERROR

14

LJE_STREAM_COMMAND_ERROR

15

LJE_STREAM_ORDER_ERROR

Stream packet recieved out of sequence.

16

LJE_AD_PIN_CONFIGURATION_ERROR

Analog request on a digital pin, or vice versa

17

LJE_REQUEST_NOT_PROCESSED

Previous request had an error.

19

LJE_SCRATCH_ERROR

20

LJE_DATA_BUFFER_OVERFLOW

21

LJE_ADC0_BUFFER_OVERFLOW

22

LJE_FUNCTION_INVALID

23

LJE_SWDT_TIME_INVALID

24

LJE_FLASH_ERROR

25

LJE_STREAM_IS_ACTIVE

26

LJE_STREAM_TABLE_INVALID

27

LJE_STREAM_CONFIG_INVALID

28

LJE_STREAM_BAD_TRIGGER_SOURCE

30

LJE_STREAM_INVALID_TRIGGER

31

LJE_STREAM_ADC0_BUFFER_OVERFLOW

33

LJE_STREAM_SAMPLE_NUM_INVALID

34

LJE_STREAM_BIPOLAR_GAIN_INVALID

35

LJE_STREAM_SCAN_RATE_INVALID

36

LJE_TIMER_INVALID_MODE

37

LJE_TIMER_QUADRATURE_AB_ERROR

38

LJE_TIMER_QUAD_PULSE_SQUENCE

39

LJE_TIMER_BAD_CLOCK_SOURCE

40

LJE_TIMER_STREAM_ACTIVE

41

LJE_TIMER_PWMSTAOP_MODULE_ERROR

42

LJE_TIMER_SEQUENCE_ERROR

43

LJE_TIMER_SHARING_ERROR

44

LJE_TIMER_LINE_SEQUENCE_ERROR

45

LJE_EXT_OSC_NOT_STABLE

46

LJE_INVALID_POWER_SETTING

47

LJE_PLL_NOT_LOCKED

48

LJE_INVALID_PIN

49

LJE_IOTYPE_SYNCH_ERROR

50

LJE_INVALID_OFFSET

51

LJE_FEEDBACK_IOTYPE_NOT_valid

52

LJE_SHT_CRC

53

LJE_SHT_MEASREADY

54

LJE_SHT_ACK

55

LJE_SHT_SERIAL_RESET

56

LJE_SHT_COMMUNICATION

57

LJE_AIN_WHILE_STREAMING

AIN not available to command/response
functions while the UE9 is stream.

58

LJE_STREAM_TIMEOUT

60

LJE_STREAM_SCAN_OVERLAP

New scan started before the previous scan
completed. Scan rate is too high.

61

LJE_FIRMWARE_VERSION_IOTYPE

IOType not supported with this firmware.

62

LJE_FIRMWARE_VERSION_CHANNEL

Channel not supported with this firmware.

63

LJE_FIRMWARE_VERSION_VALUE

Value not supported with this firmware.

64

LJE_HARDWARE_VERSION_IOTYPE

IOType not supported with this hardware.

65

LJE_HARDWARE_VERSION_CHANNEL

Channel not supported with this hardware.

66

LJE_HARDWARE_VERSION_VALUE

Value not supported with this hardware.

67

LJE_CANT_CONFIGURE_PIN_FOR_ANALOG

68

LJE_CANT_CONFIGURE_PIN_FOR_DIGITAL

69

LJE_LJTDAC_ACK_ERROR

70

LJE_TC_PIN_OFFSET_MUST_BE_4_TO_8

71

LJE_INVALID_DIFFERENTIAL_CHANNEL

72

LJE_DSP_SIGNAL_OUT_OF_RANGE

73

LJE_STREAM_INVALID_CONNECTION

112

UART_TIMEOUT

113

UART_NOTCONNECTED

Use ConfigIO to assign pins to UART

114

UART_NOTENALBED

Use AsynchConfig to Enable UART

115

I2C_BUS_BUSY

Table 4.4-1. Request Level Errorcodes

Errorcode

Name

Description

1000 LJE_MIN_GROUP_ERROR

Errors above this number stop all requests.

1001 LJE_UNKNOWN_ERROR

Unrecognized error that is caught.

1002 LJE_INVALID_DEVICE_TYPE
1003 LJE_INVALID_HANDLE
1004 LJE_DEVICE_NOT_OPEN

AddRequest() called even thought Open() failed.

1005 LJE_NO_DATA_AVAILABLE

GetResult() call without calling a Go
function, or a channel is passed that was not
in the request list.

1006 LJE_NO_MORE_DATA_AVAILABLE
1007 LJE_LABJACK_NOT_FOUND

LabJack not found at the given id or address.

Table 4-1 lists the errors which are specific to a request. For example, LJE_INVALID_CHANNEL_NUMBER. If this error occurs,
other requests are not affected. Table 4-2 lists errors which cause all pending requests for a particular Go() to fail with the same
error. If this type of error is received the state of any of the request is not known. For example, if requests are executed with a
single Go() to set the AIN range and read an AIN, and the read fails with an LJE_COMM_FAILURE, it is not known whether the AIN
range was set to the new value or whether it is still set at the old value.

5 - Low-level Function Reference

This section describes the low level functions of the U3. These are commands sent over USB directly to the processor on the U3.

The majority of Windows users will use the high-level UD driver rather than these low-level functions.

42

Содержание LJU3-LV

Страница 1: ...sponsible for shipping to LabJack Corporation and LabJack Corporation will pay for the return shipping Limitation of Liability LabJack designs and manufactures measurement and automation peripherals t...

Страница 2: ...entry below the serial number to bring up the U3 configuration panel Click on Test in the configuration panel to bring up the test panel where you can view and control the various I O on the U3 If LJ...

Страница 3: ...14 exe Size 49 99 MB Upload date 2014 10 14 12 45 The LabJack Control Panel application LJCP handles configuration and testing of the UD series hardware Click on the Find Devices button to search for...

Страница 4: ...or Ethernet devices using specified IP addresses Only applies to UE9 device LJControlPanel is normally installed by the main LabJack installer which is the link at the top of the page 1 2 Self Upgrade...

Страница 5: ...rent I O areas Communication Edge Screw Terminal Edge DB Edge The communication edge has a USB type B connector with black cable connected in Figure 2 1 All power and communication is handled by the U...

Страница 6: ...tal operations including analog digital configuration are ignored on these 4 fixed analog inputs Timers and counters can appear on various pins but other I O lines never move For example Timer1 can ap...

Страница 7: ...Negative Channel Numbers Positive channel 31 puts the internal Vreg 3 3 volts on the positive input of the ADC See Section 2 6 4 for information about the internal temperature sensor If the negative c...

Страница 8: ...aging the U3 but more thought is required to determine what is necessary to make useful measurements with the U3 or any measurement device Voltage versus ground The single ended analog inputs on the U...

Страница 9: ...es are noted connect the ground to U3 SGND with a 100 series resistor Then again use the DMM to measure the voltage of each signal wire before connecting to the U3 Another good general rule is to use...

Страница 10: ...Figure 2 6 2 where one of the resistors is known and the other is the unknown If Vin is known and Vout is measured the voltage divider equation can be rearranged to solve for the unknown resistance 2...

Страница 11: ...e other channel to GND with a small jumper and then take a differential reading of your channel compared to that grounded channel The nominal input range of a high voltage single ended analog input is...

Страница 12: ...d offset but of course the op amp must be powered with supplies greater than the desired output range depending on the ability of the op amp to drive it s outputs close to the power rails If 10 12 or...

Страница 13: ...h bit of I O corresponds to the same bit in the parameter e g the direction of FIO0 is set in bit 0 of parameter FIODir For instance in the low level function ConfigU3 the parameter FIODirection is a...

Страница 14: ...tal input to about 3 3 volts logic high When the switch is closed the ground connection will overpower the pull up resistor and pull the digital input to 0 volts logic low Since the mechanical switch...

Страница 15: ...ll turn on When the digital line is set to input it is the equivalent of a 3 3 volt connection with 100 k in series The resulting voltage across the control inputs of the relay will be close to zero a...

Страница 16: ...Hz 2 22 48 MHz default 3 23 1 MHz Divisor 4 24 4 MHz Divisor 5 25 12 MHz Divisor 6 26 48 MHz Divisor Table 2 9 2 U3 Timer Clock Base Options Note that these clocks apply to the U3 hardware revision 1...

Страница 17: ...an interrupt 61 times per second If this interrupt happens to be in progress when the edge occurs a delay of about 1 microsecond is possible If the software watchdog is enabled the system timer inter...

Страница 18: ...is 100 Hz that means the period is 10 milliseconds and thus after the command is received by the device it could be anywhere from 0 to 10 milliseconds before the start of the frequency output Frequen...

Страница 19: ...timing modes described above modes 2 3 except that hardware capture registers are used to record the edge times This limits the times to 16 bit values but is accurate to the resolution of the clock a...

Страница 20: ...e ability of these lines to sink or source current Refer to the specifications in AppendixA All digital I O on the U3 have 3 possible states input output high or output low Each bit of I O can be conf...

Страница 21: ...corner Then clockwise it goes Vbus 5 volts lower right pin 1 red wire D lower left pin 2 white wire and D upper left pin 3 green wire If you have a shield wire it can be connected to either of the lar...

Страница 22: ...FIO4 EIO7 are still available as flexible I O same as the U3 LV Revision 1 20 21 U3s cannot be upgraded to 1 30 3 Operation The following sections discuss command response mode and stream mode Comman...

Страница 23: ...the UD driver will split it like that The tables above were measured with U3 hardware version 1 21 which started shipping in late August of 2006 The times could be up to twice as long with hardware ve...

Страница 24: ...roll but the MSW be captured before it is incremented That means that only the LSW is reliable and thus you might as well just use the 16 bit modes Mode 11 the upper 32 bits of the system timer is not...

Страница 25: ...ut to all request result functions that tells the function what LabJack it is talking to The handle is obtained from the OpenLabJack function IOType This is an input to all request result functions th...

Страница 26: ...at follow are written in C To help those unfamiliar with strings in C these functions expect null terminated 8 bit ASCII strings How this translates to a particular development environment is beyond t...

Страница 27: ...eful for passing string constants in languages that cannot include the header file and is generally only used with the put get config IOTypes The strings should contain the constant name as indicated...

Страница 28: ...f information with the request to allow a generic parser to determine what should be done when the results are received Outputs None 4 2 6 Go After using AddRequest to make an internal list of request...

Страница 29: ...either function returns LJE_NO_MORE_DATA_AVAILABLE there are no more items in the list of results Items can be read more than once by calling GetFirstResult to move back to the beginning of the list U...

Страница 30: ...scription Returns Constant number of the passed string Inputs pString A pointer to the string representation of the constant Outputs None 4 2 13 ErrorToString Outputs a string describing the given err...

Страница 31: ...on the U3 Resolution Pass a nonzero value to enable QuickSample Settling Pass a nonzero value to enable LongSettling Binary If this is nonzero True the Voltage parameter will return the raw binary va...

Страница 32: ...ckBaseIndex Pass a constant to set the timer base clock The default is device specific 4 TimerClockDivisor Pass a divisor from 0 255 where 0 is a divisor of 256 aTimerModes An array where each element...

Страница 33: ...LE_PORT x1 is number of bits LJ_ioGET_ANALOG_ENABLE_PORT x1 is number of bits When a request is done with one of the port IOTypes the Channel parameter is used to specify the starting bit number and t...

Страница 34: ...t a read of AIN1 using the special 0 3 6 volt range AddRequest lngHandle LJ_ioGET_AIN_DIFF 1 0 32 0 Execute the requests GoOne lngHandle Since multiple requests were made with the same IOType and Chan...

Страница 35: ..._PORT 4 0 10 0 Set FIO3 to output high AddRequest lngHandle LJ_ioPUT_DIGITAL_BIT 3 1 0 0 Set EIO6 CIO2 5 bits starting from digital channel 14 to b10100 d20 That is EIO6 0 EIO7 0 CIO0 1 CIO1 0 and CIO...

Страница 36: ...d dblHighCycles double unsigned long dblValue 65536 dblLowCycles double unsigned long dblValue 65536 dblDutyCycle 100 dblHighCycles dblHighCycles dblLowCycles dblHighTime 0 000001 dblHighCycles dblLow...

Страница 37: ...the stream Start the stream eGet lngHandle LJ_ioSTART_STREAM 0 dblValue 0 The actual scan rate is dependent on how the desired scan rate divides into the LabJack clock The actual scan rate is returned...

Страница 38: ...RAW_OUT 0 numBytesToWrite pwriteArray Raw In This command reads the bytes from the device eGet lngHandle LJ_ioRAW_IN 0 numBytesToRead preadArray 4 3 9 Easy Functions The easy functions are simple alte...

Страница 39: ..._CLOCK_FACTOR LJ_chSPI_MOSI_PIN_NUM LJ_chSPI_MISO_PIN_NUM LJ_chSPI_CLK_PIN_NUM LJ_chSPI_CS_PIN_NUM Following is example pseudocode to configure SPI communication First configure the SPI communication...

Страница 40: ...ial protocol Using this serial protocol is considered an advanced topic A good knowledge of the protocol is recommended and a logic analyzer or oscilloscope might be needed for troubleshooting Also co...

Страница 41: ...not actually sent to the hardware until the LJ_ioSWDT_CONFIG IOType above is used LJ_chSWDT_RESET_DEVICE LJ_chSWDT_UDPATE_DIOA LJ_chSWDT_DIOA_CHANNEL LJ_chSWDT_DIOA_STATE Following is example pseudoco...

Страница 42: ...ious scan completed Scan rate is too high 61 LJE_FIRMWARE_VERSION_IOTYPE IOType not supported with this firmware 62 LJE_FIRMWARE_VERSION_CHANNEL Channel not supported with this firmware 63 LJE_FIRMWAR...

Страница 43: ...umulator 3 Divide by 28 and sum the quotient and remainder 4 Divide by 28 and sum the quotient and remainder Destination bit This bit specifies whether the command is destined for the local or remote...

Страница 44: ...Mask1 Reserved 8 LocalID 9 TimerCounterConfig Bits 4 7 TimerCounterPinOffset Bit 3 Enable Counter1 Bit 2 Enable Counter0 Bit 0 1 Number of timers enabled 10 FIOAnalog 11 FIODirection 12 FIOState 13 EI...

Страница 45: ...fies U3C and if set then bit 4 specifies HV version 5 2 3 ConfigIO Writes and reads the current IO configuration Command Byte 0 Checksum8 1 0xF8 2 0x03 3 0x0B 4 Checksum16 LSB 5 Checksum16 MSB 6 Write...

Страница 46: ...s Since this command has a flexible size byte 2 will vary For instance if a single IOType of PortStateRead d26 is passed byte 2 would be equal to 1 for the command and 3 for the response If a single I...

Страница 47: ...IN LSB MSB Analog input reading is returned justified as a 16 bit value always unsigned LabJackPython example session Automatically extracted from u3 py Debugging turned on to show the bytes sent and...

Страница 48: ...Automatically extracted from u3 py Debugging turned on to show the bytes sent and received 5 2 5 6 BitStateWrite IOType 11 BitStateWrite 2 Command Bytes 0 IOType 11 1 Bits 0 4 IO Number Bit 7 State 0...

Страница 49: ...t specifies whether to update the corresponding bit of I O State Each bit of this value corresponds to the specified bit of I O such that 1 High and 0 Low To set all low State d0 To set all 20 standar...

Страница 50: ...y Debugging turned on to show the bytes sent and received 5 2 5 15 Timer IOType 42 44 Timer 4 Command Bytes 0 IOType 42 44 1 Bit 0 UpdateReset 2 Value LSB 3 Value MSB 4 Response Bytes 0 Timer LSB 1 Ti...

Страница 51: ...e version 1 30 1 21 Command number 0x2A accesses the user memory area which consists of 512 bytes block numbers 0 15 Command number 0x2D accesses the calibration memory area consisting of 512 bytes bl...

Страница 52: ...g Command Byte 0 Checksum8 1 0xF8 2 0x00 0x01 3 0x29 0x2C 4 Checksum16 LSB 5 Checksum16 MSB 6 0x4C 7 0x6C Response Byte 0 Checksum8 1 0xF8 2 0x01 3 0x29 0x2C 4 Checksum16 LSB 5 Checksum16 MSB 6 Errorc...

Страница 53: ...15 30 for temp sensor 31 for Vreg or 193 224 for digital timer counter channels NChannel is 0 7 for FIO0 FIO7 8 15 for EIO0 EIO15 30 for Vref or 31 199 for single ended 5 2 11 StreamStart Once the str...

Страница 54: ...0 Power up the U3 with a short from FIO6 to SPC FIO2 to SCL on U3 1 20 1 21 then remove the jumper and power cycle the device again This also affects the parameters in the ConfigU3 function The watch...

Страница 55: ...ng handled manually outside of this function care must be taken to make sure SCK is initially set to CPOL before asserting CS All standard SPI modes supported A B C and D Mode A CPOL 0 CPHA 0 Mode B C...

Страница 56: ...es divided by 2 If the number of bytes is odd round up and add an extra zero to the packet NumAsynchBytesToSend Specifies how many bytes will be sent 0 56 NumAsynchBytesInRXBuffer Returns how many byt...

Страница 57: ...s the read write bit Note that the read write bit is controlled automatically by the LabJack and thus bit 0 is ignored NumI2CBytesToSend Specifies how many I C bytes will be sent 0 50 NumI2CBytesToRec...

Страница 58: ...yte Offset Description Nominal Values 0 Checksum8 0 0 3 Not Used 0x00 1 0xF8 0 4 FIO Directions 0x00 2 0x01 0 5 FIO States 0xFF 3 0x0E 0 6 FIO Analog 0x00 4 Checksum16 LSB 0 7 Not Used 0x00 5 Checksum...

Страница 59: ...formation is only needed when using low level functions and other ways of getting binary readings Readings in volts already have the calibration constants applied The UD driver for example normally re...

Страница 60: ...function to retrieve the first 8 blocks of memory This information can then be used to convert all analog input readings to voltages Again the high level Windows DLL LabJackUD does this automatically...

Страница 61: ...al LV 2 4 mV Single Ended HV 9 8 mV Special HV 19 5 mV Command Response Speed See Section 3 1 Stream Perfromance See Section 3 2 4 With DAC1 disabled on hardware version 1 30 5 This is the maximum vol...

Страница 62: ...to the U3 possible causing poor start up behavior 13 These specifications provide the answer to the question How much current can the digital I O sink or source For instance if EIO0 is configured as...

Страница 63: ...PCB Dimensions STEP U3 Enclosure Dimensions DWG U3 Enclosure Dimensions DXF U3 Enclosure Dimensions IGS U3 Enclosure Dimensions STEP U3 Enclosure Drawings zip U3 PCB Dimensions dxf U3 PCB Dimensions p...

Страница 64: ...e ack for the address will be reported Improved timer performance Changed the watchdog so that it will not clear until the host computer has read the response Fixed a problem that was causing edge32 a...

Отзывы: