; $URL: http://subversion:8080/svn/gsc/trunk/drivers/LINUX/18AI32SSC1M/doc/release.txt $
; $Rev: 56939 $
; $Date: 2026-10-05 14:06:25 -0500 (Mon, 05 Oct 2026) $

18AI32SSC1M: Linux Driver Release Notes

Revision History
================

--------------------------------------------------------------------------------

Version 2.9.118.53.0, Released 10/5/2026

driver: Updated and added 100ms settling delays for various IOCTL services.
driver: Added preliminary content for porting to Windows.
driver: Added GSC common metadata code.
driver: Made Autocal settling delay conditional upon success of operation.
driver: Improved division of code between the OS specific code and the GSC common code.
driver: Made minor VPD updates.
driver: Made updates to support porting to Windows.
driver: Improved error checking and comments.
driver: Added support for device independent metadata.
driver: Added support for device independent driver metadata.
driver: Updated code division between the OS specific BAR code and the GSC common BAR code.
driver: Updated for port to Windows.
driver: Update PLX register comments.
driver: Added comments to gsc_common.h
driver: Spelling correction in comments.
driver: Fixed a read and write bug that showed up with a zero timeout: took ms vs us.
driver: Overhauled VPD implementation.
driver: First part of VPD (Vital Product Data) overhauled.
driver: Expanded SIO4 Vendor ID values to include 1C6E for GSC.
driver: Move some BAR code here from the GSC common sources.
driver: Partial update to support porting to Windows.
driver: Improved error checking.
driver: Updated comments and documentation.
driver: Moved maintenance of the /proc/device content to metadata.c.
driver: Redirected numerous spinlock calls to the os level service rather than the GSC common code service.
driver: Made /proc/ support code more modular.
driver: LINTed sources.
driver: Added spin-lock notes for Real-Time users.
driver: Added delay notes for Real-Time users.

--------------------------------------------------------------------------------

Version 2.8.111.50.0, Released 10/7/2024

driver: Updated for Fedora 38.
driver: Minor make and start mods.
driver: Corrected error message text.
driver: Updated the Rx Debug support.
driver: Remove Red Hat 8 compiler warning (2.4 kernel).
driver: Corrected log message when excusive open request fails.
driver: White space cleanup.
driver: Fixed an issue where the register id is zero (for testing purposes).
driver: Updated and expanded error reporting.
driver: Corrected a comment.
driver: LINTed the sources for the 2.4 kernel builds.
driver: LINTed sources.
driver: Updated to address Fedora 38 complaints.
driver: Added global driver unloading flag.
driver: Added "unloading" message when unload service is called.

--------------------------------------------------------------------------------

Version 2.7.104.47.0, Released 8/24/2023

driver: Updated to support the 6.x series kernel.
driver: Added the Autocal Status IOCTL service.
driver: Renamed all Auto_Calibration content to Autocal for consistency.
driver: Renamed all Auto_Cal_Bg content to Autocal_Bg for consistency.
driver: Updated the Input Buffer Clear IOCTL service for consistency.
driver: Updated comments for consistency.
driver: Updated per PLX code segregation.
driver: Updated the DMA code for more modular code organization.
driver: Added RX DEBUG capabilities.
driver: Removed unintended debug output statements.
driver: Renamed gsc_irq_reset_pci to gsc_irq_cpi_reset for consistency.
driver: Segregated additional PLX specific code.
driver: Updated system message to begin with the driver module name.
driver: Began implementation for MSI support.
driver: Segregated all PLX specific code to accommodate alternate device implementations.
driver: Added global driver unloading flag.
driver: Added "unloading" message when unload service is called.
driver: Updated for changes after the 5.17.15 kernel.
driver: Updated to support the 6.x kernel.
driver: Updated some comments for consistency.
driver: White space cleanup.
driver: Updated for changes to Red Hat Enterprise Linux 8.6.
driver: Added the os_irq_t.created field.
driver: Updated os_irq_create, destroy, open and close services.
driver: Removed unused debugging messages.
driver: Began implementing MSI support.
driver: Added macro DEV_IRQ_SHOW to report assigned IRQ assigned to device.
driver: Removed unused macros.
driver: Updated for the 5.14 kernel.

