Autodocs
Resources:
card.resource
BeginCardAccess
CardAccessSpeed
CardChangeCount
CardForceChange
CardInterface
CardMiscControl
CardProgramVoltage
CardResetCard
CardResetRemove
CopyTuple
DeviceTuple
EndCardAccess
GetCardMap
IfAmigaXIP
OwnCard
ReadCardStatus
ReleaseCard
Include
GuruMeditation
|
Docs » Autodocs » card.resource » CardMiscControl
CardMiscControl -- Set/Clear miscellaneous control bits
control_bits=CardMiscControl( handle, control_bits );
d0 a1 d1
UBYTE CardMiscControl( struct CardHandle *, UBYTE );
Used to set/clear miscellaneous control bits (generally for
use with I/O cards).
handle - Same handle as that used when OwnCard() was called.
control_bits - A mask value of control bits to be turned on/off.
The bit values which might be usable are defined in card.h/i.
For example, to enable digital audio, and disable hardware
write-protect (if supported), you would call this function with these
values --
CARDF_DISABLE_WP|CARDF_ENABLE_DIGAUDIO
Then to turn off digital audio, but leave write-protect
disable, you would use a value of --
CARDF_DISABLE_WP
Finally too reenable write protect, call this function with
a mask value of 0.
control_bits - The same mask value you called this function
with if successful. If one, or more bits has been cleared
in the return mask, this would indicate that the control bit
is not being supported, or that the card has been removed
by the user.
For example, if you called this function with a mask value
of --
CARDF_DISABLE_WP|CARDF_ENABLE_DIGAUDIO
And this function returned a value of --
CARDF_DISABLE_WP
This would indicate that it is not possible to enable digital
audio (most likely because this feature has not been implemented).
This function may be called from within a task, or from a level 1
or level 2 interrupt.
!!!IMPORTANT!!!
You should ALWAYS try to enable digital audio for I/O cards
as this will also configure the card socket for the I/O
interface (if supported).
Not all cards will connect the write-enable line (e.g.,
some I/O cards). On some machines (e.g., the A600) it will
not be possible to write to such cards unless you disable
write-protection by using this function.
!!!NEW!!!
For card.resource V39 (check resource base for VERSION before
using), new bits have been defined which let you enable/disable
particular status change interrupts. See CardInterface() for
defaults. These new bits are backwards compatable with V37
for which only the CARDB_DISABLE_WP, and CARDB_ENABLE_DIGAUDIO
bits were defined. These new bits allow you to enable, or
disable specific status change interrupts including BVD1/SC,
BVD2/DA, and BSY/IRQ. The defaults for these status change
interrupts are unchanged from V37, and WR (Write-protect) status
change interrupts are always enabled as they use to be.
An example of use:
CARD_INTF_SETCLR!CARD_INTF_BVD1
Would enable BVD1/SC status change interrupts, and not change
the enable/disable state for BVD2/DA or BSY/IRQ status change
interrupts. If the change was made successfully, the
CARD_INTB_BVD1 bit would be set in register D0 when this function
returns.
CardInterface(), <resources/card.h>, "resources/card.i"
|
