# FirmwareDroid Meta-Data

This dataset contains official Android firmware samples from freely available internet resource. The firmware samples are grouped by Android version (0 = Unknown, 4 to 11 = Android main version). Within this folder you will find the file "Android_firmware.json", which contains some meta-data for each firmware sample in json format. The file contains a json array with a unique entry for every sample in the dataset. Every sample in the dataset is named by its md5 hash.


## Meta-Data
Android_firmware.json field description:
_id: Unique mongodb object-id
- original_filename: Name of the original archive before processing it with FirmwareDroid
- filename: Name of the file within the dataset. The name is based on an md5 hash of the file and the compression file extension.
- md5: Checksum of the firmware archive.
- sha256: Checksum of the firmware archive.
- sha1: Checksum of the firmware archive.
- version_detected: Detected Android version based on "ro.build.version.release" taken from a build property. In case FirmwareDroid was not able to detect a build.prop file then the value is set to 0.
- file_size_bytes: Size of the archive on disk.
- os_vendor: Label of the original operating system vendor.
  - Google: https://developers.google.com/android/images
  - Carbon: https://carbonrom.org/
  - LineageOS: https://lineageos.org/
  - GrapheneOS: https://grapheneos.org/
  - Resurrection: https://resurrectionremix.com/
  - OmniROM: https://omnirom.org/
  - Unknown: Note that the dataset contains three samples labeled as "Unknown". These samples have been used just for testing and are not part of the research study.


## Disclaimer
The distributed data is for research purposes only.