UTILITIES:

The last argument to the below function was changed from nrate to fsamp.
This is consistent with the operation of other drive utilities and eases
it use.

int ai32ssc1m_config_ai(int fd, int index, int verbose, s32 fsamp);

--------------------------------------------------------------------------------

Version 2.6.97.38.1, Released 3/17/2022

Made correction to the driver user manual.

--------------------------------------------------------------------------------

Version 2.6.97.38.0, Released 3/16/2022

driver: Updated the Initialize IOCTL service to include waiting on the IRQ.
driver: Updated debugging display output.

--------------------------------------------------------------------------------

Version 2.5.96.38.0, Released 1/22/2022

driver: Standardized various IOCTL system log messages.
driver: Standardized processing of the initialization IOCTL service.
driver: Standardized processing of the autocalibration IOCTL service.
driver: LINTed sources.
driver: Added temporary experimental write code in gsc_write.c for performance testing.
driver: The code is partially retained but is not included for compilation.
driver: Fixed a DMA bug relating to the use of a timeout setting of zero.
driver: Corrected endian error message.
driver: Added Endianess support for the PEX8111 and PEX8112.
driver: Fixed a timeout bug in gsc_write_pio_work_32_bit().
driver: Made spelling corrections in version notes.
driver: Changed all printk instances to printf to support porting activities.
driver: Expanded files removed for a clean operation.
driver: Updated to support the 5.9 kernel.
driver: Modified os_common.h so application code compiles under Cygwin.
driver: Reduced the minimum tick sleep from 1 to 0 ticks.
driver: Modified debug specific register access code to enhance usage.
driver: Improved Red Hat Enterprise Linux 8.x detection logic.
driver: Added support under the 4.x kernel for Red Hat Enterprise Linux 8.x.
driver: Added validation checking of the interrupt number in os_irq_open().

--------------------------------------------------------------------------------

Version 2.4.91.32.0, Released 8/24/2020

driver: Fixed device type detection bug.
driver: Some mods for porting to Windows.
driver: Updated initial file content for consistency.
driver: Updated IRQ code for improved clarity and modularity.
driver: Updated DMA code to support multiple DMA implementations.
driver: Removed I/O debug code.
driver: Removed compiler warnings under Windows.
driver: Fixed a IOCTL bug in which alt->sem wasn't being unlocked.
driver: Increased modularization for porting effort to another OS.
driver: Made DMA code more modular.
driver: Updated the /proc/ code for changes in the 5.6.6 kernel.
driver: Updated memory code for improved clarity and modularity.
driver: Code cleanup in open service.
driver: Fixed open bug applicable to multi-board devices.
driver: Made mods to accommodatedate porting to another OS.

--------------------------------------------------------------------------------

Version 2.3.87.28.1, Released 6/25/2019

Made changes to non-driver files.

--------------------------------------------------------------------------------

Version 2.3.87.28.0, Released 6/24/2019

driver: Added support for the 5.x kernel series.
driver: Added Endianness support.
driver: Updated per OS specific DMA memory allocation interface.
driver: Fixed bug in gsc_dma_perform(): timeouts were being ignored.
driver: Fixed bug in gsc_dma_perform(): the timeout detection logic was incorrect.
driver: Improved register validation.
driver: Subsystem Vendor ID and Subsystem ID can each be ignored if -1 in device table.
driver: #define for GSC_REG_ENCODE_MASK is moved here from gsc_reg.c.
driver: Enhanced error reporting for the process of validating register definitions.
driver: Fixed bug in DMA completion code.
driver: Updated initialization for the write service.
driver: Added DMA support for an IOMMU.
driver: Added error reporting when DMA memory cound not be allocated.
driver: Reduced code included when read and writ are both unsupported.
driver: Added error reporting when IRQ cound not be acquired during open requests.
driver: Some minor code reorganization.
driver: Updated BAR creation logic.

--------------------------------------------------------------------------------

Version 2.2.81.26.0, Released 11/20/2018

