Skip to content

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 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.

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.

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.

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

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

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.

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

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

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.

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.

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.