[PATCH] Documentation: devel: project-ideas: add SDL input support

[PATCH] Documentation: devel: project-ideas: add SDL input support

[Ahmad Fatoum]

For developing barebox, it's often useful to run barebox directly as
userspace program by compiling it for the sandbox architecture, but
there is no input driver for sandbox yet although we have a virtio input
drive.

Add SDL input as project idea.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/devel/project-ideas.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/Documentation/devel/project-ideas.rst b/Documentation/devel/project-ideas.rst
index 8d6b5d6e584a..7ca827a6538e 100644
--- a/Documentation/devel/project-ideas.rst
+++ b/Documentation/devel/project-ideas.rst
@@ -198,3 +198,29 @@ hardware and tutorial is extended to make use of the new peripherals.
 
 This project does not require dedicated hardware. The development
 machine need only support a recent browser.
+
+Add Sandbox SDL input support
+=============================
+
+Skills: C (Basics). Difficulty: Lowest
+
+barebox on real hardware has multiple possible input method: buttons,
+keypads and even USB keyboards allow controlling barebox beyond what
+a serial console provides.
+
+For virtualized targets, barebox has ``virtio_input`` support, which
+JSBarebox uses to move the DOOM guy around.
+
+For developing barebox, it's often useful to run barebox directly as
+userspace program by compiling it for the ``sandbox`` architecture.
+
+This mode of operation can already use SDL 2.0 for video and sound
+and it would be nice to extend it with input support.
+
+As SDL is handled in a separate thread, this means we need a thread-safe
+FIFO, where the SDL thread would queue input events and barebox would
+dequeue events on the other side as they are polled.
+
+As the code will have a SDL 2.0 dependency anyway, it should probably
+make use of SDL 2.0 mutex/condition variables API for serializing
+accesses to the FIFO.
-- 
2.39.5

Re: [PATCH] Documentation: devel: project-ideas: add SDL input support

[Sascha Hauer]

On Mon, 16 Dec 2024 12:33:44 +0100, Ahmad Fatoum wrote:
> For developing barebox, it's often useful to run barebox directly as
> userspace program by compiling it for the sandbox architecture, but
> there is no input driver for sandbox yet although we have a virtio input
> drive.
> 
> Add SDL input as project idea.
> 
> [...]

Applied, thanks!

[1/1] Documentation: devel: project-ideas: add SDL input support
      https://git.pengutronix.de/cgit/barebox/commit/?id=4134c02f0599 (link may not be stable)

Best regards,
-- 
Sascha Hauer <s.hauer@pengutronix.de>