https://github.com/tklauser/mkubootenv

U-Boot environment image creator
https://github.com/tklauser/mkubootenv

Last synced: 16 days ago
JSON representation

U-Boot environment image creator

• Host: GitHub
• URL: https://github.com/tklauser/mkubootenv
• Owner: tklauser
• Created: 2013-01-09T09:22:14.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2013-02-06T12:03:42.000Z (almost 12 years ago)
• Last Synced: 2023-03-11T17:28:57.428Z (over 1 year ago)
• Language: C
• Size: 133 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

README

        
mkubootenv

==========

Create an U-Boot environmet image suitable for flashing. The input is a text

file containing environment variable definitions in the format “name=value”,

separeated by newlines.

The output) is stored as a list of "name=value" strings, where each of the the

strings is terminated by a NULL byte ('\0'). The end of the list is marked by a

double NULL byte.

The environment is preceeded by a 32 bit CRC over the list of strings.

Usage

-----

usage: mkubootenv [-s ]  

Options:

  -s   set size of the target image file to  bytes. If  is

             bigger than the source file, the target image gets padded with

	     null bytes. If  is smaller than the source file, an error is

	     emitted.

  -r         reverse operation: get plaintext env file (target) from binary

             image file (source)

File formats

------------

The U-Boot environment is stored in a simple file format, described in

include/environment.h of the U-Boot source tree as follows:

/**************************************************************************

 *

 * The "environment" is stored as a list of '\0' terminated

 * "name=value" strings. The end of the list is marked by a double

 * '\0'. New entries are always added at the end. Deleting an entry

 * shifts the remaining entries to the front. Replacing an entry is a

 * combination of deleting the old value and adding the new one.

 *

 * The environment is preceeded by a 32 bit CRC over the data part.

 *

 **************************************************************************

 */

The input file format for mkubootenv is a simple text file containing

'name=value' pairs, separated by newlines ('\n'). This means, there are _no

newlines allowed_ inside the variable names or values.

See the example/ directory for an example input file (uboot_env.env) and its

corresponding output file (uboot_env.bin).