source/application/tensorflow-lite-micro/include/BufAttributes.hpp

/*
 * Copyright (c) 2021 Arm Limited. All rights reserved.
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef BUF_ATTRIBUTES_HPP
#define BUF_ATTRIBUTES_HPP

#ifdef __has_attribute
#define HAVE_ATTRIBUTE(x) __has_attribute(x)
#else   /* __has_attribute */
#define HAVE_ATTRIBUTE(x) 0
#endif  /* __has_attribute */

#if HAVE_ATTRIBUTE(aligned) || (defined(__GNUC__) && !defined(__clang__))

/* We want all buffers/sections to be aligned to 16 byte.  */
#define ALIGNMENT_REQ               aligned(16)

/* Model data section name. */
#define MODEL_SECTION               section("nn_model")

/* Label section name */
#define LABEL_SECTION               section("labels")

#ifndef ACTIVATION_BUF_SZ
    #warning  "ACTIVATION_BUF_SZ needs to be defined. Using default value"
    #define ACTIVATION_BUF_SZ       0x00200000
#endif  /* ACTIVATION_BUF_SZ */

#ifndef ACTIVATION_BUF_SRAM_SZ
    #warning  "ACTIVATION_BUF_SRAM_SZ needs to be defined. Using default value = 0"
    #define ACTIVATION_BUF_SRAM_SZ  0x00000000
#endif /* ACTIVATION_BUF_SRAM_SZ */

/**
 * Activation buffer aka tensor arena section name
 * We have to place the tensor arena in different region based on its size.
 * If it fits in SRAM, we place it there, and also mark it by giving it a
 * different section name. The scatter file places the ZI data in DDR and
 * the uninitialised region in the SRAM.
 **/
#define ACTIVATION_BUF_SECTION_SRAM section(".bss.NoInit.activation_buf")
#define ACTIVATION_BUF_SECTION_DRAM section("activation_buf")

#if     ACTIVATION_BUF_SZ > ACTIVATION_BUF_SRAM_SZ /* Will buffer not fit in SRAM? */
    #define ACTIVATION_BUF_SECTION      ACTIVATION_BUF_SECTION_DRAM
    #define ACTIVATION_BUF_SECTION_NAME ("DDR")
#else   /* ACTIVATION_BUF_SZ > 0x00200000 */
    #define ACTIVATION_BUF_SECTION  ACTIVATION_BUF_SECTION_SRAM
    #define ACTIVATION_BUF_SECTION_NAME ("SRAM")
#endif  /* ACTIVATION_BUF_SZ > 0x00200000 */

/* IFM section name. */
#define IFM_BUF_SECTION             section("ifm")

/* Form the attributes, alignment is mandatory. */
#define MAKE_ATTRIBUTE(x)           __attribute__((ALIGNMENT_REQ, x))
#define MODEL_TFLITE_ATTRIBUTE      MAKE_ATTRIBUTE(MODEL_SECTION)
#define ACTIVATION_BUF_ATTRIBUTE    MAKE_ATTRIBUTE(ACTIVATION_BUF_SECTION)
#define IFM_BUF_ATTRIBUTE           MAKE_ATTRIBUTE(IFM_BUF_SECTION)
#define LABELS_ATTRIBUTE            MAKE_ATTRIBUTE(LABEL_SECTION)

#else /* HAVE_ATTRIBUTE(aligned) || (defined(__GNUC__) && !defined(__clang__)) */

#define MODEL_TFLITE_ATTRIBUTE
#define ACTIVATION_BUF_ATTRIBUTE
#define IFM_BUF_ATTRIBUTE
#define LABELS_ATTRIBUTE

#endif /* HAVE_ATTRIBUTE(aligned) || (defined(__GNUC__) && !defined(__clang__)) */

#endif /* BUF_ATTRIBUTES_HPP */