Zum Inhalt springen
Zurück zum Blog
· 9 Min. Lesezeit · Alexander Nassian

Scanora 0.12.1: Was hinter U5 steckt – und warum ein Timeout nicht das Ende ist

Scanora 0.12.1 ist im Mac App Store. Fotos mit dunklem Rand bleiben ganz, Seiten lassen sich als JPEG ablegen, ein Scanner in U5 kommt ohne Aus- und Einschalten zurück – und eine Diagnose schreibt mit, was am Kabel passiert.

Kurz gesagt: Scanora 0.12.1 ist im Mac App Store. Dahinter stehen zwei Meldungen von Kunden. Die erste betrifft Fotos: Ein randloser Abzug mit fast schwarzem Hintergrund kam trotz der Korrekturen aus 0.11.0 beschnitten heraus. Er bleibt jetzt ganz, und jede Seite lässt sich auch als JPEG ablegen. Die zweite betrifft einen Scanner, der beim Anstecken U5 zeigte und für Scanora danach nicht mehr existierte. Was U5 auslöst, haben wir am Gerät gemessen, und Scanora holt den Scanner jetzt selbst wieder heraus. Weil sich nicht jeder Fehler bei uns nachstellen lässt, kann Scanora außerdem mitschreiben, was am Kabel passiert. Wer von 0.11.0 kommt, bekommt mit diesem Update auch alles aus 0.12.0.

Fotos: Wenn die meisten Zeilen danebenliegen

Scanora ist unsere macOS-App für den KODAK E1030, einen Einzugsscanner, für den der Hersteller keinen macOS-Treiber anbietet. Die App spricht das USB-Protokoll des Geräts direkt und macht aus dem Sensorbild fertige Seiten.

Nach dem Update auf 0.11.0 meldete sich der Kunde wieder, um dessen Fotos es im letzten Beitrag ging. Die Belichtung stimmte jetzt. Ein randloser 10 × 15-Abzug mit nachtschwarzem Hintergrund an beiden Seiten kam aber 110 statt 149 mm breit heraus, um 9,7° gedreht, die er gar nicht hatte. Ohne Zuschneiden blieben schwarze Ränder.

Scanora sucht in jeder Zeile des Sensorbilds die Kante des Blatts und legt durch diese Punkte eine Gerade, gegen Ausreißer abgesichert über den Median. Das setzt voraus, dass die meisten Zeilen ihre Kante finden. Auf diesem Abzug zeigte an der linken Seite nur etwas Helles am unteren Ende den wahren Rand, in 345 von 937 Zeilen. Jede andere Zeile fand ihre „Kante“ erst am Motiv in der Bildmitte, und der Median folgte der Mehrheit.

Eine Zeile, deren Papier dunkel beginnt, findet ihre Kante aber immer innerhalb des Bilds, nie außerhalb davon. Deshalb gilt als Seite jetzt die äußerste Linie, auf die sich genug Zeilen einigen – Zeilen über mindestens 10 mm der Blattlänge oder ein Zwanzigstel aller Zeilen, auf einen Millimeter genau. Die Schräglage wird für beide Seiten gemeinsam gesucht, weil sie parallel sind. Liegen fast alle Zeilen auf der Kante, wie bei einem Dokument oder einem Abzug mit weißem Rand, rechnet Scanora wie bisher. Das Polaroid aus der letzten Gegenprobe misst bitgenau dasselbe wie vorher.

Bleibt der Fall, dass an einer Seite überhaupt keine Zeile eine Kante zeigt. Auch dort ist das Papier im Mittel heller als der Hintergrund: Auf diesem Abzug lasen die dunkelsten Stellen 3,5 bis 7 je Spalte, der Hintergrund 0,5 bis 2,1. Hinter jeder gefundenen Kante vergleicht Scanora jetzt Linien parallel zu ihr mit dem Hintergrund derselben Seite, gemessen in den äußeren 2 mm des Sensors, und schiebt die Kante bis dorthin, wo der Hintergrund beginnt. Oben und unten geht das genauso, etwa bei einem dunklen Himmel. Die Suche setzt erst ein, wenn der Millimeter hinter der Kante im Mittel 1,5 über dem Hintergrund liegt. So bleiben die Kante eines Dokuments und eine Linie auf dem Glas daneben, wo sie waren.

