PS2SDK
PS2 Homebrew Libraries
libmc.h File Reference
#include <libmc-common.h>
+ Include dependency graph for libmc.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  mcIcon
 
struct  _sceMcTblGetDir
 
struct  mcTable
 
struct  mcTable._create
 
struct  mcTable._modify
 

Macros

#define MC_WAIT   0
 
#define MC_NOWAIT   1
 
#define MC_TYPE_PSX   sceMcTypePS1
 
#define MC_TYPE_PS2   sceMcTypePS2
 
#define MC_TYPE_POCKET   sceMcTypePDA
 
#define MC_TYPE_NONE   sceMcTypeNoCard
 
#define MC_FORMATTED   1
 
#define MC_UNFORMATTED   0
 
#define MC_ATTR_READABLE   sceMcFileAttrReadable
 
#define MC_ATTR_WRITEABLE   sceMcFileAttrWriteable
 
#define MC_ATTR_EXECUTABLE   sceMcFileAttrExecutable
 
#define MC_ATTR_PROTECTED   sceMcFileAttrDupProhibit
 
#define MC_ATTR_FILE   sceMcFileAttrFile
 
#define MC_ATTR_SUBDIR   sceMcFileAttrSubdir
 
#define MC_ATTR_OBJECT   (sceMcFileAttrFile|sceMcFileAttrSubdir)
 
#define MC_ATTR_CLOSED   sceMcFileAttrClosed
 
#define MC_ATTR_PDAEXEC   sceMcFileAttrPDAExec
 
#define MC_ATTR_PSX   sceMcFileAttrPS1
 
#define MC_ATTR_HIDDEN   sceMcFileAttrHidden
 
#define MC_TYPE_MC   0
 
#define MC_TYPE_XMC   1
 

Typedefs

typedef int iconIVECTOR[4]
 
typedef float iconFVECTOR[4]
 

Enumerations

enum  MC_FUNC_NUMBERS {
  MC_FUNC_NONE = 0x00, MC_FUNC_GET_INFO, MC_FUNC_OPEN, MC_FUNC_CLOSE,
  MC_FUNC_SEEK, MC_FUNC_READ, MC_FUNC_WRITE, MC_FUNC_FLUSH = 0x0A,
  MC_FUNC_MK_DIR, MC_FUNC_CH_DIR, MC_FUNC_GET_DIR, MC_FUNC_SET_INFO,
  MC_FUNC_DELETE, MC_FUNC_FORMAT, MC_FUNC_UNFORMAT, MC_FUNC_GET_ENT,
  MC_FUNC_RENAME, MC_FUNC_CHG_PRITY, MC_FUNC_ERASE_BLOCK = 0x5A, MC_FUNC_READ_PAGE,
  MC_FUNC_WRITE_PAGE
}
 
enum  MCICON_TYPES {
  MCICON_TYPE_SAVED_DATA = 0, MCICON_TYPE_SOFTWARE_PS2, MCICON_TYPE_SOFTWARE_PKT, MCICON_TYPE_SETTINGS_DATA,
  MCICON_TYPE_SYSTEM_DRIVER
}
 

Functions

struct _sceMcTblGetDir __attribute__ ((aligned(64)))
 
 aligned (64)))
 
int mcInit (int type)
 
int mcGetInfo (int port, int slot, int *type, int *free, int *format)
 
int mcOpen (int port, int slot, const char *name, int mode)
 
int mcClose (int fd)
 
int mcSeek (int fd, int offset, int origin)
 
int mcRead (int fd, void *buffer, int size)
 
int mcWrite (int fd, const void *buffer, int size)
 
int mcFlush (int fd)
 
int mcMkDir (int port, int slot, const char *name)
 
int mcChdir (int port, int slot, const char *newDir, char *currentDir)
 
int mcGetDir (int port, int slot, const char *name, unsigned mode, int maxent, sceMcTblGetDir *table)
 
int mcSetFileInfo (int port, int slot, const char *name, const sceMcTblGetDir *info, unsigned flags)
 
int mcDelete (int port, int slot, const char *name)
 
int mcFormat (int port, int slot)
 
int mcUnformat (int port, int slot)
 
int mcGetEntSpace (int port, int slot, const char *path)
 
int mcRename (int port, int slot, const char *oldName, const char *newName)
 
int mcEraseBlock (int port, int slot, int block, int mode)
 
