#include <PciAtaController.h>

Inheritance diagram for PciAtaController:

Collaboration diagram for PciAtaController:

Public Member Functions
	PciAtaController (Controller *pDev, int nController=0)

virtual void	shutdown ()

virtual void	getName (String &str)

virtual bool	sendCommand (size_t nUnit, uintptr_t pCommand, uint8_t nCommandSize, uintptr_t pRespBuffer, uint16_t nRespBytes, bool bWrite)

virtual uint64_t	executeRequest (uint64_t p1, uint64_t p2, uint64_t p3, uint64_t p4, uint64_t p5, uint64_t p6, uint64_t p7, uint64_t p8)

virtual IrqDisposition	irq (irq_id_t number)

Public Member Functions inherited from AtaController
	AtaController (Controller *pDev, int nController=0, bool startWorker=true)

virtual bool	compareRequests (const RequestQueue::Request &a, const RequestQueue::Request &b)

Public Member Functions inherited from ScsiController
	ScsiController (Controller *pDev, bool startWorker=true)

bool	prepareDiskRemoval ()

void	cancelDiskRemoval ()

virtual bool	supportsConcurrentReads () const

Public Member Functions inherited from Controller
	Controller (Device *pDev)

virtual Type	getType ()

virtual void	dump (String &str)

Public Member Functions inherited from Device
	Device (Device *p)

Device *	getParent () const

void	setParent (Device *p)

virtual const String &	getSpecificType ()

virtual void	setSpecificType (String str)

void	setPciPosition (uint32_t bus, uint32_t device, uint32_t func)

void	setPciIdentifiers (uint8_t classCode, uint8_t subclassCode, uint16_t vendorId, uint16_t deviceId, uint8_t progIf)

void	setPciConfigHeader (const PciBus::ConfigSpace &space)

PciBus::ConfigSpace	getPciConfigHeader () const

uint8_t	getPciClassCode ()

uint8_t	getPciSubclassCode ()

uint16_t	getPciVendorId ()

uint16_t	getPciDeviceId ()

uint8_t	getPciProgInterface ()

uint32_t	getPciBusPosition ()

uint32_t	getPciDevicePosition ()

uint32_t	getPciFunctionNumber ()

virtual Vector< Address * > &	addresses ()

virtual uintptr_t	getInterruptNumber ()

virtual void	setInterruptNumber (uintptr_t n)

void	addChild (Device *pDevice)

Device *	getChild (size_t n)

size_t	getNumChildren ()

void	removeChild (size_t n)

void	removeChild (Device *d)

void	replaceChild (Device src, Device dest)

Public Member Functions inherited from RequestQueue
	RequestQueue (const String &name)

virtual void	initialise ()

virtual void	destroy ()

MUST_USE_RESULT uint64_t	addRequest (size_t priority, uint64_t p1=0, uint64_t p2=0, uint64_t p3=0, uint64_t p4=0, uint64_t p5=0, uint64_t p6=0, uint64_t p7=0, uint64_t p8=0)

MUST_USE_RESULT uint64_t	addRequest (size_t priority, ActionOnDuplicate action, uint64_t p1=0, uint64_t p2=0, uint64_t p3=0, uint64_t p4=0, uint64_t p5=0, uint64_t p6=0, uint64_t p7=0, uint64_t p8=0)

uint64_t	addAsyncRequest (size_t priority, uint64_t p1=0, uint64_t p2=0, uint64_t p3=0, uint64_t p4=0, uint64_t p5=0, uint64_t p6=0, uint64_t p7=0, uint64_t p8=0)

bool	canWaitForCompletion ()

MUST_USE_RESULT bool	waitForPreallocated (PreallocatedRequest &request)

MUST_USE_RESULT PreallocatedPublishResult	publishPreallocated (PreallocatedRequest &request, size_t priority, uint64_t p1=0, uint64_t p2=0, uint64_t p3=0, uint64_t p4=0, uint64_t p5=0, uint64_t p6=0, uint64_t p7=0, uint64_t p8=0)

