{"id":13821095,"url":"https://github.com/ipxe/pipxe","last_synced_at":"2025-04-13T08:18:55.084Z","repository":{"id":37958988,"uuid":"218574423","full_name":"ipxe/pipxe","owner":"ipxe","description":"iPXE for the Raspberry Pi","archived":false,"fork":false,"pushed_at":"2024-02-27T01:49:04.000Z","size":45,"stargazers_count":198,"open_issues_count":10,"forks_count":39,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-24T11:45:49.137Z","etag":null,"topics":["ipxe","pxe","raspberry-pi","raspberrypi","uefi"],"latest_commit_sha":null,"homepage":"http://ipxe.org","language":"Makefile","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/ipxe.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":"2019-10-30T16:36:27.000Z","updated_at":"2025-03-20T20:26:16.000Z","dependencies_parsed_at":"2024-05-28T19:37:51.127Z","dependency_job_id":null,"html_url":"https://github.com/ipxe/pipxe","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipxe%2Fpipxe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipxe%2Fpipxe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipxe%2Fpipxe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipxe%2Fpipxe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ipxe","download_url":"https://codeload.github.com/ipxe/pipxe/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245755672,"owners_count":20667027,"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":["ipxe","pxe","raspberry-pi","raspberrypi","uefi"],"created_at":"2024-08-04T08:01:15.115Z","updated_at":"2025-03-27T00:09:49.477Z","avatar_url":"https://github.com/ipxe.png","language":"Makefile","funding_links":[],"categories":["raspberry-pi"],"sub_categories":[],"readme":"piPXE - iPXE for the Raspberry Pi\n=================================\n\n[![Build](https://img.shields.io/github/workflow/status/ipxe/pipxe/Build)](https://github.com/ipxe/pipxe/actions?query=workflow%3ABuild+branch%3Amaster)\n[![Release](https://img.shields.io/github/v/release/ipxe/pipxe)](https://github.com/ipxe/pipxe/releases/latest)\n\npiPXE is a build of the [iPXE] network boot firmware for the\n[Raspberry Pi].\n\nQuick start\n-----------\n\n1. Download [sdcard.img] and write it onto any blank micro SD card\nusing a tool such as `dd` or [Etcher].\n\n2. Insert the micro SD card into your Raspberry Pi.\n\n3. Power on your Raspberry Pi.\n\nWithin a few seconds you should see iPXE appear and begin booting from\nthe network:\n\n![Screenshot](screenshot.png)\n\nBuilding from source\n--------------------\n\nTo build from source, clone this repository and run `make`.  This will\nbuild all of the required components and eventually generate the SD\ncard image [sdcard.img].\n\nYou will need various build tools installed, including a\ncross-compiling version of `gcc` for building AArch64 binaries.\n\nFedora build tools:\n\n    sudo dnf install -y binutils gcc gcc-aarch64-linux-gnu \\\n                        git-core iasl libuuid-devel make \\\n                        mtools perl python subversion xz-devel\n\nUbuntu build tools:\n\n    sudo apt install -y build-essential gcc-aarch64-linux-gnu \\\n                        git iasl lzma-dev mtools perl python \\\n                        subversion uuid-dev\n\nHow it works\n------------\n\nThe SD card image contains:\n\n* Broadcom [VC4 boot firmware]: `bootcode.bin` and related files\n* [TianoCore EDK2] UEFI firmware built for the [RPi3] platform: `RPI_EFI.fd`\n* [iPXE] built for the `arm64-efi` platform: `/efi/boot/bootaa64.efi`\n\nThe Raspberry Pi has a somewhat convoluted boot process in which the\nVC4 GPU is responsible for loading the initial executable ARM CPU\ncode.  The flow of execution is approximately:\n\n1. The GPU code in the onboard boot ROM loads `bootcode.bin` from the SD card.\n2. The GPU executes `bootcode.bin` and loads `RPI_EFI.fd` from the SD card.\n3. The GPU allows the CPU to start executing `RPI_EFI.fd`.\n4. The CPU executes `RPI_EFI.fd` and loads `bootaa64.efi` from the SD card.\n5. The CPU executes `bootaa64.efi` (i.e. iPXE) to boot from the network.\n\nLicence\n-------\n\nEvery component is under an open source licence.  See the individual\nsubproject licensing terms for more details:\n\n* \u003chttps://github.com/raspberrypi/firmware/blob/master/boot/LICENCE.broadcom\u003e\n* \u003chttps://github.com/tianocore/edk2/blob/master/Readme.md\u003e\n* \u003chttps://ipxe.org/licensing\u003e\n\n[iPXE]: https://ipxe.org\n[Raspberry Pi]: https://www.raspberrypi.org\n[sdcard.img]: https://github.com/ipxe/pipxe/releases/latest/download/sdcard.img\n[Etcher]: https://www.balena.io/etcher\n[VC4 boot firmware]: https://github.com/raspberrypi/firmware/tree/master/boot\n[TianoCore EDK2]: https://github.com/tianocore/edk2\n[RPi3]: https://github.com/tianocore/edk2-platforms/tree/master/Platform/RaspberryPi/RPi3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipxe%2Fpipxe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipxe%2Fpipxe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipxe%2Fpipxe/lists"}