int mcReadPage (int port, int slot, unsigned int page, void *buffer)
 
int mcWritePage (int port, int slot, int page, const void *buffer)
 
int mcChangeThreadPriority (int level)
 
int mcSync (int mode, int *cmd, int *result)
 
int mcReset (void)
 
int xfromInit (int type)
 
int xfromGetInfo (int port, int slot, int *type, int *free, int *format)
 
int xfromOpen (int port, int slot, const char *name, int mode)
 
int xfromClose (int fd)
 
int xfromSeek (int fd, int offset, int origin)
 
int xfromRead (int fd, void *buffer, int size)
 
int xfromWrite (int fd, const void *buffer, int size)
 
int xfromFlush (int fd)
 
int xfromMkDir (int port, int slot, const char *name)
 
int xfromChdir (int port, int slot, const char *newDir, char *currentDir)
 
int xfromGetDir (int port, int slot, const char *name, unsigned mode, int maxent, sceMcTblGetDir *table)
 
int xfromSetFileInfo (int port, int slot, const char *name, const sceMcTblGetDir *info, unsigned flags)
 
int xfromDelete (int port, int slot, const char *name)
 
int xfromFormat (int port, int slot)
 
int xfromUnformat (int port, int slot)
 
int xfromGetEntSpace (int port, int slot, const char *path)
 
int xfromRename (int port, int slot, const char *oldName, const char *newName)
 
int xfromEraseBlock (int port, int slot, int block, int mode)
 
int xfromReadPage (int port, int slot, unsigned int page, void *buffer)
 
int xfromWritePage (int port, int slot, int page, const void *buffer)
 
int xfromChangeThreadPriority (int level)
 
int xfromSync (int mode, int *cmd, int *result)
 
int xfromReset (void)
 

Variables

sceMcStDateTime _Create
 
sceMcStDateTime _Modify
 
u32 FileSizeByte
 
u16 AttrFile
 
u16 Reserve1
 
u32 Reserve2
 
u32 PdaAplNo
 
unsigned char EntryName [32]
 

Detailed Description

Macros, structures & function prototypes for mclib.

Definition in file libmc.h.


Data Structure Documentation

◆ mcIcon

struct mcIcon

Definition at line 106 of file libmc.h.

Data Fields
unsigned char head[4]

header = "PS2D"

unsigned short type

filetype, used to be "unknown1" (see MCICON_TYPE_* above)

unsigned short nlOffset

new line pos within title name

unsigned unknown2

unknown

unsigned trans

transparency

iconIVECTOR bgCol[4]

background color for each of the four points

iconFVECTOR lightDir[3]

directions of three light sources

iconFVECTOR lightCol[3]

colors of each of these sources

iconFVECTOR lightAmbient

ambient light

unsigned short title[34]

application title - NOTE: stored in sjis, NOT normal ascii

unsigned char view[64]

list icon filename

unsigned char copy[64]

copy icon filename

unsigned char del[64]

delete icon filename

unsigned char unknown3[512]

unknown

◆ _sceMcTblGetDir

struct _sceMcTblGetDir

Definition at line 138 of file libmc.h.

+ Collaboration diagram for _sceMcTblGetDir:
Data Fields
sceMcStDateTime _Create
sceMcStDateTime _Modify
u32 FileSizeByte
u16 AttrFile
u16 Reserve1
u32 Reserve2
u32 PdaAplNo
unsigned char EntryName[32]
char EntryName[32]

◆ mcTable

struct mcTable

Definition at line 149 of file libmc.h.

+ Collaboration diagram for mcTable:
Data Fields
struct mcTable _create
struct mcTable _modify
unsigned fileSizeByte

File size (bytes). For a directory entry: 0

unsigned short attrFile

File attribute

unsigned short unknown3
unsigned unknown4[2]
unsigned char name[32]

Entry name

◆ mcTable._create

struct mcTable._create

Definition at line 151 of file libmc.h.

Data Fields
unsigned char unknown1
unsigned char sec

Entry creation date/time (second)

unsigned char min

Entry creation date/time (minute)

unsigned char hour

Entry creation date/time (hour)

unsigned char day

Entry creation date/time (day)

unsigned char month

Entry creation date/time (month)

unsigned short year

Entry creation date/time (year)

◆ mcTable._modify

struct mcTable._modify

Definition at line 168 of file libmc.h.

Data Fields
unsigned char unknown2
unsigned char sec

