/* * Copyright (c) 2023 Arm Limited. * * SPDX-License-Identifier: MIT * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to * deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or * sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #include "src/cl/CLTile.h" #include "ckw/Error.h" #include "ckw/TileInfo.h" #include "src/cl/CLHelpers.h" #include "src/Helpers.h" #include #include namespace ckw { CLTile::CLTile(const std::string &name, const TileInfo &info) : _is_constant(false) { validate_tile_info(info); _basename = name; _info = info; } CLTile::CLTile(const TileContainer &vals, DataType dt) : _is_constant(true) { const int32_t w = vals[0].size(); const int32_t h = vals.size(); _info.width(w); _info.height(h); _info.data_type(dt); validate_tile_info(_info); _vals = TileContainer(h, std::vector(w)); for (int32_t y = 0; y < h; ++y) { for (int32_t x = 0; x < w; ++x) { _vals[y][x] = vals[y][x]; } } } const std::string &CLTile::name() const { return _basename; } const TileInfo &CLTile::info() const { return _info; } TileVariable CLTile::scalar(int32_t row, int32_t col) const { // Clamp to nearest valid edge col = clamp(col, static_cast(0), _info.width() - 1); row = clamp(row, static_cast(0), _info.height() - 1); if (_is_constant) { // We can use the vector method to retrieve the scalar variable stored in the constant tile return vector(row, col, 1); } else { TileVariable t; t.str = create_var_name(row); t.desc.dt = _info.data_type(); t.desc.len = 1; // This check is required because if the width has only one element, we cannot use .s0 if (_info.width() != 1) { // Automatic broadcasting t.str += ".s" + dec_to_hex_as_string(col); } return t; } } TileVariable CLTile::vector(int32_t row) const { // Clamp to nearest valid edge row = clamp(row, static_cast(0), _info.height() - 1); if (_is_constant) { return vector(row, 0, _info.width()); } else { TileVariable t; t.str = create_var_name(row); t.desc.dt = _info.data_type(); t.desc.len = _info.width(); return t; } } TileVariable CLTile::vector(int32_t row, int32_t col_start, int32_t width) const { CKW_ASSERT(col_start >= 0 && col_start < _info.width()); CKW_ASSERT(col_start + width <= _info.width()); // Validate the new vector length cl_validate_vector_length(width); // Clamp to nearest valid edge row = clamp(row, static_cast(0), _info.height() - 1); TileVariable t; t.desc.dt = _info.data_type(); t.desc.len = width; if (_is_constant) { // The vector has the following form: ((data_typeN)(val0, val1,..., ValN-1)) t.str = "((" + cl_get_variable_datatype_as_string(t.desc.dt, width) + ")"; t.str += "("; int32_t col = col_start; for (; col < width - 1; ++col) { t.str += _vals[row][col]; t.str += ", "; } t.str += _vals[row][col]; t.str += "))"; } else { t.str = create_var_name(row); if (_info.width() != 1 && _info.width() != width) { t.str += ".s"; for (int i = 0; i < width; ++i) { t.str += dec_to_hex_as_string(col_start + i); } } } return t; } std::vector CLTile::all() const { std::vector vars; if (_is_constant) { for (int32_t y = 0; y < _info.height(); ++y) { for (int32_t x = 0; x < _info.width(); ++x) { // We can use the vector method to retrieve all the scalar variables stored in the constant tile TileVariable t = vector(y, x, 1); vars.push_back(t); } } } else { for (int32_t y = 0; y < _info.height(); ++y) { TileVariable t; t.str = create_var_name(y); t.desc.dt = _info.data_type(); t.desc.len = _info.width(); vars.push_back(t); } } return vars; } bool CLTile::is_assignable() const { return !_is_constant; } std::string CLTile::create_var_name(int32_t row) const { std::string var_name = _basename; // If a scalar variable, we do not append the row index if (_info.height() > 1) { var_name += "__"; var_name += std::to_string(row); } return var_name; } std::vector CLTile::supported_vector_lengths() const { return std::vector{1, 2, 3, 4, 8, 16}; } void CLTile::validate_tile_info(const TileInfo &info) const { CKW_UNUSED(info); CKW_ASSERT_MSG(cl_validate_vector_length(info.width()), "Unsupported TileInfo width"); CKW_ASSERT_MSG(info.data_type() != DataType::Unknown, "DataType::Unknown is not supported"); } } // namespace ckw