Drivers for S.Ha.R.K.

Contents

	PCI interface module (PCI6025E)
	Analog input module (ADC)
	Analog output module (DAC)
	Digital lines module (DIO_PPI)
	General porpuse counters/timers (TIM)

PCI interface module

Files

Back to Top

Function Description

This function scans the PCI bus searching National Instruments^® boards and when one is found structure NIDevice_Info[x] is filled with board's data. When more than one NI^® is found structure is filled in right way but driver can manage only the first board that is loaded

This function return number of PCI boards found

You haven't to call this function because is called by reMap function

Back to PCI Interface Module section

PCI E Series board are mapped direct to memory. In Shark OS memory are linearly organized so direct access over 1MB is immediate. Otherwise if you want re map board under 1MB memory you can do this through this function. No argument must be passed because into .h file there's two "#define" which define MITE base address and BOARD base address.

This function, like you see watching code, call find_NI_Device and if no boards is found returns 0. Otherwise if function terminates successfully returns 1

Call this function after Shark function pci_init() and before any other board related function

Back to PCI Interface Module section

DAQ-STC has more than 180 16-bit registers. Too memory is requested to map all registers on memory. Thus Windowed Memory is implemented. When you want read or write one DAQ-STC's register you must call this function passing register address and value you want write. It's important to notice that while windowed access uses much time that direct access it's important that during this operation interrupts are disabled to avoid collision, data losing or data modification

I think you don't need to call this function because it is called by function written in this driver. If you call this function pay attention about register you are going to manipulate and the mean of its bits because you can damage both board and external circuit

Parameter	Description
WORD address	DAQ-STC register address. In file REGCONST.H you can find a symbolic name associated with register address
WORD value	Value you want write into DAQ-STC register

Back to PCI Interface Module section

Like the function above this is used through windowed accessing to read a DAQ-STC register's value. Watch above to understand mean of parameter "address".

This function return value stored in register

Back to PCI Interface Module section

This function sets the internal timebase to work with a software selectable frequency from 20MHz to 100 KHz. It's also enable frequency output system (FOUT) which can provide on pin 50 a square wave with base frequency of Internal Timebase also divided by "divider" value

This function return 0 if there's an error into the parameters, otherwise return 1

Back to PCI Interface Module section

With this function you can configure the PFI lines. PFI can be configured as a generic input line or as a specific output line. You can see in 6025E User Manual the meaning of each PFI line when is configured like output.

Back to PCI Interface Module section

Use this function to select the logic level that will indicate an interrupt condition on IRQ_OUT pins and to enable or disable the possibility of duplicate selected interrupt to IRQ_OUT<0..1> pins

Back to PCI Interface Module section

Use this function to enable interrupt group and to select onto which line interrupt signal will be driven. Group A manage interrupt connected with AITM, IRQ_IN0 and TIMER 0. Otherwise Group B is connected with AOTM, IRQ_IN1 and TIMER 1.

Back to PCI Interface Module section

