Slot-1 card commands. More...

#include <stddef.h>
#include <nds/ndstypes.h>

Functions
void	cardEepromChipErase (void)
	Erase the entirety of a TYPE 3 (FLASH) card EEPROM.

u8	cardEepromCommand (u8 command)
	Send a command to the card EEPROM. More...

u32	cardEepromGetSize (void)
	Read the card EEPROM's size. More...

int	cardEepromGetType (void)
	Read the card EEPROM's type. More...

u32	cardEepromReadID (void)
	Attempt to read the ID of the card EEPROM chip. More...

void	cardEepromSectorErase (u32 address)
	Erase a single sector of a TYPE 3 (FLASH) card EEPROM. More...

void	cardParamCommand (u8 command, u32 parameter, u32 flags, u32 *destination, u32 length)
	Write a ROM command of the following form, reading the response via polling (synchronously). More...

void	cardPolledTransfer (u32 flags, u32 destination, u32 length, const u8 command)
	Write a ROM command, reading the response via polling (synchronously). More...

void	cardRead (void *dest, size_t offset, size_t len, uint32_t flags)
	Read bytes from the card ROM. More...

void	cardReadEeprom (u32 address, u8 *data, u32 length, u32 addrtype)
	Read from the card EEPROM. More...

void	cardReadHeader (u8 *header)
	Read card header to the provided buffer. More...

u32	cardReadID (u32 flags)
	Read card ID. More...

void	cardReset (void)
	Reset the card. More...

void	cardStartTransfer (const u8 command, u32 destination, int channel, u32 flags)
	Perform a ROM command, reading the response via DMA (asynchronously). More...

uint32_t	cardWriteAndRead (const u8 *command, u32 flags)
	Perform a ROM command, reading one word of response. More...

void	cardWriteCommand (const u8 *command)
	Write a command to the card interface. More...

void	cardWriteEeprom (u32 address, u8 *data, u32 length, u32 addrtype)
	Write to the card EEPROM. More...

void	disableSlot1 (void)
	Disable Slot-1 in a DSi console.

static void	eepromWaitBusy (void)
	Wait until an EEPROM command is done.

void	enableSlot1 (void)
	Enable Slot-1 in a DSi console.

Detailed Description

Slot-1 card commands.

Function Documentation

◆ cardEepromCommand()

u8 cardEepromCommand ( u8 command )

Send a command to the card EEPROM.

Parameters

command The command to send.

Returns: u8 The result, if any.

◆ cardEepromGetSize()

u32 cardEepromGetSize ( void )

Read the card EEPROM's size.

Returns: u32 The EEPROM's size, in bytes.

◆ cardEepromGetType()

int cardEepromGetType ( void )

Read the card EEPROM's type.

Type | Description
-----+-------------------------------------------------------------
-1   | no card or no EEPROM
 0   | unknown                   PassMe?
 1   | TYPE 1   4Kbit(512Byte)   EEPROM
 2   | TYPE 2  64Kbit(8KByte)or  512kbit(64Kbyte)   EEPROM
 3   | TYPE 3   2Mbit(256KByte)  FLASH MEMORY (some rare 4Mbit and 8Mbit chips also)

Returns: It returns the type.

◆ cardEepromReadID()

u32 cardEepromReadID ( void )

Attempt to read the ID of the card EEPROM chip.

Doesn't work well; most chips return 0xFFFF.

Returns: u32 The ID of the chip.

◆ cardEepromSectorErase()

void cardEepromSectorErase ( u32 address )

Erase a single sector of a TYPE 3 (FLASH) card EEPROM.

Parameters

address The address to erase at.

◆ cardParamCommand()

void cardParamCommand	(	u8	command,
		u32	parameter,
		u32	flags,
		u32 *	destination,
		u32	length
	)

Write a ROM command of the following form, reading the response via polling (synchronously).

ccpppppppp000000

