altos: Make ao_fat_readdir return real error values instead of 1/0
[fw/altos] / src / drivers / ao_fat.h
index 5b9b300f51d53ebf402658f1e2ac4bb685e0ac35..fe154cdfd42043958c91b9dd930cb1b232d87952 100644 (file)
@@ -32,9 +32,10 @@ ao_fat_init(void);
 #define AO_FAT_DENT_EMPTY              0xe5
 #define AO_FAT_DENT_END                        0x00
 
-#define AO_FAT_IS_FILE(attr)   (((attr) & (AO_FAT_FILE_VOLUME_LABEL|AO_FAT_FILE_DIRECTORY|AO_FAT_FILE_ARCHIVE)) == 0)
-#define AO_FAT_IS_DIR(attr)    (((attr) & (AO_FAT_FILE_DIRECTORY)) == AO_FAT_FILE_DIRECTORY)
+#define AO_FAT_IS_FILE(attr)   (((attr) & (AO_FAT_FILE_VOLUME_LABEL|AO_FAT_FILE_DIRECTORY)) == 0)
+#define AO_FAT_IS_DIR(attr)    (((attr) & (AO_FAT_FILE_DIRECTORY|AO_FAT_FILE_VOLUME_LABEL)) == AO_FAT_FILE_DIRECTORY)
 
+/* API error codes */
 #define AO_FAT_SUCCESS                 0
 #define AO_FAT_EPERM                   1
 #define AO_FAT_ENOENT                  2
@@ -47,6 +48,27 @@ ao_fat_init(void);
 #define AO_FAT_EMFILE                  24
 #define AO_FAT_EFBIG                   27
 #define AO_FAT_ENOSPC                  28
+#define AO_FAT_EDIREOF                 29
+
+/* ao_fat_setup return values */
+#define AO_FAT_FILESYSTEM_SUCCESS                      0
+#define AO_FAT_FILESYSTEM_MBR_READ_FAILURE             1
+#define AO_FAT_FILESYSTEM_INVALID_MBR_SIGNATURE                2
+#define AO_FAT_FILESYSTEM_INVALID_PARTITION_TYPE       3
+#define AO_FAT_FILESYSTEM_ZERO_SIZED_PARTITION         4
+
+#define AO_FAT_FILESYSTEM_BOOT_READ_FAILURE            5
+#define AO_FAT_FILESYSTEM_INVALID_BOOT_SIGNATURE       6
+#define AO_FAT_FILESYSTEM_INVALID_SECTOR_SIZE          7
+
+void
+ao_fat_sync(void);
+
+void
+ao_fat_unmount(void);
+
+int8_t
+ao_fat_full(void);
 
 int8_t
 ao_fat_open(char name[11], uint8_t mode);
@@ -80,12 +102,37 @@ ao_fat_unlink(char name[11]);
 int8_t
 ao_fat_rename(char old[11], char new[11]);
 
+/*
+ * Byte offset within a file. Supports files up to 2GB in size
+ */
+typedef int32_t                ao_fat_offset_t;
+
+/*
+ * Cluster index in partition data space
+ */
+typedef uint32_t       ao_fat_cluster_t;
+
+/*
+ * Sector offset within partition
+ */
+typedef uint32_t       ao_fat_sector_t;
+
+/*
+ * Index within the root directory
+ */
+typedef uint16_t       ao_fat_dirent_t;
+
+/*
+ * Offset within a cluster (or sector)
+ */
+typedef uint16_t       ao_fat_cluster_offset_t;
+
 struct ao_fat_dirent {
-       char            name[11];
-       uint8_t         attr;
-       uint32_t        size;
-       uint16_t        cluster;
-       uint16_t        entry;
+       char                    name[11];
+       uint8_t                 attr;
+       uint32_t                size;
+       ao_fat_cluster_t        cluster;
+       uint16_t                entry;
 };
 
 int8_t