mirror of
https://github.com/RGBCube/serenity
synced 2025-05-31 12:08:12 +00:00
6efa27537a
We have 3 new components: 1. The AudioManagement singleton. This class like in other subsystems, is responsible to find hardware audio controllers and keep a reference to them. 2. AudioController class - this class is the parent class for hardware controllers like the Sound Blaster 16 or Intel 82801AA (AC97). For now, this class has simple interface for getting and controlling sample rate of audio channels, as well a write interface for specific audio channel but not reading from it. One AudioController object might have multiple AudioChannel "child" objects to hold with reference counting. 3. AudioChannel class - this is based on the CharacterDevice class, and represents hardware PCM audio channel. It facilitates an ioctl interface which should be consistent across all supported hardware currently. It has a weak reference to a parent AudioController, and when trying to write to a channel, it redirects the data to the parent AudioController. Each audio channel device should be added into a new directory under the /dev filesystem called "audio".
82 lines
2.5 KiB
C++
82 lines
2.5 KiB
C++
/*
|
|
* Copyright (c) 2021, Liav A. <liavalb@hotmail.co.il>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/Badge.h>
|
|
#include <AK/Error.h>
|
|
#include <AK/NonnullRefPtrVector.h>
|
|
#include <AK/OwnPtr.h>
|
|
#include <AK/RefPtr.h>
|
|
#include <AK/Time.h>
|
|
#include <AK/Types.h>
|
|
#include <Kernel/API/DeviceEvent.h>
|
|
#include <Kernel/API/TimePage.h>
|
|
#include <Kernel/Arch/RegisterState.h>
|
|
#include <Kernel/Devices/CharacterDevice.h>
|
|
#include <Kernel/Devices/ConsoleDevice.h>
|
|
#include <Kernel/Devices/Device.h>
|
|
#include <Kernel/Devices/DeviceControlDevice.h>
|
|
#include <Kernel/Devices/NullDevice.h>
|
|
#include <Kernel/UnixTypes.h>
|
|
|
|
namespace Kernel {
|
|
|
|
class DeviceManagement {
|
|
|
|
public:
|
|
DeviceManagement();
|
|
static void initialize();
|
|
static DeviceManagement& the();
|
|
void attach_null_device(NullDevice const&);
|
|
|
|
void attach_device_control_device(DeviceControlDevice const&);
|
|
|
|
bool is_console_device_attached() const { return !m_console_device.is_null(); }
|
|
void attach_console_device(ConsoleDevice const&);
|
|
|
|
Optional<DeviceEvent> dequeue_top_device_event(Badge<DeviceControlDevice>);
|
|
|
|
void after_inserting_device(Badge<Device>, Device&);
|
|
void before_device_removal(Badge<Device>, Device&);
|
|
|
|
void for_each(Function<void(Device&)>);
|
|
Device* get_device(MajorNumber major, MinorNumber minor);
|
|
|
|
NullDevice const& null_device() const;
|
|
NullDevice& null_device();
|
|
|
|
ConsoleDevice const& console_device() const;
|
|
ConsoleDevice& console_device();
|
|
|
|
template<typename DeviceType, typename... Args>
|
|
static inline ErrorOr<NonnullRefPtr<DeviceType>> try_create_device(Args&&... args) requires(requires(Args... args) { DeviceType::try_create(args...); })
|
|
{
|
|
auto device = TRY(DeviceType::try_create(forward<Args>(args)...));
|
|
device->after_inserting();
|
|
return device;
|
|
}
|
|
|
|
template<typename DeviceType, typename... Args>
|
|
static inline ErrorOr<NonnullRefPtr<DeviceType>> try_create_device(Args&&... args)
|
|
{
|
|
auto device = TRY(adopt_nonnull_ref_or_enomem(new (nothrow) DeviceType(forward<Args>(args)...)));
|
|
device->after_inserting();
|
|
return device;
|
|
}
|
|
|
|
private:
|
|
RefPtr<NullDevice> m_null_device;
|
|
RefPtr<ConsoleDevice> m_console_device;
|
|
RefPtr<DeviceControlDevice> m_device_control_device;
|
|
// FIXME: Once we have a singleton for managing many sound cards, remove this from here
|
|
SpinlockProtected<HashMap<u64, Device*>> m_devices;
|
|
|
|
mutable Spinlock m_event_queue_lock;
|
|
CircularQueue<DeviceEvent, 100> m_event_queue;
|
|
};
|
|
|
|
}
|