Changes between Version 12 and Version 13 of TBR/UserManual/Using_the_RTEMS_DOS_File_System

Timestamp:

10/22/08 10:29:12 (16 years ago)

Author:

ChrisJohns

Comment:

Add examples.

TBR/UserManual/Using_the_RTEMS_DOS_File_System

@@ -235 +235 @@
 # Number of device descriptions.
 # Pointer to the device descriptions.
-#
+# Flags to control the driver.
+# Debug information level if compiled into the driver.
+
+The flags to control the driver are:
+
+# {{{RTEMS_NVDISK_CHECK_PAGES</code> checks the pages during initialisation. This can slow down the initialisation of the disk. Pages not written too may have incorrect checksums.
+
+An example set up with static RAM allocated from the heap is:
+
+ #include <rtems/nvdisk.h>
+ #include <rtems/nvdisk-sram.h>
+
+ /**
+  * The NV Device descriptor. For this test it is just DRAM.
+  */
+ rtems_nvdisk_device_desc rtems_nv_heap_device_descriptor[] =
+
+ {
+   {
+     flags:  0,
+     base:   0,
+     size:   2 * 1024 * 1024,
+     nv_ops: &rtems_nvdisk_sram_handlers
+   }
+ };
+ 
+ /**
+  * The NV Disk configuration.
+  */
+ const rtems_nvdisk_config rtems_nvdisk_configuration[] =
+
+ {
+   {
+     block_size:         512,
+     device_count:       1,
+     devices:            &rtems_nv_heap_device_descriptor[0],
+     flags:              0,
+     info_level:         0
+   }
+ };
+
+To use the NV disk you need to register the driver. For example: 
+
+  /*
+   * For our test we do not have any static RAM or EEPROM devices so
+   * we allocate the memory from the heap.
+   */
+  rtems_nv_heap_device_descriptor[0].base =
+
+    (uint32_t) malloc (rtems_nv_heap_device_descriptor[0].size);
+
+  if (!rtems_nv_heap_device_descriptor[0].base)
+  {
+    printf ("error: no memory for NV disk\n");
+    return 1;
+  }
+  
+  /*
+   * Register the NV Disk driver.
+   */
+  printf ("Register NV Disk Driver: ");
+  sc = rtems_io_register_driver (RTEMS_DRIVER_AUTO_MAJOR,
+                                 &rtems_nvdisk_io_ops,
+                                 &major);
+  if (sc != RTEMS_SUCCESSFUL)
+  {
+    printf ("error: nvdisk driver not initialised: %s\n",
+            rtems_status_text (sc));
+    return 1;
+  }
+  
+  printf ("successful\n");
+
+Once the driver has been register you can mount the disk using the shell command of:
+
+ mkdir nv
+ mount -t msdos /dev/nvdisk0 /nv
+
+The code to mount the same device to an existing /nv directory is:
+
+ #include <rtems/dosfs.h>
+ #include <rtems/fsmount.h>
+
+ rtems_filesystem_mount_table_entry_t* mt_entry;
+ 
+ if (mount (&mt_entry, &msdos_ops, options, "/dev/nvdisk0", "/nv") < 0)
+ {
+   fprintf (stderr, "mount: mount failed: %s\n", strerror (errno));
+   return 1;
+ }
+= Flash Disk =