SD Card Manager

Note: To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.

Language Note: Input fields accept ENGLISH ONLY.

Overview

The SD Card Manager (SdCardMgr) controls the use of external device storage, and is intended primarily as a security measure on devices that support a physically removable storage medium such as a Micro SD Card or USB media.

When a device supports physically removable storage, it is sometimes necessary to prevent access to such media so that unwanted software cannot be loaded onto the device or sensitive data be removed. Preventing the use of removable media greatly reduces such risks.

On devices that support a removable storage medium, that medium is the default target of the usage parameter of this CSP. Otherwise, the Primary Storage Card is the target.

Main Functionality

  • Allow/Prevent use of a removeable SD Card or Primary Storage Card

Terminology

  • External Storage - any data storage mechanism on a Zebra device.
  • Storage Card - any individual storage medium on a Zebra device, removable or fixed. Most Zebra Android devices can implement more than one storage card.
  • Access paths logically mapped data paths such as /sdcard or /storage for allowing apps to access each of the supported storage cards within a device. Paths such as /storage/sdcard0 and /storage/sdcard1 are supported when multiple storage cards are present.
  • Logical Link - an internally implemented path that links directly to a storage card. For example, the path /sdcard0 links to /storage/sdcard0.

Note: While the term "card" might imply a removable medium, the primary (and secondary) "storage card(s)" in most Zebra devices are simulated using flash memory that's built into the device and cannot be removed. On devices that support a physically removable medium such a Micro SD Card, such storage will be identified and accessed using similar terminologies.

Variations

  • The number and type of supported storage cards and their access paths vary by device.
  • Storage Cards can be accessed in multiple ways, including through built-in privileged System apps, installed unprivileged apps, and from computers using MTP or ADB over USB.
  • If access to a storage card is disabled using the SdCardMgr, all access to that medium is blocked, without exception, until access is re-enabled using the SdCardMgr.
  • Removable media can become inaccessible by means other than blockage by this CSP. For example, an unblocked Micro SD Card will be inaccessible if physically removed from the device or if encrypted and the Named Key has been removed from the Key Storage Database (see EncryptMgr).

SD Card, USB Usage

Used to control access to external storage on the device, which can include removable SD cards and USB-connected storage media. When Disabled (option 1), access to all external storage is completely blocked. IMPORTANT: Removable media can become inaccessible by means other than blockage by this CSP. For example, an unblocked Micro SD card is inaccessible if physically removed from the device or if encrypted and the Named Key has been removed from the Key Storage Database (see EncryptMgr).

Note: This parameter acts on external storage by default. If external storage is not supported by the device, primary storage is the target.

Parm Name: SdCardUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

OSX: 4.3+

MX: 4.3+

1 Enable Allows access to and usage of all storage on the device.

OSX: 4.3+

MX: 4.3+

2 Disable Blocks access to all storage on the device.

OSX: 4.3+

MX: 4.3+

Examples

Block SD Card Usage


<wap-provisioningdoc>
    <characteristic type="SdCardMgr" version="4.3" >
        <parm name="SdCardUsage" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Queries

Get SD Card Usage status

Input


<wap-provisioningdoc>
    <characteristic type="SdCardMgr" >
        <parm-query name="SdCardUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output (blocked)


<wap-provisioningdoc>
    <characteristic type="SdCardMgr" version="4.3" >
        <parm name="SdCardUsage" value="2"/>
    </characteristic>
</wap-provisioningdoc>