.. highlight:: csharp

Logging
=======
Mbientlab boards are equipped with flash memory that can store data if there is no connection with an Android device.  While the ``RouteComponent`` 
directs data to the logger, the `ILogging <http://mbientlab.com/docs/metawear/csharp/1/interfaceMbientLab_1_1MetaWear_1_1Core_1_1ILogging.html>`_ interface provides 
the functions for controlling and configuring the logger.

::

    using MbientLab.MetaWear.Core;

    ILogging logging = metawear.GetModule<ILogging>();

Start the Logger
----------------
To start logging, call the `Start <http://mbientlab.com/docs/metawear/csharp/1/interfaceMbientLab_1_1MetaWear_1_1Core_1_1ILogging.html#a323420e9d234c69973ef776df94f0379>`_ method.  
If you wish to overwrite existing entries, pass ``true`` to the method.  When you are done logging, call 
`Stop <http://mbientlab.com/docs/metawear/csharp/1/interfaceMbientLab_1_1MetaWear_1_1Core_1_1ILogging.html#a20f4110376eb828a6e8cf70ec6552328>`_.  

::

    // start logging, if log is full, no new data will be added
    logging.Start(false);
    
    // start logging, if log is full, overrite existing data
    logging.Start(overwrite: true);

    // stop the logger
    logging.Stop();

Downloading Data
----------------
When you are ready to retrieve the data, call 
`DownloadAsync <http://mbientlab.com/docs/metawear/csharp/1/interfaceMbientLab_1_1MetaWear_1_1Core_1_1ILogging.html#a436f36c07b8e790ce5106dfd5bb3d1b7>`_.  
There are variants of ``downloadAsync`` that provide progress updates and error handing during the download.

::

    // download log data and send 100 progress updates during the download
    await logging.DownloadAsync(100, (nEntries, totalEntries) => 
        Console.WriteLine("Progress Update = " + nEntriesLeft + "/" + totalEntries)
    );
    Console.WriteLine("Download completed");