{"id":18519289,"url":"https://github.com/linux-surface/aarch64-firmware","last_synced_at":"2025-04-22T22:19:11.424Z","repository":{"id":108145862,"uuid":"496843613","full_name":"linux-surface/aarch64-firmware","owner":"linux-surface","description":"Firmware files for Surface Pro X","archived":false,"fork":false,"pushed_at":"2022-07-24T23:02:53.000Z","size":68569,"stargazers_count":4,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-22T22:18:56.605Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linux-surface.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-27T03:02:06.000Z","updated_at":"2024-01-18T16:25:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"eaad8295-e2ab-4135-96e5-30b3f11a8298","html_url":"https://github.com/linux-surface/aarch64-firmware","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linux-surface%2Faarch64-firmware","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linux-surface%2Faarch64-firmware/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linux-surface%2Faarch64-firmware/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linux-surface%2Faarch64-firmware/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linux-surface","download_url":"https://codeload.github.com/linux-surface/aarch64-firmware/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250331816,"owners_count":21413104,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T17:15:56.676Z","updated_at":"2025-04-22T22:19:11.236Z","avatar_url":"https://github.com/linux-surface.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Firmware for AArch64 Surface Devices\n\nFirmware and firmware-related helpers for AArch64 based Microsoft Surface devices.\nCurrently, supports the Surface Pro X SQ1 and SQ2.\n\n\n## Obtaining Firmware\n\nTo obtain a full firmware package yourself, you need access to either a (full) Windows (recovery) image or a Windows installation.\nRecovery images can be obtained from https://support.microsoft.com/en-us/surface-recovery-image.\nThe full firmware package can then be obtained via `./scripts/getfw.py`.\nIn particular, run\n```sh\n./scripts/getfw.py -w \u003cpath-to-windows-root\u003e\n```\nwhere `\u003cpath-to-windows-root\u003e` is the path to the extracted Windows recovery image or your Windows installation (i.e. C:\\\\ drive).\nIn case your Windows installation is encrypted with BitLocker, you will need to run this script from inside WSL.\nBy default, the final firmware tree is provided in `./out`.\nSee `./scripts/getfw.py --help` for more information.\n\nNote: This repository contains submodules, so make sure you run\n```\ngit submodule init\ngit submodule update\n```\nafter cloning.\n\n\n## Licensing\n\nWe do not have an explicit re-distribution license for some of the firmware files provided here, in particular the ones specific to the Microsoft Surface Pro X.\nThese rights lie by Microsoft and/or Qualcomm.\nHowever, many of these files are signed in a way that make them usable only on the Surface Pro X.\nThe files here are provided exclusively for convenience (especially allowing easy creation of distribution packages) as owners of the Surface Pro X can obtain these themselves via the provided script.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinux-surface%2Faarch64-firmware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinux-surface%2Faarch64-firmware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinux-surface%2Faarch64-firmware/lists"}