vitasdk
Documentation of the vitasdk
Modules | Data Structures | Macros | Typedefs | Enumerations | Enumerator | Functions | Variables
Kernel
Kernel » Direct Memory Access Controller

Exports for Kernel. More...

Modules

 DMAC Register Fields
 

Data Structures

struct  SceKernelDmaOpTag
 
struct  SceKernelDmaOpEncDec
 
struct  SceKernelDmaOpChainParam
 
struct  SceKernelDmaOpEncDecChainParam
 
struct  SceKernelDmaOpDirectParam
 

Macros

#define SCE_KERNEL_DMAC_CHAIN_END   ((SceKernelDmaOpTag *)0xFFFFFFFF)
 Signifies the end of the DMA tag chain.
 

Typedefs

typedef SceInt32 SceKernelDmaOpId
 
typedef void(* SceKernelDmaOpCallback) (SceKernelDmaOpId opid, SceUInt32 stat, void *pUserData, SceKernelDmaOpTag *pTag)
 

Enumerations

enum  SceKernelDmacId {
  SCE_KERNEL_DMAC_ID_DMAC01 = 0x10 , SCE_KERNEL_DMAC_ID_DMAC23 = 0x11 , SCE_KERNEL_DMAC_ID_DMAC4 = 0x12 , SCE_KERNEL_DMAC_ID_DMAC5 = 0x13 ,
  SCE_KERNEL_DMAC_ID_DMAC6 = 0x14
}
 
enum  SceKernelDmaOpFlag {
  SCE_KERNEL_DMA_OP_PHYSICAL_ADDR = 0x000 , SCE_KERNEL_DMA_OP_VIRTUAL_SRC_ADDR = 0x001 , SCE_KERNEL_DMA_OP_VIRTUAL_DST_ADDR = 0x010 , SCE_KERNEL_DMA_OP_VIRTUAL_ADDR = 0x011 ,
  SCE_KERNEL_DMA_OP_COMPLETE_CHAIN = 0x100
}
 
enum  SceKernelDmaOpSyncMode { SCE_KERNEL_DMA_OP_SYNC_POLL = 0x1 , SCE_KERNEL_DMA_OP_SYNC_WAIT = 0x2 , SCE_KERNEL_DMA_OP_SYNC_TIMED_WAIT = 0x3 }
 

Functions

 VITASDK_BUILD_ASSERT_EQ (4, SceKernelDmaOpId)
 
 VITASDK_BUILD_ASSERT_EQ (0x20, SceKernelDmaOpTag)
 
 VITASDK_BUILD_ASSERT_EQ (0x50, SceKernelDmaOpEncDec)
 
 VITASDK_BUILD_ASSERT_EQ (0xC, SceKernelDmaOpChainParam)
 
 VITASDK_BUILD_ASSERT_EQ (0x5C, SceKernelDmaOpEncDecChainParam)
 
 VITASDK_BUILD_ASSERT_EQ (0x6C, SceKernelDmaOpDirectParam)
 
SceKernelDmaOpId ksceKernelDmaOpAlloc (const char *name)
 Allocate a DMA Op handle.
 
int ksceKernelDmaOpFree (SceKernelDmaOpId opid)
 Free a DMA Op handle.
 
int ksceKernelDmaOpEnQueue (SceKernelDmaOpId opid)
 Enqueue a DMA Op.
 
int ksceKernelDmaOpDeQueue (SceKernelDmaOpId opid)
 Dequeue a DMA Op.
 
int ksceKernelDmaOpQuit (SceKernelDmaOpId opid)
 Cancel a DMA Op.
 
int ksceKernelDmaOpSync (SceKernelDmaOpId opid, SceKernelDmaOpSyncMode syncMode, SceUInt32 *pTimeout, SceKernelDmaOpTag **ppErrorTag)
 Synchronize with the completion of a DMA Op.
 
int ksceKernelDmaOpAssign (SceKernelDmaOpId opid, SceKernelDmacId dmac, SceUInt32 channel)
 Assign a DMA Op to one of the DMA controllers.
 
