mirror of
https://github.com/genodelabs/genode.git
synced 2024-12-26 17:01:07 +00:00
17c79a9e23
Besides adapting the components to the use of base/log.h, the patch cleans up a few base headers, i.e., it removes unused includes from root/component.h, specifically base/heap.h and ram_session/ram_session.h. Hence, components that relied on the implicit inclusion of those headers have to manually include those headers now. While adjusting the log messages, I repeatedly stumbled over the problem that printing char * arguments is ambiguous. It is unclear whether to print the argument as pointer or null-terminated string. To overcome this problem, the patch introduces a new type 'Cstring' that allows the caller to express that the argument should be handled as null-terminated string. As a nice side effect, with this type in place, the optional len argument of the 'String' class could be removed. Instead of supplying a pair of (char const *, size_t), the constructor accepts a 'Cstring'. This, in turn, clears the way let the 'String' constructor use the new output mechanism to assemble a string from multiple arguments (and thereby getting rid of snprintf within Genode in the near future). To enforce the explicit resolution of the char * ambiguity, the 'char *' overload of the 'print' function is marked as deleted. Issue #1987
112 lines
2.6 KiB
C++
112 lines
2.6 KiB
C++
/*
|
|
* \brief IRQ session interface
|
|
* \author Christian Helmuth
|
|
* \author Martin Stein
|
|
* \date 2007-09-13
|
|
*
|
|
* An open IRQ session represents a valid IRQ attachment/association.
|
|
* Initially, the interrupt is masked and will only occur if enabled. This is
|
|
* done by calling ack_irq().
|
|
*
|
|
* Disassociation from an IRQ is done by closing the session.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2007-2015 Genode Labs GmbH
|
|
*
|
|
* This file is part of the Genode OS framework, which is distributed
|
|
* under the terms of the GNU General Public License version 2.
|
|
*/
|
|
|
|
#ifndef _INCLUDE__IRQ_SESSION__IRQ_SESSION_H_
|
|
#define _INCLUDE__IRQ_SESSION__IRQ_SESSION_H_
|
|
|
|
#include <base/signal.h>
|
|
#include <base/capability.h>
|
|
#include <session/session.h>
|
|
|
|
namespace Genode {
|
|
struct Irq_session;
|
|
}
|
|
|
|
|
|
struct Genode::Irq_session : Session
|
|
{
|
|
struct Info {
|
|
enum Type { INVALID, MSI } type;
|
|
unsigned long address;
|
|
unsigned long value;
|
|
};
|
|
|
|
/**
|
|
* Interrupt trigger
|
|
*/
|
|
enum Trigger { TRIGGER_UNCHANGED = 0, TRIGGER_LEVEL, TRIGGER_EDGE };
|
|
|
|
/**
|
|
* Interrupt trigger polarity
|
|
*/
|
|
enum Polarity { POLARITY_UNCHANGED = 0, POLARITY_HIGH, POLARITY_LOW };
|
|
|
|
/**
|
|
* Destructor
|
|
*/
|
|
virtual ~Irq_session() { }
|
|
|
|
/**
|
|
* Acknowledge handling of last interrupt - re-enables interrupt reception
|
|
*/
|
|
virtual void ack_irq() = 0;
|
|
|
|
/**
|
|
* Register irq signal handler
|
|
*/
|
|
virtual void sigh(Genode::Signal_context_capability sigh) = 0;
|
|
|
|
/**
|
|
* Request information about IRQ, e.g. on x86 request MSI address and
|
|
* MSI value to be programmed to device specific PCI registers.
|
|
*/
|
|
virtual Info info() = 0;
|
|
|
|
/*************
|
|
** Session **
|
|
*************/
|
|
|
|
static const char * service_name() { return "IRQ"; }
|
|
|
|
|
|
/*********************
|
|
** RPC declaration **
|
|
*********************/
|
|
|
|
GENODE_RPC(Rpc_ack_irq, void, ack_irq);
|
|
GENODE_RPC(Rpc_sigh, void, sigh, Genode::Signal_context_capability);
|
|
GENODE_RPC(Rpc_info, Info, info);
|
|
GENODE_RPC_INTERFACE(Rpc_ack_irq, Rpc_sigh, Rpc_info);
|
|
};
|
|
|
|
|
|
namespace Genode {
|
|
|
|
static inline void print(Output &out, Irq_session::Trigger value)
|
|
{
|
|
switch (value) {
|
|
case Irq_session::TRIGGER_UNCHANGED: print(out, "UNCHANGED"); break;
|
|
case Irq_session::TRIGGER_LEVEL: print(out, "LEVEL"); break;
|
|
case Irq_session::TRIGGER_EDGE: print(out, "EDGE"); break;
|
|
}
|
|
}
|
|
|
|
static inline void print(Output &out, Irq_session::Polarity value)
|
|
{
|
|
switch (value) {
|
|
case Irq_session::POLARITY_UNCHANGED: print(out, "UNCHANGED"); break;
|
|
case Irq_session::POLARITY_HIGH: print(out, "HIGH"); break;
|
|
case Irq_session::POLARITY_LOW: print(out, "LOW"); break;
|
|
}
|
|
}
|
|
}
|
|
|
|
#endif /* _INCLUDE__IRQ_SESSION__IRQ_SESSION_H_ */
|