## PLEASE READ ME!

### 🚨DISCLAIMER: THIS IS PROVIDED AS IS. USE AT YOUR OWN RISK!🚨

- Overclocking in general will shorten the lifespan of some hardware components. YOU ARE RESPONSIBLE for any problem or potential damage.
- Due to Horizon OS's design, instabilities from unsafe RAM clocks may cause filesystem corruption. Always make backup before enabling DRAM OC.

### Features

For Erista variant (HAC-001)

- CPU Overclock (Safe: 1785 MHz)
  - Unsafe
    - Due to the limit of board power draw or power IC
    - Unlockable frequencies up to 2295 MHz
    - See README for sys-clk-OC
- DRAM Overclock (Safe: 1862.4 MHz)

For Mariko variant (HAC-001-01, HDH-001, HEG-001)

- CPU / GPU Overclock (Safe: 1963 / 1075 MHz)
  - Unsafe
    - Due to the limit of board power draw or power IC
    - Unlockable frequencies up to 2907 / 1536 MHz
    - See README for sys-clk-OC
- DRAM Overclock (Safe: 1996.8 MHz)

Sys-CLK OC and ReverseNX-RT

- Global Profile
  - Designated a dummy title id `0xA111111111111111`.
  - Priority: "Temp overrides" > "Application profile" > "Global profile" > "System default".

System Settings (Optional)
See system_settings.md

### Installation

1. Download latest release.
2. Grab `x.x.x_loader.kip` for your Atmosphere version, rename it to `loader.kip` and place it in `/atmosphere/kips/`.
3. (optional) You can customize via online loader configurator

   Defaults | Mariko | Erista
   --- | --- | ---
   CPU OC | 2295 MHz Max | 2091 MHz Max
   CPU Boost | 1785 MHz | N/A
   CPU Volt | 1235 mV Max | 1235 mV Max
   GPU OC | 1152 MHz Max | 998 MHz Max
   RAM OC | 1996 MHz | 1862 MHz
   RAM Volt | Disabled | Disabled
   RAM Timing | Auto-Adjusted | Auto-Adjusted
   CPU UV | Disabled | N/A
   GPU UV | Disabled | N/A

4. Hekate-ipl bootloader Only (fss0) (Not required for AMS fusee)
   - At boot entry section in `bootloader/hekate_ipl.ini`, Add `kip1=atmosphere/kips/*.kip` to any line that works.
5. Install [sys-clk-oc]
   official [sys-clk] (2.0.0+) is compatible but not recommended (no bugfixes or additional features).
6. (optional) Copy SdOut.zip for useful utilities.

How to build this project

1. Grab necessary patches from the repo, then compile sys-clk, ReverseNX-RT and Atmosphere loader with devkitpro.
2. Before compiling Atmosphere loader, run `patch.py` in `Atmosphere/stratosphere/loader/source/` to insert oc module into loader sysmodule.
3. Run cd stratosphere/loader then make to build the loader.kip
4. When compilation is done, uncompress the kip to make it work with configurator: `hactool -t kip1 loader.kip --uncompress=loader.kip`

### Frequently Asked Questions

How to enable unsafe frequencies in sys-clk-OC?

- Above all else, you should know what "unsafe" means and issues might arise.
- See the end of README in sys-clk-OC. Place this line `allow_unsafe_freq=1` under `[values]` section in `/config/sys-clk/config.ini`

I would like to bypass limit enforced in sys-clk to improve handheld performance without charger connected.

- Bypassing clock cappings will be bad for battery.
- See the end of README in sys-clk-OC. Place this line `uncapped_clocks=1` under `[values]` section in `/config/sys-clk/config.ini`

## Download

### Get latest version of Switch OC Suite and its corresponding Atmosphere package here.

Generating link, please wait... Generating link, please wait... Generating link, please wait...

## Configurator

### Configure frequencies and voltages to suit your hardware and preferences.

Upload loader.kip here