file.html

- file system ISO9660 iso9660.c iso9660.h - file system FAT12/16 fat.c fat.h - file sy

<HR>
<A NAME="fat_goto_parentdir"></A>
<H3> fat_goto_parentdir </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_goto_parentdir">fat_goto_parentdir</A>  ( Byte id )  </PRE></TD>

</TABLE>
<P>
Go to the parent directory
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>  id: file extension to select
*
return:</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_goto_prev"></A>
<H3> fat_goto_prev </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_goto_prev">fat_goto_prev</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Fetch the previous directory info in cache
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  - OK: previous file available
  - KO: first file reached
  - KO: low_level memory error</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_goto_prev"></A>
<H3> fat_goto_prev </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_goto_prev">fat_goto_prev</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Fetch the previous directory info in cache
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  - OK: previous file available
  - KO: first file reached
  - KO: low_level memory error</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_goto_subdir"></A>
<H3> fat_goto_subdir </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_goto_subdir">fat_goto_subdir</A>  ( Byte id )  </PRE></TD>

</TABLE>
<P>
Go to the subdir if current is a directory
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>  id: file extension to select
*
return:
  - OK: subdir selected
  - KO: current entry not a directory
  - KO: low level error</PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
Also called by goto_parentdir() with current info from parent info
<HR>
<A NAME="fat_goto_subdir"></A>
<H3> fat_goto_subdir </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_goto_subdir">fat_goto_subdir</A>  ( Byte id )  </PRE></TD>

</TABLE>
<P>
Go to the subdir if current is a directory
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>  id: file extension to select
*
return:
  - OK: subdir selected
  - KO: current entry not a directory
  - KO: low level error</PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
Also called by goto_parentdir() with current info from parent info
<HR>
<A NAME="fat_install"></A>
<H3> fat_install </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit iso_install ( void )  </PRE></TD>

</TABLE>
<P>
Install the iso file system
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  - OK: intallation succeeded
  - KO: no primary or supplementary volume descriptor found
        </PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
<P>
<HR>
<A NAME="fat_install"></A>
<H3> fat_install </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit iso_install ( void )  </PRE></TD>

</TABLE>
<P>
Install the iso file system
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  - OK: intallation succeeded
  - KO: no primary or supplementary volume descriptor found
        </PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
<P>
<HR>
<A NAME="fat_install"></A>
<H3> fat_install </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit iso_install ( void )  </PRE></TD>

</TABLE>
<P>
Install the iso file system
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  - OK: intallation succeeded
  - KO: no primary or supplementary volume descriptor found
        </PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
<P>
<HR>
<A NAME="fat_load_sector"></A>
<H3> fat_load_sector </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_load_sector">fat_load_sector</A> ( Uint32 sector )  </PRE></TD>

</TABLE>
<P>
This function load a sector in fat_buf_sector
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_read_cluster12"></A>
<H3> fat_read_cluster12 </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>Uint16 fat_read_cluster  ( bit init )  </PRE></TD>

</TABLE>
<P>
Read in fat12 file system a cluster value
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>  init : initialize the parity bit or not
return:
  FAT12 cluster value</PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
<P>
<HR>
<A NAME="fat_refresh_dir_file_info"></A>
<H3> fat_refresh_dir_file_info </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>void <A HREF="#fat_refresh_dir_file_info">fat_refresh_dir_file_info</A>  ( Byte id )  </PRE></TD>

</TABLE>
<P>
Reconstruct the file directory list and seek to the file pointed by
fat_dir_list_index
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>   
return:
  </PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
<P>
<HR>
<A NAME="fat_refresh_dir_file_info"></A>
<H3> fat_refresh_dir_file_info </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>void <A HREF="#fat_refresh_dir_file_info">fat_refresh_dir_file_info</A>  ( Byte id )  </PRE></TD>

</TABLE>
<P>
Reconstruct the file directory list and seek to the file pointed by
fat_dir_list_index
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>   
return:
  </PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
<P>
<HR>
<A NAME="fat_save_cluster_info"></A>
<H3> fat_save_cluster_info </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>void <A HREF="#fat_save_cluster_info">fat_save_cluster_info</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Save in locale variables cluster information for the current opened file
- cluster index
- number of the cluster
- number of bytes in the cluster
<P>
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>  
*
return:</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_save_cluster_info"></A>
<H3> fat_save_cluster_info </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>void <A HREF="#fat_save_cluster_info">fat_save_cluster_info</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Save in locale variables cluster information for the current opened file
- cluster index
- number of the cluster
- number of bytes in the cluster
<P>
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>  
*
return:</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_seek_entry_record"></A>
<H3> fat_seek_entry_record </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_seek_entry_record">fat_seek_entry_record</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Fetch the selected entry
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>  fat_dir_list_index : # of the fetched entry
  
return:
  OK: file available
  KO: low level error</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_seek_entry_record"></A>
<H3> fat_seek_entry_record </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_seek_entry_record">fat_seek_entry_record</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Fetch the selected entry
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>  fat_dir_list_index : # of the fetched entry
  
return:
  OK: file available
  KO: low level error</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_seek_first"></A>
<H3> fat_seek_first </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_seek_first">fat_seek_first</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Fetch the first directory info in cache
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  - OK: first file found
  - KO: low level error</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_seek_first"></A>
<H3> fat_seek_first </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_seek_first">fat_seek_first</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Fetch the first directory info in cache
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  - OK: first file found
  - KO: low level error</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_seek_last"></A>
<H3> fat_seek_last </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_seek_last">fat_seek_last</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Fetch the last directory info in cache
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  OK: last file available
  KO: low level error</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_seek_last"></A>
<H3> fat_seek_last </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_seek_last">fat_seek_last</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Fetch the last directory info in cache
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  OK: last file available
  KO: low level error</PRE></TD>

</TABLE>
<HR>
<A NAME="fat_set_clusters"></A>
<H3> fat_set_clusters </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>bit <A HREF="#fat_set_clusters">fat_set_clusters</A>  ( void )  </PRE></TD>

</TABLE>
<P>
Prepare a list of the free clusters:
chain[n].cluster contains the starting cluster number of a fragment
chain[n].number contains the number of contiguous clusters in fragment
<P>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#FFD0D0"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>*
return:
  - OK: allocation done
  - KO: allocation cannot be done : no free cluster</PRE></TD>

</TABLE>
<H4> Note </H4>
<P>
Free cluster list is limited by the nb_frag parameter.
If memory is too much fragmented, created file may be limited in size.
Last list item always has single cluster
<HR>
<A NAME="fat_up_down_load_sector"></A>
<H3> fat_up_down_load_sector </H3>
<TABLE BORDER="0"  WIDTH="100 %"  BGCOLOR="#D6E8FF"  CELLPADDING="6">
<TR>
 <TD VALIGN=MIDDLE><PRE>void <A HREF="#fat_up_down_load_sector">fat_up_down_load_sector</A> ( Uint32 sector ,  bit up_down )  </PRE></TD>