Entry modification date/time (second)

unsigned char min

Entry modification date/time (minute)

unsigned char hour

Entry modification date/time (hour)

unsigned char day

Entry modification date/time (day)

unsigned char month

Entry modification date/time (month)

unsigned short year

Entry modification date/time (year)

Macro Definition Documentation

◆ MC_ATTR_OBJECT

#define MC_ATTR_OBJECT   (sceMcFileAttrFile|sceMcFileAttrSubdir)

File or directory

Definition at line 57 of file libmc.h.

◆ MC_ATTR_HIDDEN

#define MC_ATTR_HIDDEN   sceMcFileAttrHidden

not hidden in osdsys, but it is to games

Definition at line 62 of file libmc.h.

Enumeration Type Documentation

◆ MC_FUNC_NUMBERS

function numbers returned by mcSync in the 'cmd' pointer

Definition at line 65 of file libmc.h.

◆ MCICON_TYPES

These types show up in the OSD browser when set. If the OSD doesn't know the number it'll display "Unrecognizable Data" or so. AFAIK these have no other effects. Known type IDs for icon.sys file:

Definition at line 95 of file libmc.h.

Function Documentation

◆ mcInit()

int mcInit ( int  type)

init memcard lib

Parameters
typeRetained for backwards compatibility. Nominally specify MC_TYPE_MC.
Returns
0 = successful; < 0 = error

Definition at line 856 of file libmc.c.

◆ mcGetInfo()

int mcGetInfo ( int  port,
int  slot,
int *  type,
int *  free,
int *  format 
)

get memcard state mcSync result: 0 = same card as last getInfo call -1 = formatted card inserted since last getInfo call -2 = unformatted card inserted since last getInfo call < -2 = memcard access error (could be due to accessing psx memcard)