MUST_USE_RESULT PreallocatedPublishResult	republishPreallocatedWhileReleasing (PreallocatedRequest &request, size_t priority, uint64_t p1=0, uint64_t p2=0, uint64_t p3=0, uint64_t p4=0, uint64_t p5=0, uint64_t p6=0, uint64_t p7=0, uint64_t p8=0)

MUST_USE_RESULT bool	halt ()

MUST_USE_RESULT bool	resume ()

LifecycleState	getLifecycleState ()

bool	drain ()

Public Attributes
IoBase *	m_pCommandRegs

IoBase *	m_pControlRegs

Public Attributes inherited from AtaController
IoBase *	m_pCommandRegs

IoBase *	m_pControlRegs

Protected Member Functions
virtual bool	workerPlacement (ThreadPlacement &placement) const

Protected Member Functions inherited from AtaController
bool	beginShutdown ()

void	maskDiskInterrupts ()

void	stopDiskDma ()

virtual size_t	getNumUnits ()

Protected Member Functions inherited from ScsiController
virtual void	cancelRequest (const Request &request)

void	shutdownDiskCaches ()

void	searchDisks ()

Protected Member Functions inherited from Device
	NOT_COPYABLE_OR_ASSIGNABLE (Device)

Protected Member Functions inherited from RequestQueue
	RequestQueue (const RequestQueue &)

void	operator= (const RequestQueue &)

int	work ()

NextRequestResult	getNextRequest (Request *&request)

bool	drainIntakeLocked (size_t priority)

void	publishRequest (Request *request)

Request *	findDuplicate (const Request &request)

void	discardRequest (Request *request)

uint64_t	addAsyncRequestInternal (size_t priority, uint64_t p1, uint64_t p2, uint64_t p3, uint64_t p4, uint64_t p5, uint64_t p6, uint64_t p7, uint64_t p8)

PreallocatedPublishResult	publishPreallocatedRequest (PreallocatedRequest &request, PreallocatedRequest::State availableState, size_t priority, uint64_t p1, uint64_t p2, uint64_t p3, uint64_t p4, uint64_t p5, uint64_t p6, uint64_t p7, uint64_t p8)

void	releasePreallocatedRequest (Request *request)

void	invokeCancelRequest (const Request &request)

bool	callbackActiveOnCurrentThread () const

void	releaseRequest (Request *request)

uint64_t	waitForRequest (Request *request)

bool	startWorker ()

bool	stopWorker ()

void	closePreallocatedAdmission ()

void	waitForPreallocatedPublishers ()

Protected Member Functions inherited from IrqHandler
virtual	~IrqHandler ()

Protected Member Functions inherited from IrqHandlerBase
virtual	~IrqHandlerBase ()

Protected Attributes
int	m_nController

Protected Attributes inherited from AtaController
int	m_nController

Protected Attributes inherited from Device
Vector< Address * >	m_Addresses

Vector< Device * >	m_Children

Device *	m_pParent

uintptr_t	m_InterruptNumber

String	m_SpecificType

PciBus::ConfigSpace	m_ConfigHeader

uint8_t	m_ClassCode

uint8_t	m_SubclassCode

uint16_t	m_VendorId

uint16_t	m_DeviceId

uint8_t	m_ProgInterface

uint32_t	m_PciBusPos

uint32_t	m_PciDevicePos

uint32_t	m_PciFunctionNum

Protected Attributes inherited from RequestQueue
IntakeLane	m_IntakeLanes [REQUEST_QUEUE_NUM_PRIORITIES]

Request *	m_pRequestQueue [REQUEST_QUEUE_NUM_PRIORITIES]

Request *	m_pRequestQueueTail [REQUEST_QUEUE_NUM_PRIORITIES]

Request *	m_pActiveRequest

Atomic< size_t >	m_State

Mutex	m_LifecycleMutex

WaitQueue	m_RequestQueueWaiters

WaitQueue	m_WorkerWaiters

Thread *	m_pThread

Atomic< PerProcessorScheduler * >	m_pWorkerScheduler

SchedulerWorkerWake	m_WorkerWake

Atomic< size_t >	m_bWorkerReady

Atomic< size_t >	m_bWorkerActive

size_t	m_WorkerProgressGeneration

RequestQueueOverrunChecker	m_OverrunChecker

Timer *	m_pOverrunTimer

