Oni-Framework

O Oni framework é uma plataforma para desenvolvimento de software para dispositivos embarcados. É utilizado para depurar/adicionar funcionalidades remotamente a um dispositivo embarcado. Atualmente, os principais conceitos são um sistema de plugins totalmente modular, com RPC local e remoto. Foi projetado para executar no nível de privilégio ring-0, mas com alguns ajustes também pode ser usado nos níveis ring-3. Atenção: isso NÃO é para uso em produção, apenas para desenvolvedores que desejam uma plataforma de construção fácil para pesquisa.

• Atualmente este projeto está em desenvolvimento e pode não ser totalmente testado
• Será necessário conhecimento decente de C/C#
• Magia

Novas Funcionalidades!

Funcionalidades atualmente suportadas

• Sistema RPC local e remoto totalmente robusto
• Todas as funções utilizadas são stubadas para facilitar a portabilidade para diferentes plataformas
• Utilitário de transferência de arquivos
• Sistema de registro colorido (funciona via UART com PUTTY)

Funcionalidades planeadas:

• Estrutura de depuração
• Gerenciamento e instalação remota de pacotes
• Comunicação entre dispositivos
• Carregamento e descarregamento hot-swappable de módulos de plugins
• Auto-escalonamento de ring-3 para ring-0 (BYO-EntryPoint)

Compilação e Instalação

O Oni-Framework apenas requer que você faça checkout deste diretório e implemente o arquivo oni/utils/kdlsym/default.h com todas as implementações necessárias. Depois disso, deve compilar sem problemas com gcc ou clang e produzir um arquivo executável. Você precisará de um método de execução BYO, mas para a maioria dos dispositivos embarcados isso pode ser feito através de um shell ssh, um shell via telnet ou qualquer outro shell. Outros dispositivos podem ter que carregar no contexto de memória em execução e depois pular para main, que cuidará de todas as questões de inicialização.

1. Clone o repositório git clone https://github.com/kiwidoggie/oni-framework.git a. Opcional: Defina a localização dos cabeçalhos do FreeBSD export BSD_INC="/caminho/para/cabeçalhos/freebsd/include"
2. Se estiver compilando pela primeira vez, deve executar make create, que criará a estrutura de pastas
3. Compile usando make a. Se não tiver definido a variável de ambiente, pode compilar com make BSD_INC=/caminho/para/cabeçalhos/freebsd/include

Portabilidade para diferentes plataformas

O Oni-Framework não depende de uma libc totalmente funcional e foi construído para compilar e executar de forma completamente independente (desde que todos os pré-requisitos sejam atendidos). Em vez disso, a funcionalidade necessária é montada a partir do mínimo de funções existentes, seja no contexto de um processo em execução ou no contexto do kernel (este último é o único testado).

1. Crie um novo alvo kdlsym (resolução dinâmica de símbolos do kernel) criando um novo cabeçalho em include/oni/utils/kdlsym/my_platform.h
2. Copie e cole o conteúdo de include/oni/utils/kdlsym/default.h no seu arquivo de cabeçalho recém-criado
3. Adicione o seu novo alvo a 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. Adicione o seu alvo ao arquivo de configuração localizado em include/oni/config.h

// Dispositivo desconhecido
#define ONI_UNKNOWN_PLATFORM		-1
#define ONI_MY_PLATFORM		5

5. Altere o alvo de compilação atual mudando #define ONI_PLATFORM ONI_UNKNOWN_PLATFORM para #define ONI_PLATFORM ONI_MY_PLATFORM

Desenvolvedores

Se quiser contribuir, basta enviar um pull request. Caso contrário, não há suporte real para isso neste momento. Isso pode mudar no futuro.

@diwidog

Layout da Mensagem