mirror of
https://github.com/Atmosphere-NX/Atmosphere.git
synced 2025-08-04 07:08:51 +00:00
Add Github Workflow and Build Status
- Adds a Github Workflow - Shows the Build Status of the Github Workflow on the main page
This commit is contained in:
bladeoner
parent
4138abbefa
commit
ea016d2ff8
3 changed files with 127 additions and 52 deletions
53
.github/workflows/continuous-integration-workflow.yml
vendored
Normal file
53
.github/workflows/continuous-integration-workflow.yml
vendored
Normal file
|
|
@ -0,0 +1,53 @@
|
||||||
|
name: Atmosphere Build
|
||||||
|
|
||||||
|
on: [push, pull_request]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build:
|
||||||
|
name: ubuntu-20.04
|
||||||
|
runs-on: ubuntu-20.04
|
||||||
|
container: devkitpro/devkita64_devkitarm
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v1
|
||||||
|
with:
|
||||||
|
submodules: true
|
||||||
|
|
||||||
|
- name: Copy source list
|
||||||
|
run: sudo cp -r sources.list /etc/apt/
|
||||||
|
working-directory: ./workflow_files
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: |
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y dirmngr --install-recommends --allow-unauthenticated
|
||||||
|
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32
|
||||||
|
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 871920D1991BC93C
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y -f
|
||||||
|
sudo dpkg --configure -a
|
||||||
|
sudo apt-get upgrade -y --with-new-pkgs
|
||||||
|
sudo apt-get install -y lz4
|
||||||
|
sudo apt-get install -y gawk
|
||||||
|
sudo apt-get install python-is-python3
|
||||||
|
sudo apt-get install python3-pip --yes
|
||||||
|
sudo pip3 install lz4
|
||||||
|
sudo pip3 install pycryptodome
|
||||||
|
|
||||||
|
- name: Checkout libnx
|
||||||
|
uses: actions/checkout@v2
|
||||||
|
with:
|
||||||
|
repository: switchbrew/libnx
|
||||||
|
path: libnx
|
||||||
|
|
||||||
|
- name: Make libnx
|
||||||
|
run: make
|
||||||
|
working-directory: ${{ github.workspace }}/libnx
|
||||||
|
|
||||||
|
- name: Install libnx
|
||||||
|
run: make install
|
||||||
|
working-directory: ${{ github.workspace }}/libnx
|
||||||
|
|
||||||
|
- name: Build
|
||||||
|
run: |
|
||||||
|
make -j2
|
||||||
112
README.md
112
README.md
|
|
@ -1,52 +1,60 @@
|
||||||
|
|
||||||
|
|
||||||
=====
|
=====
|
||||||
|
|
||||||
|
|
||||||
[](https://discordapp.com/invite/ZdqEhed)
|
[](https://discordapp.com/invite/ZdqEhed)
|
||||||
|
|
||||||
Atmosphère is a work-in-progress customized firmware for the Nintendo Switch.
|
Atmosphère is a work-in-progress customized firmware for the Nintendo Switch.
|
||||||
|
|
||||||
Components
|
# Build Status
|
||||||
=====
|
|
||||||
|
|Build status: | [![Build Status][Build]][Actions]
|
||||||
Atmosphère consists of multiple components, each of which replaces/modifies a different component of the system:
|
|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
|
|
||||||
* Fusée: First-stage Loader, responsible for loading and validating stage 2 (custom TrustZone) plus package2 (Kernel/FIRM sysmodules), and patching them as needed. This replaces all functionality normally in Package1loader/NX Bootloader.
|
[Actions]: https://github.com/Atmosphere-NX/Atmosphere/actions
|
||||||
* Sept: Payload used to enable support for runtime key derivation on 7.0.0.
|
[Build]: https://github.com/Atmosphere-NX/Atmosphere/workflows/Atmosphere%20Build/badge.svg
|
||||||
* Exosphère: Customized TrustZone, to run a customized Secure Monitor
|
|
||||||
* Thermosphère: EL2 EmuNAND support, i.e. backing up and using virtualized/redirected NAND images
|
|
||||||
* Stratosphère: Custom Sysmodule(s), both Rosalina style to extend the kernel/provide new features, and of the loader reimplementation style to hook important system actions
|
# Components
|
||||||
* Troposphère: Application-level Horizon OS patches, used to implement desirable CFW features
|
|
||||||
|
Atmosphère consists of multiple components, each of which replaces/modifies a different component of the system:
|
||||||
Licensing
|
|
||||||
=====
|
* Fusée: First-stage Loader, responsible for loading and validating stage 2 (custom TrustZone) plus package2 (Kernel/FIRM sysmodules), and patching them as needed. This replaces all functionality normally in Package1loader/NX Bootloader.
|
||||||
|
* Sept: Payload used to enable support for runtime key derivation on 7.0.0.
|
||||||
This software is licensed under the terms of the GPLv2, with exemptions for specific projects noted below.
|
* Exosphère: Customized TrustZone, to run a customized Secure Monitor
|
||||||
|
* Thermosphère: EL2 EmuNAND support, i.e. backing up and using virtualized/redirected NAND images
|
||||||
You can find a copy of the license in the [LICENSE file](LICENSE).
|
* Stratosphère: Custom Sysmodule(s), both Rosalina style to extend the kernel/provide new features, and of the loader reimplementation style to hook important system actions
|
||||||
|
* Troposphère: Application-level Horizon OS patches, used to implement desirable CFW features
|
||||||
Exemptions:
|
|
||||||
* The [yuzu Nintendo Switch emulator](https://github.com/yuzu-emu/yuzu) and the [Ryujinx Team and Contributors](https://github.com/orgs/Ryujinx) are exempt from GPLv2 licensing. They are permitted, each at their individual discretion, to instead license any source code authored for the Atmosphère project as either GPLv2 or later or the [MIT license](https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/licensing_exemptions/MIT_LICENSE). In doing so, they may alter, supplement, or entirely remove the copyright notice for each file they choose to relicense. Neither the Atmosphère project nor its individual contributors shall assert their moral rights against any of the aforementioned projects.
|
|
||||||
* [Nintendo](https://github.com/Nintendo) is exempt from GPLv2 licensing and may (at its option) instead license any source code authored for the Atmosphère project under the Zero-Clause BSD license.
|
# Licensing
|
||||||
|
|
||||||
Credits
|
This software is licensed under the terms of the GPLv2, with exemptions for specific projects noted below.
|
||||||
=====
|
|
||||||
|
You can find a copy of the license in the [LICENSE file](LICENSE).
|
||||||
Atmosphère is currently being developed and maintained by __SciresM__, __TuxSH__, __hexkyz__, and __fincs__.<br>
|
|
||||||
In no particular order, we credit the following for their invaluable contributions:
|
Exemptions:
|
||||||
|
* The [yuzu Nintendo Switch emulator](https://github.com/yuzu-emu/yuzu) and the [Ryujinx Team and Contributors](https://github.com/orgs/Ryujinx) are exempt from GPLv2 licensing. They are permitted, each at their individual discretion, to instead license any source code authored for the Atmosphère project as either GPLv2 or later or the [MIT license](https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/licensing_exemptions/MIT_LICENSE). In doing so, they may alter, supplement, or entirely remove the copyright notice for each file they choose to relicense. Neither the Atmosphère project nor its individual contributors shall assert their moral rights against any of the aforementioned projects.
|
||||||
* __switchbrew__ for the [libnx](https://github.com/switchbrew/libnx) project and the extensive [documentation, research and tool development](http://switchbrew.org) pertaining to the Nintendo Switch.
|
* [Nintendo](https://github.com/Nintendo) is exempt from GPLv2 licensing and may (at its option) instead license any source code authored for the Atmosphère project under the Zero-Clause BSD license.
|
||||||
* __devkitPro__ for the [devkitA64](https://devkitpro.org/) toolchain and libnx support.
|
|
||||||
* __ReSwitched Team__ for additional [documentation, research and tool development](https://reswitched.team/) pertaining to the Nintendo Switch.
|
|
||||||
* __ChaN__ for the [FatFs](http://elm-chan.org/fsw/ff/00index_e.html) module.
|
# Credits
|
||||||
* __Marcus Geelnard__ for the [bcl-1.2.0](https://sourceforge.net/projects/bcl/files/bcl/bcl-1.2.0) library.
|
|
||||||
* __naehrwert__ and __st4rk__ for the original [hekate](https://github.com/nwert/hekate) project and its hwinit code base.
|
Atmosphère is currently being developed and maintained by __SciresM__, __TuxSH__, __hexkyz__, and __fincs__.<br>
|
||||||
* __CTCaer__ for the continued [hekate](https://github.com/CTCaer/hekate) project's fork and the [minerva_tc](https://github.com/CTCaer/minerva_tc) project.
|
In no particular order, we credit the following for their invaluable contributions:
|
||||||
* __m4xw__ for development of the [emuMMC](https://github.com/m4xw/emummc) project.
|
|
||||||
* __Riley__ for suggesting "Atmosphere" as a Horizon OS reimplementation+customization project name.
|
* __switchbrew__ for the [libnx](https://github.com/switchbrew/libnx) project and the extensive [documentation, research and tool development](http://switchbrew.org) pertaining to the Nintendo Switch.
|
||||||
* __hedgeberg__ for research and hardware testing.
|
* __devkitPro__ for the [devkitA64](https://devkitpro.org/) toolchain and libnx support.
|
||||||
* __lioncash__ for code cleanup and general improvements.
|
* __ReSwitched Team__ for additional [documentation, research and tool development](https://reswitched.team/) pertaining to the Nintendo Switch.
|
||||||
* __jaames__ for designing and providing Atmosphère's graphical resources.
|
* __ChaN__ for the [FatFs](http://elm-chan.org/fsw/ff/00index_e.html) module.
|
||||||
* Everyone who submitted entries for Atmosphère's [splash design contest](https://github.com/Atmosphere-NX/Atmosphere-splashes).
|
* __Marcus Geelnard__ for the [bcl-1.2.0](https://sourceforge.net/projects/bcl/files/bcl/bcl-1.2.0) library.
|
||||||
* _All those who actively contribute to the Atmosphère repository._
|
* __naehrwert__ and __st4rk__ for the original [hekate](https://github.com/nwert/hekate) project and its hwinit code base.
|
||||||
|
* __CTCaer__ for the continued [hekate](https://github.com/CTCaer/hekate) project's fork and the [minerva_tc](https://github.com/CTCaer/minerva_tc) project.
|
||||||
|
* __m4xw__ for development of the [emuMMC](https://github.com/m4xw/emummc) project.
|
||||||
|
* __Riley__ for suggesting "Atmosphere" as a Horizon OS reimplementation+customization project name.
|
||||||
|
* __hedgeberg__ for research and hardware testing.
|
||||||
|
* __lioncash__ for code cleanup and general improvements.
|
||||||
|
* __jaames__ for designing and providing Atmosphère's graphical resources.
|
||||||
|
* Everyone who submitted entries for Atmosphère's [splash design contest](https://github.com/Atmosphere-NX/Atmosphere-splashes).
|
||||||
|
* _All those who actively contribute to the Atmosphère repository._
|
||||||
|
|
|
||||||
14
workflow_files/sources.list
Normal file
14
workflow_files/sources.list
Normal file
|
|
@ -0,0 +1,14 @@
|
||||||
|
deb http://archive.ubuntu.com/ubuntu/ focal main restricted universe multiverse
|
||||||
|
deb-src http://archive.ubuntu.com/ubuntu/ focal main restricted universe multiverse
|
||||||
|
|
||||||
|
deb http://archive.ubuntu.com/ubuntu/ focal-updates main restricted universe multiverse
|
||||||
|
deb-src http://archive.ubuntu.com/ubuntu/ focal-updates main restricted universe multiverse
|
||||||
|
|
||||||
|
deb http://archive.ubuntu.com/ubuntu/ focal-security main restricted universe multiverse
|
||||||
|
deb-src http://archive.ubuntu.com/ubuntu/ focal-security main restricted universe multiverse
|
||||||
|
|
||||||
|
deb http://archive.ubuntu.com/ubuntu/ focal-backports main restricted universe multiverse
|
||||||
|
deb-src http://archive.ubuntu.com/ubuntu/ focal-backports main restricted universe multiverse
|
||||||
|
|
||||||
|
deb http://archive.canonical.com/ubuntu focal partner
|
||||||
|
deb-src http://archive.canonical.com/ubuntu focal partner
|
||||||
Loading…
Add table
Add a link
Reference in a new issue