int ksceKernelDmaOpSetupDirect (SceKernelDmaOpId opid, SceKernelDmaOpDirectParam *pParam, SceKernelDmaOpFlag flag)
 Setup a DMA Op with a direct set of parameters.
 
int ksceKernelDmaOpSetupChain (SceKernelDmaOpId opid, SceKernelDmaOpTag *pTag, SceKernelDmaOpChainParam *pParam, SceKernelDmaOpFlag flag)
 Setup a DMA Op with a chain of tags.
 
int ksceKernelDmaOpConcatenate (SceKernelDmaOpId opid, SceKernelDmaOpTag *pTag, SceKernelDmaOpFlag flag)
 Append a new list of tags to the DMA Op.
 
int ksceKernelDmaOpSetCallback (SceKernelDmaOpId opid, SceKernelDmaOpCallback callback, void *pUserData)
 Set the callback for the completion of the DMA Op.
 

Variables

const void * SceKernelDmaOpTag::src
 
void * SceKernelDmaOpTag::dst
 
SceUInt32 SceKernelDmaOpTag::len
 
SceUInt32 SceKernelDmaOpTag::cmd
 Bitwise combination of SCE_KERNEL_DMAC_CMD_* fields.
 
SceUInt32 SceKernelDmaOpTag::keyring
 
void * SceKernelDmaOpTag::iv
 Must be a physical address.
 
SceUInt32 SceKernelDmaOpTag::blockSize
 
struct SceKernelDmaOpTag * SceKernelDmaOpTag::pNext
 Set to SCE_KERNEL_DMAC_CHAIN_END to signify the last tag.
 
SceUInt32 SceKernelDmaOpEncDec::keyring
 
void * SceKernelDmaOpEncDec::iv
 Must be a physical address.
 
SceUInt32 SceKernelDmaOpEncDec::ivCoherencyMask
 
SceUInt32 SceKernelDmaOpEncDec::reserved
 
SceUInt8 SceKernelDmaOpEncDec::key [0x40]
 
SceSize SceKernelDmaOpChainParam::size
 
SceUInt32 SceKernelDmaOpChainParam::coherencyMask
 
SceUInt32 SceKernelDmaOpChainParam::setValue
 8-bit value duplicated into 32 bits
 
SceKernelDmaOpChainParam SceKernelDmaOpEncDecChainParam::header
 header.size = sizeof(SceKernelDmaOpEncDecChainParam)
 
SceKernelDmaOpEncDec SceKernelDmaOpEncDecChainParam::encDec
 
const void * SceKernelDmaOpDirectParam::src
 
void * SceKernelDmaOpDirectParam::dst
 
SceUInt32 SceKernelDmaOpDirectParam::len
 
SceUInt32 SceKernelDmaOpDirectParam::cmd
 Bitwise combination of SCE_KERNEL_DMAC_CMD_* fields.
 
SceUInt32 SceKernelDmaOpDirectParam::blockSize
 
SceUInt32 SceKernelDmaOpDirectParam::coherencyMask
 
SceUInt32 SceKernelDmaOpDirectParam::setValue
 8-bit value duplicated into 32 bits
 
SceKernelDmaOpEncDec SceKernelDmaOpDirectParam::encDec
 

Generic DMA Functions

int ksceDmacMemcpy (void *dst, const void *src, SceSize size)
 DMA memcpy.
 
int ksceDmacMemset (void *dst, int c, SceSize size)
 DMA memset.
 

Detailed Description

Exports for Kernel.

Using this library in your project

Include the header file in your project:

#include <psp2kern/kernel/dmac.h>


Link the library to the executable:

SceDmacmgrForDriver_stub


Data Structure Documentation

◆ SceKernelDmaOpTag

struct SceKernelDmaOpTag
Data Fields
const void * src
void * dst
SceUInt32 len
SceUInt32 cmd Bitwise combination of SCE_KERNEL_DMAC_CMD_* fields.
SceUInt32 keyring
void * iv Must be a physical address.
SceUInt32 blockSize
struct SceKernelDmaOpTag * pNext Set to SCE_KERNEL_DMAC_CHAIN_END to signify the last tag.

