diff options
Diffstat (limited to 'Kernel/Graphics/DisplayConnector.h')
-rw-r--r-- | Kernel/Graphics/DisplayConnector.h | 144 |
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; +}; +} |