⚙️

XenoOS

Выпущено
📁 Смотреть на GitHub

Описание

Командная оболочка (CLI) для взаимодействия с различными системными компонентами, такими как файловые системы, Wi-Fi, SD-карты и другие системные настройки. Система поддерживает множество команд для управления файлами, директориями и системными конфигурациями.

Система разработана для всего семейства микроконтроллеров ESP32, но специально адаптирована для модели ESP32-C3.

Основные возможности

📁

Управление файлами

Создание, удаление, переименование файлов и директорий

🔧

Системная диагностика

Фабричный сброс, переустановка, проверка системы

📶

Управление Wi-Fi

Подключение, отключение, сканирование сетей

💾

Работа с SD-картой

Информация о карте и управление

📜

История команд

Просмотр и очистка истории введенных команд

💻

Системная информация

Память, CPU, MAC-адрес и другая информация

🌐

Сетевые инструменты

Ping, скачивание файлов (wget)

📦

Работа с архивами

Распаковка TAR архивов

Доступные команды

Команда Описание Параметры Пример использования
wget Скачивание файлов из URL <url> [<path>] wget http://example.com/file.txt /path/to/save
help Отображение справки - help
mkdir Создание директории <path> mkdir /new_directory
ls Список содержимого директории <path> ls /sys
cd Смена текущей директории <path> cd /path/to/directory
rm Удаление файлов или директорий <path> rm /path/to/file
wifi Управление Wi-Fi подключением connect, disconnect, reconnect, scan, status, ip, help wifi connect SSID password
free Показать доступную память - free
system Системные команды restart, info, update, diagnostic, freset, check, installer, help system restart
history История команд clear, read, help history clear

Системные требования

Компонент Минимальные требования
Плата ESP32-C3 (рекомендуется) или другой ESP32
Flash память 4MB
SD карта До 4GB (опционально)
Arduino IDE 2.x с ESP32 core 3.2.0+
🔄
Состояние: Выпущено
💻
Платформы: ESP32 (ESP32-C3)
👤
Автор: VL_PLAY
📱
Тип: Встроенная система
🔧
Архитектура: RISC-V (ESP32-C3)

Установка

🔧

Стандартная установка через Arduino IDE

  1. Предварительные требования: Arduino IDE 2.x, ESP32 core 3.2.0+
  2. Клонируйте репозиторий:
    git clone https://github.com/VLPLAY-Games/XenoOS.git
  3. Откройте XenoOS.ino в Arduino IDE
  4. Выберите плату ESP32-C3 Dev Module
  5. Настройте параметры в Tools:
    • USB CDC On Boot: "Enabled"
    • CPU Frequency: "160MHz (WiFi)" (default value)
    • Core Debug Level: "None" (default value)
    • Erase All Flash Before Sketch Upload: "Disabled" (default value)
    • Flash Frequency: "80MHz" (default value)
    • Flash Mode: "QIO" (default value)
    • Flash Size: "4MB (32Mb)" (default value)
    • JTAG Adapter: "Disabled" (default value)
    • Partition Scheme: "Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)"
    • Upload Speed: "921600" (default value)
    • Zigbee Mode: "Disabled" (default value)
  6. Нажмите Upload для прошивки
⚡

Альтернативная установка для ESP32-C3

  1. Скачайте последний релиз с GitHub
  2. Для прошивки объединенного файла:
    esptool.py --chip esp32c3 --baud 921600 write_flash 0x0 XenoOS.merged.bin
  3. Или прошейте файлы отдельно:
    esptool.py --chip esp32c3 --baud 921600 write_flash \
      0x1000 XenoOS.bootloader.bin \
      0x8000 XenoOS.partitions.bin \
      0x10000 XenoOS.bin

Как использовать

1

Подключитесь к устройству через Serial порт (скорость 115200) в Putty или другом терминале

2

Введите команды напрямую в терминал

3

Используйте help для просмотра всех доступных команд

4

Для диагностики системы используйте:

  • system diagnostic - запуск диагностики
  • system check - проверка системы

Технологический стек

⚙️
Фреймворк: Arduino Core for ESP32
📚
Библиотеки: buildTime, ESPping, ESP32-targz
💾
Файловая система: SPIFFS
🔌
Протокол: Serial (UART)

Устранение неполадок

Если система не запускается или работает некорректно:

  1. Убедитесь, что используется правильная версия Arduino Core (3.2.0+)
  2. Проверьте подключение Serial порта (скорость 115200)
  3. Для SD карт используйте карты объемом не более 4GB
  4. Запустите system diagnostic для проверки компонентов

Лицензия

Этот проект лицензирован под MIT License - подробности в файле LICENSE.

❤️ Поддержать разработку