◆ SceKernelDmaOpEncDec

struct SceKernelDmaOpEncDec
Data Fields
SceUInt32 keyring
void * iv Must be a physical address.
SceUInt32 ivCoherencyMask
SceUInt32 reserved
SceUInt8 key[0x40]

◆ SceKernelDmaOpChainParam

struct SceKernelDmaOpChainParam
Data Fields
SceSize size
SceUInt32 coherencyMask
SceUInt32 setValue 8-bit value duplicated into 32 bits

◆ SceKernelDmaOpEncDecChainParam

struct SceKernelDmaOpEncDecChainParam
Data Fields
SceKernelDmaOpChainParam header header.size = sizeof(SceKernelDmaOpEncDecChainParam)
SceKernelDmaOpEncDec encDec

◆ SceKernelDmaOpDirectParam

struct SceKernelDmaOpDirectParam
Data Fields
const void * src
void * dst
SceUInt32 len
SceUInt32 cmd Bitwise combination of SCE_KERNEL_DMAC_CMD_* fields.
SceUInt32 blockSize
SceUInt32 coherencyMask
SceUInt32 setValue 8-bit value duplicated into 32 bits
SceKernelDmaOpEncDec encDec

Macro Definition Documentation

◆ SCE_KERNEL_DMAC_CHAIN_END

#define SCE_KERNEL_DMAC_CHAIN_END   ((SceKernelDmaOpTag *)0xFFFFFFFF)

Signifies the end of the DMA tag chain.

Typedef Documentation

◆ SceKernelDmaOpId

typedef SceInt32 SceKernelDmaOpId

◆ SceKernelDmaOpCallback

typedef void(* SceKernelDmaOpCallback) (SceKernelDmaOpId opid, SceUInt32 stat, void *pUserData, SceKernelDmaOpTag *pTag)

Enumeration Type Documentation

◆ SceKernelDmacId

enum SceKernelDmacId
Enumerator
SCE_KERNEL_DMAC_ID_DMAC01 

DMAC0/1.

SCE_KERNEL_DMAC_ID_DMAC23 

DMAC2/3.

SCE_KERNEL_DMAC_ID_DMAC4 

DMAC4.

SCE_KERNEL_DMAC_ID_DMAC5 

DMAC5.

SCE_KERNEL_DMAC_ID_DMAC6 

DMAC6 (Devkit only)

◆ SceKernelDmaOpFlag

enum SceKernelDmaOpFlag
Enumerator
SCE_KERNEL_DMA_OP_PHYSICAL_ADDR 

src and dst addresses are physical addresses

SCE_KERNEL_DMA_OP_VIRTUAL_SRC_ADDR 

src addresses are virtual addresses

SCE_KERNEL_DMA_OP_VIRTUAL_DST_ADDR 

dst addresses is virtual addresses

SCE_KERNEL_DMA_OP_VIRTUAL_ADDR 

Both src and dst addresses are virtual addresses.

SCE_KERNEL_DMA_OP_COMPLETE_CHAIN 

Full DMA chain is provided, starting from pTag and ending with pTag + 1.

◆ SceKernelDmaOpSyncMode

enum SceKernelDmaOpSyncMode
Enumerator
SCE_KERNEL_DMA_OP_SYNC_POLL 

Poll for completion without waiting.

SCE_KERNEL_DMA_OP_SYNC_WAIT 

Wait for completion.

SCE_KERNEL_DMA_OP_SYNC_TIMED_WAIT 

Wait for completion with timeout.

Function Documentation

◆ ksceDmacMemcpy()

int ksceDmacMemcpy ( void *  dst,
const void *  src,
SceSize  size 
)

DMA memcpy.

Parameters
[in]dst- Destination
[in]src- Source
[in]size- Size
Returns
0 on success, < 0 on error.

◆ ksceDmacMemset()

int ksceDmacMemset ( void *  dst,
int  c,
SceSize  size 
)

