Write and Read Files

In both Define mode and Run mode, files are available for write and read.

Because SD-card is slow, all the files writing and reading functions are given the highest priority. 

Touch is suspended temporarily and resumed once the file operation is completed.

Procedure

Functions
Right: Open SD sequence
Manage the SD-card
sC_beginSD checks a SD-card is available and prepares the file system 
  • Input: None
  • Output:  None
  • Exit branch if success, ERROR branch if error
 
sC_closeSD closes the file system and frees the SD card
  • Input: None
  • Output: 0 if error, otherwise success, Integer
 
sC_findFile finds a file
  • Input: file name, String
  • Output: 0 if error, otherwise success, Integer
 
sC_writeDeleteFile deletes a file
  • Input: file name, String
  • Output: 0 if error, otherwise success, Integer
 
sC_getFileError gets the error number from the file system
  • Input: None
  • Output: error number, Integer
Open and close files
Right: Open file sequence
Each file has a unique identifier, called file unique identifier.

A good idea is to have an integer variable for each file with the name of the file.
sC_openFileWrite creates a new file for writing and opens it
  • Input: file name, String
  • Output: 0 if error, otherwise file unique identifier, Integer
 
sC_openFileAppend opens an existing file for adding
  • Input: file name, String
  • Output: 0 if error, otherwise file unique identifier, Integer
 
sC_openFileRead opens an existing file for reading
  • Input: file name, String
  • Output: 0 if error, otherwise file unique identifier, Integer
 
Right: Close file sequence
sC_closeFile closes the file
  • Input: file unique identifier, Integer
  • Output: 0 if error, otherwise success, Integer
Right: Write to file sequence
Write and read files
sC_writeFileValue writes an integer value to the file
  • Input: file unique identifier, Integer non zero
  • Input: value, Integer
  • Output: 0 if error, otherwise success, Integer
 
sC_writeFileText writes a text to the file
  • Input: file unique identifier, Integer non zero
  • Input: text, String
  • Output: 0 if error, otherwise success, Integer
    •  
sC_writeFileTAB writes a tabulation to the file
sC_writeFileCRLF writes a carriage return - line feed to the file
    • Input: file unique identifier, Integer non zero
    • Output: 0 if error, otherwise success, Integer
     
sC_writeReadValue reads an integer value from the file
  • Input: file unique identifier, Integer non zero
  • Output: value, Integer

Previous

Next