Update README.md #1

Merged
wt merged 1 commits from develop into main 2026-03-13 22:42:07 +00:00
+94 -73
View File
@@ -1,112 +1,133 @@
# Bootloader Update Manager # Bootloader Update Manager
A C-based web application for updating kernel, device-tree, and U-Boot environment files on Orange Pi Zero 2W. Веб-приложение на C для обновления ядра, device-tree и U-Boot environment на Orange Pi Zero 2W.
## Features ## Возможности
- **Web Interface**: Modern, responsive UI for easy file management - **Веб-интерфейс**: Современный адаптивный UI для удобного управления
- **Kernel Update**: Upload `Image.gz` to boot partition - **Обновление ядра**: Загрузка `Image.gz` в boot раздел
- **Device-Tree Update**: Upload `sun50i-h618-orangepi-zero2w.dtb` - **Обновление Device-Tree**: Загрузка `sun50i-h618-orangepi-zero2w.dtb`
- **U-Boot Environment**: Upload `uboot.env` - **U-Boot Environment**: Загрузка `uboot.env`
- **extlinux.conf Editor**: View and edit boot configuration - **Редактор extlinux.conf**: Просмотр и редактирование конфигурации загрузчика
- **Progress Bar**: Real-time upload progress tracking - **Индикатор прогресса**: Отображение прогресса загрузки в реальном времени
- **Auto-mount**: Automatically mounts `/dev/mmcblk1p1` to `/media` - **Авто-монтирование**: Автоматически монтирует `/dev/mmcblk1p1` в `/media`
- **Large File Support**: Upload files up to 200MB - **Поддержка больших файлов**: Загрузка файлов до 200 MB
- **Перезагрузка системы**: Кнопка безопасной перезагрузки с корректным отмонтированием
## Requirements ## Структура проекта
- GCC compiler ```
- [Mongoose](https://mongoose.ws) - Embedded web server .
- [cJSON](https://github.com/DaveGamble/cJSON) - JSON parser ├── main.c # Основной сервер (C + mongoose + cJSON)
- Root privileges (for mounting devices) ├── index.html # HTML веб-интерфейса
├── style.css # Стили веб-интерфейса
### Installing Dependencies ├── app.js # Frontend JavaScript
├── Makefile # Конфигурация сборки
**Ubuntu/Debian:** ├── README.md # Документация
```bash ├── mongoose.h # Mongoose web server (v7.19)
# Install mongoose (or build from source) ├── mongoose.c # Mongoose web server (v7.19)
sudo apt-get install libmongoose-dev ├── cJSON.h # JSON parser (v1.7.18)
├── cJSON.c # JSON parser (v1.7.18)
# Install cJSON └── mongoose_config.h # Конфигурация mongoose
sudo apt-get install libcjson-dev
``` ```
**Build from source:** ## Требования
```bash
# Mongoose
git clone https://github.com/cesanta/mongoose.git
cd mongoose && make && sudo make install
# cJSON - GCC компилятор
git clone https://github.com/DaveGamble/cJSON.git - Библиотеки встроены в проект:
cd cJSON && mkdir build && cd build && cmake .. && make && sudo make install - [Mongoose](https://mongoose.ws) v7.19 - встроенный веб-сервер
``` - [cJSON](https://github.com/DaveGamble/cJSON) v1.7.18 - JSON парсер
- Права root (для монтирования устройств и перезагрузки)
## Building ## Сборка
```bash ```bash
make make
``` ```
## Running ## Запуск
```bash ```bash
sudo make run
# or
sudo ./up sudo ./up
``` ```
The server will start on **http://localhost:8080** Сервер запустится на **http://localhost:43243**
## Веб-интерфейс
### System Status
- Статус монтирования `/dev/mmcblk1p1` → `/media`
- Информация о устройстве
### File Upload
Три вкладки для загрузки:
- **Kernel** → `/media/Image.gz`
- **Device-Tree** → `/media/sun50i-h618-orangepi-zero2w.dtb`
- **U-Boot Environment** → `/media/uboot.env`
### extlinux.conf Editor
- Загрузка текущего `extlinux.conf`
- Редактирование в текстовом поле
- Сохранение изменений
### System Control
- Кнопка **Reboot System** с подтверждением
- Безопасная перезагрузка:
- `sync()` - сброс буферов ФС
- `umount /media` - отмонтирование
- `shutdown -r now` - мягкая перезагрузка через finit
## API Endpoints ## API Endpoints
| Endpoint | Method | Description | | Endpoint | Method | Описание |
|----------|--------|-------------| |----------|--------|----------|
| `/api/upload` | POST | Upload files (kernel, dtb, uboot) | | `/api/upload` | POST | Загрузка файлов (kernel, dtb, uboot) |
| `/api/extlinux` | GET | Read extlinux.conf | | `/api/extlinux` | GET | Чтение extlinux.conf |
| `/api/extlinux` | POST | Write extlinux.conf | | `/api/extlinux` | POST | Запись extlinux.conf |
| `/api/progress` | GET | Get upload progress | | `/api/progress` | GET | Статус загрузки |
| `/api/mount` | GET | Get mount status | | `/api/mount` | GET | Статус монтирования |
| `/api/reboot` | POST | Перезагрузка системы |
## Upload Parameters ## Параметры загрузки
For `/api/upload`: Для `/api/upload` (multipart/form-data):
- `type`: File type (`kernel`, `dtb`, or `uboot`) - `type`: Тип файла (`kernel`, `dtb`, `uboot`)
- `file`: The file to upload - `file`: Загружаемый файл
## File Locations ## Расположение файлов
| Type | Destination File | | Тип | Файл назначения |
|------|------------------| |-----|-----------------|
| Kernel | `/media/Image.gz` | | Ядро | `/media/Image.gz` |
| Device-Tree | `/media/sun50i-h618-orangepi-zero2w.dtb` | | Device-Tree | `/media/sun50i-h618-orangepi-zero2w.dtb` |
| U-Boot Env | `/media/uboot.env` | | U-Boot Env | `/media/uboot.env` |
| Extlinux | `/media/extlinux.conf` | | Extlinux | `/media/extlinux/extlinux.conf` |
## Project Structure ## Конфигурация
``` ### mongoose_config.h
. ```c
├── main.c # Main application (C server) #define MG_MAX_RECV_SIZE (256 * 1024 * 1024) // 256 MB лимит запроса
├── index.html # Web interface HTML #define MG_IO_SIZE 131072 // 128 KB буфер
├── style.css # Web interface styles
├── app.js # Frontend JavaScript
├── Makefile # Build configuration
└── README.md # This file
``` ```
## Screenshots ### Ограничения
- Максимальный размер файла: **200 MB**
- Порт сервера: **43243**
The web interface includes: ## Безопасность
- System status panel showing mount state
- Tabbed upload interface for different file types
- Real-time progress bar during uploads
- Full-featured text editor for extlinux.conf
## Security Notes ⚠️ **Предупреждение**:
- Приложение требует права **root** для монтирования и перезагрузки
- Используйте с осторожностью в production окружении
- Рекомендуется ограничить доступ к веб-интерфейсу
⚠️ **Warning**: This application requires root privileges to mount devices. Use with caution and ensure proper access controls in production environments. ## Зависимости
## License Все зависимости встроены в проект:
- `mongoose.c/h` - веб-сервер (из репозитория Cesanta)
- `cJSON.c/h` - JSON парсер (из репозитория DaveGamble)
## Лицензия
MIT License MIT License