Firmware images and the PLF container
Three official Parrot update images were downloaded from the Parrot Bebop range support page and unpacked read-only. This page records what the files contain. The Skycontroller image is the NG model’s by its own library’s decoding of its model id (0x0913), and is not the Skycontroller 2’s firmware. The narrative is at /story/firmware-adventure/.
| Status | Meaning |
|---|---|
| Verified | The value was read from the file or bytes named in the Source column. |
| Agent-cited | The value was taken from a note and not re-checked. |
| Open | The value is unknown or the role has not been established. |
Paths in Source columns are relative to the extraction root of the image (rootfs/, partitions/, metadata.json, sections.json, manifest.json) unless a .plf file is named.
Image inventory
Section titled “Image inventory”| Image | File name | Size (bytes) | Status |
|---|---|---|---|
| Bebop 1 | bebop-1_v4.0.6.plf |
19034024 | Verified |
| Bebop 2 family | bebop-2-family_v4.7.1.plf |
25278808 | Verified |
| Skycontroller | skycontroller_nap_update.plf |
28997204 | Verified |
| Image | SHA-256 | Status |
|---|---|---|
| Bebop 1 | 705e4cf368f7ae5328b5b7e54e60e501f1a1683fb7c1fda0e703f173f53ffd2f |
Verified |
| Bebop 2 family | 6fe03e1ec402eedef61b4c5e0426aaa71bf50526103d73af29fa66ba28ab7f30 |
Verified |
| Skycontroller | dbba796e4fad830bacc43ee0650faf51f477fa197b45cef871bfb562b204fc83 |
Verified |
The hashes match firmware/README.md and sha256sum of the three files.
Header fields per image
Section titled “Header fields per image”Source for every cell: metadata.json, cross-checked by unpacking the first 56 bytes of each .plf.
| Field | Bebop 1 | Bebop 2 family | Skycontroller | Status |
|---|---|---|---|---|
| header_version | 13 | 13 | 13 | Verified |
| header_length | 56 | 56 | 56 | Verified |
| entry_header_length | 20 | 20 | 20 | Verified |
| file_type | 2 | 2 | 2 | Verified |
| entry_point | 0x00000000 | 0x00000000 | 0x00000000 | Verified |
| target_platform | 6 | 6 | 6 | Verified |
| target_application | 104 (0x68) | 121 (0x79) | 103 (0x67) | Verified |
| hardware_compatibility | 2955444605 (0xb028817d) | 2241106895 (0x859493cf) | 183847359 (0x0af549bf) | Verified |
| version (major.minor.bugfix) | 4.0.6 | 4.7.1 | 2.0.0 | Verified |
| language_zone | 0 | 0 | 3354706 | Verified |
| declared file length | 19034024 | 25278808 | 28997204 | Verified |
| section count | 1183 | 1313 | 1211 | Verified |
| filesystem entry count | 1181 | 1309 | 1209 | Verified |
Declared file length equals the actual file size for all three images.
Build properties per image
Section titled “Build properties per image”Source: rootfs/etc/build.prop.
| Field | Bebop 1 | Bebop 2 family | Skycontroller | Status |
|---|---|---|---|---|
| ro.parrot.build.group | drones | drones | drones | Verified |
| ro.parrot.build.project | ardrone3 | ardrone3 | nap | Verified |
| ro.parrot.build.product | ardrone3 | ardrone3 | nap | Verified |
| ro.parrot.build.variant | mykonos3 | milos | linux | Verified |
| ro.parrot.build.region | (empty) | (empty) | (empty) | Verified |
| ro.parrot.build.uid | ardrone3-mykonos3-4.0.6 | ardrone3-milos-4.7.1 | nap-linux-2.0.0-rc3 | Verified |
| ro.parrot.build.version | 4.0.6 | 4.7.1 | 2.0.0-rc3 | Verified |
| ro.build.date | Wed May 3 11:17:52 CEST 2017 | Wed Jun 6 11:54:38 UTC 2018 | Wed Aug 9 11:09:49 CEST 2017 | Verified |
The Skycontroller header version is 2.0.0 and its build.prop version is 2.0.0-rc3.
Section and entry counts by type
Section titled “Section and entry counts by type”Source: sections.json, counted by type and entry_kind.
| Section type | Bebop 1 | Bebop 2 family | Skycontroller | Status |
|---|---|---|---|---|
| 9 (filesystem entry), file | 694 | 799 | 672 | Verified |
| 9 (filesystem entry), symlink | 369 | 388 | 429 | Verified |
| 9 (filesystem entry), directory | 118 | 122 | 108 | Verified |
| 11 | 1 | 1 | 1 | Verified |
| 3 | 1 | 1 | 1 | Verified |
| 12 | 0 | 1 | 0 | Verified |
| 7 | 0 | 1 | 0 | Verified |
| 4 and 5 | 0 | 0 | 0 | Verified |
PLF header layout
Section titled “PLF header layout”Little-endian. Struct format <4s13I, 56 bytes. Source: tools/third_party/extract_plf.py, line HEADER = struct.Struct("<4s13I").
| Offset | Size | Field | Status |
|---|---|---|---|
| 0 | 4 | magic, ASCII PLF! |
Verified |
| 4 | 4 | header_version | Verified |
| 8 | 4 | header_length (first section starts here) | Verified |
| 12 | 4 | entry_header_length (extractor requires 20) | Verified |
| 16 | 4 | file_type | Verified |
| 20 | 4 | entry_point | Verified |
| 24 | 4 | target_platform | Verified |
| 28 | 4 | target_application | Verified |
| 32 | 4 | hardware_compatibility | Verified |
| 36 | 4 | version_major | Verified |
| 40 | 4 | version_minor | Verified |
| 44 | 4 | version_bugfix | Verified |
| 48 | 4 | language_zone | Verified |
| 52 | 4 | declared file length | Verified |
| Open item | Status |
|---|---|
| Meaning of the numeric values of target_platform, target_application and file_type | Open |
| How hardware_compatibility is computed or compared by the updater | Open |
| Meaning of language_zone when nonzero | Open |
Section layout
Section titled “Section layout”Little-endian. Struct format <5I, 20 bytes, followed by length bytes of stored data. The next section begins at the end of the data rounded up to a multiple of 4. Reading stops at the declared file length. Source: extract_plf.py, SECTION = struct.Struct("<5I") and the main loop.
| Offset | Size | Field | Notes | Status |
|---|---|---|---|---|
| 0 | 4 | type | Selects how the extractor handles the section | Verified |
| 4 | 4 | length | Stored data length in bytes | Verified |
| 8 | 4 | crc32 | See note below | Verified |
| 12 | 4 | load_address | Recorded in sections.json, not otherwise used |
Verified |
| 16 | 4 | uncompressed_size | Nonzero means the stored data is gzip and the extractor checks the decompressed length against this value | Verified |
In all 3707 sections across the three images the header crc32 differs from zlib.crc32 of the stored bytes (the header_crc32 and stored_crc32 fields in sections.json). The algorithm behind the header value is Open. Compressed sections (uncompressed_size nonzero) are all type 9: 578 in Bebop 1, 655 in Bebop 2 family, 614 in the Skycontroller. Types 3, 7, 11 and 12 are stored uncompressed.
Section types as the extractor handles them
Section titled “Section types as the extractor handles them”| Type | Extractor action | Status |
|---|---|---|
| 4 | Payload is a NUL-terminated name then file content; written under data/ |
Verified |
| 5 | Payload name creates a directory under data/ |
Verified |
| 9 | Payload is a NUL-terminated name, then 4 bytes of little-endian mode, then 8 bytes the extractor skips, then content; written under rootfs/ as file, directory or symlink by the mode type bits |
Verified |
| 11 | Skipped, no file written | Verified |
| any other | Payload written to partitions/section-NNNNN-type-T.bin |
Verified |
| Meaning of type 11 (600 bytes in Bebop 1 and Bebop 2, 840 bytes in the Skycontroller) | Open | |
| Meaning of the 8 skipped bytes in a type 9 payload | Open |
Names are rejected if they contain ... Symlink content is the target string up to the first NUL.
Extractor output layout
Section titled “Extractor output layout”Command shape: extract_plf.py <plf> <output directory>. The extractor rebuilds rootfs, data and partitions on each run and writes three JSON files.
| Path under output directory | Content | Status |
|---|---|---|
rootfs/ |
Type 9 entries: files, directories and symlinks with recorded modes | Verified |
data/ |
Type 4 and 5 entries; empty in all three images | Verified |
partitions/ |
One .bin per section that is not type 4, 5, 9 or 11, named section-NNNNN-type-T.bin (section number, type) |
Verified |
metadata.json |
Source path, source SHA-256, actual and declared length, all header fields, section count, filesystem entry count; entry_point and load addresses are hex strings, version is major.minor.bugfix |
Verified |
sections.json |
One row per section: number, type, offset, stored_size, uncompressed_size, compressed, header_crc32, stored_crc32, load_address, and path or entry_kind where applicable | Verified |
manifest.json |
One row per type 9 entry: path, kind, mode, size, sha256 (files only, otherwise null), section number | Verified |
Bebop 2 family 4.7.1 extraction notes
Section titled “Bebop 2 family 4.7.1 extraction notes”Section order
Section titled “Section order”Source: sections.json.
| Section | Type | Stored size (bytes) | Output | Status |
|---|---|---|---|---|
| 1 | 11 | 600 | none | Verified |
| 2 | 12 | 4546428 | partitions/section-00002-type-12.bin |
Verified |
| 3 | 7 | 46000 | partitions/section-00003-type-7.bin |
Verified |
| 4 | 3 | 3661552 | partitions/section-00004-type-3.bin |
Verified |
| 5 to 1313 | 9 | varies | rootfs/ |
Verified |
Empty directories in rootfs
Section titled “Empty directories in rootfs”Each of the following exists as a mode 040755 directory entry and contains nothing after extraction.
| Directory | Status |
|---|---|
rootfs/data |
Verified |
rootfs/factory |
Verified |
rootfs/update |
Verified |
rootfs/boot |
Verified |
rootfs/tmp |
Verified |
rootfs/calib is not empty; it holds calibration and lookup-table files.
The three raw partition blobs
Section titled “The three raw partition blobs”Two of the blobs begin with the PLF magic and carry their own 56-byte header and 20-byte section headers in the same layout as the outer file. The third does not.
| Blob | Size | SHA-256 | Leading bytes | Status |
|---|---|---|---|---|
partitions/section-00002-type-12.bin |
4546428 | f06c9a0ebab7a5cbf3762126b62416ef842889d97dea9b692c72e5c432ed892a |
PLF! |
Verified |
partitions/section-00003-type-7.bin |
46000 | 09160e61d021cdaed047f36c212eaa7c6c213e5a3fbe7da61dac826c5f31e900 |
18f09fe5 pattern |
Verified |
partitions/section-00004-type-3.bin |
3661552 | f741b934e761e56660fa4a3fcb5035e753de33eeefe11f3d3404e4477b36b052 |
PLF! |
Verified |
Inner PLF headers, same field order as the outer header:
| Field | type-12 blob | type-3 blob | Status |
|---|---|---|---|
| header_version | 13 | 13 | Verified |
| header_length | 56 | 56 | Verified |
| entry_header_length | 20 | 20 | Verified |
| file_type | 1 | 1 | Verified |
| entry_point | 0x821e8430 | 0x82000000 | Verified |
| target_platform | 6 | 6 | Verified |
| target_application | 121 | 121 | Verified |
| hardware_compatibility | 96126509 (0x05bac62d) | 2123291353 | Verified |
| version | 5.9.63 | 0.0.0 | Verified |
| language_zone | 0 | 0 | Verified |
| declared length | 4546428 | 3661552 | Verified |
The inner declared length equals the blob size in both cases. The type-3 inner file_type is 1 and the entry_point value is the same one the type-3 blobs of the other two images carry in their inner headers.
Inner sections, read with the 20-byte layout (type, length, load address):
| Blob | Inner section | Type | Length | Load address | Status |
|---|---|---|---|---|---|
| type-12 | 1 | 0 | 2546256 | 0x821e8430 | Verified |
| type-12 | 2 | 3 | 1999919 | 0x82000000 | Verified |
| type-12 | 3 | 7 | 133 | 0x80700000 | Verified |
| type-3 | 1 | 0 | 3661248 | 0x82000000 | Verified |
| type-3 | 2 | 7 | 208 | 0x80700000 | Verified |
The type-12 inner section 2 begins with the gzip magic 1f8b0800. The type-7 inner sections begin with the ASCII text mtdparts=nand0:8. The type-3 inner section 1 begins with the ARM instruction bytes 0000a0e1 repeated (a no-op pattern). The inner type-0 sections of both PLF blobs and the type-12 inner section 2 hold gzip streams, decompressed for the table below.
The type-7 blob has no PLF header. It starts with a block of the 4-byte pattern 18f09fe5 (ARM load-pc) and contains the string ecos-bootloader-p7-start-343-gb32f66c and a list of DRAM configuration names.
Kernels inside the PLF blobs
Section titled “Kernels inside the PLF blobs”A gzip stream starts at offset 0x5ae8 of the inner type-0 section in both blobs. Each decompresses to an ARM Linux kernel. The type-12 inner section 2 also decompresses (3,928,576 bytes) but is not a kernel: it has no version string and holds a table of Parrot machine names and a device-tree model path.
| Blob | Inner section | Decompressed size | Version string in the decompressed kernel | Status |
|---|---|---|---|---|
section-00004-type-3.bin |
1 | 7,235,156 bytes | Linux version 3.4.11+ … #1 SMP PREEMPT Wed Jun 6 12:02:19 UTC 2018 |
Verified |
section-00002-type-12.bin |
1 | 4,909,700 bytes | Linux version 3.4.11+ … #1 SMP PREEMPT Tue Dec 1 10:23:38 CET 2015 |
Verified |
The build date of the type-3 kernel matches the image’s ro.build.date (Wed Jun 6 11:54:38 UTC 2018) and the kernel line (3.4.11+, built 2018-06-06) that the log of one Bebop 2 unit reports (Confirmed independently, from another session’s reading of that log). Both kernels contain the machine names “Mykonos3 board” and “Milos board” (Verified). The type-12 kernel also contains Evinrude board messages (Verified). The role of each blob remains Open.
| Role of each blob | Status |
|---|---|
| What the type-12 blob is flashed to or used for | Open |
| What the type-3 blob is flashed to or used for | Open |
| What the type-7 blob is flashed to or used for | Open |
| Whether the outer section type numbers 3, 7, 11 and 12 correspond to a named partition | Open |
Family content in the configuration folders
Section titled “Family content in the configuration folders”Source: rootfs/etc/colibry/ and rootfs/etc/boxinit.standalone.*.rc, rootfs/etc/default.*.prop.
| Item | Value | Status |
|---|---|---|
Directories under etc/colibry/ |
chimeraboard, common, milosblack, milosboard, milosthermal, mykonos3board |
Verified |
Boards with a full set of 12 entries (controller.cfg, default, drone.cfg, estimator.cfg, event.cfg, fvt, helper.cfg, reference.cfg, root.cfg, simulator, states.cfg, video.cfg) |
chimeraboard, milosboard, mykonos3board |
Verified |
| Board-specific boxinit files | boxinit.standalone.milosboard.rc, boxinit.standalone.mykonos3board.rc |
Verified |
| Board-specific default property files | default.milosboard.prop, default.mykonos3board.prop |
Verified |
| ro.parrot.build.variant of this image | milos |
Verified |
The mykonos3board folder is also the variant name of the Bebop 1 4.0.6 image. Contents of the folders are described at /reference/colibry-config/, and the service files at /reference/boxinit-services/.
Comments
Spotted a mistake, or tried this on your own Bebop? Leave a note. Comments are kept on this site's own server.