Visual_DSP_Device_Drivers_and_System_Services_Manu

W5.0DeviceDriversandSystemServicesManualforBlackfin®ProcessorsRevision3.1,November2007PartNumber82-000430-01AnalogDevices,Inc.OneTechnologyWayNorwood,Mass.02062-9106CopyrightInformation©2007AnalogDevices,Inc.,ALLRIGHTSRESERVED.Thisdocumentmaynotbereproducedinanyformwithoutprior,expresswrittenconsentfromAnalogDevices,Inc.PrintedintheUSA.DisclaimerAnalogDevices,Inc.reservestherighttochangethisproductwithoutpriornotice.InformationfurnishedbyAnalogDevicesisbelievedtobeaccurateandreliable.However,noresponsibilityisassumedbyAnalogDevicesforitsuse;norforanyinfringementofpatentsorotherrightsofthirdpartieswhichmayresultfromitsuse.Nolicenseisgrantedbyimpli-cationorotherwiseunderthepatentrightsofAnalogDevices,Inc.TrademarkandServiceMarkNoticeTheAnalogDeviceslogoandiconbar,Blackfin,theBlackfinlogo,EZ-KITLite,SHARC,TigerSHARC,andVisualDSP++areregisteredtrademarksofAnalogDevices,Inc.Allotherbrandandproductnamesaretrademarksorservicemarksoftheirrespectiveowners.VisualDSP++5.0DeviceDriversandSystemiiiServicesManualforBlackfinProcessorsCONTENTSPREFACEPurposeofThisManual...............................................................xxxiIntendedAudience.......................................................................xxxiManualContentsDescription.....................................................xxxiiTechnicalorCustomerSupport..................................................xxxiiiSupportedProcessors..................................................................xxxivProductInformation..................................................................xxxivMyAnalog.com.....................................................................xxxivProcessorProductInformation...............................................xxxvRelatedDocuments..............................................................xxxviOnlineTechnicalDocumentation........................................xxxviiAccessingDocumentationFromtheWeb.........................xxxviiViewingHelpFiles..........................................................xxxviiNotationConventions..............................................................xxxviiiINTRODUCTIONSystemServicesOverview..............................................................1-2General...................................................................................1-3ApplicationInterface...............................................................1-7ContentsivVisualDSP++5.0DeviceDriversandSystemServicesManualforBlackfinProcessorsDependencies..........................................................................1-8Initialization.........................................................................1-10Termination..........................................................................1-10SystemServicesDirectoryandFileStructure..........................1-11AccessingtheSystemServicesAPI.....................................1-11LinkingintheSystemServicesLibrary..............................1-13RebuildingtheSystemServicesLibrary.............................1-15Examples..........................................................................1-16Dual-CoreConsiderations................................................1-16RTOSConsiderations.................................................................1-17InteroperabilityofSystemServicesWithVDK.......................1-17DeploymentofServicesWithinaMulti-ThreadedApplication........................................................................1-18DeviceDriverOverview..............................................................1-19ApplicationInterface.............................................................1-20DeviceDriverArchitecture....................................................1-21InteractionWithSystemServices......................................1-23Initialization.........................................................................1-23Termination..........................................................................1-24DeviceDriverDirectoryandFileStructure............................1-24AccessingtheDeviceDriverAPI.......................................1-25DeviceDriverFileLocations.............................................1-27LinkingintheDeviceDriverLibrary................................1-28RebuildingtheDeviceDriverLibrary................................1-29ExamplesonDistribution.................................................1-30VisualDSP++5.0DeviceDriversandSystemvServicesManualforBlackfinProcessorsContentsINTERRUPTMANAGERIntroduction.................................................................................2-2InterruptManagerInitialization....................................................2-4InterruptManagerTermination.....................................................2-5CoreEventControllerFunctions...................................................2-6adi_int_CECHook()Function.................................................2-6adi_int_CECUnhook()Function.............................................2-8InterruptHandle