summaryrefslogtreecommitdiff
path: root/Kernel/Graphics/DisplayConnector.h
diff options
context:
space:
mode:
Diffstat (limited to 'Kernel/Graphics/DisplayConnector.h')
-rw-r--r--Kernel/Graphics/DisplayConnector.h144
1 files changed, 144 insertions, 0 deletions
diff --git a/Kernel/Graphics/DisplayConnector.h b/Kernel/Graphics/DisplayConnector.h
new file mode 100644
index 0000000000..ee01d7cdf4
--- /dev/null
+++ b/Kernel/Graphics/DisplayConnector.h
@@ -0,0 +1,144 @@
+/*
+ * Copyright (c) 2022, Liav A. <liavalb@hotmail.co.il>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <AK/Types.h>
+#include <Kernel/Devices/CharacterDevice.h>
+#include <LibC/sys/ioctl_numbers.h>
+#include <LibEDID/EDID.h>
+
+namespace Kernel {
+
+class GraphicsManagement;
+class DisplayConnector : public CharacterDevice {
+ friend class GraphicsManagement;
+ friend class DeviceManagement;
+
+public:
+ struct ModeSetting {
+ size_t horizontal_blanking_start() const
+ {
+ return horizontal_active;
+ }
+ size_t horizontal_sync_start() const
+ {
+ return horizontal_active + horizontal_front_porch_pixels;
+ }
+ size_t horizontal_sync_end() const
+ {
+ return horizontal_active + horizontal_front_porch_pixels + horizontal_sync_time_pixels;
+ }
+ size_t horizontal_total() const
+ {
+ return horizontal_active + horizontal_blank_pixels;
+ }
+
+ size_t vertical_blanking_start() const
+ {
+ return vertical_active;
+ }
+ size_t vertical_sync_start() const
+ {
+ return vertical_active + vertical_front_porch_lines;
+ }
+ size_t vertical_sync_end() const
+ {
+ return vertical_active + vertical_front_porch_lines + vertical_sync_time_lines;
+ }
+ size_t vertical_total() const
+ {
+ return vertical_active + vertical_blank_lines;
+ }
+
+ size_t horizontal_stride; // Note: This is commonly known as "pitch"
+ size_t pixel_clock_in_khz;
+
+ size_t horizontal_active;
+ size_t horizontal_front_porch_pixels;
+ size_t horizontal_sync_time_pixels;
+ size_t horizontal_blank_pixels;
+
+ size_t vertical_active;
+ size_t vertical_front_porch_lines;
+ size_t vertical_sync_time_lines;
+ size_t vertical_blank_lines;
+
+ size_t horizontal_offset; // Note: This is commonly known as "x offset"
+ size_t vertical_offset; // Note: This is commonly known as "y offset"
+ };
+
+public:
+ enum class DisplayMode {
+ Graphical,
+ Console,
+ };
+
+public:
+ virtual ~DisplayConnector() = default;
+
+ virtual bool mutable_mode_setting_capable() const = 0;
+ virtual bool double_framebuffering_capable() const = 0;
+ virtual bool flush_support() const = 0;
+ virtual bool partial_flush_support() const = 0;
+ // Note: This can indicate to userland if the underlying hardware requires
+ // a defined refresh rate being supplied when modesetting the screen resolution.
+ // Paravirtualized hardware don't need such setting and can safely ignore this.
+ virtual bool refresh_rate_support() const = 0;
+
+ bool console_mode() const;
+ ErrorOr<ByteBuffer> get_edid() const;
+ virtual ErrorOr<void> set_mode_setting(ModeSetting const&) = 0;
+ virtual ErrorOr<void> set_safe_mode_setting() = 0;
+ ModeSetting current_mode_setting() const;
+ virtual ErrorOr<void> set_y_offset(size_t y) = 0;
+ virtual ErrorOr<void> unblank() = 0;
+
+ void set_display_mode(Badge<GraphicsManagement>, DisplayMode);
+
+protected:
+ void set_edid_bytes(Array<u8, 128> const& edid_bytes);
+
+ // ^File
+ virtual bool is_seekable() const override { return true; }
+ virtual bool can_read(OpenFileDescription const&, u64) const final override { return true; }
+ virtual bool can_write(OpenFileDescription const&, u64) const final override { return true; }
+ virtual ErrorOr<size_t> read(OpenFileDescription&, u64, UserOrKernelBuffer&, size_t) override final;
+ virtual ErrorOr<size_t> write(OpenFileDescription&, u64, UserOrKernelBuffer const&, size_t) override final;
+ virtual ErrorOr<Memory::Region*> mmap(Process&, OpenFileDescription&, Memory::VirtualRange const&, u64, int, bool) override final;
+ virtual ErrorOr<void> ioctl(OpenFileDescription&, unsigned request, Userspace<void*> arg) override final;
+ virtual StringView class_name() const override final { return "DisplayConnector"sv; }
+
+ DisplayConnector();
+ virtual ErrorOr<size_t> write_to_first_surface(u64 offset, UserOrKernelBuffer const&, size_t length) = 0;
+ virtual void enable_console() = 0;
+ virtual void disable_console() = 0;
+ virtual ErrorOr<void> flush_first_surface() = 0;
+ virtual ErrorOr<void> flush_rectangle(size_t buffer_index, FBRect const& rect);
+
+ ErrorOr<void> initialize_edid_for_generic_monitor();
+
+ mutable Spinlock m_control_lock;
+ mutable Mutex m_flushing_lock;
+
+ bool m_console_mode { false };
+
+ bool m_vertical_offsetted { false };
+
+ mutable Spinlock m_modeset_lock;
+ ModeSetting m_current_mode_setting {};
+
+ Optional<EDID::Parser> m_edid_parser;
+ EDID::Parser::RawBytes m_edid_bytes {};
+ bool m_edid_valid { false };
+
+private:
+ virtual void will_be_destroyed() override;
+ virtual void after_inserting() override;
+
+ IntrusiveListNode<DisplayConnector, RefPtr<DisplayConnector>> m_list_node;
+};
+}