changes.txt

rt 7520采集卡 linux驱动源代码

Change log for SWP-700010005 rev C

DM7520 driver, library, and example programs for Linux.

Copyright 2004 RTD Embedded Technologies, Inc.  All Rights Reserved.


v1.0	GV
----------

- Initial version.


v1.1	GV
----------

- 2.4 kernel support added
- DMA support added


v1.2	MAS
-----------

- bugfixes to allow compiling with modversions
- support for the Redhat 6.2 modified kernel


v1.3 (rev A)	08/13/2003	RY
----------------------------------

- Documented for ISO9000
- removed static declaration from functions init_module() and cleanup_module()
  that prevented driver working correctly on Redhat 8.0


v1.7 (rev B)	10/14/2003	RY
----------------------------------

- Company name changed
- Standard header information added to all source files
- README.TXT re-written.
- CHANGES.TXT re-written.
- LICENSE.TXT added.
- Interrupt and DMA related functions rewritten.
- interface of the following library functions changed:
	UnSetDMAMode7520
	SetupDAC7520
- the following functions removed from the library:
	SetupPort17520 (use SetDIO1Direction7520)
	ClearITMask7520	(removed because it was not available in user mode)
	ReadITOverrun7520 (removed because it was not available in user mode)
	ClearITOverrun7520 (removed because it was not available in user mode)
	SetDMAMode7520 (use specific functions for AD, DA, HSDIN)
	read group of functions (fread etc.) - use ReadData7520
	write group of functions (fwrite etc.) - use WriteDac1Fifo7520,
		WriteDac2Fifo7520
- the following functions added to the library:
	SetAD_DMAMode7520
	SetHD_DMAMode7520
	setDA_DMA7520
	setWriteBuffer7520
	get_control_buf7520
	SelectPacerClockPrimaryClock7520
	SetPacerRateF7520
	SetPacerClockF7520
	SelectBurstClockPrimaryClock7520
	SetBurstRateF7520
	SelectDACClockPrimaryClock7520
	SetDACRateF7520
	SetupBurstF7520
	DACClockStartSelect7520
	DACClockStopSelect7520
	DACClockFreeRun7520
	DACClockStart7520
	DACClockStop7520
	McBSPADControl7520
	McBSPDAControl7520
	SetReadChannel7520
	ReadData7520
- samples programm added:
	ad_dma.c
	da_dma.c
	da_dma_cycle.c
	etrig.c
	extint.c
	hd.c
	hd_dma.c
	mcbsp.c
	test.c
	user_inp.c


v1.8 (rev C)	07/14/2004	RWB
-----------------------------------
- Renamed upper level directory from dm7520/ to dm7520_Linux_v1.8/
- Changed permissions on all files to rw-rw-rw-
- Changed permissions on all directories to rwxrwxrwx
- Renamed changes.txt to CHANGES.TXT
- Renamed license.txt to LICENSE.TXT
- Renamed readme.txt to README.TXT
- Renamed samples/ to examples/
- Deleted driver/procfs.c
- Added header documentation to all applicable files
- Standardized source file names in driver/ and lib/
- Moved all header files into include/
- Renamed some header files in include/ to better reflect their purposes and
  changed all relevant source code to include the new names
- Removed some stray executable files from examples/
- CHANGES.TXT changes:
    * Reformatted into standard format
- driver/Makefile changes:
    * Replaced all references to dm7520.* with rtd-dm7520.*
    * Removed DM7520_PROC_FILE
    * Deleted DEVMAJOR
    * Reworked devices target to get major number from /proc/devices
    * On insmod target, put relative path name on rtd-dm7520.o
- driver/rtd-dm7520.c changes:
    * Merged in code from driver/procfs.c
    * Changed init_module() to ask kernel to dynamically allocate a character
      device major number
    * Changed base device name to "rtd-dm7520-"
    * Removed all uses of DM7520_PROC_FILE
    * Changed company name
    * Changed driver version
    * In dm7520_proc_output(), cast rwchan_names[] indices to int to remove
      compiler warnings
    * Removed global spin lock variable slock because it 1) was superfluous
      since it was only locked and unlocked in the interrupt routine; Linux
      interrupt handlers are guaranteed to be mutually exclusive with respect
      to themselves, and 2) was causing some compiler errors in newer Red Hat
      releases
    * Removed references to slock from dm7520_interrupt()
    * In dm7520_interrupt(), deleted local variables "flags"
    * Modified dm7520_read() to check status of copy_to_user() and put_user()
      calls, returning EFAULT if they fail
    * Fixed a bug in dm7520_open() whereby it allows access to an DM7520 device
      file with an invalid minor number of MAXDM7520.
    * Fixed a bug in dm7520_release() whereby it allows access to an DM7520
      device file with an invalid minor number of MAXDM7520.
    * Fixed a bug in dm7520_read() whereby it allows access to an DM7520 device
      file with an invalid minor number of MAXDM7520.
    * Fixed a bug in dm7520_ioctl() whereby it allows access to an DM7520
      device file with an invalid minor number of MAXDM7520.
    * Fixed a bug in dm7520_poll() whereby it allows access to an DM7520 device
      file with an invalid minor number of MAXDM7520.
    * Fixed a bug in dm7520_fasync() whereby it allows access to an DM7520
      device file with an invalid minor number of MAXDM7520.