Der Scan des Kunden misst jetzt 149,3 × 101,7 mm bei 0,55°. Dabei fiel noch eine Kleinigkeit auf. Läuft ein Blatt schräg ein, liegen seine Ecken außerhalb der aufgenommenen Zeilen, und seit 0.11.0 ergänzt Scanora sie weiß. Am Rand eines Dokuments sieht das aus wie Rand. Am Rand eines dunklen Fotos war es ein heller Streifen, bei 0,55° bis zu 1,5 mm breit. Bei Fotos wiederholt Scanora dort jetzt den nächsten aufgenommenen Bildpunkt, und auf diese Tiefe sieht man davon nichts.

JPEG

Gewünscht hat sich das derselbe Kunde: Wer Abzüge scannt, um sie aufzubewahren und weiterzugeben, dem steht ein PDF um jedes Bild nur im Weg. Jedes Profil hat jetzt ein Dateiformat, PDF oder JPEG. Bei JPEG wird jede Seite eine eigene Datei, und zwar sobald sie fertig ist: Klemmt der Stapel, liegen die ersten Blätter schon im Ordner. Mit {Nummer} im Dateinamen zählt jede Seite weiter (Foto 0007, Foto 0008 …). Der Qualitätsregler reicht jetzt bis 100. Die Texterkennung ist bei JPEG ausgegraut, weil die Datei keine Textebene hat, in die der Text käme.

U5: ein Scanner, den es nicht mehr gab

Die zweite Meldung: Kaum angesteckt, zeigte ein Scanner abwechselnd U und 5 auf dem Display, die Ein-Taste blinkte, und Scanora meldete „Kein Scanner gefunden“, obwohl die Systeminformationen ihn auflisteten. Danach kam noch „Die Abschaltzeit konnte nicht auf den Scanner übertragen werden“, als läge dort das Problem.

Zwei Dinge daran lagen bei uns. Erstens sagte Scanora zu jedem Fehler beim Öffnen „Kein Scanner gefunden“, auch wenn der Scanner da war und nur nicht antwortete oder ein anderes Programm ihn belegte. Diese Meldung schickt einen zum Kabel, und am Kabel lag es nicht. Jetzt unterscheidet Scanora drei Fälle und sagt jeweils, was zu tun ist: nicht angeschlossen; von einem anderen Programm benutzt, mit dem Rat, es zu beenden; angeschlossen, aber ohne Antwort. Abschaltzeit und Profilzahl gehen nur noch an einen Scanner, der geantwortet hat, und ein Scanner ohne Antwort löst keine zweite Meldung mehr aus.

Zweitens kam Scanora aus U5 nie heraus. U5 ist die Fehleranzeige des Scanners für seine USB-Verbindung. Er sperrt dann beide Übertragungsrichtungen und nimmt nichts mehr an. Die Sperre sitzt im Gerät, nicht im Mac, deshalb fand jeder neue Verbindungsversuch sie wieder. In der Praxis half nur Aus- und Einschalten.

Was U5 auslöst

Beim Kunden ließ sich das nicht nachstellen, also haben wir am eigenen Gerät gemessen, wie man hineinkommt. Aus der Analyse der Firmware war ein Weg bekannt: Endet ein Befehl im Scanner mit bestimmten Fehlern, schaltet er auf U5. Der zweite ist überraschender. Der Scanner wartet nach jedem Befehl darauf, dass der Mac die Antwort abholt. Holt sie niemand ab, gibt er auf und sperrt beide Richtungen, gemessen nach 5,1 Sekunden, mit U5 auf dem Display.

Hinaus führt ein Zurücksetzen der USB-Verbindung, derselbe Bus-Reset, den auch das Einstecken auslöst. Er hebt beide Sperren, den Fehlerzustand und die Anzeige auf, gemessen in 1,4 Sekunden. Scanora fragt beim Verbinden jetzt zuerst, ob der Scanner gesperrt ist, und setzt ihn in dem Fall selbst zurück, höchstens einmal pro Minute.

Dass das Einstecken selbst schon zurücksetzt, heißt aber auch: Zeigt ein Scanner gleich danach U5, passiert in den ersten Sekunden etwas, das er nicht verträgt. Ein Verdacht fiel auf Scanora selbst. Bisher beendete die App bei jedem Öffnen vorsorglich einen Scanauftrag, auch wenn gar keiner offen war. Das waren die ersten Befehle, die ein frisch angesteckter Scanner sah, und was ein Gerät ohne offenen Auftrag darauf antwortet, ist nicht für jede Firmware bekannt. Jetzt fragt Scanora erst nach und beendet nur einen Auftrag, der wirklich offen ist, etwa von einem Programm, das mitten im Scan beendet wurde. Ob das beim Kunden U5 ausgelöst hat, wissen wir nicht.

