Skip to content

Commit

Permalink
Additional documentation changes
Browse files Browse the repository at this point in the history
  • Loading branch information
acmeplus committed Apr 9, 2024
1 parent 9167d52 commit 8371c67
Show file tree
Hide file tree
Showing 14 changed files with 366 additions and 15 deletions.
38 changes: 38 additions & 0 deletions docs/devices/anbernic/rg35xx.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Anbernic RG35XX (Original)

![](../../_inc/images/devices/anbernic-rg35xx.png){ .off-glb }

## Overview

| Device | CPU / Architecture | Kernel | GL driver | Interface |
| -- | -- | -- | -- | -- |
| RG35xx Original | Actions Semi 7039 (ARM) | Actions Semi BSP 4.9.170 | pvrsrvkm | Emulation Station / Simplemenu |

!!! warning "The RG35XX distribution includes a bootloader, u-boot, and kernel in binary form extracted from the stock firmware. There are no public sources provided by anbernic for those"

## Extracting the kernel and bootloader

Anbernic has not published the source code of the u-boot and kernel of the RG35xx (original). In order to have a working configuration you have two options:

* You can use the stock kernel, bootloader, and u-boot from the stock SDCARD. See below for instructions on how to extract those.
* You can compile the included kernel with the source code of this distribution, however, note that there will be a few elements that are missing

The firwmare included in releases uses the kernel, bootloader, and u-boot from the stock firmware.

## Features



## Notes

### Installation

Download the latest `RG35XX` version of KNULLI from the button below and follow the instructions listed on the [Install](../../../play/install/) page.