- examples/ad.c changes:
    * Added second argument to IsBusMaster7520() call to pass address of bus
      master flag
    * Added second argument to GetFifoStatus7520() call to pass address of FIFO
      status
    * Added "uint8_t bus_master" declaration
    * Changed type of fifostat from int to uint16_t
- examples/ad_dma.c changes:
    * Added second argument to IsBusMaster7520() call to pass address of bus
       master flag
    * Added second argument to GetFifoStatus7520() call to pass address of FIFO
      status
    * Added "uint8_t bus_master" declaration
    * Changed declaration of fifostat from int to uint16_t
    * Removed unnecessary argument DM7520_READ_AD from SetAD_DMAMode7520() call
- examples/async.c changes:
    * Added second argument to GetITStatus7520() call to pass address of
      interrupt status
    * Changed declaration of itStat from int to uint16_t
    * Added second argument to IsBusMaster7520() call to pass address of bus
      master flag
    * Added "uint8_t bus_master" declaration
    * Added second argument to GetFifoStatus7520() calls to pass address of
      FIFO status
    * Changed type of fifostat from int to uint16_t
    * Added second argument to IsADFifoEmpty7520() call to pass address of
      empty flag
    * Added "uint8_t fifo_empty" declaration
    * Added second argument to ReadADDataWithMarker7520() call to pass address
      of sample
- examples/dig.c changes:
    * Changed usage message to indicate program expects DM7520 device file
      argument
- examples/etrig.c changes:
    * Added second argument to IsADFifoEmpty7520() calls to pass address of
      empty flag
    * Added "uint8_t fifo_empty" declaration
- examples/fifo.c changes:
    * Added second argument to IsBusMaster7520() call to pass address of bus
      master flag
    * Added "uint8_t bus_master" declaration
    * Added second argument to GetFifoStatus7520() calls to pass address of
      FIFO status
    * Changed type of fifostat from int to uint16_t
    * Added second argument to IsADFifoFull7520() call to pass address of full
      flag
    * Added "uint8_t fifo_full" declaration
    * Added second argument to IsADFifoEmpty7520() call to pass address of
      empty flag
    * Added "uint8_t fifo_empty" declaration
    * Added second argument to ReadADData7520() call to pass address of sample
- examples/hd.c changes:
    * Added second argument to GetFifoStatus7520() calls to pass address of
      FIFO status
    * Changed type of fifostat from int to uint16_t
    * Added second parameter to IsDINFifoFull7520() call to pass address of
      full flag
    * Added "uint8_t fifo_full" declaration
- examples/hd_dma.c changes:
    * Added second argument to IsBusMaster7520() call to pass address of bus
      master flag
    * Added "uint8_t bus_master" declaration
    * Added second argument to GetFifoStatus7520() call to pass address of FIFO
      status
    * Changed type of fifostat from int to uint16_t
    * Removed unnecessary argument DM7520_READ_HD from SetHD_DMAMode7520() call
- examples/mcbsp.c changes:
    * Removed references to DSP program (which is supposed to modulate the sine
      wave output) as this program does not exist in the Linux package
    * Removed references to modulated sine wave output
- examples/user_inp.c changes:
    * Added second argument to ReadUserInput7520() call to pass address of user
      input value
    * Changed type of userInp from int to uint16_t
- include/dm7520_library.h changes:
    * Alphabetized library functions
    * Documented all exported library functions
    * Added third parameter "uint16_t *value_p" to Get8254Count7520() to return
      clock value
    * Added third parameter "uint8_t *mode_p" to Get8254Mode7520() to return
      clock mode
    * Added third parameter "uint8_t *status_p" to Get8254Status7520() to
      return clock status