Ein zweiter Verdacht ließ sich ausräumen. Unser Gerät lief bisher nur an SuperSpeed-Anschlüssen. Hinter einem USB-2.0-Hub zeigte es dieselben Antwortzeiten, scannte 300 dpi in Graustufen und 600 dpi farbig beidseitig ohne eine einzige Zeitüberschreitung und kam auf demselben Weg in U5 hinein und wieder heraus.

Warum ein Timeout nicht das Ende ist

Bisher wartete jede Übertragung so lange, wie es der Treiber des Herstellers tut: 30 Sekunden hin, 60 zurück, auch bei Statusabfragen, die ein gesundes Gerät in Millisekunden beantwortet. Bei einem Scanner, der Befehle annimmt und nie antwortet, dauerte es so Minuten, bis Scanora das merkte. Jetzt bekommen diese Abfragen fünf Sekunden. Gemessen brauchen sie höchstens 5 ms, eine einzige 136 ms. Was wirklich dauert, also ein Blatt einziehen oder Bilddaten über eine langsame Verbindung schicken, behält die langen Zeiten.

Kurze Zeitgrenzen haben aber eine Falle, und die hängt mit U5 zusammen. Gibt der Mac das Warten auf, ist die Antwort nicht verschwunden, der Scanner hält sie weiter bereit. Holt sie niemand ab, sperrt er nach fünf Sekunden – U5. Holt sie der nächste Befehl ab, bekommt der die Antwort seines Vorgängers, und von da an liegt jede Antwort einen Befehl zurück. Deshalb schickt Scanora nach einer Zeitüberschreitung nichts mehr über dieselbe Verbindung, und die nächste Verbindung liest zuerst ab, was noch in der Leitung liegt. Auch das haben wir am Gerät nachgemessen: Ein Bus-Reset wirft eine solche Antwort nicht weg, erst das Lesen tut es.

Mitschreiben, was am Kabel passiert

Was beim Kunden das U5 beim Einstecken auslöst, wissen wir trotz allem nicht. Unser Gerät tut es nicht, und raten hilft hier nicht weiter. Deshalb kann Scanora jetzt mitschreiben: In den Einstellungen gibt es „Diagnose aufzeichnen“, und „Diagnose sichern …“ im Menü „Hilfe“ macht daraus eine Textdatei. Darin steht:

  • jeder Befehl an den Scanner mit Antwort und Dauer und nach einer Sperre, welche Richtung gesperrt ist;
  • was der Mac am Bus sieht, auch wenn der Scanner gar nicht antwortet: Geschwindigkeit, Anschluss, wie viele Hubs dazwischen liegen, der USB-Controller;
  • die Firmware des Scanners und die Versionen von Scanora, macOS und Mac;
  • ob ein anderes Scanprogramm läuft;
  • je Scan die Einstellungen und die gemessene Größe jeder Seite.

Nicht darin stehen Scans, erkannter Text, Datei-, Ordner- und Profilnamen und Seriennummern. Bilddaten erscheinen nur als Summe, so viele Megabyte in so vielen Sekunden. Kommt dieselbe Abfrage hundertmal mit demselben Ergebnis zurück, wird sie gezählt statt hundertmal geschrieben. Die Aufzeichnung liegt im Container der App, höchstens zweimal 2 MB, und verlässt den Mac nur, wenn Sie die Datei selbst verschicken: Scanora hat weiterhin keine Netzwerkberechtigung.

Wie das geht, zeigt ein Video von gut einer Minute:

Vorschaubild des Videos „Diagnose aufzeichnen und senden“: das Scanora-Symbol, darunter der Titel und eine Wiedergabetaste.
„Diagnosedaten von Scanora teilen“, 1:11 Minuten. Der Link öffnet YouTube.

Was sonst noch dabei ist

  • Ein Abbruch direkt nach dem Start eines Scans wird nicht mehr übergangen.
  • Ein Scanauftrag, den ein beendetes Programm im Scanner offen gelassen hat, wird vor dem nächsten Scan sauber beendet.
  • Ein Scanner, der nicht antwortet, hält das Fenster nicht mehr auf. Ein Abbruch wartet dabei höchstens fünf Sekunden, im ungünstigsten Fall zehn.

