View source for User:S3lph/Screamer M.2

{{Verwendung/Privat|s3lph}}

[[File:Screamer M.2 Banane.jpg|200px|thumb|right|Screamer M.2, Banana for scale™]]

Der '''Screamer M.2''' ist ein FPGA-basiertes Board, um mit dem PCIe-Bus eines Computers zu interagieren.  Das Gerät kostet in der Anschaffung (Stand 2020, Modell M.2 R04) etwas über CHF 300.
Das Board hat den Formfaktor einer M.2-Steckkarte (zum Einstecken in den Zielcomputer) und verfügt über einen USB-3.1-Anschluss (zum Anschliessen an den Kontrollcomputer).

== Lieferumfang ==

* Screamer M.2
* Adapter auf PCIe CEM x1, nur minimal Grösser als der Screamer selbst
* Adapter auf PCIe CEM x4, mit Bracket zur (semi-) permanenten Installation in einem Computer
* USB-3.1-Kabel
* Adapter USB-C/USB-A

== Verwendung ==

=== Hotplug ===

Auch wenn Hotplugging mit PCIe prinzipiell möglich ist, hängt es doch von sehr vielen Faktoren ab, ob eine im Betrieb eingestecktes Gerät auch ohne Power Cycle funktioniert.

{{Achtung|Wenn du die Kontrolle über einen laufenden Computer übernehmen willst, z.B. weil du das Passwort für deine Festplattenverschlüsselung vergessen hast, ist dieses Gerät nur in manchen Fällen die richtige Wahl.  Das Einstecken eines PCIe-Geräts in einen der CEM-Steckkartenplätze auf dem Mainboard des Zielgeräts kann funktionieren, es kann aber auch ebenso gut das Zielgerät zum Absturz bringen.  ExpressCard- oder Thunderbolt-Anschlüsse sollten da hingegen schon deutlich risikofreier sein.}}

==== Anforderungen ====

* Das Gerät muss hotplugfähig sein
** Screamer M.2 ist hotplugfähig.  Eventuell muss man den Resetbutton auf dem Gerät drücken, aber grundsätzlich: ja
* Wenn mit dem Kernel interagiert werden soll, muss der Kernel das neue Gerät enumerieren können
** Linux-Kernel
*** [https://lwn.net/Articles/767885/ pciehp seit 2004]
*** <code>echo 1 > /sys/bus/pci/rescan</code>
* Das Mainboard muss hotplugfähig sein
** Variiert sehr stark von Mainboard zu Mainboard
** Mit den Details kenne ich mich hier nicht aus
* Thunderbolt 3: Bei vielen Geräten sind defaultmässig nur USB und DP erlaubt, für PCIe müssen die angeschlossen Geräte dann erst zugelassen werden.

==== Erfahrungen ====

Ich habe bei meinen Hotplug-Tests je nach Gerät eins der drei folgenden Ergebnisse feststellen können:
* Hotplug funktioniert, Gerät wird vom Kernel erkannt und kann ab dann DMA-Zugriffe machen
* Gerät wird weitestgehend ignoriert, teilweise kommen einzelne Ereignisse (<abbr title="Non-Maskable Interrupt, ein Hardwareinterrupt, der vom Kernel zwingend entgegengenommen werden muss">NMI</abbr>) durch.
** Teilweise hilft ein <code>echo 1 > /sys/bus/pci/rescan</code>, teilweise braucht es einen Power Cycle
* Der Zielcomputer geht in einen <abbr title="'Halt and Catch Fire', das heisst, dass sich das Gerät aufhängt und nicht mehr reagiert, bis der Strom getrennt wird.">HCF</abbr>-Zustand.

=== Verwendung mit PCILeech ===

# FT60x-Treiber installieren
## <code>git clone https://github.com/lambdaconcept/ft60x_driver</code>
## <code>cd ft60x_driver</code>
## <code>make</code>
## <code>sudo insmod ft60x.ko</code>
# PCILeech installieren
## [https://github.com/ufrisk/pcileech/releases/ Neueste Version herunterladen]
## Archiv entpacken
## <code>chmod +x pcileech</code>
# Hardware in Betrieb nehmen
## Screamer M.2 am Zielgerät anschliessen
## Zielgerät starten (wenn kein Hotplug)
## Resetbutton auf dem Screamer M.2 drücken
## USB-Kabel im Kontrollgerät einstecken
# DMA testen
## <code>sudo ./pcileech testmemread -device FPGA</code>
# Weitere Verwendung: Siehe [https://github.com/ufrisk/pcileech/wiki PCILeech-Doku]

== Links ==

* Hersteller-Doku: http://docs.lambdaconcept.com/screamer/index.html
* PCILeech (Werkzeug und Payloads, um via DMA mit dem Betriebssystemkernel zu interagieren und z.B. Dateien auszulesen und zu schreiben): https://github.com/ufrisk/pcileech/