Serenity Operating System
1/*
2 * Copyright (c) 2020, Liav A. <liavalb@hotmail.co.il>
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are met:
7 *
8 * 1. Redistributions of source code must retain the above copyright notice, this
9 * list of conditions and the following disclaimer.
10 *
11 * 2. Redistributions in binary form must reproduce the above copyright notice,
12 * this list of conditions and the following disclaimer in the documentation
13 * and/or other materials provided with the distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
16 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
22 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
23 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 */
26
27#pragma once
28
29#include <AK/HashTable.h>
30#include <AK/OwnPtr.h>
31#include <AK/Types.h>
32#include <Kernel/Arch/i386/CPU.h>
33#include <Kernel/Interrupts/GenericInterruptHandler.h>
34#include <Kernel/Interrupts/IRQController.h>
35
36namespace Kernel {
37
38class SpuriousInterruptHandler final : public GenericInterruptHandler {
39public:
40 static void initialize(u8 interrupt_number);
41 virtual ~SpuriousInterruptHandler();
42 virtual void handle_interrupt(const RegisterState& regs) override;
43
44 void register_handler(GenericInterruptHandler&);
45 void unregister_handler(GenericInterruptHandler&);
46
47 virtual bool eoi() override;
48
49 virtual size_t sharing_devices_count() const override { return 1; }
50 virtual bool is_shared_handler() const override { return false; }
51 virtual bool is_sharing_with_others() const override { return false; }
52
53 virtual HandlerType type() const override { return HandlerType::SpuriousInterruptHandler; }
54 virtual const char* purpose() const override { return "Spurious Interrupt Handler"; }
55 virtual const char* controller() const override;
56
57private:
58 void enable_interrupt_vector();
59 void disable_interrupt_vector();
60 explicit SpuriousInterruptHandler(u8 interrupt_number);
61 bool m_enabled;
62 RefPtr<IRQController> m_responsible_irq_controller;
63 OwnPtr<GenericInterruptHandler> m_real_handler;
64};
65}