1. User manual

Contents:

• 1.1. Introduction
  • 1.1.1. Community
  • 1.1.2. Patch workflow
• 1.2. barebox
  • 1.2.1. Getting barebox
  • 1.2.2. Configuration
  • 1.2.3. Compilation
  • 1.2.4. Starting barebox
  • 1.2.5. First Steps
  • 1.2.6. Building barebox tools
• 1.3. Networking
  • 1.3.1. Network configuration
  • 1.3.2. Network filesystems
  • 1.3.3. Network console
  • 1.3.4. Fastboot over UDP
  • 1.3.5. DSA (Distributed Switch Architecture) Support in Barebox
• 1.4. Automount
• 1.5. Memory areas
  • 1.5.1. Examples
• 1.6. Driver model
  • 1.6.1. Device detection
  • 1.6.2. Device parameters
• 1.7. Variables
  • 1.7.1. The global device
  • 1.7.2. Non volatile variables
  • 1.7.3. Non volatile device variables
• 1.8. Magic variables
  • 1.8.1. No prefix
  • 1.8.2. efi.*
  • 1.8.3. global.*
  • 1.8.4. arm-specific variables
  • 1.8.5. kvx-specific variables
  • 1.8.6. riscv-specific variables
  • 1.8.7. Board-specific variables
• 1.9. Hush shell
  • 1.9.1. Hush features
• 1.10. Default environment version 2
  • 1.10.1. /env/bin/init
  • 1.10.2. /env/init/
  • 1.10.3. /env/boot/
  • 1.10.4. /env/config
  • 1.10.5. /env/network/
  • 1.10.6. /env/bmode/
• 1.11. Updating barebox
  • 1.11.1. Repairing existing boot images
• 1.12. Image MetaData (IMD)
  • 1.12.1. Limitations
  • 1.12.2. IMD and barebox_update
• 1.13. Devicetree support
  • 1.13.1. The internal devicetree
  • 1.13.2. Devicetree commands
  • 1.13.3. Device tree overlays
• 1.14. PreBootLoader images (PBL)
  • 1.14.1. Technical background
• 1.15. Multi Image Support
  • 1.15.1. Technical background
• 1.16. Framebuffer support
  • 1.16.1. Framebuffer splash screen
  • 1.16.2. Framebuffer console
• 1.17. USB support
  • 1.17.1. USB host support
  • 1.17.2. USB device support
  • 1.17.3. USB OTG support
  • 1.17.4. USB Type-C support
  • 1.17.5. USB Gadget autostart Support
• 1.18. UBI/UBIFS support
  • 1.18.1. UBI Fastmap
• 1.19. Booting Linux
  • 1.19.1. Introduction
  • 1.19.2. The bootm command
  • 1.19.3. The boot command
  • 1.19.4. Network boot
• 1.20. Devboot
  • 1.20.1. Boot overrides
  • 1.20.2. The devboot script
• 1.21. Barebox Bootchooser
  • 1.21.1. Bootchooser Targets
  • 1.21.2. The Bootchooser Algorithm
  • 1.21.3. General Bootchooser Options
  • 1.21.4. Setup Example
  • 1.21.5. Scenarios
  • 1.21.6. Using the State Framework as Backend for Run-Time Variable Data
  • 1.21.7. Using NV Run-Time Variable Data
  • 1.21.8. Updating systems
• 1.22. barebox remote control
  • 1.22.1. Enabling remote control support
  • 1.22.2. Running the bbremote tool
  • 1.22.3. running commands on the target
  • 1.22.4. ping
  • 1.22.5. getenv
  • 1.22.6. interactive console
  • 1.22.7. transferring files
• 1.23. Security Considerations
  • 1.23.1. Verified Boot
  • 1.23.2. Ensuring barebox is verified
  • 1.23.3. Loading firmware
  • 1.23.4. Ensuring the kernel is verified
  • 1.23.5. Prevent the kernel from booting the rootfs in verity boots
  • 1.23.6. Configuring barebox
  • 1.23.7. Security Policy
• 1.24. Security Policies (User Manual)
  • 1.24.1. Overview
  • 1.24.2. Concepts
  • 1.24.3. Usage
  • 1.24.4. Limitations
  • 1.24.5. Trying it out
  • 1.24.6. Differences from Kconfig
  • 1.24.7. Best Practices
• 1.25. Reset Reason
• 1.26. System Restart
• 1.27. Barebox State Framework
  • 1.27.1. Backends (e.g. Supported Memory Types)
  • 1.27.2. Backend-Types (e.g. state Storage Format)
  • 1.27.3. Backend Storage Types (e.g. Media Storage Layout)
  • 1.27.4. Redundant state Variable Set Copies
  • 1.27.5. Handling of Bad Blocks
  • 1.27.6. Examples
  • 1.27.7. Frontend
• 1.28. barebox Artifact Versioning
  • 1.28.1. Query from barebox
  • 1.28.2. Query from OS
  • 1.28.3. Query without booting
• 1.29. Random Number Generator support
  • 1.29.1. API
  • 1.29.2. User interface
• 1.30. OP-TEE
  • 1.30.1. Loading OP-TEE
  • 1.30.2. Communication with OP-TEE
• 1.31. Debugging with OpenOCD
• 1.32. Watchdog Support
  • 1.32.1. Barebox Watchdog Functionality
• 1.33. Reboot Mode
  • 1.33.1. User API
  • 1.33.2. Reset
  • 1.33.3. Disambiguation
• 1.34. VirtIO Support
  • 1.34.1. What’s VirtIO?
  • 1.34.2. Status
  • 1.34.3. Build Instructions
  • 1.34.4. Testing
• 1.35. barebox TLV - Non-Volatile Factory Data Storage
  • 1.35.1. Data Format
  • 1.35.2. Tags
  • 1.35.3. Signature
  • 1.35.4. Data Types
  • 1.35.5. TLV Binary Generation
• 1.36. Appendix: Development Host Setup
  • 1.36.1. Serial Console Access
  • 1.36.2. Network Access

• Search Page

• Index