Atomic< size_t >	m_PublicationState

size_t	m_nMaxAsyncRequests

Atomic< size_t >	m_nAsyncRequests

Atomic< size_t >	m_nTotalRequests

Atomic< size_t >	m_nActiveRequests

NormalStaticString	m_Name

Private Types
enum	{ UnknownController , PIIX , PIIX3 , PIIX4 , ICH , ICH0 , ICH2 , ICH3 , ICH4 , ICH5 }

Private Member Functions
	PciAtaController (const PciAtaController &)

void	operator= (const PciAtaController &)

void	diskHelper (bool master, IoBase cmd, IoBase ctl, BusMasterIde *dma, size_t irq)

Private Attributes
enum PciAtaController:: { ... }	m_PciControllerType

irq_id_t	m_IrqIds [3]

size_t	m_IrqCount

Additional Inherited Members
Public Types inherited from Device
enum	Type { Generic , Root , Disk , Bus , Display , Network , Sound , Console , Mouse , Controller , UsbController , UsbGeneric , UsbContainer }

typedef Device (	Callback) (Device *)

Public Types inherited from RequestQueue
enum class	OverrunStatus { Clear , Armed , Stalled , Overloaded }

enum class	PreallocatedPublishResult { Accepted , TokenBusy , QueueStopped , QueueFull , InvalidPriority }

enum	ActionOnDuplicate { Block , NewRequest , ReturnImmediately }

enum class	LifecycleState { Stopped , Accepting , Stopping , Destroyed }

Static Public Member Functions inherited from Device
static void	foreach (Callback callback, Device *root=0)

template<class F , class... Args>
static void	foreach (pedigree_std::Callable< F > &callback, Device *root, Args... args)

static void	addToRoot (Device *device)

static void	searchByVendorId (uint16_t vendorId, void(callback)(Device ), Device *root=0)

static void	searchByVendorIdAndDeviceId (uint16_t vendorId, uint16_t deviceId, void(callback)(Device ), Device *root=0)

static void	searchByClass (uint16_t classCode, void(callback)(Device ), Device *root=0)

static void	searchByClassAndSubclass (uint16_t classCode, uint16_t subclassCode, void(callback)(Device ), Device *root=0)

static void	searchByClassSubclassAndProgInterface (uint16_t classCode, uint16_t subclassCode, uint8_t progInterface, void(callback)(Device ), Device *root=0)

Protected Types inherited from RequestQueue
enum class	NextRequestResult { Item , Empty , Retry }

Static Protected Member Functions inherited from AtaController
static bool	canCoalesceCanonicalRequests (uint64_t aType, uint64_t aDisk, uint64_t aLocation, uint64_t bType, uint64_t bDisk, uint64_t bLocation)

Static Protected Member Functions inherited from Device
static Device &	root ()

Static Protected Member Functions inherited from RequestQueue
static int	trampoline (void *p)

static void	completeRequest (Request *request, uint64_t returnValue, bool rejected)

static void	retainRequest (Request *request)

Static Protected Attributes inherited from Device
static Device	m_Root

static Mutex	m_TreeLock

Static Protected Attributes inherited from RequestQueue
static constexpr size_t	PublicationClosed = static_cast<size_t>(1) << ((sizeof(size_t) * 8) - 1)

static constexpr size_t	PublicationCountMask = ~PublicationClosed

Detailed Description

Class for a PCI-based IDE controller.

Definition at line 38 of file PciAtaController.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

private

Definition at line 68 of file PciAtaController.h.

Constructor & Destructor Documentation

◆ PciAtaController()

PciAtaController::PciAtaController	(	Controller *	pDev,
		int	nController = `0`
	)

Todo:: for ICH and the like, there's more Ultra DMA configuration.

Todo:: Bus master registerss may be memory mapped...

Todo:: ICH will have "native mode" to worry about

Todo:: Detect PCI IRQ, don't use ISA IRQs in native mode (etc...)

Definition at line 42 of file PciAtaController.cc.