driver: Bug fix: was ignoring BAR setup return value.
driver: Updated per changes to the OS specific PCI services.
driver: Made updates for DEV_SUPPORTS_XXX macro changes.
driver: Modified code so open succeeds even if initialization fails.
driver: Updated per changes to common I/O code.
driver: Added Scan Marker value get/set support.
driver: Added Pretrigger Counter access services.
driver: Added External Clock Divisor support.
driver: Removed the Pretrigger Delay feature as it isn't available to end users.
driver: Updated muti-channel ISR code for new I/O streams structure.
driver: DEV_WAIT_IO_ALL is now required if WAIT is supported along with READ or WRITE
driver: I/O WAIT macros are now defined by the device API and are passed to GSC code in dev_io_t.
driver: Updated Block Mode DMA macro name (_DMA to _BMDMA).
driver: Added I/O, DMA and register access debug code.
driver: Added stream selection field in the "size" argument for the read and writecalls.
driver: Added OS IRQ calls: os_irq_create() and os_irq_destroy()
driver: Renamed field in gsc_irq_t for clarity.
driver: Fixed a bug in which wait list node removal didn't always have the list locked.
driver: Added support for some DMA metrics.
driver: Improved IOCTL argument validation.
driver: Moved a typedef to device specific code.
driver: Udated some utility services: applying a setting, end by reading it back
driver: Updated for support of some drivers under older kernels.
driver: Updated #include files for consistancy.
driver: Fixed a DMA timeout calculation bug.
driver: Updated to accommodate porting to Windows KMDF.
driver: Updated per changes to the low level register interface.
driver: Updated the driver initialization logic.
driver: Updated IOCTL init and reset code.
driver: Added support to exclude the WAIT feature.
driver: Updated macros to include/exclude IRQ support.
driver: Fixed bug in init code where last PCI device is one of ours.
driver: Implemented support for a stream selection field in the I/O bytes argument.
driver: Implemented register access debug code.
driver: Implemented calls: os_irq_create() and os_irq_destroy()
driver: Field in gsc_irq_t renamed for clarity.
driver: Changed macro name for clarity.
driver: Updated to accomodate Fedora 27.
driver: Updated the low level register interface.

--------------------------------------------------------------------------------

Version 2.1.68.18.0, Released 12/2/2016

driver: The BAR code has been updated to include the data under a single structure.
driver: The register definitions have been updated.
driver: I/O services now pass around an os_mem_t structure instead of a buffer pointer.
driver: White space cleanup.
driver: Changed the arbitrary wait event callback argument to a void* type.
driver: Modified to allow multiple apps to simultaneously access a single device.
driver: Correct access to BAR0 and BAR1 (is RO, was RW).
driver: Added an infinite I/O timeout option.
driver: Corrected the IOCTL code for the register write and mod services.
driver: Added special case for register I/O where register id value is 0.
driver: Added support for inifinite I/O timeout.
driver: Improved response to being signalled (i.e. being told to abort).
driver: An event wait timeout value of zero now means do not timeout.
driver: Fixed an I/O bug.
driver: Updated the version number macros.
driver: Updated the format and encoding of register macros.
driver: Fixed DMA bug.
driver: Moved some BAR functionality to the OS specific code.
driver: I/O now passes around an os_mem_t structure instead of a buffer pointer.
driver: Copying to and from user space is now done with more use specific routines.
driver: Made more ISR functionality subject to the GSC_IRQ_ISR_FLAG_DETECT_ONLY flag.
driver: Dropped I/O register access services.
driver: Performed some LINTing.
driver: Simplified error messages.
driver: Fixed ul2hex().
driver: The macro S32_MAX is defined only if not already done so.
driver: Added the utility service ul2hex().
driver: Changed register offsets to u16 from unsigned long.
driver: Changed printk's to printf's.
driver: Made ISR access more OS agnostic.
driver: Made PCI registers accessible from inside an ISR.
driver: Added special case handling for reads of register id value 0.
driver: Added support for reporting metrics information during driver installation.
driver: Removed use of function check_mem_region() in 4.x kernels.
driver: Implemented support for the 4.x kernels.
driver: Added checks on some pointers before using them.
driver: Added safety check in EVENT_RESUME_IRQ().
driver: Removed unused macro (OS_CAST_VOIDP_TO_U32).
driver: Moved some BAR functionality here from more common code.
driver: Renamed os_event_cleanup() to os_event_destroy().
driver: Simplified use of os_mem_t structures and content.
driver: Removed the use of __DATE__ and __TIME__.