Die vollständigen Versionshinweise stehen auf der Produktseite.

Was daraus für Geräteprojekte folgt

  1. Eine Zeitüberschreitung beendet nur das Warten, nicht den Vorgang. Das Gerät arbeitet weiter, und seine Antwort liegt danach irgendwo. Wer nach einem Timeout einfach weitermacht, liest zum nächsten Befehl die falsche Antwort oder lässt das Gerät in eine Sperre laufen. Was nach einer Zeitüberschreitung geschieht, gehört zum Protokoll und muss am Gerät gemessen werden.
  2. Eine Fehlermeldung ist eine Handlungsanweisung. „Kein Scanner gefunden“ schickt den Nutzer zum Kabel. Drei Ursachen brauchen drei Meldungen, und dafür muss der Treiber sie bis in die Oberfläche auseinanderhalten.
  3. Robuste Statistik ist nur gegen eine Minderheit robust. Der Median verträgt Ausreißer, solange sie in der Minderheit sind. Auf dem dunklen Foto lag die Mehrheit falsch, aber immer in dieselbe Richtung. Dieses Wissen über die Messung trägt weiter als jede Statistik.
  4. Für den Fehler, den man nicht nachstellen kann, vorher das Werkzeug bauen. Eine Aufzeichnung, die der Kunde selbst einschalten und verschicken kann, ohne dass Dokumente oder Namen darin stehen, ist bei einem Gerät im Feld der einzige Blick auf sein Kabel.

Wie sich solche Messungen regelmäßig gegen das echte Gerät wiederholen lassen, beschreibt unser Beitrag Hardware-in-the-Loop-Testing.


Scanora ist ein unabhängiges Produkt der bitshift dynamics GmbH und steht in keiner Verbindung zum Inhaber der Marke KODAK. Der Modellname benennt allein, mit welchem Gerät die App zusammenarbeitet.

Häufige Fragen

Wie bekomme ich Scanora 0.12.1?
Über den Mac App Store. Ist dort die automatische Aktualisierung eingeschaltet, kommt das Update von selbst; sonst finden Sie es im App Store unter „Updates“. Wer von 0.11.0 kommt, bekommt damit auch alles aus 0.12.0. Die Voraussetzungen sind unverändert: macOS 13 oder neuer und ein Mac mit Apple Silicon.
Mein Scanner zeigt U und 5 im Wechsel. Was tue ich?
Mit 0.12.1 nichts: Scanora erkennt beim Verbinden, dass der Scanner gesperrt ist, und setzt die USB-Verbindung selbst zurück. Das dauert etwa anderthalb Sekunden, danach verschwindet U5 vom Display. Kommt U5 immer wieder, zeichnen Sie bitte eine Diagnose auf und schicken Sie sie uns.
Wie schicke ich Ihnen eine Diagnose?
In den Einstellungen „Diagnose aufzeichnen“ einschalten, das Problem einmal nachstellen, dann im Menü „Hilfe“ „Diagnose sichern …“ wählen und die Textdatei an info@bitshift-dynamics.com schicken. Die Datei enthält keine Scans, keinen erkannten Text, keine Datei-, Ordner- oder Profilnamen und keine Seriennummern.
Wann wähle ich JPEG statt PDF?
JPEG für Fotos, die Sie aufbewahren, bearbeiten oder weitergeben wollen: Jede Seite wird eine eigene Bilddatei. PDF für Dokumente: alle Seiten eines Durchgangs in einer Datei, auf Wunsch mit durchsuchbarem Text. Die Texterkennung gibt es nur im PDF, weil ein JPEG keine Textebene hat.

Alexander Nassian

Geschäftsführer, bitshift dynamics

Entwickelt mit seinem Team hardwarenahe Software für Embedded-Produkte – C++, Qt/QML, Embedded Linux und das Yocto Project. bitshift dynamics arbeitet seit 2005 in diesem Feld.

Verwandte Beiträge

Steht bei Ihnen eine ähnliche Aufgabe an?

Wir begleiten Embedded-Teams genau bei solchen Fragestellungen – von der Architekturentscheidung bis zur Serienreife. Schildern Sie uns kurz Ihr Vorhaben.

Projekt anfragen