Oni-Framework

Oni framework は、組み込みデバイスソフトウェア開発のためのプラットフォームです。組み込みデバイスのリモートデバッグや機能追加のために使用されます。現時点での主なコンセプトは、完全にモジュール化されたプラグインシステムと、ローカルおよびリモートのRPCです。これはring-0特権レベルで動作するように設計されていますが、少し調整すればring-3レベルでも使用できます。警告しておきますが、これは本番環境用ではありません。研究用の簡単なビルドプラットフォームを求める開発者専用です。

• 現在このプロジェクトは開発中であり、完全にはテストされていない可能性があります
• C/C# に関する十分な知識が必要です
• 魔法

新機能！

現在サポートされている機能

• 完全に堅牢なローカルおよびリモートRPCシステム
• 異なるプラットフォームへの移植を容易にするために、使用されるすべての関数がスタブ化されています
• ファイル転送ユーティリティ
• カラーロギングシステム（UART経由でPUTTYと連携）

計画中の機能:

• デバッグフレームワーク
• リモートパッケージ管理とインストール
• デバイス間の通信
• プラグインモジュールのホットスワップ可能なロード/アンロード
• ring-3からring-0への自己権限昇格（BYO-EntryPoint）

ビルドとインストール

Oni-Frameworkは、このディレクトリをチェックアウトし、要求されるすべての実装を oni/utils/kdlsym/default.h ファイルに実装するだけで済みます。その後、gcc または clang で問題なくコンパイルでき、実行可能ファイルが生成されるはずです。実行方法はBYO（各自で用意）とする必要がありますが、ほとんどの組み込みデバイスでは、sshシェル、telnet経由のシェル、または任意のシェルで実現できます。他のデバイスでは、実行中のメモリコンテキストにロードしてから main にジャンプする必要があるかもしれません。main がすべての初期化の問題を処理します。

1. リポジトリをクローンします git clone https://github.com/kiwidoggie/oni-framework.git a. 任意: FreeBSDヘッダーの場所を設定します export BSD_INC="/path/to/freebsd/headers/include"
2. 初めてビルドする場合は、フォルダ構造を作成する make create を実行する必要があります
3. make を使用してビルドします a. 環境変数を設定していない場合は、make BSD_INC=/path/to/freebsd/headers/include でビルドできます

異なるプラットフォームへの移植

Oni-Frameworkは完全な機能を持つlibcに依存しておらず、すべての前提条件が満たされていれば、完全にスタンドアロンでビルドおよび実行できるように作られています。その代わり、必要な機能は、実行中のプロセスのコンテキストまたはカーネルコンテキスト（テスト済みなのは後者のみ）に存在する必要最低限の関数から組み立てられます。

1. include/oni/utils/kdlsym/my_platform.h に新しいヘッダーを作成して、新しいkdlsym（カーネル動的シンボル解決）ターゲットを作成します
2. include/oni/utils/kdlsym/default.h の内容を、新しく作成したヘッダーファイルにコピー＆ペーストします
3. 新しいターゲットを include/oni/utils/kdlsym.h に追加します

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

4. 新しいターゲットを include/oni/config.h にある設定ファイルに追加します

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

5. 現在のビルドターゲットを変更するには、 #define ONI_PLATFORM ONI_UNKNOWN_PLATFORM を #define ONI_PLATFORM ONI_MY_PLATFORM に変更します

開発者

貢献したい場合は、プルリクエストを送信してください。それ以外の場合、現時点ではこれに対する実際のサポートはありません。これは将来変更される可能性があります

@diwidog

メッセージレイアウト