Update README.md #1
@@ -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
|
||||||
Reference in new issue
Block a user