From 2328f889ef3f48f985d6cea16cdba8a203bbcc50 Mon Sep 17 00:00:00 2001
From: Matheus <matheusuky@gmail.com>
Date: Wed, 9 Sep 2026 16:37:15 -0300
Subject: [PATCH] kernel: firmware loading

---
 firmware/LICENCE.rtlwifi_firmware.txt |  39 ++++++++++
 firmware/rtl8188eufw.bin              | Bin 0 -> 15262 bytes
 kernel-src/include/kernel/firmware.h  |  11 +++
 kernel-src/io/firmware.c              |  99 ++++++++++++++++++++++++++
 recipes/firmware                      |   8 +++
 source-recipes/firmware               |   3 +
 6 files changed, 160 insertions(+)
 create mode 100644 firmware/LICENCE.rtlwifi_firmware.txt
 create mode 100644 firmware/rtl8188eufw.bin
 create mode 100644 kernel-src/include/kernel/firmware.h
 create mode 100644 kernel-src/io/firmware.c
 create mode 100644 recipes/firmware
 create mode 100644 source-recipes/firmware

diff --git a/firmware/LICENCE.rtlwifi_firmware.txt b/firmware/LICENCE.rtlwifi_firmware.txt
new file mode 100644
index 00000000..d70921f4
--- /dev/null
+++ b/firmware/LICENCE.rtlwifi_firmware.txt
@@ -0,0 +1,39 @@
+Copyright (c) 2010, Realtek Semiconductor Corporation 
+All rights reserved.
+
+Redistribution.  Redistribution and use in binary form, without 
+modification, are permitted provided that the following conditions are 
+met:
+
+* Redistributions must reproduce the above copyright notice and the 
+  following disclaimer in the documentation and/or other materials 
+  provided with the distribution. 
+* Neither the name of Realtek Semiconductor Corporation nor the names of its
+  suppliers may be used to endorse or promote products derived from this
+  software without specific prior written permission. 
+* No reverse engineering, decompilation, or disassembly of this software 
+  is permitted.
+
+Limited patent license. Realtek Semiconductor Corporation grants a world-wide, 
+royalty-free, non-exclusive license under patents it now or hereafter 
+owns or controls to make, have made, use, import, offer to sell and 
+sell ("Utilize") this software, but solely to the extent that any 
+such patent is necessary to Utilize the software alone, or in 
+combination with an operating system licensed under an approved Open 
+Source license as listed by the Open Source Initiative at 
+http://opensource.org/licenses.  The patent license shall not apply to 
+any other combinations which include this software.  No hardware per 
+se is licensed hereunder.
+
+DISCLAIMER.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND 
+CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, 
+BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 
+COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 
+OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR 
+TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 
+USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 
+DAMAGE.
diff --git a/firmware/rtl8188eufw.bin b/firmware/rtl8188eufw.bin
new file mode 100644
index 0000000000000000000000000000000000000000..8bb12ea88246d2e7060a46bdeef61800c1ed1881
GIT binary patch
literal 15262
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

literal 0
HcmV?d00001

