jelos.org/docs/devices/ayn/loki-zero.md
2023-09-19 14:09:08 -04:00

142 lines
No EOL
6.1 KiB
Markdown

# Loki Zero
![](../../_inc/images/devices/ayn-loki.png){ .off-glb }
## Overview
| Device | CPU / Architecture | Kernel | GL driver | Interface |
| -- | -- | -- | -- | -- |
| Loki Zero | AMD Athlon Silver 3050e (x86_64) | Mainline Linux | Radeonsi | Weston + Emulation Station |
## Features
| Feature                 | Notes |
| -- | -- |
| :material-harddisk: Storage | JELOS can be run from an SD Card, USB Drive or installed directly to the internal NVME. <br> When installed directly to the NVME; an SD Card can be used for game storage. |
| :material-wifi: Wifi | Can be turned on in Emulation Station under Main Menu > Network |
| :simple-bluetooth: Bluetooh | Supports bluetooth audio and controllers |
| :material-fan: Fan | Can be set globally, per system or per game. |
| :material-lightning-bolt-circle: TPD Limit | Can be set globally, per system or per game. |
| :material-vibrate: Rumble | Enables the device rumble motor in emulators that support it. |
| :material-lightbulb-on: RGB | Supports selecting from a set of colors or turning the RGB off (choice persists through reboots) <br> Does not support changing brightness or turning on other effects. |
## Notes
| DMI_SYS_VENDOR | DMI_PRODUCT_NAME |
| -- | -- |
| `ayn` | `Loki Zero` |
### Installation
Download the latest `AMD64` 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)
### Booting from an SD Card
In order to launch JELOS from an SD card or a USB drive you will need to first change the boot order in the BIOS.
During boot you can enter the bios by either (1) holding the `Home` & `LCC (Turbo)` buttons that sit bellow the dpad and right analog stick OR (2) connecting an external keyboard and pressing the `del` key.
In the bios; navigate to the `Boot` menu and then change the boot order to prioritize the SD card or USB Drive under `Boot Order Priorities`. Then go `Save & Exit` and select the Save Changes and Exit option. This change will persist through all reboots. If you want to boot into Windows simply remove the SD Card or USB drive.
### Changing the RGB
In EmulationStation press the `Start` button to open the Main Menu. Then select `System Settings` and scroll until you see `Device LEDS`. Under that setting you can choose to turn RGB Off or select from a set of pre-defined colors. The value you set will persist through all future reboots but note your RGB setting will only take effect after JELOS boots.
## Controls
### `evtest` Output
??? abstract "Main Controls"
``` bash title="/dev/input/event5: Microsoft X-Box 360 pad"
Input driver version is 1.0.1
Input device ID: bus 0x3 vendor 0x45e product 0x28e version 0x110
Input device name: "Microsoft X-Box 360 pad"
Supported events:
Event type 0 (EV_SYN)
Event type 1 (EV_KEY)
Event code 304 (BTN_SOUTH)
Event code 305 (BTN_EAST)
Event code 307 (BTN_NORTH)
Event code 308 (BTN_WEST)
Event code 310 (BTN_TL)
Event code 311 (BTN_TR)
Event code 314 (BTN_SELECT)
Event code 315 (BTN_START)
Event code 316 (BTN_MODE)
Event code 317 (BTN_THUMBL)
Event code 318 (BTN_THUMBR)
Event type 3 (EV_ABS)
Event code 0 (ABS_X)
Value 0
Min -32768
Max 32767
Fuzz 16
Flat 128
Event code 1 (ABS_Y)
Value -1
Min -32768
Max 32767
Fuzz 16
Flat 128
Event code 2 (ABS_Z)
Value 0
Min 0
Max 255
Event code 3 (ABS_RX)
Value 0
Min -32768
Max 32767
Fuzz 16
Flat 128
Event code 4 (ABS_RY)
Value -1
Min -32768
Max 32767
Fuzz 16
Flat 128
Event code 5 (ABS_RZ)
Value 0
Min 0
Max 255
Event code 16 (ABS_HAT0X)
Value 0
Min -1
Max 1
Event code 17 (ABS_HAT0Y)
Value 0
Min -1
Max 1
Event type 21 (EV_FF)
Event code 80 (FF_RUMBLE)
Event code 81 (FF_PERIODIC)
Event code 88 (FF_SQUARE)
Event code 89 (FF_TRIANGLE)
Event code 90 (FF_SINE)
Event code 96 (FF_GAIN)
```
??? abstract "LCC (Turbo) Button"
``` bash title="/dev/input/event3: AT Translated Set 2 keyboard"
Event: time 1695132759.592781, type 4 (EV_MSC), code 4 (MSC_SCAN), value 1d
Event: time 1695132759.592781, type 1 (EV_KEY), code 29 (KEY_LEFTCTRL), value 1
Event: time 1695132759.592781, -------------- SYN_REPORT ------------
Event: time 1695132759.594824, type 4 (EV_MSC), code 4 (MSC_SCAN), value 38
Event: time 1695132759.594824, type 1 (EV_KEY), code 56 (KEY_LEFTALT), value 1
Event: time 1695132759.594824, -------------- SYN_REPORT ------------
Event: time 1695132759.597498, type 4 (EV_MSC), code 4 (MSC_SCAN), value 2a
Event: time 1695132759.597498, type 1 (EV_KEY), code 42 (KEY_LEFTSHIFT), value 1
Event: time 1695132759.597498, -------------- SYN_REPORT ------------
Event: time 1695132759.599549, type 4 (EV_MSC), code 4 (MSC_SCAN), value 14
Event: time 1695132759.599549, type 1 (EV_KEY), code 20 (KEY_T), value 1
```
## Additional References
- [Platform Documentation (AMD64)](https://github.com/JustEnoughLinuxOS/distribution/blob/main/documentation/PER_DEVICE_DOCUMENTATION/AMD64)
- [Device Quirks](https://github.com/JustEnoughLinuxOS/distribution/tree/main/packages/hardware/quirks/devices/ayn%20Loki%20Zero)
- [Panel Rotation](https://github.com/JustEnoughLinuxOS/distribution/blob/main/packages/kernel/linux/patches/AMD64/002-display-quirks.patch)