head 1.1; branch 1.1.1; access ; symbols start:1.1.1.1 PAlibDoc:1.1.1; locks ; strict; comment @# @; 1.1 date 2005.11.02.08.30.36; author jandujar; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2005.11.02.08.30.36; author jandujar; state Exp; branches ; next ; desc @@ 1.1 log @Initial revision @ text @ PA_lib: Saving commands !!!

Saving commands !!!


Macros

#define PA_Save8bit(offset, value)   SRAM[offset] = value
 Sauvegarde une valeur 8 bits dans une section donnée de la SRAM. Utilise 1 section
#define PA_Save16bit(offset, value)   {PA_Save8bit(offset, value&255); PA_Save8bit(offset + 1, value >> 8)}
 Sauvegarde une valeur 8 bits dans une section donnée de la SRAM. Utilise 2 sections
#define PA_Save32bit(offset, value)   {PA_Save8bit(offset, value&255); PA_Save8bit(offset + 1, value >> 8); PA_Save8bit(offset + 2, value >> 16); PA_Save8bit(offset + 3, value >> 24);}
 Sauvegarde une valeur 32 bits dans une section donnée de la SRAM. Utilise 4 sections
#define PA_Load8bit(offset)   SRAM[offset]
 Retourne une valeur 8 bits sauvegardée dans une section donnée de la SRAM.
#define PA_Load16bit(offset)   (SRAM[offset] + (SRAM[offset+1] << 8))
 Retourne une valeur 16 bits sauvegardée dans une section donnée de la SRAM.
#define PA_Load32bit(offset)   (PA_Load8bit(offset) + (PA_Load8bit(offset + 1) << 8) + (PA_Load8bit(offset + 2) << 16) + (PA_Load8bit(offset + 3) << 24))
 Retourne une valeur 32 bits sauvegardée dans une section donnée de la SRAM.

Fonctions

s16 PA_SaveString (s32 offset, char *string)
 Sauvegarde une chaine de caractères (un nom par exemple) a u n endroit donné en SRAM. La dernière valeur doit etre 0. Utilise autant de place en SRAM que la longueur de la chaine + 1. Renvoie la longueur
void PA_SaveData (s32 offset, void *Data, u16 NBytes)
 Sauvegarde N Octets en SRAM. Cette fonction peut être utilisée pour sauvegarder un tableau complet...
s16 PA_LoadString (s32 offset, char *string)
 Retourne une chaine de caractères sauvegardée dans une section donnée de la SRAM. Renvoie la longueur de la chaine
void PA_LoadData (s32 offset, void *Data, u16 NBytes)
 Renvoie les données sauvegardées avec PA_SaveData

Description détaillée

With these functions you can save data to SRAM :-)

Documentation des macro

#define PA_Load16bit offset   )     (SRAM[offset] + (SRAM[offset+1] << 8))
 

Retourne une valeur 16 bits sauvegardée dans une section donnée de la SRAM.

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)

#define PA_Load32bit offset   )     (PA_Load8bit(offset) + (PA_Load8bit(offset + 1) << 8) + (PA_Load8bit(offset + 2) << 16) + (PA_Load8bit(offset + 3) << 24))
 

Retourne une valeur 32 bits sauvegardée dans une section donnée de la SRAM.

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)

#define PA_Load8bit offset   )     SRAM[offset]
 

Retourne une valeur 8 bits sauvegardée dans une section donnée de la SRAM.

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)

#define PA_Save16bit offset,
value   )     {PA_Save8bit(offset, value&255); PA_Save8bit(offset + 1, value >> 8)}
 

Sauvegarde une valeur 8 bits dans une section donnée de la SRAM. Utilise 2 sections

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)
value Valeur à enregistrer...

#define PA_Save32bit offset,
value   )     {PA_Save8bit(offset, value&255); PA_Save8bit(offset + 1, value >> 8); PA_Save8bit(offset + 2, value >> 16); PA_Save8bit(offset + 3, value >> 24);}
 

Sauvegarde une valeur 32 bits dans une section donnée de la SRAM. Utilise 4 sections

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)
value Valeur à enregistrer...

#define PA_Save8bit offset,
value   )     SRAM[offset] = value
 

Sauvegarde une valeur 8 bits dans une section donnée de la SRAM. Utilise 1 section

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)
value Valeur à enregistrer...


Documentation des fonctions

inline void PA_LoadData s32  offset,
void *  Data,
u16  NBytes
[inline]
 

Renvoie les données sauvegardées avec PA_SaveData

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)
Data Données à sauvegarder
NBytes Nombre d'octets à sauvegarder

inline s16 PA_LoadString s32  offset,
char *  string
[inline]
 

Retourne une chaine de caractères sauvegardée dans une section donnée de la SRAM. Renvoie la longueur de la chaine

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)
string Chaine dans laquelle copier la chaine en mémoire

inline void PA_SaveData s32  offset,
void *  Data,
u16  NBytes
[inline]
 

Sauvegarde N Octets en SRAM. Cette fonction peut être utilisée pour sauvegarder un tableau complet...

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)
Data Données à sauvegarder
NBytes Nombre d'octets à sauvegarder

inline s16 PA_SaveString s32  offset,
char *  string
[inline]
 

Sauvegarde une chaine de caractères (un nom par exemple) a u n endroit donné en SRAM. La dernière valeur doit etre 0. Utilise autant de place en SRAM que la longueur de la chaine + 1. Renvoie la longueur

Paramètres:
offset Section dans la SRAM, de 0 à beaucoup (dépend de combien on utlise de SRAM)
string Chaine de caractères...


Généré le Fri Oct 28 23:18:14 2005 pour PA_lib par  doxygen 1.3.9.1
@ 1.1.1.1 log @Initial import of PalibDoc, begin on PAlib0.64b @ text @@