======================================================
KYOCERA SANE DRIVER
v2.2.1511

(c) 2025 KYOCERA Document Solutions Inc.
======================================================

---------------------------------------------------------
Provided packages
---------------------------------------------------------
For Ubuntu and Debian OS
   - kyocera-sane_2.2.1511_i386.deb
   - kyocera-sane_2.2.1511_amd64.deb

For Fedora, CentOS and openSUSE
   - kyocera-sane-2.2-1511.i686.rpm
   - kyocera-sane-2.2-1511.x86_64.rpm

---------------------------------------------------------
HOW TO INSTALL/UNINSTALL
---------------------------------------------------------
For Debian package:
    Install / Upgrade from existing installation:
	$ sudo dpkg -i [package-filename]
    Uninstall (keep configuration files):
        $ sudo dpkg -r kyocera-sane
    Uninstall (purge / delete configuration files):
        $ sudo dpkg -P kyocera-sane
    Search / check installation
        $ sudo dpkg -l | grep 'kyocera-sane'


For RPM package:
    Install:
        # sudo rpm -ihv [package-filename]
    Upgrade from existing installation:
		For older RPM package until version 1.2.2729, KyoceraSANE driver must be uninstalled when upgrading to a newer RPM package.
			# sudo rpm -e kyocera-sane
			# sudo rpm -ihv [new-package-filename]
		RPM package version starting from KyoceraSANE_v1.2.2729 may upgrade automatically to a newer RPM package without uninstalling old RPM package.
			# sudo rpm -Uhv [package-filename]
    Uninstall:
        # sudo rpm -e kyocera-sane
    Search / check installation
        # rpm -qa | grep kyocera-sane


		
Configuration for Network devices:

  1. After installing the Debian/RPM package, open the following file in a text editor.
	/etc/sane.d/kyocera_devices.conf

  2. Add the hostname/IP address and model of your device as "<Hostname> <ModelName>".
	E.g.
	PC12345 FS-1135MFP
	192.168.1.100 FS-1135MFP

     You can add more than 1 device to the list (1 device per line).
     Please refer to instructions provided in configuration file for more details.

NOTE: 	- SU privileges may be required to modify the configuration file.
	- For RPM based OS, might need to configure Firewall settings and change interface to Internal or Trusted Zone to automatically detect devices.

---------------------------------------------------------
Supported OS
--------------------------------------------------------- 
- Ubuntu 24.04 LTS x64
- Ubuntu 16.04 LTS x32
- Fedora 38 x64
- Fedora 30 x86
- Debian 12 x64
- Debian 12 x86
- CentOS 7 x64
- CentOS 7 x86
- CentOS 9 Stream
- openSUSE Leap
- openSUSE Tumbleweed x64
- openSUSE Tumbleweed x86

---------------------------------------------------------
USB Scan
--------------------------------------------------------- 
1. A4 USB scan was tested on ECOSYS M2040dn and ECOSYS M2640dw

Limitations:
1.  XSane crashes when scanning 998 pages. In this scenario scanning, there are only 871 pages scanned
2.  Failure to install sane driver using package manager
3.  Invalid argument error is encountered when successive scan is performed via terminal commands
4.  Remote function is stopped after DP jam error is cleared
5.  Out of memory error" is encountered when scanning pages in Full Color mode (CentOS)
6.  Scanning via terminal is suddenly killed after scanning more than 370 A6 sheets
7.  Error occurs when cancellation is done almost at the end of scanning of 4 pages or more
8.  XSane crashes after the maximum of 998 scanned pages has been reached by the device.(CentOS)
9.  Error message is displayed during scanning of 998 pages (Ubuntu, Fedora, Debian)
10. Full color scanning in Fedora 33 will result to Green scanned output.
11. Error will sometimes occur when using Hostname instead of IP address in the configuration file.
12. In Ubuntu20 and other Ubuntu20 based OS, USB device will be detected as eSCL or AirPrint device and scanning will fail. Executing "sudo apt purge ippusbxd" will fix the issue.
13. In some OS, XSANE crashes when value of Contrast or Density is manualy updated (by typing). Crash issues does not occur when Slider or Spinner is used to update the value.
14. CentOS 7 32bit requires at least GCC 7.3.0 and at least GCC 12.2.0 in CentOS 7 64bit.
15. Density manual setting can be still set even if Density type is set to Auto. Density value will be disregarded if Density type is set to Auto
16. DP is enabled even if no attached DP on device which results to error being prompted when DP is selected as source.
17. Scan via Pictor may result to invalid argument after first scan. Close the error and scan again. 
18. Switching from KM to TA vice versa will cause for missing reference thus package needed to be installed and uninstalled twice. (Debian)
19. Unable to open SANE when installing KM and TA in one distro due to conflict of files used. 
20. Scanned output may not be accessible to normal user if a root user executes scanning application.
21. Device is stuck in processing state after force quit therefore needs to be restarted.
22. If multiple devices of the same model are connected, an error may occur when one of them is selected for connection. 
23. Last scan settings is saved when using XSANE and other scanning application with UI which affects initial settings when running the application.
24. Connecting multiple same models via USB may result in error due to conflict in name. 
25. XSANE cannot discover USB connected devices when opened via icon (CentOS7 32bit)
26. MA2000, MA2001, MA2000w, MA2001w devices will display E-0003 error when scanning again after Top Cover open error recovery.
27. Some Devices that uses ADF Document process will still return true when getting capability which results in 2-sided/duplex option displayed as Feed method.
28. 2-sided Left-Right have the same result as 2-sided Top
29. Density will not apply if Full Color/Gray is selected when using GDI A4 models (Ex. FS-1025MFP, MA2000w) 
30. Openning of DP cover or pulling original while scanning may not cause paper jam in GDI A4 models (Ex. FS-1025MFP)
31. In some OS, "libsane" is not installed by default. This will cause failure to install the sane package. Execute these commands to install the "libsane":
	a. wget http://mirrors.kernel.org/ubuntu/pool/universe/s/sane-backends/libsane_1.2.1-1_amd64.deb
	b. sudo dpkg -i libsane_1.2.1-1_amd64.deb or any latest available version of libsane in the mirror if 1.2.1-1 is not available. (Opening the link to a browser will display the list).
32. ZLIB_1.2.9 is needed. (CentOS 7 32 bit)

----------------------------------------------------------
Note
----------------------------------------------------------
The following copyright notices apply:

Copyright (c) 1998-2011 The OpenSSL Project.  All rights reserved.
Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
		All rights reserved.