6 Updating Application Gain Table into ATWINC15x0 Device Flash

Update the Application Gain Table into the ATWINC15x0 device Flash using the procedures mentioned in the ATWINC15x0/ATWINC3400 - Integrated Serial Flash and Memory Download Procedure Application Note (DS00002378). This application note details the download procedures of the firmware, TLS/SSL root certificates and TX power gain values into the WINC serial Flash through different supported serial interfaces like SPI/UART. Refer to Chapter 7 in the ATWINC15x0/ATWINC3400 - Integrated Serial Flash and Memory Download Procedure Application Note (DS00002378) for the Gain Values Download.

Once the gain table value is loaded into the Flash memory, verify the values using the MCHPRT2 tool. For more details on reading gain table values, refer to the MCHPRT2 User Guide (DS50002893).

For firmware versions after 19.6.1 (not inclusive), perform the following steps to update the application gain table in the ATWINC15x0 device Flash.

1. The atwinc1500_mr210pb_gain_setting.csv file in the ..\WINC1500_FIRMWARE_UPDATE_PROJECT\src\firmware\Tools\gain_builder\gain_sheets folder holds the gain values. The values can be changed in this .csv file using Notepad++.
2. Run the prepare_image.cmd 1500 command from the folder location \firmware\ of the firmware upgrade project.
3. The ATWINC15x0/ATWINC3400 Integrated Serial Flash and Memory Download Procedure Application Note (DS00002378) is part of the firmware upgrade project and is available inside the folder \WINC1500_FIRMWARE_UPDATE_PROJECT\doc. For a more detailed step-by-step procedure of the Serial Flash Download using the Serial Bridge application or Serial Flash Download via Built-in UART, refer to the ATWINC15x0/ATWINC3400 Integrated Serial Flash and Memory Download Procedure Application Note (DS00002378).
4. Review the pass log to ensure that there are no errors generated during the execution of the prepare_image.cmd command. For example, see the following pass log:

   ...\firmware>prepare_image.cmd 1500
   Converting gain table
   Default gain table specified as Tools\gain_builder\gain_sheets\samd21_gain_setting_hp.csv
   Change this script if different gain sheet is required!
   python gain_converter.py Tools\gain_builder\gain_sheets\samd21_gain_setting_hp.csv -o new_gain.config
   Building flash images for 3A0 variant (prog and OTA format)
   Device Image Creation Tool 1.0.2 [r708] (Jul 28 2020)
   Copyright (C) Microchip Technology Inc. 2020
   processing region '[boot firmware]'
   WINCFirmwareImageBuild: opening firmware file 'boot_firmware/release3A0/boot_firmware.bin'
   written 1304 of 4096 bytes to image (32%)
   processing region '[control sector]'
   WINC1500ControlSectorBuild: creating control sector
   written 64 of 8192 bytes to image (1%)
   processing region '[pll table]'
   Creating WiFi channel lookup table for PLL with xo_offset = 0.0000.
   written 456 of 1024 bytes to image (45%)
   processing region '[gain table]'
   WINC1500GainBuildV2: creating gain tables
   written 1600 of 3072 bytes to image (53%)
   processing region '[root certificates]'
   found certificate: Baltimore CyberTrust Root
   found certificate: DigiCert High Assurance EV Root CA
   found certificate: DigiCert SHA2 High Assurance Server CA
   found certificate: Entrust Root Certification Authority
   found certificate: GeoTrust Global CA
   found certificate: GlobalSign Root CA
   found certificate: GlobalSign
   found certificate: Google Internet Authority G3
   found certificate: QuoVadis Root CA 2
   found certificate: VeriSign Class 3 Public Primary Certification Authority - G5
   found certificate: Amazon Root CA 1
   written 3620 of 4096 bytes to image (89%)
   processing region '[tls certificates]'
   written 0 of 8192 bytes to image (0%)
   processing region '[http files]'
   HTTPFileSystemAddFile: opening HTTP file 'provisioning_webpage/default.html'
   HTTPFileSystemAddFile: opening HTTP file 'provisioning_webpage/style.css'
   HTTPFileSystemAddFile: opening HTTP file 'provisioning_webpage/favicon.ico'
   HTTPFileSystemAddFile: opening HTTP file 'provisioning_webpage/logo.png'
   HTTPFileSystemAddFile: opening HTTP file 'provisioning_webpage/error.json'
   HTTPFileSystemAddFile: opening HTTP file 'provisioning_webpage/scanresults.json'
   HTTPFileSystemAddFile: opening HTTP file 'provisioning_webpage/ok.json'
   written 7760 of 8192 bytes to image (95%)
   processing region '[connection parameters]'
   written 0 of 4096 bytes to image (0%)
   processing region '[downloader firmware]'
   WINCFirmwareImageBuild: opening firmware file 'downloader_firmware/release3A0/downloader_firmware.bin'
   written 4628 of 241664 bytes to image (2%)
   processing region '[wifi firmware]'
   WINCFirmwareImageBuild: opening firmware file 'firmware/wifi_v111/ASIC_3A0/wifi_firmware.bin'
   written 235286 of 237036 bytes to image (100%)
   processing region '[ate firmware]'
   WINCFirmwareImageBuild: opening firmware file 'ate_firmware/burst_tx_firmware_winc1500.bin'
   written 76736 of 765952 bytes to image (11%)
   Device Image Creation Tool 1.0.2 [r708] (Jul 28 2020)
   Copyright (C) Microchip Technology Inc. 2020
   processing region '[downloader firmware]'
   WINCFirmwareImageBuild: opening firmware file 'downloader_firmware/release3A0/downloader_firmware.bin'
   written 4628 of 241664 bytes to image (2%)
   processing region '[wifi firmware]'
   WINCFirmwareImageBuild: opening firmware file 'firmware/wifi_v111/ASIC_3A0/wifi_firmware.bin'
   written 235286 of 237036 bytes to image (100%)
   **********************************************************
   Success
   Created: firmware\m2m_image_3A0.bin
   Created: ota_firmware\m2m_ota_3A0.bin

   Note: While updating the gain table for the first time, the user can read back the gain table using the commands listed in the Verifying the Gain Value.