--------------------------------------------------------------------------------

Version 2.0.60.8.0, Released 9/15/2015

rxrate: Renamed one or more variables.
rxrate: Changed the default I/O mode.
rxrate: Updated the display output.
rxrate: Updated the input rate calculation.

--------------------------------------------------------------------------------

Version 2.0.59.7.0, Released 7/30/2015

driver: Updated to use the newer common driver sources.
driver: Removed GNU notice from non-Linux specific files.
driver: Removed Linux specific content from non-Linux specific source files.
driver: Now using a spinlock rather than enabling and disabling interrupts.
driver: Updated gsc_irq_open() and gsc_irq_close().
driver: Updated gsc_dma_open() and gsc_dma_close().
docsrc: Updated per changes to the device node name, which is now /dev/<device>.X.
sbtest: Removed dead code (i.e. excluded by #if 0).
LINTed various sources.
White space cleanup.

--------------------------------------------------------------------------------

Version 1.7.52.0, Released 2/28/2014

Driver: Reduced #include list in driver interface header.
Additional LINTing.
White space cleanup.

--------------------------------------------------------------------------------

Version 1.6.51.0, Released 1/8/2014

Driver: The IOCTL command code is now treated as an integer.
Driver: Numerous minor changes for LINTing of the code.

--------------------------------------------------------------------------------

Version 1.6.48.0, Released 11/7/2013

Driver: Modified the conditional definition of flags used by kmalloc().
Driver: Updated /proc file support for the 3.10 kernel changes.
Driver: Additional porting for the 2.2 kernel.

--------------------------------------------------------------------------------

Version 1.6.45.0, Released 7/17/2013

Driver: Freeing the board interrupt is now conditioned upon it being acquired.
Driver: Corrected definition of register GSC_PLX_9056_PABTADR.
Driver: Added support for the Bus Abort interrupt.
Driver: Updated DMA reads to improve performance.
Driver: Changed how I/O buffers are allocated.
Driver: Changed how s8 ... u32 are included.
Driver: Enhanced the IOCTL service code to accommodate unsupported services.
Driver: Updated the BAR mapping failure messages.
Driver: Added s8 ... u32 definitions for application use.
Driver: Updated gsc_dma_destroy() - now zero fills memory when done.
Driver: Updated gsc_irq_destroy() - does cleanup when done.
rxrate: Changes the sample rate to be 1M S/S.
sbtest: Corrected some error accounting.

--------------------------------------------------------------------------------

Version 1.6.39.0, Released 7/20/2012

Driver: Updated for the 3.x kernel.
Driver: Corrected a jiffies roll over bug in ioctl.c and device.c.
Driver: Added support for boards that need additional setup after a DMA channel has been selected.
Driver: Made the IOCTL buffer larger - 512 bytes.
signal: Added this application to the release.
Updated the parameter list to gsc_id_driver().

--------------------------------------------------------------------------------

Version 1.5.36.0, Released 3/26/2012

Driver: Removed compile warnings from the copy_from_user_ret macro.
Updated the makefile for consistency.
White space cleanup.
Updated the utils interface for consistency.
Fixeg a bug in the RBG Nrate utility code.

--------------------------------------------------------------------------------

Version 1.5.34.0, Released 12/20/2011

Driver: BAR0 and BAR2 are now the only BAR regions used.
Driver: All common driver sources are included even though not all are used.
Split the utility code into two libraries: common and device specific.

--------------------------------------------------------------------------------

Version 1.4.31.0, Released 11/1/2011

Driver: Fixed an ISR bug which caused recurring interrupts.
Driver: Modified driver start script to correct messages under Ubuntu.
Driver: Numerous updates per changes to the common code base. See main.h.
Driver: Updated the set of IOCTL services.
Driver: Overhauled IOCTL based local interrupt implementation.
Driver: Updated per changes to the common source code.
Driver: Implemented IOCTL based I/O Abort support.
Driver: Implemented IOCTL based event/interrupt wait support.
Driver: Updated to use the common gsc_open() and gsc_close() services.
Driver: Implemented explicit local interrupt support.
Driver: Implemented support for the common PIO I/O routines.
Driver: Changed use of DEV_SUPPORTS_READ macro.
Driver: Changed use of DEV_SUPPORTS_WRITE macro.
Driver: Added initial support for Vital Product Data.
Driver: Eliminated the global dev_check_id() routine.
Driver: Fixed a bug in the GSC_INTCSR_MAILBOX_INT_ACTIVE macro.
Driver: Removed a compiler warning under Fedora 15.
Driver: Added #defines for D0 through D31.
Driver: Modified gsc_sem_t to prevent hanging on an uninitialized structure.
Driver: Moved dev_check_id() functionality to dev_device_create().
Driver: Added support for deprication of file_ops.ioctl.
Driver: Started PLX EEPROM access support.
Driver: Modified so BAR2 can now be memory or I/O mapped.
Driver: Corrected the _1M macro.
Driver: Removed compiler warning in Fedora 12: reduced module_init stack usage.
Driver: Removed remove_proc_entry() call from proc_start - fix for Fedora 14.
Driver: Fixed a bug in gsc_ioctl_init().
Driver: Added common PIO read and write routines.
Driver: Changed use of DEV_SUPPORTS_PROC_ID_STR macro.
Driver: Changed use of DEV_SUPPORTS_READ macro.
Driver: Changed use of DEV_SUPPORTS_WRITE macro.
Driver: Added initial support for Vital Product Data.
Driver: Corrected a bug: wait timeouts in jiffy units are negative.
Driver: Added support for aborting active I/O operations.
Driver: Added support for Auto-Start operations.
Driver: Added wait options for I/O cancellations.
Driver: Fixed bugs in the DMA code evaluating lock return status.
Driver: Added /proc board identifier string support.
Driver: Added gsc_irq_local_disable and gsc_irq_local_enable;
Driver: Added failure message when driver doesn't load.
Driver: Improved timeout handling.
Driver: Added gsc_time.c.
Driver: Added wait event, wait cancel and wait status services.
id: Corrected output spelling.
id: Updated the register output data.
sbtest: Removed compile warnings for Fedora 15.
Updated numerous sources per changes in the set of supported IOCTL services.
Updated various Auto Cal related strings and macros for consistency.
Modified makefiles to correct messages under Ubuntu.
Modified make files for standardization.

--------------------------------------------------------------------------------

Version 1.3.13.0, Released 12/29/2009

Driver: Fixed a bug in the AI32SSC1M_IOCTL_QUERY service.
Driver: Removed some unused #defines from the driver's main.h header.
sbtest: Corrected deficiencies in the QUERY IOCTL service test.

--------------------------------------------------------------------------------

Version 1.2.13.0, Released 12/28/2009

driver: Fixed a DMA bug.

--------------------------------------------------------------------------------

Version 1.2.12.0, Released 12/22/2009

driver: Fixed a bug in the AI32SSC1M_IOCTL_AIN_BUF_CLEAR service.
driver: Updated opena and close services to use the common code base.
driver: Added more id information as the board now has a second subdevice id.
driver: Modified the AI32SSC1M_IOCTL_INPUT_SYNC service to not wait.
driver: Fixed a bug in the query service enumeration.
driver: Added support for the pretrigger board option.
id: Modified to report high/low vontage range in the Board Config Reg.
id: Added pretrigger identification information.
regs: Registers which may not be supported can now be edited.
regs: Added support for additional registers.
rxrate: Modified data read routine so DMA transferred more data at a time.
sbtest: Updated reg_read tests as newer boards have a different subdev id.
sbtest: Made a correction to the query service test.
sbtest: Remodularized numerous test code modules.
utils: Remodularized numerous source files according to IOCTL command codes.

--------------------------------------------------------------------------------

Version 1.1.10.0, Released 10/15/2009

Driver: Made various read support services use the same argument data types.
Removed the color code from the driver start script.
Added the voltage range (hi/low) query option.
Added more voltage selection options.

--------------------------------------------------------------------------------

Version 1.0.6.0, Released 4/27/2009

Initial release.

--------------------------------------------------------------------------------