This two function are useful to print (not in graphic mode... I'm sorry) a register value bit by bit. I use this function to check registers value during operations set up. The second function differs from the first only for the little feature that prints the "str" string before prints register value.

Parameter	Description
dim	Dimension in byte of the second parameter. Example: BYTE has dimension 1; WORD has dimension 2; and so on...
value	Value which will be printed on screen
str only for TEST_bitfield	This string will be printed before printing value

Back to PCI Interface Module section

These two groups macro write or read directly into memory. The final x stand for "b" that means BYTE or for "w" that means WORD. With Immediate_Writex you must pass first address and second value which will be written into memory. Otherwise with Immediate_Readx only address must be passed.

Example: Immediate_Writeb(0x0C, 0xFF) writes at offset 0x0C value 0xFF

In REGCONST.H you must find address of the most useful board's registers.

Back to PCI Interface Module section

Analog Input Module

I'm sorry but driver's routine for ADC isn't tested yet

I hope It will be finished for the next snapshot

Back to Top

Analog Output Module

With this module you can program the Analog Output Timing Module (AOTM) of the DAQ-STC and the two DACs on board. Into DAQ-STC there are two timing module for output operations. I only program the first module leave the second module for the next snapshot. Timing module is important but could be substituted with SHARK timing functions and using only the function which access directly DACs output registers.

Files

Back to Top

Function Description

Reset two DACs and into DAQ-STC the associated timing system

Call this function before any DAC's operation or set up

Back to DAC Interface Module

With this function the most common options, like source pin or polarity for the AOTM, can be selected.

This function must be called after DAC-reset but before any other operation.

Back to DAC Interface Module

With this function it's possible to set which signal trigger the analog output operations

Back to DAC Interface Module

With this function you can select the number of iterations that must be performed and the number of update that must be made into each iteration

Back to DAC Interface Module

Use this function to select where get the update and the UI event

Back to DAC Interface Module

With this function you can select how many DACs you want update every UPDATE pulse

Back to DAC Interface Module

Use this function to set source and update mode for LDAC<0..1> signals

Back to DAC Interface Module

With this function you can select under which error conditions AOTM must be stopped

Back to DAC Interface Module

This function allows to select which FIFO flags can assert an Interrupt or DMA request

Back to DAC Interface Module

Through this function you can enable which signal will de driven onto an Interrupt Request Line.

Back to DAC Interface Module

Use this function to arm counters into AOTM module of DAQ-STC. When AOTM is armed also the first values is preloaded into DACs

Back to DAC Interface Module

When software trigger is selected with this function analog output operation can be started. Otherwise is hardware trigger is selected call this function has no effects

Back to DAC Interface Module

This function must be called previous any operation and reset the DACs calling DAC_reset prepare the environment to work configuring the two available DACs

Back to DAC Interface Module

This function writes directly into a DAC output register so "value" is immediately got out as analogic value

Back to DAC Interface Module

Digital lines Module

With this module it's possible to manage the eight (DIO 0..7) digital lines provided by DAQ-STC and the additional 24 digital lines provided by OKI MSM82C55A Programmable Peripheral Interface

Files

Back to Top

Function Description

Initialize the eight digital lines provided by DAQ-STC

Back to DIO_PPI Interface Module

Force all digital lines as output and force their value to 0

Back to DIO_PPI Interface Module

With this function each line of the eight provided by DAQ-STC can configured separately from the others

Back to DIO_PPI Interface Module

Read DAQ-STC's digital lines configured as input. Where a line is configured as output value read is 0

Back to DIO_PPI Interface Module

Puts on digital lines the "out" value. Only line configured as output can be accessed. Other lines during output operations are forced to 0

Back to DIO_PPI Interface Module

Initialize the 24 digital lines provided by MSM82C55A

Back to DIO_PPI Interface Module

Force all digital lines as output and force their value to 0

Back to DIO_PPI Interface Module

With this function you can configure MSM82C55A to work in one of its three available modes

Back to DIO_PPI Interface Module

Reads eight digital lines from MSM82C55A

Back to DIO_PPI Interface Module

Writes into a MSM82C55A port the value specified with "val"

Back to DIO_PPI Interface Module

General Purpose Timers/Counters

This is the module that controls the General purpose 24-bit timers/counters provided by DAQ-STC. Differently from other modules there aren't function which must be combined to obtain that counters count but each function programs a counter to perform a specified action like counting events or measuring time. In this first snapshot Position sensing and pulse generation aren't implemented. I'm sorry but form my Thesis this features aren't useful. I hope I can put them in the next snapshot.

Files

Back to Top

This function must be called before any operation with timers. It resets the specified counter and the related DAQ-STC's registers

Back to Timers/Counters Interface Module

This function must be called after all setting operation because making counters begin count. Parameter "counter" has the same meaning of previous function's parameter

Back to Timers/Counters Interface Module

Calling this function make counters stop counting (but counters aren't resected). See above for parameter "counter" meaning

Back to Timers/Counters Interface Module

Use this function to read counters value while they are counting without disturbing them

It is not possible read both counters content at the same time

Back to Timers/Counters Interface Module

During buffered operation like buffered event counting or buffered time measurement, counters when an interrupt occurred save their values into Hardware Save Registers. With this function it's possible accessing and reading these registers

Meaning of parameter "counter" is the same of previous function

Back to Timers/Counters Interface Module

This function sets up specified counter to perform a gated (if you want) events count. You must specify source line, gate line, which interrupts must be enabled and an initial value that will be loaded into the counter

Back to Timers/Counters Interface Module

Also this function performs an event counting but when a gate's event occurs DAQ-STC saves counter values into related Hardware Save registers and if counting is cumulative continues counting else restarts counting from 0 (pay attention: count restarts from 0 and not from your initial value "in")

Back to Timers/Counters Interface Module

With this function you can perform a pulsewidth or a single period measurement. This function can be used only for one shot measurement so you can get only one pulsewidth measure or only one period measure. The next function, like you'll see, performs continue measurements

Back to Timers/Counters Interface Module

This function measures time continually. It can measure periods, semiperiods, or pulsewidths.

Back to Timers/Counters Interface Module

go to next page