xpctarget-driver-gd

[e-mail][e-mail]@[e-mail],licenserenewals,[e-mail],pricing,andgeneralinformation508-647-7000(Phone)508-647-7001(Fax)TheMathWorks,Inc.3AppleHillDriveNatick,MA01760-2098Forcontactinformationaboutworldwideoffices,seetheMathWorksWebsite.xPCTargetDeviceDriversGuide©COPYRIGHT2007byTheMathWorks,Inc.Thesoftwaredescribedinthisdocumentisfurnishedunderalicenseagreement.Thesoftwaremaybeusedorcopiedonlyunderthetermsofthelicenseagreement.NopartofthismanualmaybephotocopiedorreproducedinanyformwithoutpriorwrittenconsentfromTheMathWorks,Inc.FEDERALACQUISITION:ThisprovisionappliestoallacquisitionsoftheProgramandDocumentationby,for,orthroughthefederalgovernmentoftheUnitedStates.ByacceptingdeliveryoftheProgramorDocumentation,thegovernmentherebyagreesthatthissoftwareordocumentationqualifiesascommercialcomputersoftwareorcommercialcomputersoftwaredocumentationassuchtermsareusedordefinedinFAR12.212,DFARSPart227.72,andDFARS252.227-7014.Accordingly,thetermsandconditionsofthisAgreementandonlythoserightsspecifiedinthisAgreement,shallpertaintoandgoverntheuse,modification,reproduction,release,performance,display,anddisclosureoftheProgramandDocumentationbythefederalgovernment(orotherentityacquiringfororthroughthefederalgovernment)andshallsupersedeanyconflictingcontractualtermsorconditions.IfthisLicensefailstomeetthegovernment’sneedsorisinconsistentinanyrespectwithfederalprocurementlaw,thegovernmentagreestoreturntheProgramandDocumentation,unused,toTheMathWorks,Inc.TrademarksMATLAB,Simulink,Stateflow,HandleGraphics,Real-TimeWorkshop,SimBiology,SimHydraulics,SimEvents,andxPCTargetBoxareregisteredtrademarksandTheMathWorks,theL-shapedmembranelogo,EmbeddedMATLAB,andPolySpacearetrademarksofTheMathWorks,Inc.Otherproductorbrandnamesaretrademarksorregisteredtrademarksoftheirrespectiveholders.PatentsTheMathWorksproductsareprotectedbyoneormoreU.S.patents.Pleasesee(Release2007a)September2007OnlineonlyNewforVersion3.3(Release2007b)ContentsCustomizingxPCTargetDrivers1Introduction......................................1-2xPCTargetDrivers................................1-2WhentoWriteYourOwnDrivers....................1-3RestrictionsonCustomizingxPCTargetDrivers........1-3ExpectedBackground..............................1-3ResourcesforCustomizingxPCTargetDrivers.........1-4WhatMakesUpanxPCTargetDriver?...............1-6BeforeYouStart...................................1-8Introduction......................................1-8DriverTypes.....................................1-9BusTypesandRegisterAccess......................1-9RegisterAccess...................................1-10InliningxPCTargetDrivers.........................1-10CreatingaCustomDriver..........................1-11PCIDrivers2PCIBusConsiderations............................2-2Introduction......................................2-2PCIConfigurationSpaceAPI........................2-3Memory-MappedAccesses..........................2-6I/OPortAccesses..................................2-6SamplePCIDeviceDriver..........................2-8vISAandPC/104Drivers3ISAandPC/104BusConsiderations.................3-2Introduction......................................3-2I/OMapped......................................3-2MemoryMapped..................................3-3MaskingDrivers4CreatingDriverSubsystemMasks..................4-2DriverMaskGuidelines............................4-3Cross-BlockChecking..............................4-5WhenYouAreDone................................4-6SampleDriverMask...............................4-7InterruptSupport5xPCTargetInterrupts.............................5-2Introduction......................................5-2InterruptProcessinginxPCTarget...................5-2AddingInterruptSupport..........................5-7Introduction......................................5-7GuidelinesforCreatingInterruptFunctions...........5-9FillingintheDriverboardStructure.................5-10HookFunctionPrototypes.........................5-13viContentsCustomxPCTargetDriverNotes6S-FunctionGuidelines.............................6-2mdlStartandmdlTerminateConsiderations.........6-4DMAConsiderations...............................6-5PassingParameters................................6-6AccessingRegisters................................6-7I/OSpace........................................6-7Memory-MappedSpace.............................6-7I/OStructures—ByCategory7I/OStructures—AlphabeticalList8I/OFunctions—ByCategory9PortI/O...........................................9-2PCIConfigurationInformation.....................9-2PhysicalMemory..................................9-2viiTime..............................................9-2Miscell