Oni-Framework

Oni framework es una plataforma para el desarrollo de software de dispositivos embebidos. Se utiliza para depurar/añadir funcionalidad de forma remota a un dispositivo embebido. Por ahora, los conceptos principales son un sistema de plugins totalmente modular, con RPC local y remoto. Fue diseñado para ejecutarse en el nivel de privilegio ring-0, pero con algunos ajustes también se puede usar en niveles ring-3. Ten en cuenta que esto NO es para uso en producción, solo para desarrolladores que quieran una plataforma de construcción fácil para investigación.

• Actualmente este proyecto está en desarrollo, y puede no estar completamente probado
• Se necesitará un conocimiento decente de C/C#
• Magia

¡Nuevas características!

Características actualmente soportadas

• Sistema RPC local y remoto totalmente robusto
• Todas las funciones utilizadas se dejan como stubs para facilitar el portado a diferentes plataformas
• Utilidad de transferencia de archivos
• Sistema de registro (logging) con colores (funciona por UART con PUTTY)

Funcionalidades planificadas:

• Framework de depuración
• Gestión e instalación remota de paquetes
• Comunicación entre dispositivos
• Carga y descarga en caliente de módulos de plugins
• Auto-escalada de ring-3 a ring-0 (BYO-EntryPoint)

Compilación e instalación

Oni-Framework solo requiere que clones este directorio e implementes el archivo oni/utils/kdlsym/default.h con todas las implementaciones requeridas. Después de esto, debería compilar sin problemas con gcc o clang y producir un archivo ejecutable. Necesitarás traer tu propio método de ejecución (BYO), pero para la mayoría de los dispositivos embebidos esto se puede lograr mediante un shell SSH, un shell a través de telnet, o cualquier otro shell, de hecho. Otros dispositivos pueden tener que cargarse en el contexto de memoria en ejecución y luego saltar a main, que debería encargarse de todos los problemas de inicialización.

1. Clona el repositorio git clone https://github.com/kiwidoggie/oni-framework.git a. Opcional: Establece la ubicación de los encabezados de FreeBSD export BSD_INC="/path/to/freebsd/headers/include"
2. Si es la primera vez que compilas, debes ejecutar make create, que creará la estructura de carpetas
3. Compila usando make a. Si no has establecido la variable de entorno, puedes compilar con make BSD_INC=/path/to/freebsd/headers/include

Portado a diferentes plataformas

Oni-Framework no depende de una libc completamente funcional, y está construido para compilarse y ejecutarse de forma totalmente independiente (siempre que se cumplan todos los requisitos previos). En su lugar, la funcionalidad necesaria se ensambla a partir del mínimo indispensable de funciones existentes, ya sea en el contexto de un proceso en ejecución o en el contexto del kernel (este último es el único probado).

1. Crea un nuevo objetivo kdlsym (resolución dinámica de símbolos del kernel) creando un nuevo encabezado en include/oni/utils/kdlsym/my_platform.h
2. Copia y pega el contenido de include/oni/utils/kdlsym/default.h en tu archivo de encabezado recién creado
3. Añade tu nuevo objetivo 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. Añade tu objetivo al archivo de configuración que se encuentra en include/oni/config.h

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

5. Cambia el objetivo de compilación actual cambiando #define ONI_PLATFORM ONI_UNKNOWN_PLATFORM por #define ONI_PLATFORM ONI_MY_PLATFORM

Desarrolladores

Si quieres contribuir, simplemente envía una pull request. De lo contrario, no hay soporte real para esto en este momento. Esto puede cambiar en el futuro

@diwidog

Diseño del mensaje