secubox/secubox-deb
1
0
Fork 0
mirror of https://github.com/CyberMind-FR/secubox-deb.git synced 2026-07-29 13:59:40 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

docs: Add USB boot scripts documentation for ESPRESSObin

Browse Source 
- Updated board/espressobin-v7/README.md with boot scripts section
- Added "U-Boot Boot Scripts" section to wiki/ESPRESSObin.md
- Documented boot-usb.scr, flash-emmc.scr usage

Simplifies ESPRESSObin installation with automated scripts.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
CyberMind-FR 2026-04-10 11:36:54 +02:00
parent 9f4eae6058
commit e4f65d21b1
2 changed files with 106 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
board/espressobin-v7/README.md
View File

@ -113,6 +113,48 @@ Or set eMMC as default boot:
=> reset
```
## USB Boot Scripts (Recommended)
Pre-compiled U-Boot scripts simplify the boot process:
| Script | Purpose |
|--------|---------|
| `boot-usb.scr` | Boot live system from USB |
| `flash-emmc.scr` | Flash image to eMMC |
| `boot.scr` | Boot from eMMC (post-install) |
### Prepare USB Drive (FAT32)
```bash
# Format USB as FAT32
mkfs.vfat -F 32 /dev/sdX1
# Mount and copy files
mount /dev/sdX1 /mnt
cp output/secubox-espressobin-v7-bookworm.img.gz /mnt/
cp board/espressobin-v7/boot-usb.scr /mnt/boot.scr
cp board/espressobin-v7/flash-emmc.scr /mnt/
umount /mnt
```
### Boot from USB (Live)
```
Marvell>> usb start
Marvell>> load usb 0:1 $loadaddr boot.scr
Marvell>> source $loadaddr
```
### Flash to eMMC
```
Marvell>> usb start
Marvell>> load usb 0:1 $loadaddr flash-emmc.scr
Marvell>> source $loadaddr
# Follow prompts, then:
Marvell>> reset
```
## Alternative: Flash from SD Card
If using SD card instead of USB:

65
wiki/ESPRESSObin.md
View File

@ -114,7 +114,70 @@ The 5-position DIP switch controls boot source and CPU speed.
**For normal SecuBox operation:** All switches OFF (boot from SPI NOR which loads U-Boot → then boot from eMMC/SD)
## U-Boot Flash Procedure
## U-Boot Boot Scripts (Easiest Method)
Pre-compiled U-Boot scripts automate the boot and flash process.
### Available Scripts
| Script | Purpose | Description |
|--------|---------|-------------|
| `boot-usb.scr` | Live USB boot | Boot system directly from USB |
| `flash-emmc.scr` | Flash to eMMC | Write image to internal storage |
| `boot.scr` | eMMC boot | Normal boot after installation |
### Prepare USB Drive
```bash
# Download scripts and image
wget https://github.com/CyberMind-FR/secubox-deb/releases/latest/download/secubox-espressobin-v7-bookworm.img.gz
wget https://raw.githubusercontent.com/CyberMind-FR/secubox-deb/master/board/espressobin-v7/boot-usb.scr
wget https://raw.githubusercontent.com/CyberMind-FR/secubox-deb/master/board/espressobin-v7/flash-emmc.scr
# Format USB as FAT32
sudo mkfs.vfat -F 32 /dev/sdb1
# Copy files
sudo mount /dev/sdb1 /mnt
sudo cp secubox-espressobin-v7-bookworm.img.gz /mnt/
sudo cp boot-usb.scr /mnt/boot.scr
sudo cp flash-emmc.scr /mnt/
sudo umount /mnt
```
### Live USB Boot (No Installation)
Boot directly from USB to test SecuBox:
```
Marvell>> usb start
Marvell>> load usb 0:1 $loadaddr boot.scr
Marvell>> source $loadaddr
```
The system boots from USB. Data is not persistent.
### Install to eMMC
Flash SecuBox to internal eMMC storage:
```
Marvell>> usb start
Marvell>> load usb 0:1 $loadaddr flash-emmc.scr
Marvell>> source $loadaddr
```
Follow the prompts, wait for flash to complete (~3 min), then:
```
Marvell>> reset
```
Remove USB drive. SecuBox will boot from eMMC.
---
## U-Boot Manual Flash Procedure
### Method 1: USB Drive with gzwrite (Recommended)