4 Updating Application Gain Table into ATWINC3400A Device Flash

Update the Application Gain Table in the ATWINC3400A 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 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.

For Firmware versions after 1.3.1 (not inclusive), the following are the steps to update the Application Gain Table in the ATWINC3400A device Flash.

  1. The .csv file in the ..\WINC3400_FIRMWARE_UPDATE_PROJECT\src\firmware\Tools\gain_builder\gain_sheets folder holds the gain values. The values can be changed in this .csv file.
  2. Run the prepare_image.cmd 3400 command from the \firmware\ folder location 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 \WINC3400_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 3400
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 3400 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/release3400/boot_firmware.bin'
written 1488 of 4096 bytes to image (37%)
processing region '[control sector]'
WINC3400ControlSectorBuild: creating control sector
written 72 of 4096 bytes to image (2%)
processing region '[backup sector]'
written 0 of 4096 bytes to image (0%)
processing region '[pll table]'
Creating WiFi channel lookup table for PLL with xo_offset = 0.0000.
Creating frequency lookup table for PLL with xo_offset = 0.0000.
written 796 of 2048 bytes to image (39%)
processing region '[gain table]'
WINC3400GainBuild: creating gain tables
written 3448 of 6144 bytes to image (57%)
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 3532 of 4096 bytes to image (87%)
processing region '[tls certificates]'
written 0 of 8192 bytes to image (0%)
processing region '[connection parameters]'
written 0 of 4096 bytes to image (0%)
processing region '[downloader firmware]'
WINCFirmwareImageBuild: opening firmware file 'downloader_firmware/release3400/downloader_firmware.bin'
written 3384 of 8192 bytes to image (42%)
processing region '[wifi firmware]'
WINCFirmwareImageBuild: opening firmware file 'firmware/wifi_v111/ASIC_3400/wifi_firmware.bin'
written 223152 of 303104 bytes to image (74%)
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 7756 of 8192 bytes to image (95%)
processing region '[ble firmware]'
WINCFirmwareImageBuild: opening firmware file 'ble/bt_firmware/fw.bin'
written 129700 of 163840 bytes to image (80%)
processing region '[blank]'
written 0 of 4096 bytes to image (0%)
processing region '[ate firmware]'
WINCFirmwareImageBuild: opening firmware file 'ate_firmware/burst_tx_firmware_winc3400.bin'
written 148436 of 524288 bytes to image (29%)
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/release3400/downloader_firmware.bin'
written 3384 of 8192 bytes to image (42%)
processing region '[wifi firmware]'
WINCFirmwareImageBuild: opening firmware file 'firmware/wifi_v111/ASIC_3400/wifi_firmware.bin'
written 223152 of 303104 bytes to image (74%)
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 7756 of 8192 bytes to image (95%)
processing region '[ble firmware]'
WINCFirmwareImageBuild: opening firmware file 'ble/bt_firmware/fw.bin'
written 129700 of 163840 bytes to image (80%)
**********************************************************
Success
Created: firmware\m2m_image_3400.bin
Created: ota_firmware\m2m_ota_3400.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.