-
Notifications
You must be signed in to change notification settings - Fork 0
Controlling Device
Navigating KryonOS is designed to be intuitive, relying heavily on the touch screen interface.
When you boot KryonOS, you are greeted by the Launcher.
To launch an app, simply tap its icon in the Launcher. The OS will parse the app's app.json metadata, load its JavaScript file, and hand over control to the JS engine.
Tip
App Installation Guide: You can develop your own JS app, put it in a folder, and install it manually by copying it to your SD Card or the internal LittleFS storage. However, you can also use the Built-in App Store to download and install community apps and games. The App Store is the easiest and recommended way to get JavaScript Apps And Games!
While KryonOS does not run multiple JS apps simultaneously (due to RAM constraints), it provides a fast multitasking feel.
When you want to exit an app, you can usually tap a designated close button (often rendered as an X in the top right corner) or trigger an interrupt, which suspends the JS execution and immediately drops you back to the Launcher.
The system monitor allows you to view real-time data about your ESP32:
- Free Heap (RAM): Crucial for knowing how much memory your JS apps can use.
- Uptime: How long the device has been running.
- Wi-Fi Status: Connection strength and IP address.
The file explorer lets you navigate the SD card structure. You can tap on .js files to open them in the built-in Text Editor, or manage your app directories directly on the device.
If an app consumes too much memory (e.g., trying to parse massive JSON files or creating too many sprites), the kernel will intercept the crash and display a red "Out Of RAM Error" screen.
How to recover: Tap the X button on the error screen to reboot the device or return to the launcher safely. To avoid this, apps should be written to stream data rather than loading it all into memory at once.