References AtaStatus::__reg_contents, Device::addresses(), IoPort::allocate(), Vector< T >::clear(), Device::getInterruptNumber(), Device::getPciDeviceId(), Device::getPciProgInterface(), RequestQueue::initialise(), BusMasterIde::initialise(), Device::Address::m_Address, Device::m_Children, Device::Address::m_Io, ProcessorBase::pause(), PciBus::readConfigSpace(), IrqManager::registerIsaIrqHandler(), IrqManager::registerPciIrqHandler(), Device::setSpecificType(), IoPort::write8(), and PciBus::writeConfigSpace().

◆ ~PciAtaController()

PciAtaController::~PciAtaController ( )

virtual

Definition at line 321 of file PciAtaController.cc.

Member Function Documentation

◆ diskHelper()

void PciAtaController::diskHelper	(	bool	master,
		IoBase *	cmd,
		IoBase *	ctl,
		BusMasterIde *	dma,
		size_t	irq
	)

private

Definition at line 346 of file PciAtaController.cc.

◆ executeRequest()

uint64_t PciAtaController::executeRequest	(	uint64_t	p1,
		uint64_t	p2,
		uint64_t	p3,
		uint64_t	p4,
		uint64_t	p5,
		uint64_t	p6,
		uint64_t	p7,
		uint64_t	p8
	)

virtual

Callback - classes are expected to inherit and override this function. It's called when a request needs to be executed (by the worker thread).

Reimplemented from ScsiController.

Definition at line 381 of file PciAtaController.cc.

References AtaDisk::doRead(), AtaDisk::doWrite(), and AtaDisk::doWriteDirect().

◆ getName()

virtual void PciAtaController::getName ( String & str )

inlinevirtual

Stores the device's name in str.

Implements AtaController.

Definition at line 44 of file PciAtaController.h.

◆ irq()

IrqDisposition PciAtaController::irq ( irq_id_t number )

virtual

Handles a pending IRQ in thread context.

Reimplemented from AtaController.

Definition at line 401 of file PciAtaController.cc.

References BusMasterIde::completeIdleTransaction(), AtaDisk::getBusMaster(), Device::getChild(), Device::getInterruptNumber(), Device::getNumChildren(), and AtaDisk::irqReceived().

◆ sendCommand()

bool PciAtaController::sendCommand	(	size_t	nUnit,
		uintptr_t	pCommand,
		uint8_t	nCommandSize,
		uintptr_t	pRespBuffer,
		uint16_t	nRespBytes,
		bool	bWrite
	)

virtual

Implements ScsiController.

Definition at line 361 of file PciAtaController.cc.

◆ shutdown()

void PciAtaController::shutdown ( )

virtual

Retires disk work and every hardware callback before device transfer.

Implements AtaController.

Definition at line 325 of file PciAtaController.cc.

References RequestQueue::destroy(), AtaController::maskDiskInterrupts(), ScsiController::shutdownDiskCaches(), AtaController::stopDiskDma(), and IrqManager::unregisterHandler().

◆ workerPlacement()

bool PciAtaController::workerPlacement ( ThreadPlacement & placement ) const

protectedvirtual

Reimplemented from RequestQueue.

Definition at line 373 of file PciAtaController.cc.

Member Data Documentation

◆ m_IrqCount

size_t PciAtaController::m_IrqCount

private

Definition at line 82 of file PciAtaController.h.

◆ m_IrqIds

irq_id_t PciAtaController::m_IrqIds[3]

private

Definition at line 81 of file PciAtaController.h.

◆ m_nController

int PciAtaController::m_nController

protected

Definition at line 89 of file PciAtaController.h.

◆ m_pCommandRegs

IoBase* PciAtaController::m_pCommandRegs

Definition at line 61 of file PciAtaController.h.

◆ m_pControlRegs

IoBase* PciAtaController::m_pControlRegs

Definition at line 62 of file PciAtaController.h.

The documentation for this class was generated from the following files:

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ PciAtaController()

◆ ~PciAtaController()

Member Function Documentation

◆ diskHelper()

◆ executeRequest()

◆ getName()

◆ irq()

◆ sendCommand()

◆ shutdown()

◆ workerPlacement()

Member Data Documentation

◆ m_IrqCount

◆ m_IrqIds

◆ m_nController

◆ m_pCommandRegs

◆ m_pControlRegs