MintSCAN
=======
MintSCAN scans directly from modern eSCL/AirScan network scanners and
multifunction printers to files on a classic Amiga. It needs no PC scan
server, scanner-specific Amiga driver, or system modification.
It is the scanning companion to MintPRINT, with a standalone GadTools
interface for discovery, saved profiles, scan settings, status and saving.
Archive contents
----------------
Install / Install.info optional Installer entry point
MintSCAN.info Workbench drawer icon
MintSCAN.readme this description
MintSCAN/
MintScan / MintScan.info application and Workbench tool icon
MintSCAN.guide AmigaGuide user manual
LICENSE MIT licence
Features
--------
- HTTP eSCL scanner discovery through mDNS (_uscan._tcp)
- DNS-SD SRV port and TXT rs= resource-root support
- Manual IPv4 and optional port Query
- Scanner make/model and top-level state display
- Flatbed or feeder, RGB/Grayscale/B&W, 100-600 DPI
- JPEG, PNG or PDF output; A4, Letter, Legal or A3 regions
- Source-scoped colour and DPI capability validation
- Eight saved scanner profiles (Unit0 to Unit7)
- ASL save requester plus direct AmigaDOS path entry
- Timeout-bounded network operations and sleeping Wi-Fi retry
- Content-Length/chunked transfer validation and checked disk writes
- Partial destination removal after timeout, truncation or write failure
Requirements
------------
- Motorola 68000 or later
- AmigaOS 3.0 or later
- A running TCP/IP stack providing bsdsocket.library
- An eSCL/AirScan scanner reachable over plain HTTP
- About 1 MiB free memory recommended
MintScan requests a 128 KiB stack. Use the supplied MintScan.info when
launching it from Workbench.
Installation
------------
Double-click Install and choose a destination, or copy the MintSCAN drawer
wherever you prefer. The installer copies only the application drawer and
does not change DEVS:, LIBS:, preferences or startup files. No reboot is
required.
Quick start
-----------
1. Start the TCP/IP stack and run MintScan.
2. Click Discover, or enter SCANNER-IP[:PORT] and click Query.
3. Confirm Model and Status, then choose the scan options.
4. Set Save to with Browse or type an AmigaDOS path.
5. Click Scan.
6. Use Save Config to retain the profile in the selected Unit.
Saved profiles live in ENV:MintSCAN/Unit0-Unit7 and matching ENVARC: files.
Use `File > About MintSCAN...` for version and project details. `Help > MintSCAN Help...`
opens the supplied AmigaGuide manual when MultiView or AmigaGuide is installed.
Limitations
-----------
- Plain HTTP eSCL only; no HTTPS/AmiSSL in 1.1.0
- One page per scan; no multi-page feeder loop or duplex
- Fixed Source, Format and Size lists
- Manual Query accepts IPv4, not hostnames or IPv6
- No cancellation while a scan is active
The Brother MFC-J6930DW advertises BlackAndWhite1 but has been observed to
return damaged colour data for it. MintSCAN substitutes Grayscale8 for that
model only.
Compatibility
-------------
MintSCAN targets the V39/V37-era APIs used on AmigaOS 3.0 and later. End-to-
end testing has been performed with a Brother MFC-J6930DW. Reports from other
scanners, TCP/IP stacks and early AmigaOS 3.x systems are welcome.
Support and source
------------------
https://github.com/boingball/MintSCAN
https://github.com/boingball/MintSCAN/issues
When reporting a problem, include the scanner model, AmigaOS version, TCP/IP
stack and exact Source/Colour/DPI/Format/Size selections. The source archive's
windows_escl_probe.py can capture a comparable transaction from a PC.
License
-------
MIT License. See LICENSE in the archive.
History
-------
1.1.0 Saved Unit profiles; live status; ASL Browse; network timeouts and
Wi-Fi retry; advertised port/root discovery; robust HTTP framing and
file integrity checks; 400 DPI; model-scoped B&W workaround; installer,
AmigaGuide, parser tests and release packaging.
1.0.0 Initial single-page eSCL scan-to-file implementation.
|
aminet net>