[![Latest Version](https://img.shields.io/github/release/knulli-cfw/distribution.svg?labelColor=111111&color=5998FF&label=Latest&style=flat#only-light)](https://github.com/knulli-cfw/distribution/releases/latest)
[![Latest Version](https://img.shields.io/github/release/knulli-cfw/distribution.svg?labelColor=dddddd&color=5998FF&label=Latest&style=flat#only-dark)](https://github.com/knulli-cfw/distribution/releases/latest)

## Additional References

- [Platform Documentation (RK3326)](https://github.com/knulli-cfw/distribution/blob/main/documentation/PER_DEVICE_DOCUMENTATION/RK3326)
- [Device Quirks](https://github.com/knulli-cfw/distribution/tree/main/packages/hardware/quirks/devices/Anbernic%20RG351M)
2 changes: 1 addition & 1 deletion docs/devices/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ There are two main categories, those that have GPU support and include Emulation
| Powkiddy | [Powkiddy A13](powkiddy/powkiddy-a13.md) | Rockchip RK3128 / Mali 400 MP4 (ARMv7-A) | Rockchip BSP 4.4 | Mali | Weston + Emulation Station |
| Powkiddy | [RGB30](powkiddy/rgb30.md) | Rockchip RK3566 (ARM) | Rockchip BSP 4.19 | Mali | KMS/DRM + Emulation Station |
| Sega | [Astro City Mini](sega/astro-city-mini.md) | Allwinner R16 / Mali 400 MP4 (ARMv7-A) | Allwinner BSP 4.0 | Mali | fbdev + Emulationstation |
| SGJAM | [M16](sgjam/m17.md) | Rockchip RK3126 / Mali 400 MP4 (ARMv7-A) | Rockchip BSP 4.4 | Mali | Weston + Emulation Station |
| SJGAM | [M16](sjgam/m17.md) | Rockchip RK3126 / Mali 400 MP4 (ARMv7-A) | Rockchip BSP 4.4 | Mali | Weston + Emulation Station |
| Taito | [Egret II Mini](taito/egret-ii-mini.md) | Allwinner R16 / Mali 400 MP4 (ARMv7-A) | Allwinner BSP 4.0 | Mali | fbdev + Emulationstation |
| Unbranded | [PocketGo S30](unbranded/pocketgo-s30.md) | Allwinner A33 / Mali 400 MP4 (ARMv7-A) | Allwinner BSP 4.4 | Mali | fbdev + Emulation Station |

Expand Down
28 changes: 28 additions & 0 deletions docs/devices/orange-pi/orange-pi-zero-2w.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# Orange Pi 5

![](../../_inc/images/devices/orange-pi-zero-2w.png){ .off-glb }

## Overview

| Device | CPU / Architecture | Kernel | GL driver | Interface |
| -- | -- | -- | -- | -- |
| Orange Pi Zero 2w | Allwinner H618 / Mali G31 (ARMv8-A) | Mainline Linux | Panfrost | Weston + Emulation Station |

## Notes

### Installation

Download the latest `RK3588` version of JELOS from the button below and follow the instructions listed on the [Install](../../../play/install/) page.

[![Latest Version](https://img.shields.io/github/release/JustEnoughLinuxOS/distribution.svg?labelColor=111111&color=5998FF&label=Latest&style=flat#only-light)](https://github.com/JustEnoughLinuxOS/distribution/releases/latest)
[![Latest Version](https://img.shields.io/github/release/JustEnoughLinuxOS/distribution.svg?labelColor=dddddd&color=5998FF&label=Latest&style=flat#only-dark)](https://github.com/JustEnoughLinuxOS/distribution/releases/latest)

## Additional References

- [Platform Documentation (RK3588)](https://github.com/JustEnoughLinuxOS/distribution/blob/main/documentation/PER_DEVICE_DOCUMENTATION/RK3588)

## Community Videos

<iframe width="560" height="315" src="https://www.youtube.com/embed/K3dByIl0RAs?si=l84PvS6Oc8ntl9ka" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

<iframe width="560" height="315" src="https://www.youtube.com/embed/oW7oWiwdELE?si=nf5vrscBn9ro7ACl" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
68 changes: 68 additions & 0 deletions docs/devices/powkiddy/rgb30.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Powkiddy RGB30

![](../../_inc/images/devices/powkiddy-rgb30.png){ .off-glb }

## Overview

| Device | CPU / Architecture | Kernel | GL driver | Interface |
| -- | -- | -- | -- | -- |
| RGB30 | Rockchip RK3566 (ARM) | Rockchip BSP 4.19 | Mali | KMS/DRM + Emulation Station |

## Features

| Feature&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Notes |
| -- | -- |
| :material-harddisk: Storage | KNULLI can be run from an SD Card and an second SD card can be used to store games |
| :material-wifi: Wifi | Can be turned on in Emulation Station under Main Menu > Network Settings |
| :simple-bluetooth: Bluetooth | Supports bluetooth audio and controllers |
| :material-lightbulb-on: LED | Supports selecting from a set of colors or turning the power LED off (choice persists through reboots) <br> Does not support other effects. |

## Controls

{%set btn_north = 'Y(NORTH)' %}
{%set btn_west = 'X(WEST)' %}
{%set btn_south = 'A(SOUTH)' %}
{%set btn_east = 'B(EAST)' %}

{%include 'controls/retroarch.md' %}
{%include 'controls/mednafen.md' %}
{%include 'controls/mupen64plus.md' %}

{%set btn_save = 'R2' %}
{%set btn_load = 'L2' %}
{%set btn_menu = 'R3' %}
{%include 'controls/ppsspp.md' %}

{%include 'controls/hypseus-singe.md' %}

{%set btn_pre1 = 'SELECT' %}
{%set btn_pre2 = 'START' %}
{%include 'controls/extra.md' %}

## Emulators

- [Platform Documentation (RK3566)](https://github.com/knulli-cfw/distribution/blob/main/documentation/PER_DEVICE_DOCUMENTATION/RK3566)

## Notes

### Installation

#### Video Guide
> Courtesy of [@RetroGameCorps](https://www.youtube.com/@RetroGameCorps)
<iframe width="560" height="315" src="https://www.youtube.com/embed/yXtZTMxn94Q?si=WTPxyu2W1RyCk6sF" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
Download the latest `RK3566` version of KNULLI from the button below and follow the instructions listed on the [Install](../../../play/install/) page. Insert the SD card into the TF-OS slot of the device and power it on.

[![Latest Version](https://img.shields.io/github/release/knulli-cfw/distribution.svg?labelColor=111111&color=5998FF&label=Latest&style=flat#only-light)](https://github.com/knulli-cfw/distribution/releases/latest)
[![Latest Version](https://img.shields.io/github/release/knulli-cfw/distribution.svg?labelColor=dddddd&color=5998FF&label=Latest&style=flat#only-dark)](https://github.com/knulli-cfw/distribution/releases/latest)


### Community Videos

| <iframe width="560" height="315" src="https://www.youtube.com/embed/KTb6ik1Eb40?si=gvmcp0znmXJcjTrQ&amp;start=788" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> | <iframe width="560" height="315" src="https://www.youtube.com/embed/Tf4k6f8fgbY?si=qLEdnDXHRi3DdZuj&amp;start=266" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> |
| -- | -- |
| <iframe width="560" height="315" src="https://www.youtube.com/embed/Aejn0iveDtQ?si=OvUjUO6eOhIb_TqC&amp;start=788" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> | <iframe width="560" height="315" src="https://www.youtube.com/embed/U25ioCRHQ9k?si=zN8bR0uNJOhcOhzV&amp;start=788" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> |
| <iframe width="560" height="315" src="https://www.youtube.com/embed/0j92-FzEeaQ?si=knrRFkohSPP6bZbZ&amp;start=788" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> | <iframe width="560" height="315" src="https://www.youtube.com/embed/C_-JS9gTw54?si=aDPulkkgWauDd_P0&amp;start=316" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> |
| <iframe width="560" height="315" src="https://www.youtube.com/embed/LIMepWAzUuw?si=U2L569LghjezOCu5" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> | <iframe width="560" height="315" src="https://www.youtube.com/embed/YNaiPSv1AKo?si=IhyKo5F33o1ymdRJ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> |
| <iframe width="560" height="315" src="https://www.youtube.com/embed/Wpwaitv7aRM?si=zHrmWiRFUXnX5H_h" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> | <iframe width="560" height="315" src="https://www.youtube.com/embed/PN7iUBZiaec?si=N1KL0iobZGfkqtea" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> |
| <iframe width="560" height="315" src="https://www.youtube.com/embed/Pp9wfW5fU6Y?si=pAX1xrK77WweKpJJ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> |
13 changes: 13 additions & 0 deletions docs/devices/trimui/smart-pro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
search:
exclude: true
---
# Trimui Smart Pro

![](../../_inc/images/devices/trimui-smart-pro.png){ .off-glb }

## Overview

| Device | CPU / Architecture | Kernel | GL driver | Interface |
| -- | -- | -- | -- | -- |
| Trimui Smart Pro | Allwinner A133 / PowerVR GE8300 | Allwinner BSP | pvrsrvkm | Emulation Station |
3 changes: 2 additions & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,12 @@

# Welcome to the KNULLI Wiki :material-gamepad:

KNULLI is a custom firmware for retro gaming devices (handhelds, bartops, etc.). It's developed as fork of [Batocera](https://batocera.org). It tries to provide support for devices that fall under at least one of these categories:
KNULLI is a custom firmware for retro gaming devices (handhelds, bartops, etc.). It's developed as a fork of [Batocera](https://batocera.org). It tries to provide support for devices that fall under at least one of these categories:

* There are no open source kernel and/or u-boot sources available
* There are sources, but the kernel is either not mainline, and/or too old (e.g. devices with a BSP kernel 3.4 like the Egret II Mini)
* There is no GPU support or the gpu is not supported, so framebuffer is the only option
* It's a device that I own and have decided to build a CFW for it

## Features

Expand Down
109 changes: 109 additions & 0 deletions docs/play/add-games.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,109 @@
# :material-layers-plus: Adding Games to KNULLI

KNULLI has a few options for adding games and the option you choose will depend on the device you have and its available functionality *(For example, some devices do not have networking capabilites so those devices will not be able to use the network transfer option)*. To create the default set of game directories on your device, choose the 'CREATE GAME DIRECTORIES' option in the System Settings menu.

This page will aim to document all possible options and indicate when you might use a given one over another.

!!! note "For details on which specific files each system requires please see the corresponding pages in the systems section of this wiki."

## Storage Modes

KNULLI has support for using internal and external storage (microsd) for games. To make games available in the OS we provide different features based on the capability of the filesystem that you are using. To support our storage modes KNULLI nests games into a directory on your games card called "roms". All games found in this path will be available in the OS.

### Merged Storage

When using a microsd that is formatted as Ext4 (Linux), KNULLI will present users with the ability to merge both the internal and external storage together allowing users to use both devices to store games. This mode has two preferences, external (default), and internal.

* Preference External
* This mode will save anything written to `/userdata/roms` to your external microsd (`/userdata/games-external/roms`).
* Preference Internal
* This mode will save anything written to `/userdata/roms` to your internal storage (`/userdata/games-internal/roms`).

> Note: *Merged Storage is disabled by default.*
### Simple Storage

When Merged Storage is disabled, or when you are using ExFAT or FAT32, KNULLI will mount your external card to `/userdata/games-external` and make the content of `/userdata/games-external/roms` available at /userdata/roms.

### Troubleshooting

* It is possible to create a conflict which will prevent games from being displayed in EmulationStation. This can usually be resolved by executing `/usr/bin/cleanup_overlay`. Note: This will reboot your device.
* If no game folders appear in /userdata/roms after running `CREATE GAME DIRECTORIES`, make sure you have a `roms` directory on your microsd.

## Option 1: Network Transfer

Network transfer can be used on any device that can connect to the internet (this includes devices with native networking capabilites and ones where networking can be added through an external dongle).

This option first requires you to set up networking on your device. Please see [Networking](../../configure/networking) for details. Once you have completed those steps make note of your IP Address in the Network Settings menu.

In addition to your IP you will also need your root password. This can be found in the Main Menu by pressing ++"START"++ in EmulationStation and navigating to `System Settings`. You will see your root password under the `Authentication` header.

!!! note "By default the root password is set up to rotate to a unique string of characters after every reboot. You can leave it like this and make note of the current password, or you can turn it off and set it to something that will persist."

### HTTP

Enabling Simple HTTP Server in Network settings lets you upload and download files by entering your device's IP address in any browser on the local network (or on VPN IP, see VPN section for details). The username is `root` and the password can be found in `Root Password` in the main menu.

### SMB

- Windows:
- open a Windows Explorer window, and type in `\\[YOUR IP ADDRESS]`; replace `[YOUR IP ADDRESS]` with the IP Address seen in the Network Settings menu.
- You will be prompted for a username and password.
- The username is `root` and your password will be the value from `Root Password` in the System Settings menu.
- MacOS:
- open Finder and select `Go > Connect to Server` from the top menu.
- In the address bar that appears, type `smb://[YOUR IP ADDRESS]`; replace `[YOUR IP ADDRESS]` with the IP Address seen in the Network Settings menu.
- You will be prompted for a username and password.
- For name enter `root` and your password will be the value from `Root Password` in the System Settings menu.

### FTP

Using your FTP program of choice; set up an SFTP connection to the IP Address seen in the Network Settings menu. Make sure the Port is set to `22`. The username is `root` and your password will be the value from `Root Password` in the System Settings menu.

### After connecting

- You will see a list of folders after you have connected via network.
- Open the `roms` folder and you will see a list of folders where games and bios files can be placed. *(Please see the systems section of the wiki for details on where each system's files should be placed)*
- After you have added your games you can get them to display in EmulationStation by pressing ++"START"++ to open the Main Menu, then open `Game Settings` then select `Update Gamelists` under the Tools header.

## Option 2: SD Card

Games can also be added via an SD card. There are 2 primary methods for this depending on your device.

### If your device has 2 SD card slots

- With your device turned off; insert a FAT32/ExFAT/ext4 formated SD card into slot 2 of your device.
- Turn your device on.
- When KNULLI completes its boot process, create your game directories by selecting the `Create Game Directories` option in `System Settings`.
- Now you can turn off your device, remove your SD card from slot 2 and open it on your PC.
- You PC will display a list of folders, open the `roms` directory and you will see a list of folders for each system where you can place your games and bios files.
- Add your games and place your SD card back into slot 2 and boot up KNULLI.

If your device does not see your SD card (or write the needed folders to it) please open `System Settings` and make sure `Autodetect Games Card` is turned on (located under the Hardware/Storage header) then reboot your device.

### If your device has 1 SD card slot

!!! warning "This option is only for devices where you have installed KNULLI to the internal drive of the device. In this scenario an SD card can be used directly for storage"

- With KNULLI installed to your internal drive press ++"START"++ to open the Main Menu, then open `System Settings` and turn on `Autodetect Games Card` under the Hardware/Storage header.
- Turn your device off
- Insert a FAT32/ExFAT/ext4 formated SD card into your device.
- Turn your device on
- When KNULLI completes its boot process, create your game directories by selecting the `Create Game Directories` option in `System Settings`.
- Now you can turn off your device, remove your SD card and open it on your PC.
- You PC will display a list of folders, open the `roms` directory and you will see a list of folders for each system where you can place your games and bios files.
- Add your games and place your SD card back into your device and boot up KNULLI.

## Option 3: External USB Drive

KNULLI has a built in File Manager and you can use it to access connected USB drives and transfer files.

1. Connect your USB Drive to your device
2. Open the Tools system and select File Manager
3. Navigate up to `/` and then select `media` - you should see your drive listed after opening media
4. Open your drive and you should see its contents
5. From here you can navigate to the file(s) you would like to copy and then navigate back to the `userdata/roms` directory and paste your copied files in the approrpiate folder.

## Option 4: Linux OS

KNULLI' storage drive is formated as ext4 which can be read natively by linux operating systems. Plugging in your SD card into an linux OS will enable you to browse the directories and add files directly.
Loading

0 comments on commit 8371c67

Please sign in to comment.