Parameters
portport number
slotslot number
typepointer to get memcard type
freepointer to get number of free clusters
formatpointer to get whether or not the card is formatted (Note: Originally, sceMcGetInfo didn't have a 5th argument for returning the format status. As this is emulated based on the return value of sceMcSync() when rom0:MCSERV is used, please keep track of the return value from sceMcSync instead!)
Returns
0 = successful; < 0 = error

Definition at line 865 of file libmc.c.

◆ mcOpen()

int mcOpen ( int  port,
int  slot,
const char *  name,
int  mode 
)

open a file on memcard mcSync returns: 0 or more = file descriptor (success) < 0 = error

Parameters
portport number
slotslot number
namefilename to open
modeopen file mode (O_RDWR, O_CREAT, etc)
Returns
0 = successful; < 0 = error

Definition at line 873 of file libmc.c.

◆ mcClose()

int mcClose ( int  fd)

close an open file on memcard mcSync returns: 0 if closed successfully < 0 = error

Parameters
fdfile descriptor of open file
Returns
0 successful; < 0 = error

Definition at line 881 of file libmc.c.

◆ mcSeek()

int mcSeek ( int  fd,
int  offset,
int  origin 
)

move memcard file pointer mcSync returns: 0 or more = offset of file pointer from start of file < 0 = error

Parameters
fdfile descriptor
offsetnumber of bytes from origin
origininitial position for offset
Returns
0 = successful; < 0 = error

Definition at line 889 of file libmc.c.

◆ mcRead()

int mcRead ( int  fd,
void *  buffer,
int  size 
)

read from file on memcard mcSync returns: 0 or more = number of bytes read from memcard < 0 = error

Parameters
fdfile descriptor
bufferbuffer to read to
sizenumber of bytes to read
Returns
0 = successful; < 0 = error

Definition at line 897 of file libmc.c.

◆ mcWrite()

int mcWrite ( int  fd,
const void *  buffer,
int  size 
)

write to file on memcard mcSync returns: 0 or more = number of bytes written to memcard < 0 = error

Parameters
fdfile descriptor
bufferto write from write
sizenumber of bytes to read
Returns
0 = successful; < 0 = error

Definition at line 905 of file libmc.c.

◆ mcFlush()

int mcFlush ( int  fd)

flush file cache to memcard mcSync returns: 0 if ok < 0 if error

Parameters
fdfile descriptor
Returns
0 = successful; < 0 = error

Definition at line 913 of file libmc.c.

◆ mcMkDir()

int mcMkDir ( int  port,
int  slot,
const char *  name 
)

create a dir mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
namedirectory name
Returns
0 = successful; < 0 = error

Definition at line 921 of file libmc.c.

◆ mcChdir()

int mcChdir ( int  port,
int  slot,
const char *  newDir,
char *  currentDir 
)

change current dir (can also get current dir) mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
newDirnew dir to change to
currentDirbuffer to get current dir (use 0 if not needed)
Returns
0 = successful; < 0 = error

Definition at line 929 of file libmc.c.

◆ mcGetDir()

int mcGetDir ( int  port,
int  slot,
const char *  name,
unsigned  mode,
int  maxent,
sceMcTblGetDir table 
)

get memcard filelist mcSync result: 0 or more = number of file entries obtained (success) -2 = unformatted card -4 = dirname error

Parameters
portport number of memcard
slotslot number of memcard
namefilename to search for (can use wildcard and relative dirs)
modemode: 0 = first call, otherwise = followup call
maxextmaximum number of entries to be written to filetable in 1 call
tablemc table array
Returns
0 = successful; < 0 = error

Definition at line 937 of file libmc.c.

◆ mcSetFileInfo()

int mcSetFileInfo ( int  port,
int  slot,
const char *  name,
const sceMcTblGetDir info,
unsigned  flags 
)

change file information mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
namefilename to access
infodata to be changed
flagsflags to show which data is valid
Returns
0 = successful; < 0 = error

Definition at line 945 of file libmc.c.

◆ mcDelete()

int mcDelete ( int  port,
int  slot,
const char *  name 
)

delete file mcSync returns: 0 if deleted successfully < 0 if error

Parameters
portport number to delete from
slotslot number to delete from
namefilename to delete
Returns
0 = successful; < 0 = error

Definition at line 953 of file libmc.c.

◆ mcFormat()

int mcFormat ( int  port,
int  slot 
)

format memory card mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
Returns
0 = success; -1 = error

Definition at line 961 of file libmc.c.

◆ mcUnformat()

int mcUnformat ( int  port,
int  slot 
)

unformat memory card mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
Returns
0 = success; -1 = error

Definition at line 969 of file libmc.c.

◆ mcGetEntSpace()

int mcGetEntSpace ( int  port,
int  slot,
const char *  path 
)

get free space info mcSync returns: 0 or more = number of free entries (success) < 0 if error

Parameters
portport number
slotslot number
pathpath to be checked
Returns
0 or more = number of empty entries; -1 = error

Definition at line 977 of file libmc.c.

◆ mcRename()

int mcRename ( int  port,
int  slot,
const char *  oldName,
const char *  newName 
)

rename file or dir on memcard Note: rom0:MCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
oldNamename of file/dir to rename
newNamenew name to give to file/dir
Returns
1 = success; < 0 = error

Definition at line 985 of file libmc.c.

◆ mcEraseBlock()

int mcEraseBlock ( int  port,
int  slot,
int  block,
int  mode 
)

Erases a block on the memory card. Note: rom0:XMCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
blockBlock number of the block to be erased.
modeMode: -1 to inhibit ECC recalculation of the erased block's pages (useful if sceMcWritePage is used to fill in its contents later on), 0 for normal operation.
Returns
0 = success; -1 = error

Definition at line 993 of file libmc.c.

◆ mcReadPage()

int mcReadPage ( int  port,
int  slot,
unsigned int  page,
void *  buffer 
)

Reads a page from the memory card. Note: rom0:XMCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
pagePage number of the page to be read.
bufferPointer to buffer that will contain the read data.
Returns
0 = success; -1 = error

Definition at line 1001 of file libmc.c.

◆ mcWritePage()

int mcWritePage ( int  port,
int  slot,
int  page,
const void *  buffer 
)

Writes a page to the memory card. (The block which the page resides on must be erased first!) Note: rom0:XMCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
pagePage number of the page to be written.
bufferPointer to buffer containing data to be written.
Returns
0 = success; -1 = error

Definition at line 1009 of file libmc.c.

◆ mcChangeThreadPriority()

int mcChangeThreadPriority ( int  level)

change mcserv thread priority (I don't think this is implemented properly) Note: rom0:MCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters
levelthread priority
Returns
0 = success; -1 = error

Definition at line 1017 of file libmc.c.

◆ mcSync()

int mcSync ( int  mode,
int *  cmd,
int *  result 
)

wait for mc functions to finish or check if they have finished yet

Parameters
modemode 0=wait till function finishes, 1=check function status
cmdpointer for storing the number of the currenlty processing function
resultpointer for storing result of function if it finishes
Returns
0 = function is still executing (mode=1); 1 = function has finished executing; -1 = no function registered

Definition at line 1025 of file libmc.c.

◆ mcReset()

int mcReset ( void  )

Reset (force deinit) of library

Returns
0 = success

Definition at line 1033 of file libmc.c.

◆ xfromInit()

int xfromInit ( int  type)

init external flash ROM lib

Returns
0 = successful; < 0 = error

Definition at line 1041 of file libmc.c.

◆ xfromGetInfo()

int xfromGetInfo ( int  port,
int  slot,
int *  type,
int *  free,
int *  format 
)

get external flash ROM state xfromSync result: 0 = same external flash ROM as last getInfo call -1 = formatted external flash ROM inserted since last getInfo call -2 = unformatted external flash ROM inserted since last getInfo call < -2 = external flash ROM access error (could be due to accessing psx external flash ROM)

Parameters
portport number
slotslot number
typepointer to get external flash ROM type
freepointer to get number of free clusters
formatpointer to get whether or not the external flash ROM is formatted
Returns
0 = successful; < 0 = error

Definition at line 1050 of file libmc.c.

◆ xfromOpen()

int xfromOpen ( int  port,
int  slot,
const char *  name,
int  mode 
)

open a file on external flash ROM xfromSync returns: 0 or more = file descriptor (success) < 0 = error

Parameters
portport number
slotslot number
namefilename to open
modeopen file mode (O_RDWR, O_CREAT, etc)
Returns
0 = successful; < 0 = error

Definition at line 1058 of file libmc.c.

◆ xfromClose()

int xfromClose ( int  fd)

close an open file on external flash ROM xfromSync returns: 0 if closed successfully < 0 = error

Parameters
fdfile descriptor of open file
Returns
0 successful; < 0 = error

Definition at line 1066 of file libmc.c.

◆ xfromSeek()

int xfromSeek ( int  fd,
int  offset,
int  origin 
)

move external flash ROM file pointer xfromSync returns: 0 or more = offset of file pointer from start of file < 0 = error

Parameters
fdfile descriptor
offsetnumber of bytes from origin
origininitial position for offset
Returns
0 = successful; < 0 = error

Definition at line 1074 of file libmc.c.

◆ xfromRead()

int xfromRead ( int  fd,
void *  buffer,
int  size 
)

read from file on external flash ROM xfromSync returns: 0 or more = number of bytes read from external flash ROM < 0 = error

Parameters
fdfile descriptor
bufferbuffer to read to
sizenumber of bytes to read
Returns
0 = successful; < 0 = error

Definition at line 1082 of file libmc.c.

◆ xfromWrite()

int xfromWrite ( int  fd,
const void *  buffer,
int  size 
)

write to file on external flash ROM xfromSync returns: 0 or more = number of bytes written to external flash ROM < 0 = error

Parameters
fdfile descriptor
bufferto write from write
sizenumber of bytes to read
Returns
0 = successful; < 0 = error

Definition at line 1090 of file libmc.c.

◆ xfromFlush()

int xfromFlush ( int  fd)

flush file cache to external flash ROM xfromSync returns: 0 if ok < 0 if error

Parameters
fdfile descriptor
Returns
0 = successful; < 0 = error

Definition at line 1098 of file libmc.c.

◆ xfromMkDir()

int xfromMkDir ( int  port,
int  slot,
const char *  name 
)

create a dir xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
namedirectory name
Returns
0 = successful; < 0 = error

Definition at line 1106 of file libmc.c.

◆ xfromChdir()

int xfromChdir ( int  port,
int  slot,
const char *  newDir,
char *  currentDir 
)

change current dir (can also get current dir) xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
newDirnew dir to change to
currentDirbuffer to get current dir (use 0 if not needed)
Returns
0 = successful; < 0 = error

Definition at line 1114 of file libmc.c.

◆ xfromGetDir()

int xfromGetDir ( int  port,
int  slot,
const char *  name,
unsigned  mode,
int  maxent,
sceMcTblGetDir table 
)

get external flash ROM filelist xfromSync result: 0 or more = number of file entries obtained (success) -2 = unformatted external flash ROM -4 = dirname error

Parameters
portport number of external flash ROM
slotslot number of external flash ROM
namefilename to search for (can use wildcard and relative dirs)
modemode: 0 = first call, otherwise = followup call
maxextmaximum number of entries to be written to filetable in 1 call
tableexternal flash ROM table array
Returns
0 = successful; < 0 = error

Definition at line 1122 of file libmc.c.

◆ xfromSetFileInfo()

int xfromSetFileInfo ( int  port,
int  slot,
const char *  name,
const sceMcTblGetDir info,
unsigned  flags 
)

change file information xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
namefilename to access
infodata to be changed
flagsflags to show which data is valid
Returns
0 = successful; < 0 = error

Definition at line 1130 of file libmc.c.

◆ xfromDelete()

int xfromDelete ( int  port,
int  slot,
const char *  name 
)

delete file xfromSync returns: 0 if deleted successfully < 0 if error

Parameters
portport number to delete from
slotslot number to delete from
namefilename to delete
Returns
0 = successful; < 0 = error

Definition at line 1138 of file libmc.c.

◆ xfromFormat()

int xfromFormat ( int  port,
int  slot 
)

format external flash ROM xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
Returns
0 = success; -1 = error

Definition at line 1146 of file libmc.c.

◆ xfromUnformat()

int xfromUnformat ( int  port,
int  slot 
)

unformat external flash ROM xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
Returns
0 = success; -1 = error

Definition at line 1154 of file libmc.c.

◆ xfromGetEntSpace()

int xfromGetEntSpace ( int  port,
int  slot,
const char *  path 
)

get free space info xfromSync returns: 0 or more = number of free entries (success) < 0 if error

Parameters
portport number
slotslot number
pathpath to be checked
Returns
0 or more = number of empty entries; -1 = error

Definition at line 1162 of file libmc.c.

◆ xfromRename()

int xfromRename ( int  port,
int  slot,
const char *  oldName,
const char *  newName 
)

rename file or dir on external flash ROM xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
oldNamename of file/dir to rename
newNamenew name to give to file/dir
Returns
1 = success; < 0 = error

Definition at line 1170 of file libmc.c.

◆ xfromEraseBlock()

int xfromEraseBlock ( int  port,
int  slot,
int  block,
int  mode 
)

Erases a block on the external flash ROM. Note: The current implementation of xfromserv does not support this. xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
blockBlock number of the block to be erased.
modeMode: -1 to inhibit ECC recalculation of the erased block's pages (useful if xfromWritePage is used to fill in its contents later on), 0 for normal operation.
Returns
0 = success; -1 = error

Definition at line 1178 of file libmc.c.

◆ xfromReadPage()

int xfromReadPage ( int  port,
int  slot,
unsigned int  page,
void *  buffer 
)

Reads a page from the external flash ROM. Note: The current implementation of xfromserv does not support this. xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
pagePage number of the page to be read.
bufferPointer to buffer that will contain the read data.
Returns
0 = success; -1 = error

Definition at line 1186 of file libmc.c.

◆ xfromWritePage()

int xfromWritePage ( int  port,
int  slot,
int  page,
const void *  buffer 
)

Writes a page to the external flash ROM. (The block which the page resides on must be erased first!) Note: The current implementation of xfromserv does not support this. xfromSync returns: 0 if ok < 0 if error

Parameters
portport number
slotslot number
pagePage number of the page to be written.
bufferPointer to buffer containing data to be written.
Returns
0 = success; -1 = error

Definition at line 1194 of file libmc.c.

◆ xfromChangeThreadPriority()

int xfromChangeThreadPriority ( int  level)

change xfromserv thread priority (I don't think this is implemented properly) xfromSync returns: 0 if ok < 0 if error

Parameters
levelthread priority
Returns
0 = success; -1 = error

Definition at line 1202 of file libmc.c.

◆ xfromSync()

int xfromSync ( int  mode,
int *  cmd,
int *  result 
)

wait for external flash ROM functions to finish or check if they have finished yet

Parameters
modemode 0=wait till function finishes, 1=check function status
cmdpointer for storing the number of the currenlty processing function
resultpointer for storing result of function if it finishes
Returns
0 = function is still executing (mode=1); 1 = function has finished executing; -1 = no function registered

Definition at line 1210 of file libmc.c.

◆ xfromReset()

int xfromReset ( void  )

Reset (force deinit) of library

Returns
0 = success

Definition at line 1218 of file libmc.c.