where cc is the command and pp is the parameter.

Parameters

command	The command.
parameter	The parameter.
flags	The ROM control flags to use for the transfer.
destination	The response's destination buffer.
length	The length of the response, in bytes.

◆ cardPolledTransfer()

void cardPolledTransfer	(	u32	flags,
		u32 *	destination,
		u32	length,
		const u8 *	command
	)

Write a ROM command, reading the response via polling (synchronously).

Parameters

flags	The ROM control flags to use for the transfer.
destination	The response's destination buffer.
length	The length of the response, in bytes.
command	8-byte command buffer, little endian.

◆ cardRead()

void cardRead	(	void *	dest,
		size_t	offset,
		size_t	len,
		uint32_t	flags
	)

Read bytes from the card ROM.

Parameters

dest	The destination buffer.
offset	The offset to read from, in bytes.
len	The number of bytes to read.
flags	The read flags.

◆ cardReadEeprom()

void cardReadEeprom	(	u32	address,
		u8 *	data,
		u32	length,
		u32	addrtype
	)

Read from the card EEPROM.

Parameters

address	The address to read from.
data	The data to write.
length	The length of data, in bytes.
addrtype	The card EEPROM's type.

See also: cardEepromGetType

◆ cardReadHeader()

void cardReadHeader ( u8 * header )

Read card header to the provided buffer.

This command requires the cart to not be initialized yet, which may mean the user needs to eject and reinsert the cart or they will return random data.

TODO: Is that correct?

Parameters

header Buffer to store the data in.

◆ cardReadID()

u32 cardReadID ( u32 flags )

Read card ID.

This command requires the cart to not be initialized yet, which may mean the user needs to eject and reinsert the cart or they will return random data.

TODO: Is that correct?

Parameters

flags The ROM control flags to use for the transfer.

Returns: The card ID.

◆ cardReset()

void cardReset ( void )

Reset the card.

This command requires the cart to not be initialized yet, which may mean the user needs to eject and reinsert the cart or they will return random data.

TODO: Is that correct?

◆ cardStartTransfer()

void cardStartTransfer	(	const u8 *	command,
		u32 *	destination,
		int	channel,
		u32	flags
	)

Perform a ROM command, reading the response via DMA (asynchronously).

Note that this function does not wait for the DMA to complete!

Parameters

command	8-byte command buffer, little endian.
destination	The response's destination buffer.
channel	The DMA channel to use for the transfer.
flags	The ROM control flags to use for the transfer.

◆ cardWriteAndRead()

uint32_t cardWriteAndRead	(	const u8 *	command,
		u32	flags
	)

Perform a ROM command, reading one word of response.

Parameters

command	8-byte command buffer, little endian.
flags	The ROM control flags to use for the transfer.

Returns: uint32_t The response.

◆ cardWriteCommand()

void cardWriteCommand ( const u8 * command )

Write a command to the card interface.

Parameters

command 8-byte command buffer, little endian.

◆ cardWriteEeprom()

void cardWriteEeprom	(	u32	address,
		u8 *	data,
		u32	length,
		u32	addrtype
	)

Write to the card EEPROM.

Note that TYPE 3 (FLASH) EEPROM must be erased before writing.

Parameters

address	The address to write to.
data	The data to write.
length	The length of data, in bytes.
addrtype	The card EEPROM's type.

See also: cardEepromGetType

Functions

Detailed Description

Function Documentation

◆ cardEepromCommand()

◆ cardEepromGetSize()

◆ cardEepromGetType()

◆ cardEepromReadID()

◆ cardEepromSectorErase()

◆ cardParamCommand()

◆ cardPolledTransfer()

◆ cardRead()

◆ cardReadEeprom()

◆ cardReadHeader()

◆ cardReadID()

◆ cardReset()

◆ cardStartTransfer()

◆ cardWriteAndRead()

◆ cardWriteCommand()

◆ cardWriteEeprom()