Merge pull request 'feature/boot.mgr' (#71 ) from feature/boot.mgr into develop

Reviewed-on: #71 Reviewed-by: Aaron Hance <[email protected]>
Fix unicode characters
2026-03-14 20:38:39 +00:00 · 2026-03-14 20:02:25 +00:00 · 2026-03-13 15:49:03 +00:00 · 2026-03-13 15:37:43 +00:00 · 2026-03-12 19:26:21 +00:00 · 2026-03-11 19:41:51 +00:00
502 changed files with 200033 additions and 13078 deletions
@@ -0,0 +1,96 @@
 kind: pipeline
 type: docker
 name: build
 steps:
  - name: build-image
    image: plugins/docker
    settings:
      repo: t3hn3rd/asuro-build
      tags: latest
      dockerfile: Dockerfile
      registry: docker.io
      username:
        from_secret: docker_username
      password:
        from_secret: docker_password
  - name: compile
    image: t3hn3rd/asuro-build:latest
    depends_on:
      - build-image
    commands:
      - git fetch --tags
      - find . -type f -print0 | xargs -0 dos2unix
      - chmod +x /drone/src/toolchain/*.sh
      - /drone/src/toolchain/compile.sh
  - name: deploy-docs
    image: alpine:latest
    depends_on:
      - compile
    when:
      branch:
        - master
        - develop
        - feature/mkdocs
    volumes:
      - name: docs-htdocs
        path: /htdocs
    commands:
      - apk add --no-cache rsync
      - |
        if [ "${DRONE_BRANCH}" = "master" ]; then
          DEST="/htdocs/master"
        else
          DEST="/htdocs/develop"
        fi
      - mkdir -p "$DEST"
      - rsync -a --delete site/ "$DEST/"
      - echo "Documentation deployed to ${DRONE_BRANCH}"
  - name: upload-iso-artifact
    image: alpine/git
    depends_on:
      - compile
    when:
      branch:
        - master
    environment:
      GITEA_TOKEN:
        from_secret: gitea_token
    commands:
      - apk add --no-cache curl
      - chmod +w Asuro.iso
      - cp Asuro.iso "Asuro-$(git rev-parse --short HEAD).iso"
      - echo "Uploading Asuro-$(git rev-parse --short HEAD).iso to Gitea Packages..."
      - |
         curl -X PUT "https://gitea.spexeah.com/api/packages/Spexeah/generic/asuro-iso/$(git rev-parse --short HEAD)/Asuro.iso" \
         -H "Authorization: token $GITEA_TOKEN" --upload-file "Asuro-$(git rev-parse --short HEAD).iso"
      - echo "Updating latest ISO reference..."
      - |
        curl -X DELETE https://gitea.spexeah.com/api/packages/Spexeah/generic/asuro-iso/latest/Asuro.iso \
        -H "Authorization: token $GITEA_TOKEN" || echo "No previous latest version found."
      - |
        curl -X PUT https://gitea.spexeah.com/api/packages/Spexeah/generic/asuro-iso/latest/Asuro.iso \
        -H "Authorization: token $GITEA_TOKEN" --upload-file "Asuro-$(git rev-parse --short HEAD).iso"
  - name: msg status
    image: appleboy/drone-discord
    failure: ignore
    depends_on:
      - compile
    when:
      status: [success, failure, changed]
    settings:
      webhook_id:
        from_secret: discord_webhook_id
      webhook_token:
        from_secret: discord_webhook_secret
      message: "**Asuro Build**\n\n{{#success build.status}}✅ Build successful!\n\n{{else}}❌ Build failed!\n\n{{/success}}Repository: `{{repo.namespace}}/{{repo.name}}`\nBranch: `{{commit.branch}}`\nCommit: `{{commit.sha}}`\nAuthor: `{{commit.author}} <{{commit.email}}>`\n\nGitea Diff: [Link](<{{commit.link}}>)\nDrone Build: [Link](<{{build.link}}>)\n\nMessage: {{commit.message}}"
 volumes:
  - name: docs-htdocs
    host:
      path: /mnt/user/htdocs/asuro_docs
@@ -1 +1,8 @@
-* text=auto eol=lf
+* text=auto eol=lf
 lvglh/** linguist-vendored
 lvgl/** linguist-vendored
 .vscode/* linguist-vendored
 lib/* linguist-generated
 release/* linguist-generated
 iso/* linguist-generated
 *.asm linguist-detectable
@@ -10,5 +10,13 @@
 /*.sh~
 /*.img
 src/include/asuro.pas
-.vscode/launch.json
+localenv.json
-.vscode
+/lvgl/
 dockerout.txt
 AGENTS.md
 lessons_learnt.md
 *.log
 wasuro
 src/core/core.version.pas
 site/*
 !site/.gitkeep
@@ -1,73 +0,0 @@
 stages:
  - Compile Versions
  - Compile Sources
  - Link
  - Generate Documentation
  - Deploy
 cache:
  - key: ${CI_COMMIT_REF_SLUG}
    paths:
      - lib/*.o
      - bin/kernel.bin
      - doc
 before_script:
  - chmod +x *.sh
 versions:
  stage: Compile Versions
  script:
    - ./compile_vergen.sh
  artifacts:
    paths:
      - release/*.svg
      - src/include/asuro.pas
 compile_sources:
  stage: Compile Sources
  script:
    - rm -f lib/*.so
    - ./compile_sources.sh
  needs:
    - versions
 link:
  stage: Link
  script:
    - ./compile_stub.sh
    - ./compile_link.sh
  needs:
    - versions
    - compile_sources
 isogen:
  stage: Deploy
  script:
    - ./compile_isogen.sh
    - ./compile_sumgen.sh
  artifacts:
    paths:
      - ./Asuro.iso
      - ./release/checksum.svg
  needs:
    - link
 docgen:
  stage: Generate Documentation
  only:
    - master
    - develop
  script:
    - ./compile_sourcelist.sh
    - ./compile_docs.sh
    # Remove comments when we want to use gitlab pages.
    #- cp doc public
  allow_failure: true
  artifacts:
    paths:
      - doc
      #- public/*
      #- ./sources.list
  needs:
    - versions
@@ -0,0 +1,13 @@
 # Map all Aaron identities to a single preferred identity
 Aaron Hance <[email protected]> aaron <aaron@6dbc8c32-bb84-406f-8558-d1cf31a0ab0c>
 Aaron Hance <[email protected]> aaronhance <[email protected]>
 Aaron Hance <[email protected]> aaron hance <[email protected]>
 Aaron Hance <[email protected]> Aaron <[email protected]>
 # Map all Kieron identities to a single preferred identity
 Kieron Morris <[email protected]> kieron <kieron@6dbc8c32-bb84-406f-8558-d1cf31a0ab0c>
 Kieron Morris <[email protected]> Kieron <[email protected]>
 Kieron Morris <[email protected]> t3hn3rd <[email protected]>
 # Map goose's multiple identities
 goose <goose@6dbc8c32-bb84-406f-8558-d1cf31a0ab0c> goose <[email protected]>
@@ -3,18 +3,11 @@
        {
            "name":"Run",
            "request": "launch",
-            "type": "coreclr",
+            "type": "PowerShell",
            "preLaunchTask": "Build",
-            "program": "VBoxSDL",
+            "script": "${workspaceFolder}/virtualbox-wrapper.ps1",
-            "args": [
+            "args": ["-Command", "up"],
                "--comment", 
                "Asuro", 
                "--startvm", 
                "7d395c96-891c-4139-b77d-9b6b144b0b93"
            ],
            "cwd": "${workspaceFolder}",
            "console": "internalConsole",
            "internalConsoleOptions": "neverOpen"
        }
    ]
 }
@@ -9,14 +9,18 @@
            "command": "docker-compose",
            "args": [
                "run",
-                "builder"
+                "builder",
            ],
            "type": "shell",
            "problemMatcher": [],
            "group": {
                "kind": "build",
                "isDefault": true
-            }
+            },
            "dependsOn": [
                "Close VirtualBox",
                "Clean"
            ]
        },
        {
            "label": "Build (Builder)",
@@ -26,6 +30,24 @@
                "builder"
            ],
            "type": "shell"
        },
        {
            "label": "Clean",
            "command": "docker-compose",
            "args": [
                "down",
                "--remove-orphans"
            ],
            "type": "shell"
        },
        {
            "label": "Close VirtualBox",
            "command": "./virtualbox-wrapper.ps1",
            "args": [
                "-Command", 
                "down"
            ],
            "type": "shell"
        }
    ]
 }
@@ -5,19 +5,21 @@ VOLUME ["/code"]
 ENV DEBIAN_FRONTEND=noninteractive
 RUN dpkg --add-architecture i386
 RUN apt-get update && apt-get install -y \
-	curl dos2unix wget git make nasm binutils:i386 xorriso grub-pc-bin && \
+	curl dos2unix wget git make nasm binutils xorriso grub-pc-bin gcc gcc-multilib \
 	python3 python3-pip python3-pil && \
 	apt-get clean my room
 RUN pip3 install --no-cache-dir --break-system-packages "mkdocs>=1.6,<2" mkdocs-material
 SHELL ["/bin/bash", "-c"]
-ARG FPC_VERSION=2.6.4
+ARG FPC_VERSION=3.2.2
 RUN curl -sL https://sourceforge.net/projects/freepascal/files/Linux/$FPC_VERSION/fpc-$FPC_VERSION.i386-linux.tar/download | tar -xf - && \
 	pushd fpc-$FPC_VERSION.i386-linux && ./install.sh && popd && \
 	rm -rf fpc-$FPC_VERSION.i386-linux
 COPY compile.sh /compile.sh
 ADD https://raw.githubusercontent.com/fsaintjacques/semver-tool/master/src/semver /usr/bin/semver
-RUN mkdir /code && chmod +x /usr/bin/semver
+RUN chmod +x /usr/bin/semver
 WORKDIR /code
 RUN find . -type f -print0 | xargs -0 dos2unix
 ENTRYPOINT ["/bin/bash", "-c"]
-CMD ["/compile.sh"]
+CMD ["find toolchain -name '*.sh' -exec dos2unix {} + 2>/dev/null; find toolchain -name '*.sh' -exec chmod +x {} +; bash toolchain/compile.sh"]
@@ -0,0 +1,75 @@
 { Compatibility shim: wasuro references the old unit name 'lmemorymanager'.
  Since wasuro/ cannot be modified, this unit re-exports the public API of
  memory.heap so that 'uses lmemorymanager' continues to compile. }
 unit lmemorymanager;
 interface
 uses
    memory.heap;
 const
    ALLOC_UNIT        = memory.heap.ALLOC_UNIT;
    DATA_OFFSET       = memory.heap.DATA_OFFSET;
    PAGE_SIZE_LMM     = memory.heap.PAGE_SIZE_LMM;
    TOTAL_UNITS       = memory.heap.TOTAL_UNITS;
    BITMAP_DWORDS     = memory.heap.BITMAP_DWORDS;
    SIZE_PREFIX       = memory.heap.SIZE_PREFIX;
    LARGE_ALLOC_MAGIC = memory.heap.LARGE_ALLOC_MAGIC;
 type
    PHeapPageHeader = memory.heap.PHeapPageHeader;
    THeapPageHeader = memory.heap.THeapPageHeader;
 procedure init;
 function kalloc(size : uint32) : void;
 function klalloc(size : uint32) : void;
 procedure klfree(address : uint32);
 function kpalloc(address : uint32) : void;
 procedure kfree(area : void);
 function lmm_total_free : uint32;
 function lmm_page_count : uint32;
 implementation
 procedure init;
 begin
    memory.heap.init;
 end;
 function kalloc(size : uint32) : void; inline;
 begin
    kalloc := memory.heap.kalloc(size);
 end;
 function klalloc(size : uint32) : void; inline;
 begin
    klalloc := memory.heap.klalloc(size);
 end;
 procedure klfree(address : uint32); inline;
 begin
    memory.heap.klfree(address);
 end;
 function kpalloc(address : uint32) : void; inline;
 begin
    kpalloc := memory.heap.kpalloc(address);
 end;
 procedure kfree(area : void); inline;
 begin
    memory.heap.kfree(area);
 end;
 function lmm_total_free : uint32; inline;
 begin
    lmm_total_free := memory.heap.lmm_total_free;
 end;
 function lmm_page_count : uint32; inline;
 begin
    lmm_page_count := memory.heap.lmm_page_count;
 end;
 end.
@@ -0,0 +1,7 @@
 unit types;
 interface
 implementation
 end.
@@ -1,45 +0,0 @@
 #!/usr/bin/env bash
 ERRCOUNT=0
 echo " "
 echo "======================="
 echo " "
 echo "Asuro Compilation"
 echo " "
 #Compile Stub.asm
 rm lib/*
 runOrFail() {
 	local binary=$1
 	local errorText=$2
 	if $binary; then
 		echo "Success."
 	else
 		echo "$errorText"
 		ERRCOUNT=$((ERRCOUNT+1))
 	fi
 }
 runOrFail $(pwd)/compile_stub.sh "Failed to compile stub!"
 #Generate .pas with versioning headers.
 runOrFail $(pwd)/compile_vergen.sh "Versions failed to compile"
 #Compile all .pas sources
 runOrFail $(pwd)/compile_sources.sh "Failed to compile FPC Sources!"
 #Link into a binary.
 runOrFail $(pwd)/compile_link.sh "Failed linking!"
 #Generate an ISO with GRUB as the Bootloader.
 runOrFail ./compile_isogen.sh "Failed to create ISO!"
 #Call generate final artifacts based on failure or success of the above.
 if [ "$ERRCOUNT" -ne "0" ]
 then
 	./compile_finish.sh "failed"
 else
 	./compile_finish.sh "success"
 fi
 cd ..
@@ -1,17 +0,0 @@
 #!/usr/bin/env bash
 echo " "
 echo "======================="
 echo " "
 echo "Generating Documentation..."
 echo " "
 echo "Dowloading Pasdoc..."
 wget https://github.com/pasdoc/pasdoc/releases/download/v0.16.0/pasdoc-0.16.0-linux-x86_64.tar.gz -O pasdoc.tar.gz
 echo "Extracting Pasdoc..."
 tar -xf pasdoc.tar.gz
 echo "Creating doc output directory..."
 mkdir ./doc
 echo "Removing old docs"
 rm -rf ./doc/*
 echo "Generating Docs..."
 ./pasdoc/bin/pasdoc -N "Asuro" -T "Asuro OS Documentation" -O "html" -E ./doc/ -S sources.list --use-tipue-search
 echo "Docgen finished."
@@ -1,7 +0,0 @@
 #!/usr/bin/env bash
 echo " "
 echo "======================="
 echo " "
 echo "Compiling FPC Sources..."
 echo " "
 fpc -Aelf -gw -n -va -O3 -Op3 -Si -Sc -Sg -Xd -CX -XXs -CfSSE -CfSSE2 -Rintel -Pi386 -Tlinux -FElib/ -Fusrc/* -Fusrc/driver/* -Fusrc/driver/net/* src/kernel.pas
@@ -1,7 +0,0 @@
 #!/usr/bin/env bash
 echo " "
 echo "======================="
 echo " "
 echo "Compiling Stub..."
 echo " "
 nasm -f elf src/stub/stub.asm -o lib/stub.o
@@ -0,0 +1,94 @@
 # lmemorymanager
 Compatibility shim that re-exports the `memory.heap` API under the legacy unit name.
 ## Overview
 The Wasuro WASM VM project references the old unit name `lmemorymanager` for heap memory operations. Because the Wasuro source tree cannot be modified, this shim unit re-exports every public symbol from `memory.heap` so that `uses lmemorymanager` continues to compile without changes. All functions are thin inline wrappers that delegate directly to their `memory.heap` counterparts.
 ## Dependencies
 - `memory.heap` -- the canonical heap allocator implementation in the Asuro kernel.
 ## Constants
 ### ALLOC_UNIT
 Re-exported from `memory.heap.ALLOC_UNIT`. The base allocation unit size used by the heap allocator.
 ### DATA_OFFSET
 Re-exported from `memory.heap.DATA_OFFSET`. Byte offset from a heap block header to the start of user data.
 ### PAGE_SIZE_LMM
 Re-exported from `memory.heap.PAGE_SIZE_LMM`. Page size used by the lightweight memory manager.
 ### TOTAL_UNITS
 Re-exported from `memory.heap.TOTAL_UNITS`. Total number of allocation units per heap page.
 ### BITMAP_DWORDS
 Re-exported from `memory.heap.BITMAP_DWORDS`. Number of 32-bit words in the per-page allocation bitmap.
 ### SIZE_PREFIX
 Re-exported from `memory.heap.SIZE_PREFIX`. Size of the prefix stored before each allocation to record its length.
 ### LARGE_ALLOC_MAGIC
 Re-exported from `memory.heap.LARGE_ALLOC_MAGIC`. Magic value used to identify large (multi-page) allocations.
 ## Types
 ### PHeapPageHeader / THeapPageHeader
 Re-exported from `memory.heap`. Pointer and record types describing the header structure at the beginning of each heap page.
 ## Functions and Procedures
 ### init
 ```pascal
 procedure init;
 ```
 Initializes the heap memory manager by delegating to `memory.heap.init`.
 ### kalloc
 ```pascal
 function kalloc(size: uint32): void;
 ```
 Allocates `size` bytes from the kernel heap and returns a pointer to the allocated memory.
 ### klalloc
 ```pascal
 function klalloc(size: uint32): void;
 ```
 Performs a large kernel allocation of `size` bytes and returns a pointer to the allocated memory.
 ### klfree
 ```pascal
 procedure klfree(address: uint32);
 ```
 Frees a large allocation previously obtained via `klalloc`.
 ### kpalloc
 ```pascal
 function kpalloc(address: uint32): void;
 ```
 Allocates a heap page at the specified address and returns a pointer to it.
 ### kfree
 ```pascal
 procedure kfree(area: void);
 ```
 Frees a standard allocation previously obtained via `kalloc`.
 ### lmm_total_free
 ```pascal
 function lmm_total_free: uint32;
 ```
 Returns the total number of free bytes available across all heap pages.
 ### lmm_page_count
 ```pascal
 function lmm_page_count: uint32;
 ```
 Returns the current number of heap pages managed by the allocator.
 ## Notes
 - Every function and procedure in the implementation section is marked `inline`, so the compiler eliminates the wrapper overhead entirely.
 - This unit exists solely for backward compatibility with the Wasuro WASM VM build. New kernel code should use `memory.heap` directly.
@@ -0,0 +1,16 @@
 # types
 Empty compatibility shim that satisfies `uses types` references from the Wasuro WASM VM project.
 ## Overview
 Some units in the Wasuro WASM VM source tree include `uses types` to pull in shared type definitions from the Asuro kernel. In the kernel proper, those types may be declared elsewhere or may no longer be needed in the WASM context. This stub unit provides an empty `types` compilation unit so that `uses types` resolves without error during the Wasuro build.
 ## Dependencies
 None.
 ## Notes
 - The unit declares no constants, types, variables, or routines. Its only purpose is to exist as a valid compilation unit.
 - If Wasuro code is ever updated to remove the `uses types` dependency, this shim can be deleted.
@@ -0,0 +1,32 @@
 # Asuro OS
 Asuro is a 32-bit x86 operating system kernel written in Free Pascal and x86 assembly.
 ## Documentation Structure
 - **Kernel Entry** -- The `asuro.pas` main unit and boot sequence.
 - **Architecture (x86)** -- CPU initialization, descriptor tables, interrupt handling, fault handlers, memory management, and process scheduling for the i386 target.
 - **Boot** -- Splash screen and early boot visuals.
 - **Core** -- Foundational libraries including data structures, encoding algorithms, string handling, graphics primitives, and the kernel panic subsystem.
 - **Memory** -- Heap allocator (`kalloc`/`kfree`) and page-level allocation.
 - **Processes** -- Process lifecycle, round-robin scheduling, and inter-process messaging.
 - **I/O** -- Standard I/O (shell command dispatch) and the system log fan-out.
 - **Debug** -- Execution tracer with ring-buffer call stack recording.
 - **Drivers** -- Hardware abstraction covering PCI/USB buses, HID devices, networking (E1000, TCP/IP stack), storage (IDE, AHCI, VFS, file systems), video (VESA, LVGL, double-buffering), serial I/O, and timers.
 - **Services** -- Background daemons for graphics rendering and USB hotplug.
 - **Applications** -- Userland commands and utilities: terminal, text editor, disk tools, network tools, and a WebAssembly runtime.
 - **Compatibility** -- Shim layers for legacy code.
 - **LVGL Headers** -- Configuration and patches for the LVGL v9.2.2 GUI library.
 - **Planning** -- Design documents and architectural notes for subsystems under development.
 - **Toolchain** -- Build pipeline documentation covering compilation, linking, and ISO generation.
 ## Building
 The kernel is built inside Docker using a containerized FreePascal 3.2.2 toolchain:
 ```bash
 docker compose build builder
 docker compose run builder
 ```
 The documentation site will be available at `http://docs.asuro.xyz`.
@@ -0,0 +1,53 @@
 # hack_14.c
 LVGL bitmap font source for the Hack Regular typeface at 14 px.
 ## Overview
 This file contains a pre-rendered bitmap font generated from the Hack Regular TrueType font (`Hack-Regular.ttf`) for use with LVGL. It provides a complete monospaced programmer font covering the full Basic Multilingual Plane (Unicode range 0x0000--0xFFFF). The font is intended for use in terminal emulators, code editors, or any UI element within Asuro that benefits from a fixed-width typeface.
 The file was generated by the LVGL font converter tool and is approximately 12,900 lines (~548 KB) of static bitmap and glyph descriptor data.
 ## Configuration Options / Defines
 ### HACK_14
 Value: `1` (default). Acts as a compile-time guard. Set to `0` to exclude this font from the build entirely.
 ## Font Properties
 | Property | Value |
 |----------|-------|
 | Font family | Hack Regular |
 | Size | 14 px |
 | Bits per pixel | 4 (16-level anti-aliasing) |
 | Compression | None (`--no-compress`) |
 | Stride alignment | 1 byte |
 | Data alignment | 1 byte |
 | Line height | 19 px |
 | Baseline | 5 px from bottom |
 | Underline position | -2 |
 | Underline thickness | 1 |
 | Unicode range | 0x0000--0xFFFF |
 | Subpixel rendering | None |
 ## Public Symbol
 ```c
 const lv_font_t hack_14;
 ```
 This is the font descriptor exposed for use in LVGL widget styles. Reference it as `&hack_14` when assigning fonts to labels, text areas, or other text-bearing widgets.
 ## Generation Command
 ```
 --bpp 4 --size 14 --no-compress --stride 1 --align 1 \
 --font Hack-Regular.ttf --range 0-65535 --format lvgl -o hack_14.c
 ```
 ## Notes
 - This is a machine-generated file. Do not edit by hand; regenerate using the LVGL font converter if changes are needed.
 - The full 0--65535 Unicode range makes this a large file. If binary size is a concern, the range could be narrowed to only the code points actually used.
 - The font includes version-conditional compilation guards for compatibility across LVGL 6.x through 9.x, though Asuro targets LVGL 9.2.2.
 - The `LV_ATTRIBUTE_LARGE_CONST` annotation on the glyph bitmap array allows the linker to place it in an appropriate read-only section.
@@ -0,0 +1,133 @@
 # lv_conf.h
 LVGL v9.2.2 configuration header tailored for the Asuro bare-metal kernel environment.
 ## Overview
 This file configures the LVGL graphics library for use inside the Asuro kernel, where no standard C library, operating system, or GPU hardware is available. It selects a 32-bit XRGB8888 color depth to match the VESA framebuffer, routes all stdlib functionality through LVGL's built-in implementations, enables only the software renderer, and disables every hardware backend, filesystem driver, and image decoder. The result is a minimal but functional GUI stack that runs entirely in kernel space.
 ## Configuration Options / Defines
 ### Color Settings
 #### LV_COLOR_DEPTH
 Value: `32`. Matches the VESA XRGB8888 framebuffer used by Asuro.
 ### Standard Library Wrappers
 #### LV_USE_STDLIB_MALLOC / LV_USE_STDLIB_STRING / LV_USE_STDLIB_SPRINTF
 Value: `LV_STDLIB_BUILTIN`. All three are set to use LVGL's own built-in implementations since no libc is available in the bare-metal environment.
 ### Memory Pool
 #### LV_MEM_SIZE
 Value: `256 * 1024U` (256 KB). Size of LVGL's internal memory pool for widget allocations and draw buffers.
 #### LV_MEM_POOL_EXPAND_SIZE
 Value: `0`. Pool expansion is disabled; the 256 KB allocation is fixed.
 #### LV_MEM_ADR
 Value: `0`. LVGL allocates the pool itself rather than using a fixed address.
 ### HAL Settings
 #### LV_DEF_REFR_PERIOD
 Value: `33` (milliseconds). Targets approximately 30 frames per second.
 #### LV_DPI_DEF
 Value: `96`. Standard screen DPI assumption.
 ### Operating System
 #### LV_USE_OS
 Value: `LV_OS_NONE`. No OS abstraction layer; LVGL runs in a bare-metal cooperative model.
 ### Rendering Configuration
 #### LV_USE_DRAW_SW
 Value: `1`. The software renderer is the sole rendering backend.
 Only the color formats actually used are enabled within the software renderer:
 | Define | Value | Description |
 |--------|-------|-------------|
 | `LV_DRAW_SW_SUPPORT_XRGB8888` | 1 | Primary framebuffer format |
 | `LV_DRAW_SW_SUPPORT_ARGB8888` | 1 | Alpha-blended surfaces |
 | `LV_DRAW_SW_SUPPORT_RGB888` | 1 | 24-bit fallback |
 | `LV_DRAW_SW_SUPPORT_RGB565` | 0 | Disabled |
 | All other formats | 0 | Disabled |
 #### LV_DRAW_SW_COMPLEX
 Value: `1`. Enables complex draw operations (shadows, rounded corners). Shadow cache is disabled (`LV_DRAW_SW_SHADOW_CACHE_SIZE = 0`); circle cache is set to 4 entries.
 #### LV_DRAW_LAYER_SIMPLE_BUF_SIZE
 Value: `24 * 1024` (24 KB). Buffer for simple layer rendering.
 #### GPU Backends
 All GPU-accelerated backends are disabled: VGLite, PXP, Dave2D, SDL, VG-Lite.
 ### Logging
 #### LV_USE_LOG
 Value: `1`. Logging is enabled at `LV_LOG_LEVEL_WARN`. Printf-based logging, timestamps, and file/line info are all disabled to reduce overhead. All trace categories (memory, timer, indev, display refresh, events, object creation, layout, animation, cache) are disabled.
 ### Assertions
 #### LV_USE_ASSERT_NULL / LV_USE_ASSERT_MALLOC
 Value: `1`. Null-pointer and malloc-failure assertions are active.
 #### LV_ASSERT_HANDLER
 Value: `{}` (no-op). The assert handler intentionally does nothing to avoid hanging the kernel on a failed assertion.
 ### Fonts
 #### LV_FONT_MONTSERRAT_14
 Value: `1`. The only built-in Montserrat size enabled.
 #### LV_FONT_DEFAULT
 Value: `&lv_font_montserrat_14`. All other Montserrat sizes (8--48), compressed variants, and alternative font families (DejaVu, SimSun, UNSCII) are disabled.
 ### Text Settings
 #### LV_TXT_ENC
 Value: `LV_TXT_ENC_UTF8`. UTF-8 text encoding. BiDi and Arabic/Persian character support are disabled.
 ### Widgets
 Enabled widgets: AnimImg, Arc, Bar, Button, ButtonMatrix, Checkbox, Dropdown, Image, Keyboard, Label, Line, List, MsgBox, Roller, Slider, Spinner, Switch, TextArea, Table, TabView, Win.
 Disabled widgets: Calendar, Canvas, Chart, ImageButton, LED, Lottie, Menu, Scale, Span, SpinBox, TileView.
 ### Themes
 #### LV_USE_THEME_DEFAULT
 Value: `1`. Dark mode enabled (`LV_THEME_DEFAULT_DARK = 1`) with 80 ms transition time.
 #### LV_USE_THEME_SIMPLE
 Value: `1`.
 #### LV_USE_THEME_MONO
 Value: `0`.
 ### Layouts
 Both Flex and Grid layout engines are enabled.
 ### Third-Party Libraries
 All filesystem drivers are disabled (stdio, POSIX, Win32, FatFS, MemFS, LittleFS). All image decoders are disabled (PNG, BMP, JPEG, GIF, RLE). FreeType, TinyTTF, Rlottie, vector graphics, LZ4, and FFmpeg are all disabled.
 ### Device Drivers
 All platform-specific device drivers are disabled (SDL, X11, Wayland, Linux FBDEV, Linux DRM, NuttX, various SPI display controllers, Windows, OpenGLES, QNX). Display and input are handled by Asuro's own HAL layer.
 ### Examples and Demos
 All built-in examples and demo applications are disabled.
 ## Notes
 - The configuration is designed for minimal footprint. Features are enabled only when required by the Asuro desktop shell.
 - Since no libc is linked, all string, memory, and formatting operations fall through to LVGL's internal implementations.
 - The assert handler is a deliberate no-op to prevent the kernel from halting on non-critical UI assertion failures.
 - The 256 KB memory pool is fixed and cannot expand at runtime. UI complexity must stay within this budget.
--- a/Show More
+++ b/Show More