unleashed-firmware/site_scons/fbt/elfmanifest.py
SG b9a766d909 [FL-2627] Flipper applications: SDK, build and debug system (#1387)
* Added support for running applications from SD card (FAPs - Flipper Application Packages)
* Added plugin_dist target for fbt to build FAPs
* All apps of type FlipperAppType.EXTERNAL and FlipperAppType.PLUGIN are built as FAPs by default
* Updated VSCode configuration for new fbt features - re-deploy stock configuration to use them
* Added debugging support for FAPs with fbt debug & VSCode
* Added public firmware API with automated versioning

Co-authored-by: hedger <hedger@users.noreply.github.com>
Co-authored-by: SG <who.just.the.doctor@gmail.com>
Co-authored-by: あく <alleteam@gmail.com>
2022-09-15 02:21:03 +09:00

85 lines
2.1 KiB
Python

from dataclasses import dataclass
import os
import struct
from dataclasses import dataclass, field
from .appmanifest import FlipperApplication
_MANIFEST_MAGIC = 0x52474448
@dataclass
class ElfManifestBaseHeader:
manifest_version: int
api_version: int
hardware_target_id: int
manifest_magic: int = 0x52474448
def as_bytes(self):
return struct.pack(
"<IIIh",
self.manifest_magic,
self.manifest_version,
self.api_version,
self.hardware_target_id,
)
@dataclass
class ElfManifestV1:
stack_size: int
app_version: int
name: str = ""
icon: bytes = field(default=b"")
def as_bytes(self):
return struct.pack(
"<hI32s?32s",
self.stack_size,
self.app_version,
bytes(self.name.encode("ascii")),
bool(self.icon),
self.icon,
)
def assemble_manifest_data(
app_manifest: FlipperApplication,
hardware_target: int,
sdk_version,
):
image_data = b""
if app_manifest.fap_icon:
from flipper.assets.icon import file2image
image = file2image(os.path.join(app_manifest._apppath, app_manifest.fap_icon))
if (image.width, image.height) != (10, 10):
raise ValueError(
f"Flipper app icon must be 10x10 pixels, but {image.width}x{image.height} was given"
)
if len(image.data) > 32:
raise ValueError(
f"Flipper app icon must be 32 bytes or less, but {len(image.data)} bytes were given"
)
image_data = image.data
app_version_as_int = ((app_manifest.version[0] & 0xFFFF) << 16) | (
app_manifest.version[1] & 0xFFFF
)
data = ElfManifestBaseHeader(
manifest_version=1,
api_version=sdk_version,
hardware_target_id=hardware_target,
).as_bytes()
data += ElfManifestV1(
stack_size=app_manifest.stack_size,
app_version=app_version_as_int,
name=app_manifest.name,
icon=image_data,
).as_bytes()
return data