ROCKNIX

ROCKNIX is a community developed Linux distribution for handheld gaming devices. Our goal is to produce an operating system that has the features and capabilities that we need, and to have fun as we develop it.

Licenses

ROCKNIX is a Linux distribution that is made up of many open-source components. Components are provided under their respective licenses. This distribution includes components licensed for non-commercial use only.

ROCKNIX Branding

ROCKNIX branding and images are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are free to

• Share — copy and redistribute the material in any medium or format
• Adapt — remix, transform, and build upon the material

Under the following terms

• Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
• NonCommercial — You may not use the material for commercial purposes.
• ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

ROCKNIX Software

Copyright (C) 2024 ROCKNIX (https://github.com/ROCKNIX)

Licensed under the GPL License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

https://choosealicense.com/licenses/gpl-2.0/

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Installation

• Download the latest version of ROCKNIX.
• Decompress the image.
• Write the image to an SDCARD using an imaging tool. Common imaging tools include Balena Etcher, Raspberry Pi Imager, and Win32 Disk Imager. If you're skilled with the command line, dd works fine too.

Installation Package Downloads

Upgrading

• Download and install the update online via the System Settings menu.
• If you are unable to update online
  • Download the latest version of ROCKNIX from Github
  • Copy the update to your device over the network to your device's update share.
  • Reboot the device, and the update will begin automatically.

Update Package Downloads

Documentation

Contribute

• Building ROCKNIX
• Code of Conduct
• Contributing to ROCKNIX
• Modifying ROCKNIX
• Adding Hardware Quirks
• Creating Packages
• Pull Request Template

Play

• Installing ROCKNIX
• Updating ROCKNIX
• Controls
• Netplay
• Configuring Moonlight
• Device Specific Documentation

Configure

• Optimizations
• Shaders
• Cloud Sync
• VPN

Other

• Frequently Asked Questions
• Donating to ROCKNIX

Change Log

New Features

• RK3588: Add libmali GPU driver and set as default (huge performance gain)

Updates

• Update to linux 6.9.7 (all except RK3326 and RK3588)
• Update Mesa, libmali kernel driver (RK3566, RK3326, S922X), & vulkan blob (S922X)
• Update several emulator cores
• Rework Dolphin SA controls to be more intelligent
• Update Mupen64 SA
• Update MelonDS-SA to work on libmali (only software renderer on mali).
• Update several dependency packages: SDL2, zerotier, pipewire, fakeroot, bdf2psf, etc. Thanks @NeoTheFox, @maxengel, @faux123
• Set default cpu scaler to ondemand (RK3566) Thanks @faux123
• Rework Cloud backup and restore. Thanks @maxengel

Bug Fixes

• RK3566: Improve battery driver
• Removed deprecated options from EmulationStation.
• Fix controller mappings after driver update
• Retro Lite CM5 (RK3588) Bug fixes and improvements. Thanks @ginkage
• Hide id tech doom 3 and quake 3 on unsupported devices. Thanks @porschemad911

Full Changelog: 2024061...2024070

ROCKNIX

ROCKNIX is a community developed Linux distribution for handheld gaming devices. Our goal is to produce an operating system that has the features and capabilities that we need, and to have fun as we develop it.

Licenses

ROCKNIX is a Linux distribution that is made up of many open-source components. Components are provided under their respective licenses. This distribution includes components licensed for non-commercial use only.

ROCKNIX Branding

ROCKNIX branding and images are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are free to

• Share — copy and redistribute the material in any medium or format
• Adapt — remix, transform, and build upon the material

Under the following terms

• Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
• NonCommercial — You may not use the material for commercial purposes.
• ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

ROCKNIX Software

Copyright (C) 2024 ROCKNIX (https://github.com/ROCKNIX)

Licensed under the GPL License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

https://choosealicense.com/licenses/gpl-2.0/

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Installation

• Download the latest version of ROCKNIX.
• Decompress the image.
• Write the image to an SDCARD using an imaging tool. Common imaging tools include Balena Etcher, Raspberry Pi Imager, and Win32 Disk Imager. If you're skilled with the command line, dd works fine too.

Installation Package Downloads

Upgrading

• Download and install the update online via the System Settings menu.
• If you are unable to update online
  • Download the latest version of ROCKNIX from Github
  • Copy the update to your device over the network to your device's update share.
  • Reboot the device, and the update will begin automatically.

Update Package Downloads

Documentation

Contribute

• Building ROCKNIX
• Code of Conduct
• Contributing to ROCKNIX
• Modifying ROCKNIX
• Adding Hardware Quirks
• Creating Packages
• Pull Request Template

Play

• Installing ROCKNIX
• Updating ROCKNIX
• Controls
• Netplay
• Configuring Moonlight
• Device Specific Documentation

Configure

• Optimizations
• Shaders
• Cloud Sync
• VPN

Other

• Frequently Asked Questions
• Donating to ROCKNIX

Change Log

New Features

• Generic MIPI DSI panel driver, that allows loading panel parameters via an overlay. Allows for R36S panels to be supported with and external panel description. Thanks @stolen. See wiki for more info: https://rocknix.org/devices/unbranded/game-console-r35s-r36s/#new-displays-r36s-of-year-2024
• RK3566: MelonDS standalone emulator, requires panfrost gpudriver.
• RK3566: Add Undervolting options at 3 different levels, allows for better sustained performance in higher end emulators and lowers battery drain on lower end emulators. See wiki for more info: https://rocknix.org/devices/anbernic/rgarc/#tweaks
• RK3588: Initial support Retro Lite CM5. Thanks @ginkage

Updates

• Update Retroarch to 1.19.
• Update linux 6.9.3 (all except RK3326 and RK3588)
• Update Wayland and Vulkan (S922X).
• Update Mesa.
• Update curl. Thanks @UzuCore
• Update Stress-ng. Thanks @aenertia

Bug Fixes

• RK3566: Fix libmali gpu driver for Powkiddy X55
• RK3566: Improved display brighhtness RK3566.
• RK3566: Deep sleep Powkiddy RK2023, RGB30, RGB10 Max 3 and RGB20SX.
• RK3566: Fix non-responsive controls after sleep
• Fix big and little cores setting per system and game. Thanks @porschemad911
• RK3326: Fix shaders. Thanks @amd343
• S922X: fix black screen on bootup with no input devices.
• Fix broken emulators: freej2me-lr and hypeseus-singe (Daphne).
• Miscellanous repo, OS and bug fixes, Thanks @mauroferra, @porschemad911, @stolen, @DinStamou

Full Changelog: 2024041...2024061

ROCKNIX

ROCKNIX is a community developed Linux distribution for handheld gaming devices. Our goal is to produce an operating system that has the features and capabilities that we need, and to have fun as we develop it.

Licenses

ROCKNIX is a Linux distribution that is made up of many open-source components. Components are provided under their respective licenses. This distribution includes components licensed for non-commercial use only.

ROCKNIX Branding

ROCKNIX branding and images are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are free to

• Share — copy and redistribute the material in any medium or format
• Adapt — remix, transform, and build upon the material

Under the following terms

• Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
• NonCommercial — You may not use the material for commercial purposes.
• ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

ROCKNIX Software

Copyright (C) 2024 ROCKNIX (https://github.com/ROCKNIX)

Licensed under the GPL License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

https://choosealicense.com/licenses/gpl-2.0/

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Installation

• Download the latest version of ROCKNIX.
• Decompress the image.
• Write the image to an SDCARD using an imaging tool. Common imaging tools include Balena Etcher, Raspberry Pi Imager, and Win32 Disk Imager. If you're skilled with the command line, dd works fine too.

Installation Package Downloads

Upgrading

• Download and install the update online via the System Settings menu.
• If you are unable to update online
  • Download the latest version of ROCKNIX from Github
  • Copy the update to your device over the network to your device's update share.
  • Reboot the device, and the update will begin automatically.

Update Package Downloads

Documentation

Contribute

• Building ROCKNIX
• Code of Conduct
• Contributing to ROCKNIX
• Modifying ROCKNIX
• Adding Hardware Quirks
• Creating Packages
• Pull Request Template

Play

• Installing ROCKNIX
• Updating ROCKNIX
• Controls
• Netplay
• Configuring Moonlight
• Device Specific Documentation

Configure

• Optimizations
• Shaders
• Cloud Sync
• VPN

Other

• Frequently Asked Questions
• Donating to ROCKNIX

Change Log

New Features

• The ROCKNIX team is pleased to announce full support for the Powkiddy RGB20SX
• The ROCKNIX team is pleased to announce full support for the Anbernic ARC-D / ARC-S (ARC-D owners will need to format android partition).
• Ability to reset all Standalone emultor settings.
• Add ability to switch between Panfrost and Mali gpu backends on RK3566 and RK3326 devices. Defaults to mali for best performance. Thanks @stolen & @JeffyCN
• Add support for RK3588 sbc's (OPi5, OPi5+, Rock5 A/B/B+, etc. (need to manually set DTB in extlinux.conf before first boot)
• Unify input drivers for RK3399, RK3588, RK3566, & S922X.
• Add mednafen Saturn support to RK3588 build.
• Add gamepad tester application (RK3588 & RK3399).
• Add idtech game laucher ceator.
• Enable NTFS support for SD card 2.
• Enable / fix HDMI on RK3566 devices.

Updates

• Kernel 6.9 (6.8.9 on rk3326 devices).
• Mesa Panfrost Graphics drivers updates.
• Update SDL2 to 2.30.3.
• Bump several Standalone and Retroarch emulators, wine, box86/64, etc.
• Portmaster now only maps connected controllers. Other Portmaster impovements. Thanks @porschemad911
• Cleanup docker builds. Thanks @alexdelorenzo, @Sparticuz, @porschemad911
• Update bluetooth and several improvements. Thanks @ananjaser1211
• Moonlight run at 60fps by default. Thanks @ananjaser1211
• Clean up unused packages and tech debt from repo. Thanks @stolen and rocknix team
• Update input driver to include radial deadz one fix and function key support.
• Update kernel firmware and several drivers.
• Other bug fixes across the build. Thanks @faux123

Bug Fixes

• Fix S922X PSP, Dolphin, and other emulator mappings. Thanks @alexdelorenzo
• Fix emulator mappings on RK3566 devices. Thanks @ananjaser1211
• Fix RK3588 Ace installer. (update incompatible ram blob)
• Fix RK3566 battery reporting. Thanks @macromorgan & @faux123

Full Changelog: 2024041...2024051

ROCKNIX

ROCKNIX is a community developed Linux distribution for handheld gaming devices. Our goal is to produce an operating system that has the features and capabilities that we need, and to have fun as we develop it.

Licenses

ROCKNIX is a Linux distribution that is made up of many open-source components. Components are provided under their respective licenses. This distribution includes components licensed for non-commercial use only.

ROCKNIX Branding

ROCKNIX branding and images are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are free to

• Share — copy and redistribute the material in any medium or format
• Adapt — remix, transform, and build upon the material

Under the following terms

• Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
• NonCommercial — You may not use the material for commercial purposes.
• ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

ROCKNIX Software

Copyright (C) 2024 ROCKNIX (https://github.com/ROCKNIX)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http:https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Installation

• Download the latest version of ROCKNIX.
• Decompress the image.
• Write the image to an SDCARD using an imaging tool. Common imaging tools include Balena Etcher, Raspberry Pi Imager, and Win32 Disk Imager. If you're skilled with the command line, dd works fine too.

Installation Package Downloads

Upgrading

• Download and install the update online via the System Settings menu.
• If you are unable to update online
  • Download the latest version of ROCKNIX from Github
  • Copy the update to your device over the network to your device's update share.
  • Reboot the device, and the update will begin automatically.

Update Package Downloads

Documentation

Contribute

• Building ROCKNIX
• Code of Conduct
• Contributing to ROCKNIX
• Modifying ROCKNIX
• Adding Hardware Quirks
• Creating Packages
• Pull Request Template

Play

• Installing ROCKNIX
• Updating ROCKNIX
• Controls
• Netplay
• Configuring Moonlight
• Device Specific Documentation

Configure

• Optimizations
• Shaders
• Cloud Sync
• VPN

Other

• Frequently Asked Questions
• Donating to ROCKNIX

Change Log

New Features

• The ROCKNIX team is pleased to announce full support for Powkiddy X55! thanks @ananjaser1211
• The ROCKNIX team is pleased to announce full support for S922X platform! (Odroid Go Ultra / N2 / N2+ / N2L & Powkiddy RGB10 Max 3 Pro) thanks @spycat88 & @porschemad911
• Add Supermodel SA - Segal Model 3 emulator (RK3588 devices). thanks @KeyserSoze1
• Add Lime3DS SA emulator (S922X devices)
• Add optional Panfrost build for S922X devices (source build only) thanks @porschemad911
• Add OrangePi 5 Plus DTB to RK3588 build (will need to manually update extlinux.conf to point to correct DTB)
• Add support for RGB30 v2 - instructions: https://github.com/ROCKNIX/packages/blob/main/CPU_Governor_RGB30_R2_v2.pdf

Updates

• Kernel 6.8.5
• U-boot 2024.04 (RK3399 and RK3566 builds)
• Set default root password to rocknix
• Clean up boot logic
• Samba no longer requires password by default
• Improve fan profiles
• Mesa Panfrost Graphics drivers
• Bump several Standalone and Retroarch emulators
• Improve installer

Bug Fixes

• RK3566 devices thermal settings
• Fix docker build thanks @UzuCore
• Fix several package source locations thanks @edemirkan
• Fix RGB30 shutdown issue
• Experimental RGB30 panel alignment (please let us know if you continue to have issues)
• Fix several standalone emulator mappings and launchers
• Access boot partition on Windows

Full Changelog: 2024032...2024041

ROCKNIX

ROCKNIX is a community developed Linux distribution for handheld gaming devices. Our goal is to produce an operating system that has the features and capabilities that we need, and to have fun as we develop it.

Licenses

ROCKNIX is a Linux distribution that is made up of many open-source components. Components are provided under their respective licenses. This distribution includes components licensed for non-commercial use only.

ROCKNIX Branding

ROCKNIX branding and images are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are free to

• Share — copy and redistribute the material in any medium or format
• Adapt — remix, transform, and build upon the material

Under the following terms

• Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
• NonCommercial — You may not use the material for commercial purposes.
• ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

ROCKNIX Software

Copyright (C) 2023 ROCKNIX (https://github.com/ROCKNIX)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http:https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Installation

• Download the latest version of ROCKNIX.
• Decompress the image.
• Write the image to an SDCARD using an imaging tool. Common imaging tools include Balena Etcher, Raspberry Pi Imager, and Win32 Disk Imager. If you're skilled with the command line, dd works fine too.

Documentation

Contribute

• Building ROCKNIX
• Code of Conduct
• Contributing to ROCKNIX
• Modifying ROCKNIX
• Adding Hardware Quirks
• Creating Packages
• Pull Request Template

Play

• Installing ROCKNIX
• Updating ROCKNIX
• Controls
• Netplay
• Configuring Moonlight
• Device Specific Documentation

Configure

• Optimizations
• Shaders
• Cloud Sync
• VPN

Other

• Frequently Asked Questions
• Donating to ROCKNIX

We are excited to announce the first release of ROCKNIX!

ROCKNIX is a custom linux gaming OS for Rockchip based handhelds. ROCKNIX started as a fork of JELOS by a few of the former JELOS team members. JELOS has reached EOL and will be archived. We took this opportunity to make a fresh start and start the new ROCKNIX project. All of the ROCKNIX builds (except for the RK3588 platform) use full stable upstream Linux, 6.8.2, and Mesa Panfrost GPUdrivers

Currently the following Rockhip SOC's and devices are supported:

• RK3588 (GameForce Ace)
• RK3326 (Anbernic RG351P/M/V, Hard Kernel OGS/OGA/OGA BE, Powkiddy RGB10, Game Console R33s/R36s/R35s, Magic XU10)
• RK3399 (Anbernic RG552)

While we are sad that the JELOS project is coming to an end we are excited what the future holds for the ROCKNIX project.

Note worthy changes since the last JELOS release:

• Update kernel to 6.8.2
• Update GPU driver to Mesa 24.1
• Add the SWAY Wayland compositor backend
• Add additional Emulation Station features for several emulators
• Additional emulator cores
• Bring back auto system folder generation
• Add Battery and Ram info to system information
• GameForce Ace now supports eMMc installation
• Drop several legacy BSP packages and patches no longer needed
• Fix bugs like MPV controls, Sway issues, etc

We would first like to thank @fewtarius for starting the JELOS project

And we would also like to thank the following community contributors for their commits pulled into this release:
@wwark, @plampix, @stolen, @citral23, @spycat88, @swilde, @Sparticuz, @octopuserectus, @Oendaril, @macromorgan

And finally thank you to everyone else who has contributed to JELOS, the Linux community as a whole, emulator developers, and every other FOSS project that ROCKNIX depends on.