diff --git a/kernel-src/include/kernel/firmware.h b/kernel-src/include/kernel/firmware.h
new file mode 100644
index 00000000..e0b48c86
--- /dev/null
+++ b/kernel-src/include/kernel/firmware.h
@@ -0,0 +1,11 @@
+#ifndef _FIRMWARE_H
+#define _FIRMWARE_H
+
+#include <stddef.h>
+
+typedef void (*firmware_callback_t)(void *ctx, void *data, size_t size);
+
+// firmware data is only valid only for the duration of the callback
+int firmware_load(const char *name, firmware_callback_t callback, void *ctx);
+
+#endif
diff --git a/kernel-src/io/firmware.c b/kernel-src/io/firmware.c
new file mode 100644
index 00000000..87e9dd32
--- /dev/null
+++ b/kernel-src/io/firmware.c
@@ -0,0 +1,99 @@
+#include <kernel/firmware.h>
+#include <kernel/vfs.h>
+#include <kernel/alloc.h>
+#include <errno.h>
+
+#define FIRMWARE_SIZE_LIMIT (16 * 1024)
+#define FIRMWARE_PATH "/usr/lib/firmware/"
+
+typedef struct {
+	const char *name;
+	firmware_callback_t callback;
+	void *ctx;
+} firmware_ctx_t;
+
+static void do_load(void *ctx) {
+	firmware_ctx_t *fc = ctx;
+	printf("firmware: loading \"%s\"\n", fc->name);
+
+	vnode_t *firmware_dir;
+	int error = vfs_lookup(&firmware_dir, vfsroot, FIRMWARE_PATH, NULL, 0);
+	if (error) {
+		printf("firmware: loading \"%s\" failed: failed to open %s (%s)\n",
+			       	fc->name, FIRMWARE_PATH, strerror(error));
+		goto leave;
+	}
+
+	VOP_UNLOCK(firmware_dir); // vfs_lookup returns vnode locked
+
+	vnode_t *firmware_file;
+	error = vfs_lookup(&firmware_file, firmware_dir, fc->name, NULL, 0);
+	VOP_RELEASE(firmware_dir);
+	if (error) {
+		printf("firmware: loading \"%s\" failed: failed to open file (%s)\n", 
+				fc->name, strerror(error));
+		goto leave;
+	}
+
+	vattr_t vattr;
+	error = VOP_GETATTR(firmware_file, &vattr, NULL);
+	VOP_UNLOCK(firmware_file);
+	if (error)
+		goto leave_release;
+
+	if (vattr.size >= FIRMWARE_SIZE_LIMIT) {
+		error = EINVAL;
+		goto leave_release;
+	}
+
+	void *buffer = alloc(vattr.size);
+	if (buffer == NULL) {
+		error = ENOMEM;
+		goto leave_release;
+	}
+
+	size_t bytes_read;
+	error = vfs_read(firmware_file, buffer, vattr.size, 0, &bytes_read, 0); 
+	if (error)
+		goto leave_free;
+
+	if (bytes_read != vattr.size) {
+		error = EINVAL;
+		goto leave_free;
+	}
+
+	printf("firmware: \"%s\" loaded\n", fc->name);
+	fc->callback(fc->ctx, buffer, vattr.size);
+
+leave_free:
+	free(buffer);
+leave_release:
+	if (error) {
+		printf("firmware: loading \"%s\" failed: %s\n", 
+				fc->name, strerror(error));
+	}
+	VOP_RELEASE(firmware_file);
+leave:
+	free(fc);
+}
+
+int firmware_load(const char *name, firmware_callback_t callback, void *ctx) {
+	// TODO: support kernel embedded firmware
+	firmware_ctx_t *fc = alloc(sizeof(firmware_ctx_t));
+	if (fc == NULL)
+		return ENOMEM;
+
+	fc->name = name;
+	fc->callback = callback;
+	fc->ctx = ctx;
+
+	int error = vfs_root_event_attach(do_load, fc);
+	if (error && error != EBUSY) {
+		free(fc);
+		return error;
+	} else if (error == EBUSY) {
+		do_load(fc);
+	}
+
+	return 0;
+}
diff --git a/recipes/firmware b/recipes/firmware
new file mode 100644
index 00000000..29641f82
--- /dev/null
+++ b/recipes/firmware
@@ -0,0 +1,8 @@
+name=firmware
+revision=1
+from_source=firmware
+
+package() {
+	mkdir -p ${dest_dir}/usr/lib/firmware
+	cp -r ${source_dir}/* ${dest_dir}/usr/lib/firmware
+}
diff --git a/source-recipes/firmware b/source-recipes/firmware
new file mode 100644
index 00000000..0cdf23fb
--- /dev/null
+++ b/source-recipes/firmware
@@ -0,0 +1,3 @@
+name=firmware
+version=0
+source_dir="firmware"