text: /**
   * \file
   * \brief CryptoAuthLib Basic API methods for UpdateExtra command.
   *
   * The UpdateExtra command is used to update the values of the two extra bytes
   * within the Configuration zone after the Configuration zone has been locked.
   *
   * \note List of devices that support this command - ATSHA204A, ATECC108A,
   *       ATECC508A, and ATECC608A. There are differences in the modes that they
   *       support. Refer to device datasheets for full details.
   *
   * \copyright (c) 2017 Microchip Technology Inc. and its subsidiaries.
   *            You may use this software and any derivatives exclusively with
   *            Microchip products.
   *
   * \page License
   *
   * (c) 2017 Microchip Technology Inc. and its subsidiaries. You may use this
   * software and any derivatives exclusively with Microchip products.
   *
   * THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES, WHETHER
   * EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED
   * WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A
   * PARTICULAR PURPOSE, OR ITS INTERACTION WITH MICROCHIP PRODUCTS, COMBINATION
   * WITH ANY OTHER PRODUCTS, OR USE IN ANY APPLICATION.
   *
   * IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE,
   * INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND
   * WHATSOEVER RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS
   * BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE
   * FULLEST EXTENT ALLOWED BY LAW, MICROCHIPS TOTAL LIABILITY ON ALL CLAIMS IN
   * ANY WAY RELATED TO THIS SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY,
   * THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THIS SOFTWARE.
   *
   * MICROCHIP PROVIDES THIS SOFTWARE CONDITIONALLY UPON YOUR ACCEPTANCE OF THESE
   * TERMS.
   */
  #include "atca_basic.h"
  #include "host/atca_host.h"
  
  /** \brief Executes UpdateExtra command to update the values of the two
   *          extra bytes within the Configuration zone (bytes 84 and 85).
   *
   * Can also be used to decrement the limited use counter associated with the
   * key in slot NewValue.
   *
   * \param[in] mode       Mode determines what operations the UpdateExtra
   *                      command performs.
   * \param[in] new_value  Value to be written.
   *
   * \return ATCA_SUCCESS on success, otherwise an error code.
   */
  ATCA_STATUS atcab_updateextra(uint8_t mode, uint16_t new_value)
  {
      ATCAPacket packet;
      ATCACommand ca_cmd = _gDevice->mCommands;
      ATCA_STATUS status = ATCA_GEN_FAIL;
  
      do
      {
          // Build command
          memset(&packet, 0, sizeof(packet));
          packet.param1 = mode;
          packet.param2 = new_value;
  
          if ((status = atUpdateExtra(ca_cmd, &packet)) != ATCA_SUCCESS)
          {
              break;
          }
  
          if ((status = atcab_execute_command(&packet)) != ATCA_SUCCESS)
          {
              break;
          }
  
      }
      while (0);
  
      return status;
  }
  