DMA memset.

Parameters
[in]dst- Destination
[in]c- Constant
[in]size- Size
Returns
0 on success, < 0 on error.

◆ VITASDK_BUILD_ASSERT_EQ() [1/6]

VITASDK_BUILD_ASSERT_EQ ( 4  ,
SceKernelDmaOpId   
)

◆ VITASDK_BUILD_ASSERT_EQ() [2/6]

VITASDK_BUILD_ASSERT_EQ ( 0x20  ,
SceKernelDmaOpTag   
)

◆ VITASDK_BUILD_ASSERT_EQ() [3/6]

VITASDK_BUILD_ASSERT_EQ ( 0x50  ,
SceKernelDmaOpEncDec   
)

◆ VITASDK_BUILD_ASSERT_EQ() [4/6]

VITASDK_BUILD_ASSERT_EQ ( 0xC  ,
SceKernelDmaOpChainParam   
)

◆ VITASDK_BUILD_ASSERT_EQ() [5/6]

VITASDK_BUILD_ASSERT_EQ ( 0x5C  ,
SceKernelDmaOpEncDecChainParam   
)

◆ VITASDK_BUILD_ASSERT_EQ() [6/6]

VITASDK_BUILD_ASSERT_EQ ( 0x6C  ,
SceKernelDmaOpDirectParam   
)

◆ ksceKernelDmaOpAlloc()

SceKernelDmaOpId ksceKernelDmaOpAlloc ( const char *  name)

Allocate a DMA Op handle.

Parameters
name- Name of the DMA Op.
Returns
the ID of the DMA Op on success, < 0 on error.

◆ ksceKernelDmaOpFree()

int ksceKernelDmaOpFree ( SceKernelDmaOpId  opid)

Free a DMA Op handle.

Parameters
opid- The DMA Op to free.
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpEnQueue()

int ksceKernelDmaOpEnQueue ( SceKernelDmaOpId  opid)

Enqueue a DMA Op.

Parameters
opid- The target DMA Op.
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpDeQueue()

int ksceKernelDmaOpDeQueue ( SceKernelDmaOpId  opid)

Dequeue a DMA Op.

Parameters
opid- The target DMA Op.
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpQuit()

int ksceKernelDmaOpQuit ( SceKernelDmaOpId  opid)

Cancel a DMA Op.

Parameters
opid- The target DMA Op.
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpSync()

int ksceKernelDmaOpSync ( SceKernelDmaOpId  opid,
SceKernelDmaOpSyncMode  syncMode,
SceUInt32 *  pTimeout,
SceKernelDmaOpTag **  ppErrorTag 
)

Synchronize with the completion of a DMA Op.

Parameters
opid- The target DMA Op.
syncMode- One of SceKernelDmaOpSyncMode
pTimeout- Time limit for SCE_KERNEL_DMA_OP_SYNC_TIMED_WAIT
ppErrorTag- The SceKernelDmaOpTag which was running when the DMA Op failed.
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpAssign()

int ksceKernelDmaOpAssign ( SceKernelDmaOpId  opid,
SceKernelDmacId  dmac,
SceUInt32  channel 
)

Assign a DMA Op to one of the DMA controllers.

Parameters
opid- The target DMA Op.
dmac- The DMA controller to assign it to.
channel- The channel of the controller (0 - 15 for DMAC4, 0 otherwise).
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpSetupDirect()

int ksceKernelDmaOpSetupDirect ( SceKernelDmaOpId  opid,
SceKernelDmaOpDirectParam *  pParam,
SceKernelDmaOpFlag  flag 
)

Setup a DMA Op with a direct set of parameters.

Parameters
opid- The target DMA Op.
pParam- The parameters for the DMA Op.
flag- One of SceKernelDmaOpFlag, excluding SCE_KERNEL_DMA_OP_COMPLETE_CHAIN.
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpSetupChain()

int ksceKernelDmaOpSetupChain ( SceKernelDmaOpId  opid,
SceKernelDmaOpTag *  pTag,
SceKernelDmaOpChainParam *  pParam,
SceKernelDmaOpFlag  flag 
)

