Oni-Framework

Das Oni-Framework ist eine Plattform für die Softwareentwicklung für eingebettete Geräte. Es wird verwendet, um ein eingebettetes Gerät remote zu debuggen bzw. um Funktionen hinzuzufügen. Derzeit sind die Hauptkonzepte ein vollständig modulares Plugin-System mit lokalem und Remote-RPC. Es wurde für die Ausführung auf Privilegienstufe Ring-0 entwickelt, kann aber mit einigen Anpassungen auch auf Ring-3-Ebenen verwendet werden. Sei gewarnt: Dies ist NICHT für den Produktionseinsatz gedacht, sondern nur für Entwickler, die eine einfache Build-Plattform für Forschungszwecke suchen.

• Derzeit befindet sich dieses Projekt in der Entwicklung und ist möglicherweise nicht vollständig getestet
• Es werden fundierte Kenntnisse in C/C# benötigt
• Magie

Neue Funktionen!

Derzeit unterstützte Funktionen

• Vollständig robustes lokales und Remote-RPC-System
• Alle verwendeten Funktionen sind als Stubs angelegt, um die Portierung auf verschiedene Plattformen zu erleichtern
• Dienstprogramm zur Dateiübertragung
• Farb-Logging-System (funktioniert über UART mit PUTTY)

Geplante Funktionen:

• Debugging-Framework
• Remote-Paketverwaltung und -installation
• Kommunikation zwischen Geräten
• Laden und Entladen von Plugin-Modulen im laufenden Betrieb (Hot-Swap)
• Selbstständige Eskalation von Ring-3 zu Ring-0 (BYO-EntryPoint)

Erstellung und Installation

Das Oni-Framework erfordert lediglich, dass du dieses Verzeichnis auscheckst und die Datei oni/utils/kdlsym/default.h mit allen erforderlichen Implementierungen ausfüllst. Danach sollte es mit gcc oder clang problemlos kompilieren und eine ausführbare Datei erzeugen. Du musst eine BYO-Ausführungsmethode mitbringen, aber bei den meisten eingebetteten Geräten kann dies über eine SSH-Shell, eine Shell über Telnet oder über jede beliebige Shell bewerkstelligt werden. Andere Geräte müssen möglicherweise in einen laufenden Speicherkontext geladen werden und dann zu main springen, das sich um alle Initialisierungsprobleme kümmern sollte.

1. Klone das Repository git clone https://github.com/kiwidoggie/oni-framework.git a. Optional: Setze den Speicherort der FreeBSD-Header export BSD_INC="/path/to/freebsd/headers/include"
2. Wenn du zum ersten Mal baust, musst du make create ausführen, das die Ordnerstruktur erstellt
3. Baue mit make a. Wenn du die Umgebungsvariable nicht gesetzt hast, kannst du mit make BSD_INC=/path/to/freebsd/headers/include bauen

Portierung auf andere Plattformen

Das Oni-Framework ist nicht auf ein voll funktionsfähiges libc angewiesen und ist so konzipiert, dass es vollständig eigenständig erstellt werden und laufen kann (sofern alle Voraussetzungen erfüllt sind). Stattdessen wird die benötigte Funktionalität aus dem absoluten Minimum vorhandener Funktionen zusammengesetzt – entweder im Kontext eines laufenden Prozesses oder im Kernel-Kontext (letzteres ist der einzige getestete).

1. Erstelle ein neues kdlsym-Ziel (Kernel Dynamic Symbol Resolution), indem du einen neuen Header in include/oni/utils/kdlsym/my_platform.h erstellst
2. Kopiere den Inhalt von include/oni/utils/kdlsym/default.h und füge ihn in deine neu erstellte Header-Datei ein
3. Füge dein neues Ziel zu include/oni/utils/kdlsym.h hinzu

#if ONI_PLATFORM==ONI_UNKNOWN_PLATFORM
#include "kdlsym/default.h"
#elif ...
#elif ONI_PLATFORM==ONI_MY_PLATFORM
#include "kdlsym/my_platform.h"
#endif

4. Füge dein Ziel der Konfigurationsdatei hinzu, die sich unter include/oni/config.h befindet

// Unknown device
#define ONI_UNKNOWN_PLATFORM		-1
#define ONI_MY_PLATFORM		5

5. Ändere das aktuelle Build-Ziel, indem du #define ONI_PLATFORM ONI_UNKNOWN_PLATFORM in #define ONI_PLATFORM ONI_MY_PLATFORM änderst

Entwickler

Wenn du einen Beitrag leisten möchtest, reiche einfach einen Pull-Request ein. Ansonsten gibt es derzeit keinen echten Support dafür. Das könnte sich in der Zukunft ändern

@diwidog

Nachrichtenlayout