README FOR AB CIRCLE CCID / PCSC DRIVER INSTALLER FOR MACOS.

Introduction:

This package installs the AB Circle CCID / PCSC Smart Card Reader Driver for macOS. This driver package provides the AB Circle USB CCID (Chip/SmartCard Interface Devices) and ICCD (Integrated Circuit(s) Card Devices) driver. See also the USB CCID [1] and ICCD [2] specifications from the USB working group.

abcccid is based on ccid. See also the CCID free software driver [3] for more information.

[1]	https://www.usb.org/sites/default/files/DWG_Smart-Card_CCID_Rev110.pdf
[2]	https://www.usb.org/sites/default/files/DWG_Smart-Card_USB-ICC_ICCD_rev10.pdf
[3]	https://ccid.apdu.fr/

Supported Operating Systems:

- macOS 10.12 (Sierra)
- macOS 10.13 (High Sierra)
- macOS 10.14 (Mojave)
- macOS 10.15 (Catalina)
- macOS 11 (Big Sur)
- macOS 11 (Big Sur) on Apple M1
- macOS 12 (Monterey)
- macOS 12 (Monterey) on Apple M1
- macOS 13 (Ventura)
- macOS 13 (Ventura) on Apple M1
- macOS 14 (Sonoma)
- macOS 14 (Sonoma) on Apple M1

Note: 
Other Mac OS (X) releases should work as well, 
but are un-tested at this time.

Installation:

	1.	Double click the “abcccid_installer-2.2.2.dmg" to mount the disk image file.
		
	2.	From the mounted image, double click the  “abcccid_installer.pkg" and follow the onscreen instructions. 

Uninstallation:

	1.	To uninstall the driver, double click the “abcccid_uninstaller.pkg" and follow the onscreen instructions.

Licence:

Copyright (C) 2019-2025 AB Circle Limited
Copyright (C) 2003-2011 Ludovic Rousseau
Copyright (C) 2000-2001 Carlos Prados
Copyright (C) 2003 Olaf Kirch
Copyright (C) 1999-2002 Matthias Bruestle

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301  USA

History:

2.2.2                           25 Jul 2025
•	Updated version to 2.2.2
•	Added support for custom reader

2.2.1                           20 Feb 2025
•	Updated version to 2.2.1
•	Added support for custom reader

2.2.0                           20 Jan 2025
•	Updated version to 2.2.0
•	Added support for custom readers

2.1.9                           25 Oct 2024
•	Updated version to 2.1.9
•	Added support for Circle CIR115 CT reader
•	Added support for Circle CIR315-SE CL reader

2.1.8                           20 Feb 2024
•	Updated version to 2.1.8
•	Added support for Circle CIR135 reader

2.1.7                           04 May 2023
•	Updated version to 2.1.7

2.1.6                           24 April 2023
•	Removed unused readers

2.1.5                           23 February 2023
•	Use default read timeout to 3 seconds (except apdu) to prevent macOS waiting 
	to unload driver for a long time after reader suprise removal
•	Stop read / polling threads after 5 times an error occurs (to stop threads 
	racing after reader suprise removal)
•	Added minor fixes from latest generic ccid package 1.5.2 
	from Ludovic Rousseau (https://ccid.apdu.fr/)

2.1.4                           28 September 2022
•	Merged changes from the latest generic ccid package 1.5.0 from Ludovic Rousseau
	(https://ccid.apdu.fr/):
	- Add support of simultaneous slot access on multi slots readers
	- Always compute readTimeout to use a value greater than default 3 seconds
	- Check the bSeq value when receiving a CCID frame
	- Avoid logging errors when a reader is removed
	- Some other minor improvements
	- By default hide buffer info in CCID frames

2.1.3                           07 July 2022
•	Enabled extended apdu support for CIR315B reader
•	Added support for Circle CIR715 reader
•	Added support for custom readers

2.1.2                           14 January 2022
•	Updated list of supported oses

2.1.2                           19 November 2021
•	Added support for custom reader

2.1.1                           29 June 2021
•	Added support for:
	⁃	Circle CIR125 ICC reader

2.1.0                           02 June 2021
•	Added support for custom readers

2.0.9                           10 May 2021
•		Added support for:
	⁃	Circle CIR515 ICC reader

2.0.8                           07 May 2021
•		Special (32-slot) edition for CSR105 reader

2.0.7                           31 March 2021
•		Added support for custom reader
•		Improved support for composite devices on macOS Big Sur

2.0.6				10 March 2021
•	Added support for custom readers
•	Small change in Info.plist

2.0.5				 07 January 2021
•	Updates to readme text.

2.0.5				09 December 2020
•	Updated installer package for native support for Apple M1 architecture.

2.0.5				03 December 2020
•	Added support for:
	⁃	Circle CIR315 IMP
	⁃	Circle CIR415 CL
	⁃	Circle CIR615 CL & 1S
	⁃	Circle CIR615 CL	
		Readers.
•        Added driver support for Apple M1 architecture
•        Fixed detection issue with composite device readers in Mac OS  
•        Fixed minor issue in CIR415 SAM slot handling

2.0.4				09 October 2020
•		Recompiled with proper libusb versions (Mac OSX only)

2.0.3				 02 September 2020
•		Initialise default read timeout on card power up
•		Made default read timeout longer (as it was too short for some cases).

2.0.2				10 August 2020
•		Signed driver bundle and installer package
•		Notarized installer package and disk image
                          
2.0.2				28 May 2020
•		Improved behaviour of ifsc and ifsd setting for T=1 protocol
•		Don't send SetParameters for card using default speed.
•		Fixed issue in T=1 IFS max frame length setting.

2.0.1			03 February 2020
•		Added support for Escape Command IO Control Code 3500.

2.0.0				15 October 2019
•		Removed PPS call for all ABC readers (use CCID_SetParameters only).
•		Implemented new reader names.

1.0.01			04 September 2019
•		Always start multi-slot card detection thread as on MacOS X Mojave pcscd is not used anymore (thus treat all readers as multi-slot). 
•		Merged changes from the latest generic ccid package 1.4.3x from Ludovic Rousseau (https://ccid.apdu.fr/)

1.0.00			16 August 2019
•		Initial release
•		Based on the generic ccid package 1.4.30 from Ludovic Rousseau (https://ccid.apdu.fr/)
•		Added support for:
	⁃	Circle CIR115 ICC
	⁃	Circle CIR215 PICC
	⁃	Circle CIR215 CL
	⁃	Circle CIR315 Dual & 1S
	⁃	Circle CIR315 PICC
	⁃	Circle CIR315 SAM
	⁃	Circle CIR315 CL
	⁃	Circle CIR315 DI
	⁃	Circle CIR415 CL & 1S
		Readers.
•		Fixed issue of TPDU pps being sent to APDU reader.