Setup a DMA Op with a chain of tags.

Parameters
opid- The target DMA Op.
pTag- The list of DMA tags for the op.
pParam- The parameters for the DMA Op.
flag- One of SceKernelDmaOpFlag.
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpConcatenate()

int ksceKernelDmaOpConcatenate ( SceKernelDmaOpId  opid,
SceKernelDmaOpTag *  pTag,
SceKernelDmaOpFlag  flag 
)

Append a new list of tags to the DMA Op.

Parameters
opid- The target DMA Op.
pTag- The list of DMA tags to append.
flag- One of SceKernelDmaOpFlag.
Returns
0 on success, < 0 on error.

◆ ksceKernelDmaOpSetCallback()

int ksceKernelDmaOpSetCallback ( SceKernelDmaOpId  opid,
SceKernelDmaOpCallback  callback,
void *  pUserData 
)

Set the callback for the completion of the DMA Op.

Parameters
opid- The target DMA Op.
callback- The callback.
pUserData- The callback parameter.
Returns
0 on success, < 0 on error.

Variable Documentation

◆ src [1/2]

const void* SceKernelDmaOpTag::src

◆ dst [1/2]

void* SceKernelDmaOpTag::dst

◆ len [1/2]

SceUInt32 SceKernelDmaOpTag::len

◆ cmd [1/2]

SceUInt32 SceKernelDmaOpTag::cmd

Bitwise combination of SCE_KERNEL_DMAC_CMD_* fields.

◆ keyring [1/2]

SceUInt32 SceKernelDmaOpTag::keyring

◆ iv [1/2]

void* SceKernelDmaOpTag::iv

Must be a physical address.

◆ blockSize [1/2]

SceUInt32 SceKernelDmaOpTag::blockSize

◆ pNext

struct SceKernelDmaOpTag* SceKernelDmaOpTag::pNext

Set to SCE_KERNEL_DMAC_CHAIN_END to signify the last tag.

◆ keyring [2/2]

SceUInt32 SceKernelDmaOpEncDec::keyring

◆ iv [2/2]

void* SceKernelDmaOpEncDec::iv

Must be a physical address.

◆ ivCoherencyMask

SceUInt32 SceKernelDmaOpEncDec::ivCoherencyMask

◆ reserved

SceUInt32 SceKernelDmaOpEncDec::reserved

◆ key

SceUInt8 SceKernelDmaOpEncDec::key[0x40]

◆ size

SceSize SceKernelDmaOpChainParam::size

◆ coherencyMask [1/2]

SceUInt32 SceKernelDmaOpChainParam::coherencyMask

◆ setValue [1/2]

SceUInt32 SceKernelDmaOpChainParam::setValue

8-bit value duplicated into 32 bits

◆ header

SceKernelDmaOpChainParam SceKernelDmaOpEncDecChainParam::header

header.size = sizeof(SceKernelDmaOpEncDecChainParam)

◆ encDec [1/2]

SceKernelDmaOpEncDec SceKernelDmaOpEncDecChainParam::encDec

◆ src [2/2]

const void* SceKernelDmaOpDirectParam::src

◆ dst [2/2]

void* SceKernelDmaOpDirectParam::dst

◆ len [2/2]

SceUInt32 SceKernelDmaOpDirectParam::len

◆ cmd [2/2]

SceUInt32 SceKernelDmaOpDirectParam::cmd

Bitwise combination of SCE_KERNEL_DMAC_CMD_* fields.

◆ blockSize [2/2]

SceUInt32 SceKernelDmaOpDirectParam::blockSize

◆ coherencyMask [2/2]

SceUInt32 SceKernelDmaOpDirectParam::coherencyMask

◆ setValue [2/2]

SceUInt32 SceKernelDmaOpDirectParam::setValue

8-bit value duplicated into 32 bits

◆ encDec [2/2]

SceKernelDmaOpEncDec SceKernelDmaOpDirectParam::encDec