storage
Usage
>> storage [ used | remaining | size ]
Security
Open.
Description
Reports basic information about the total usage of the data memory. All parameters are read-only:
used is the total number of bytes actually used to store information for all datasets in the memory.
remaining is the number of bytes still available for storage.
size is the maximum total size of the memory in bytes.
For further information about the storage used by each dataset, refer to the dataset command.
Some additional notes:
It is sometimes not true that (used + remaining)=size; this is normal. The inherent nature of the physical devices used means that memory must be "allocated" for a particular purpose in blocks that are much larger than the typical sample size. Once such a block has been allocated for one purpose, it can not be used for another, so if some of the block remains unused for its original purpose, it is no longer available.
The value of size is not always exactly the same for all instruments. Some physical devices may have a small percentage of their capacity marked as "bad" by the device manufacturer. These areas are never used for information storage, so there is no risk to the user's stored data. The only impact is a slight reduction in usable memory from the nominal capacity.
When access=usbhost the instrument will not allow dataset downloads through the API. Downloads must be done using the mass storage utility on the host OS.
Examples
>> storage
<< storage used=1528 remaining=134216192 size=134217728 access=instrument