Whenever an application needs information which is stored in a file
somewhere in a remote location, the application can use the Host File Download feature
to retrieve the file from the remote location and temporarily store it in the WINC’s
Flash. When a download is successfully completed, a file handler is generated and stored
in NVM in the WINC, therefore it is valid even after a WINC reset. After a handler is
generated, access to the file is possible via the provided APIs and reading of a file is
possible via two mechanisms, HIF and SPI. In either case, the read operation requires
the file handler of the file which the application is trying to access, if the handler
being requested and the handler internally stored match, then the access is granted.
The same procedure is valid for erasing the file. The use of a file handler avoids
access to invalid data, for example when trying to concurrently access the file. The
following figure depicts the steps which the WINC follows when performing a Host File
Download.
The download starts only if the space available in Flash is enough to store
the file which is requested to be downloaded. If Host File Download is requested in the
ATWINC1500 (4 Mb Flash), the download fails since there is no Host File partition in
Flash and therefore no space to store the file.
The “Start Download” step causes any previously available valid file handler
to be invalidated. When “OTA Get Successful” message is received, a new file handler is
generated along with the status and the total size of the downloaded file, they are
included in the Download completion notification sent to the host.
The online versions of the documents are provided as a courtesy. Verify all content and data in the device’s PDF documentation found on the device product page.