Struktur
Das VCA-Treiber-Repository ist mit Dienstprogrammskripten, Vorlagen, Beispielen und dem VCA-SDK selbst verfügbar, um die Entwicklung der Kameraanschlüsse zu erleichtern.
Ordner "requirements"
Der Ordner "requirements" enthält sowohl wichtige Installationsskripte als auch optionale Skripte für die Entwicklung.
install_build_requirements.sh: Dieses Skript installiert eine bestimmte Version von CMake und die Pakete, die ausschließlich zum Erstellen der Kameraconnectors erforderlich sind.
install_test_requirements.sh: Dieses Skript richtet die Umgebung zum Erstellen und Ausführen von Tests für die Kameraconnectors ein.
install_opencv.sh: Das Repository enthält eine spezielle Version von OpenCV mit FFmpeg, die auch von VCA verwendet wird. Mit diesen installierten 3rd-Party-Bibliotheken ist es möglich, Kamera-Konnektoren mit OpenCV zu erstellen.
install_clangd_language_server_16_0_2.sh (für Dev Container): Wenn die Entwicklungsumgebung Dev Container verwendet wird, wird empfohlen, den Sprachserver clangd language server zu verwenden. Dieses Skript installiert den Sprachserver.
Ordner "SDK"
Das VCA-Treiber-Repository wird mit einem vorgefertigten VCA-SDK geliefert. Die Bibliotheksdatei, die Header-Dateien und Informationen zur aktuellen SDK-Version befinden sich im Ordner "sdk".
Ordner "drivers"
Dieser Ordner enthält Beispiele für Kameraanschlüsse. Sie können sich auf die Implementierung dieser Konnektoren beziehen, um zusätzliche Einblicke in das gesamte Konzept zu erhalten.
Ordner "templates"
Um die Einrichtung und Entwicklung eines neuen Kamera-Connectors zu erleichtern, gibt es Vorlagendateien mit der grundlegenden Implementierung der wesentlichen Klassen. Dazu gehören zusätzliche Dateien zum Testen und Ordner für die API-Dateien des Kameraherstellers. Diese Dateien und Ordner im Ordner "templates" dürfen nicht bearbeitet werden, sie werden vom Scaffolding Utility-Skript verwendet, wenn ein neuer Konnektor erstellt wird.
Gerüst-Skript
Das Skript des Gerüstbau-Dienstprogramms befindet sich im Stammverzeichnis des Repositorys. Wie im Abschnitt "Vorlagen" erwähnt, soll dieses Skript die Einrichtung eines neuen Kameraanschlusses erleichtern und den Einstieg in die Entwicklung erleichtern.
. /scaffolding.sh *Name des Steckers*
# Der Name des Konnektors darf keine Leerzeichen oder Sonderzeichen enthalten.
Nach dem Ausführen des Skripts wird ein neuer Ordner mit dem angegebenen Namen im Ordner "drivers" erstellt. Dieser neue Ordner basiert auf dem Ordner "templates". Das Skript ersetzt die Dateinamen und den Dateiinhalt, um den neuen Namen des Kameraanschlusses widerzuspiegeln.
Wenn Sie z. B. das folgende Skript ausführen:
. /scaffolding.sh MyCam
Dies hat folgende Auswirkungen:
Der mycam-Ordner wird unter "Treiber" erstellt
Die Namen der Quelldateien beginnen mit dem Präfix MyCam
Die Klassen, die sich auf den Kamera-Connector beziehen, haben das Präfix MyCam
Ein leerer "lib"-Ordner und die enthaltenen Ordner werden für die Herstellerdateien hinzugefügt
Die CMakeLists.txt wird mit dem mycam-Projekt und der mycam-Bibliothek aktualisiert
Das build.sh-Skript wird mit den Befehlen MyCam build und install hinzugefügt
Die CMakePresets.json und CMakeLists.txt im Stammverzeichnis werden mit den neuen Konfigurationen für den MyCam-Kamera-Connector aktualisiert.
MyCam und mycam werden bewusst getrennt voneinander verwendet.
Die Namenskonvention des Kamerasteckers ist derzeit durch VCA eingeschränkt. Die Bibliotheksdatei und der Name des Konnektors dürfen nur Kleinbuchstaben enthalten. Das Skript übernimmt die Benennung.
Build_drivers Skript
Sobald die Entwicklungsumgebung eingerichtet ist, können die verfügbaren Kamera-Konnektoren im Ordner "drivers" mit dem build_drivers-Skript aus der Quelle erstellt werden. Das Skript erstellt die Release-Version der Connectors und verpackt sie bereits, in VCA verwendet zu werden.
Build_drivers_with_docker Skript
Durch die build_drivers_with_docker Skripte ist es möglich, die verfügbaren Kamera-Konnektoren im Ordner "drivers" aus der Quelle zu erstellen, ohne die Entwicklungsumgebung mit Docker einzurichten. Das Skript verwendet die Dockerfile im Stammverzeichnis des Repositorys, um eine temporäre Entwicklungsumgebung in einem Container zu erstellen, und führt dasselbe build_drivers.sh Skript aus.
Voraussetzungen für die Skripts
Es ist wichtig zu beachten, dass die Skripts, die vom VCA-Treiber-Repository bereitgestellt werden, möglicherweise erhöhte Benutzerrechte erfordern. Führen Sie das Gerüstskript z. B. wie folgt aus:
```
CHMOD 777 scaffolding.sh
sudo ./scaffoldoing.sh MyCam
```