nn::fs::InitializeLatencyEmulation Function

Syntax

void InitializeLatencyEmulation(
     void
);

Parameters

None.

Return Values

None.

Description

Initializes the feature for emulating the behavior of a non-volatile memory device that has become degraded, and the behavior when a conflict arises for FS resources with a process in the background.

Be absolutely sure to call this initialization function because the emulation feature cannot be enabled unless you do.
You can enable/disable this feature in the Config settings.
In the retail product environment, this feature is invariably disabled, so there is no problem including a call to this function in the product code.

Total latency is the sum of the routinely-applied delay time plus a random delay time determined separately for each access event.
A randomly determined delay time is enabled only if the debug mode setting is enabled by Config.
For each Read/TryRead, the range is 0 ms to 100 ms. For each Write/TryWrite, the range is 0 ms to 380 ms. If disabled, it is 0.
The routinely-applied delay time takes the value configured in the FS Latency Emulation settings in Config.

The table shows latency times in the development environment.

Config settingsDelay time
Debug ModeFS Latency Emulation
enableSome time other than 0 msRandom delay + routine delay
enable0 msRandom delay only
disableSome time other than 0 msRoutine delay only
disable0 msNone

Revision History

2012/09/05
Described the range of the randomly-determined delay times.
2012/04/16
Added description of the relationship between Config settings and the behavior of latency emulation.
2011/10/27
Initial version.

CONFIDENTIAL