NAME

       umps3-mkdev - The umps3-mkdev device creation utility

SYNOPSIS

       umps3-mkdev -d DISKFILE [DISKOPTIONS]
       umps3-mkdev -f FLASHFILE FILE [FLASHOPTIONS]

DESCRIPTION

       The command-line umps3-mkdev utility is used to create the files that represent disk and flash devices.

       DISKS  Disks  in uMPS3 are "direct access" nonvolatile read/write devices. The umps3-mkdev utility allows
              one to create an empty disk only; this way an  OS  developer  may  elect  any  desired  disk  data
              organization.
              The  created DISKFILE represents the entire disk contents, even when empty. Hence this file may be
              very large. It is recommended to create small disks which  can  be  used  to  represent  a  little
              portion of an otherwise very large disk unit.
              As  with  real  disks,  differing  performance  statistics  result  in  differing  simulated drive
              performance. E.g. a faster rotation speed results in less latency delay and a smaller sector  data
              occupancy percentage results in shorter read/write times.
              The  default values for all these parameters are shown when entering the umps3-mkdev alone without
              any parameters.

       FLASH DEVICES
              Flash devices in uMPS3 are "random access" nonvolatile read/write devices. A uMPS3 flash device is
              essentially equivalent to a seek-free one-dimensional disk drive. The umps3-mkdev  utility  allows
              one  to  create  both  slow  flash  devices  (e.g.  USB  stick) or fast flash devices (e.g. SSDs).
              Furthermore, the utility allows one to create both empty flash devices as well as  ones  preloaded
              with a specific file.
              The  created FLASHFILE represents the entire device contents, even when empty. Hence this file may
              be very large. It is recommended to create small flash devices which can be used  to  represent  a
              little portion of an otherwise very large device.
              uMPS3  caps  the maximum block size for flash devices at 2^24. This translates to a maximum device
              size of 64GB.
              As with real flash devices, read operations are faster than write operations. The read  speed  for
              uMPS3 flash devices is fixed at 75% of the device write time in microseconds.
              The  default values for all these parameters are shown when entering the umps3-mkdev alone without
              any parameters.

OPTIONS

       -d instructs the utility to build a disk file image.
       -f instructs the utility to build a flash device file image.

FILES

       DISKFILE is the name of the disk file image to be created.

       FLASHFILE is the name of the flash device file image to be created.

       FILE is the name of the file to be preloaded onto the device beginning with block 0.  If  one  wishes  to
       create  an  empty  flash device but still specify some of the additional parameters, use /dev/null as the
       FILE argument. To load a flash device with a collection of files, it is recommended to initially create a
       single .tar file from the collection and then use this single .tar file for this parameter. We  recommend
       the .tar file format due to its simple structure.

DISKOPTIONS

       [CYL [HEAD [SECT [RPM [SEEKT [DATAS]]]]]]

       CYL    Number of cylinders: [1..65535], default = 32

       HEAD   Number of heads/surfaces: [1..255], default = 2

       SECT   Number of 4KB sectors/tracks: [1..255], default = 8

       RPM    Disk rotations per minute: [360..10800], default = 3600

       SEEKT  Average cylinder to cylinder seek time in microseconds: [1..10000], default = 100

       DATAS  Sector data occupation %: [10%..90%], default = 80%

FLASHOPTIONS

       [BLOCKS [WT]]

       BLOCKS Number of blocks: [1..0xFFFFFF], default = 512

       WT     Average write time in microseconds: [1..10000], default = 1000

AUTHOR

       Mauro Morsiani
       Mattia Biondi mattiabiondi1@gmail.com
       Contributors can be listed on GitHub.

BUGS

       Report issues on GitHub: https://github.com/virtualsquare/umps3

SEE ALSO

       umps3(1), umps3-elf2umps(1), umps3-objdump(1)

       Full documentation at: https://github.com/virtualsquare/umps3
       Project wiki: https://wiki.virtualsquare.org/#!umps/umps.md

COPYRIGHT

       2004, Mauro Morsiani
       2020, Mattia Biondi mattiabiondi1@gmail.com

                                                   August 2020                                    UMPS3-MKDEV(1)