| 
				 | 
				
| Line 16: | 
Line 16: | 
|   |  |   |  | 
|   | ==Detailed description==  |   | ==Detailed description==  | 
|   | + |  | 
|   | + |  | 
|   |  |   |  | 
|   |  |   |  | 
| Line 22: | 
Line 24: | 
|   |  |   |  | 
|   | ==Examples==  |   | ==Examples==  | 
|   | + |  | 
|   | + |  | 
|   |  |   |  | 
|   |  |   |  | 
| Line 202: | 
Line 206: | 
|   | |-  |   | |-  | 
|   | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE  |   | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE  | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadFileLength'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Returns the number of bytes in the current sector that are used by the current open file. Return = 512 - Sector is filled with file data Return < 512 - Last sector of the file, Retval specifies how many bytes of data are remaining in the sector 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:]] - 
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''OpenFile'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Searches for and opens a file for reading or writing from within the current directory on the disk. Returns 0 for success. 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
  |   | 
| − | | width="90%" | Filename
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | 8.3 filename of the file we are trying to open e.g. "file.txt" 
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteFileSector'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''AppendStringToFile'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
  |   | 
| − | | width="90%" | Data_String
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadFileSize'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Reads the entire size of the current file in bytes. 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u32-icon.png]] - ULONG
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadFileLength'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Returns the number of bytes in the current sector that are used by the current open file. Return = 512 - Sector is filled with file data Return < 512 - Last sector of the file, Retval specifies how many bytes of data are remaining in the sector 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:]] - 
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''OpenFile'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Searches for and opens a file for reading or writing from within the current directory on the disk. Returns 0 for success. 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
  |   | 
| − | | width="90%" | Filename
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | 8.3 filename of the file we are trying to open e.g. "file.txt" 
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteFileSector'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Overwrites the current sector on the memory card with the contents of the local sector buffer. See write_byte_to_buffer function. Return = 0 - File sector written successfully. Return > 0 - File sector write error 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetFileIndex'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Sets the current file index and used to switch between several open file streams.  Default = 0.  
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" | File_Index
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | File index ranges from 0 to (Max Concurrent Files - 1) 
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''AppendStringToFile'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Adds the contents of the data string parameter to the end of the currently open file. Returns 0 for success. 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
  |   | 
| − | | width="90%" | Data_String
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Data to append to the end of the file 
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetByte'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG
  |   | 
| − | | width="90%" | Int
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" | Ix
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" | Value
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadFileSize'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Reads the entire size of the current file in bytes. 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u32-icon.png]] - ULONG
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetByte'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Gets a byte from an int 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG
  |   | 
| − | | width="90%" | Int
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" | Ix
  |   | 
| − | |-
  |   | 
| − | | colspan="2" |  
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetTimeAndDate'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Sets the current time and date.  Time = (Hour << 11) + (Min << 5) + (Sec >> 1) Date = (YearFrom1980 << 9) + (Month << 5) + (Day) Additional details can be found here: http://www.maverick-os.dk/FileSystemFormats/FAT16_FileSystem.html#TimeFormat 
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
  |   | 
| − | | width="90%" | Time
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Sets the current Time in FAT Time format hhhhhmmmmmmsssss - S=Secs/2 
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
  |   | 
| − | | width="90%" | Date
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Sets the current Date in FAT Date format yyyyyyymmmmddddd - Y=Years since 1980 
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Attempts to communicate with the SD card and if successful sets up the file system. Returns 0 for success.  
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
  |   | 
| − | | width="90%" style="border-top: 2px solid #000;" | ''Return''
  |   | 
| − | |}
  |   | 
| − | 
  |   | 
| − | 
  |   | 
| − | {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
  |   | 
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
  |   | 
| − | |-
  |   | 
| − | | colspan="2" | Must be called before any other CAN component macros to enable and initialise the CAN peripheral.  
  |   | 
| − | |-
  |   | 
| − | |-
  |   | 
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
  |   | 
|   | | width="90%" style="border-top: 2px solid #000;" | ''Return''  |   | | width="90%" style="border-top: 2px solid #000;" | ''Return''  | 
|   | |}  |   | |}  |