1 /*
2  * Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved.
3  *
4  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5  *
6  * This file contains Original Code and/or Modifications of Original Code
7  * as defined in and that are subject to the Apple Public Source License
8  * Version 2.0 (the 'License'). You may not use this file except in
9  * compliance with the License. The rights granted to you under the License
10  * may not be used to create, or enable the creation or redistribution of,
11  * unlawful or unlicensed copies of an Apple operating system, or to
12  * circumvent, violate, or enable the circumvention or violation of, any
13  * terms of an Apple operating system software license agreement.
14  *
15  * Please obtain a copy of the License at
16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17  *
18  * The Original Code and all software distributed under the License are
19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23  * Please see the License for the specific language governing rights and
24  * limitations under the License.
25  *
26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27  */
28 
29 #include <IOKit/IODMAController.h>
30 
31 
32 #define super IOService
33 OSDefineMetaClassAndAbstractStructors(IODMAController, IOService);
34 
35 const OSSymbol *IODMAController::createControllerName(UInt32 phandle)
36 {
37 #define CREATE_BUF_LEN 48
38   char           buf[CREATE_BUF_LEN];
39 
40   snprintf(buf, CREATE_BUF_LEN, "IODMAController%08X", (uint32_t)phandle);
41 
42   return OSSymbol::withCString(buf);
43 }
44 
45 IODMAController *IODMAController::getController(IOService *provider, UInt32 dmaIndex)
46 {
47   OSData          *dmaParentData;
48   const OSSymbol  *dmaParentName;
49   IODMAController *dmaController;
50 
51   // Find the name of the parent dma controller
52   dmaParentData = OSDynamicCast(OSData, provider->getProperty("dma-parent"));
53   if (dmaParentData == 0) return NULL;
54   dmaParentName = createControllerName(*(UInt32 *)dmaParentData->getBytesNoCopy());
55   if (dmaParentName == 0) return NULL;
56 
57   // Wait for the parent dma controller
58   dmaController = OSDynamicCast(IODMAController, IOService::waitForService(IOService::nameMatching(dmaParentName)));
59 
60   return dmaController;
61 }
62 
63 
64 bool IODMAController::start(IOService *provider)
65 {
66   if (!super::start(provider)) return false;
67 
68   _provider = provider;
69 
70   return true;
71 }
72 
73 
74 // protected
75 
76 void IODMAController::registerDMAController(IOOptionBits options)
77 {
78   OSData *phandleData;
79 
80   phandleData = OSDynamicCast(OSData, _provider->getProperty("AAPL,phandle"));
81 
82   _dmaControllerName = createControllerName(*(UInt32 *)phandleData->getBytesNoCopy());
83 
84   setName(_dmaControllerName);
85 
86   registerService(options | ((options & kIOServiceAsynchronous) ? 0 : kIOServiceSynchronous));
87 }
88 
89 void IODMAController::completeDMACommand(IODMAEventSource *dmaES, IODMACommand *dmaCommand)
90 {
91   dmaES->completeDMACommand(dmaCommand);
92 }
93 
94 void IODMAController::notifyDMACommand(IODMAEventSource *dmaES, IODMACommand *dmaCommand, IOReturn status, IOByteCount actualByteCount)
95 {
96   dmaES->notifyDMACommand(dmaCommand, status, actualByteCount);
97 }
98 
99 
100 // private
101