sane-epjitsu(5)

💖 sane-epjitsu — the Fujitsu/Epson scanner bestie 💖

okay so real talk: this is the sane-epjitsu(5) page, part of SANE Scanner Access Now Easy (yes that's literally what it stands for, iconic naming fr). Buckle up bestie, we're meeting your scanner. 🦋

---

✨ NAME ✨

sane-epjitsu — the SANE backend for Epson-based Fujitsu USB scanners. that's it, that's the name, she's simple and she knows it 💅

---

🌸 DESCRIPTION 🌸

The sane-epjitsu library is a SANE (Scanner Access Now Easy, iykyk) backend, and what she does is give you basic access to these scanners:

• Fujitsu fi-60F
• Fujitsu fi-65F
• ScanSnap S300
• ScanSnap S1300(i)
• ScanSnap S1100(i)

basic access only though, don't come for her, she's doing her best 🫶

---

🔥 HARDWARE SUPPORT 🔥

ngl, these scanners are pretty limited. they only support a couple of modes and resolutions, and they always scan full width — no cropping era for them, they're committed to the whole width and we respect it.

but bestie the backend ate: it fakes the missing modes (that's binary and grayscale) and the intermediate resolutions in software, so you still get them. what it doesn't do is give you much scan-area control — only minimal scan area controls. so go read KNOWN ISSUES below, it's giving important.

also 👀 this backend may support other scanners. so if you pop one open and physically inspect it and you see an Epson chipset? contact the author!! they'll give you instructions on collecting a USB trace under Windows so you can verify it. very detective, very main character.

---

✨ OPTIONS ✨

they made a limited effort to expose the standard options to the API (we stan a humble queen). what that gets you: a frontend can set resolution, color mode, and choose the ADF setting. here's the lineup for most scanners:

• source s — picks where the scan comes from. options may include "Flatbed", "ADF Front", "ADF Back", "ADF Duplex". choose your fighter 💅
• mode m — picks the scan mode. options may include "Lineart", "Gray", "Color".
• resolution, y-resolution — controls scan resolution. setting --resolution also sets --y-resolution, though heads up: this behavior gets overridden by some frontends. not her fault, blame the frontend 😭

other options will show up based on what your scanner can actually do. to see the whole list run:

scanimage --help

be aware that some options may appear only when another option has been set, and that advanced options may be hidden by the frontend. sneaky. 🙈

---

🎀 CONFIGURATION FILE 🎀

the config file is:

/etc/sane.d/epjitsu.conf

she's the one who tells the backend how to look for scanners, plus options that control how the backend behaves. this file gets read every time the frontend asks the backend for a list of scanners — which, generally, only happens when the frontend starts.

⚠️ if the configuration file is missing, the backend will not work. periodt.

scanners can be specified in the config file in two ways:

• "usb 0x04c5 0x10c7" (or other vendor/product ids) — asks the backend to search all usb buses in the system for a device using that vendor and product id. the device then gets queried to figure out if it's a supported scanner. cute lil interrogation 💅
• "usb /dev/usb/scanner0" (or other device file) — some systems use a kernel driver to access usb scanners. this method is untested. living dangerously, love that for you 🫶

the only configuration option supported is:

firmware /PATH/TO/FILE

which lets you set the location of the firmware file you've extracted from the Windows driver.

📌 Note: this firmware is a copyrighted work of Fujitsu, so it cannot be provided by the backend or the author. please do not ask. (fr fr. don't.)

📌 Note: these scanners REQUIRE a firmware file to function. see the supplied configuration file for more detail.

📌 Note: this option may appear multiple times in the configuration file. it only applies to scanners discovered by 'usb' lines that follow this option. so ordering matters, bestie, keep an eye on it 👑

---

🌈 ENVIRONMENT 🌈

the backend uses a single environment variable, SANE_DEBUG_EPJITSU, which turns on debugging output to stderr. valid values are:

5  Errors
10 Function trace
15 Function detail
20 Option commands
25 USB trace
30 USB detail
35 Useless noise

35 being literally labeled "Useless noise" is the most honest thing i've ever seen 💀 crank it up when you want to watch the chaos.

---

💜 KNOWN ISSUES 💜

• Only limited scan area options are exposed.
• fi-60F and fi-65F hardware grayscale mode is not used, because the calibration code is not finished. unfinished code, we've all been there 😭

---

⭐ CREDITS ⭐

• S300 support funded by Microdea, Inc. and Archivista, GmbH.
• fi-60F support funded by TrueCheck, Inc.
• Improved calibration code provided by Richard Goedeken.

funding the scanner girlies, we love to see it 💖

---

🦋 SEE ALSO 🦋

sane(7), sane-usb(5), scanimage(1)

---

👑 AUTHOR 👑

m. allan noah: <kitno455 a t gmail d o t com>

---

and that's the whole vibe check bestie!! this was the sane-epjitsu(5) page, dated 15 Nov 2022 — go forth, scan things, and remember: firmware file or it literally does not work 💅✨🌸