1 /*
2 * Copyright (C) 2010-2021 Arm Limited or its affiliates. All rights reserved.
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 *
6 * Licensed under the Apache License, Version 2.0 (the License); you may
7 * not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
9 *
10 * www.apache.org/licenses/LICENSE-2.0
11 *
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an AS IS BASIS, WITHOUT
14 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
17 */
18
19 /* ----------------------------------------------------------------------
20 * Project: CMSIS NN Library
21 * Title: arm_convolve_HWC_q15_basic.c
22 * Description: Q15 version of convolution
23 *
24 * $Date: January 26, 2021
25 * $Revision: V.1.0.2
26 *
27 * Target Processor: Cortex-M cores
28 *
29 * -------------------------------------------------------------------- */
30
31 #include "arm_nnfunctions.h"
32 #include "arm_nnsupportfunctions.h"
33
34 /**
35 * @ingroup groupNN
36 */
37
38 /**
39 * @addtogroup NNConv
40 * @{
41 */
42
43 /**
44 * @brief Basic Q15 convolution function
45 * @param[in] Im_in pointer to input tensor
46 * @param[in] dim_im_in input tensor dimention
47 * @param[in] ch_im_in number of input tensor channels
48 * @param[in] wt pointer to kernel weights
49 * @param[in] ch_im_out number of filters, i.e., output tensor channels
50 * @param[in] dim_kernel filter kernel size
51 * @param[in] padding padding sizes
52 * @param[in] stride convolution stride
53 * @param[in] bias pointer to bias
54 * @param[in] bias_shift amount of left-shift for bias
55 * @param[in] out_shift amount of right-shift for output
56 * @param[in,out] Im_out pointer to output tensor
57 * @param[in] dim_im_out output tensor dimension
58 * @param[in,out] bufferA pointer to buffer space for input
59 * @param[in,out] bufferB pointer to buffer space for output
60 * @return The function returns <code>ARM_MATH_SUCCESS</code>
61 *
62 * @details
63 *
64 * <b>Buffer size:</b>
65 *
66 * bufferA size: ch_im_in*dim_kernel*dim_kernel
67 *
68 * bufferB size: 0
69 *
70 * This basic version is designed to work for any input tensor and weight
71 * dimension.
72 */
73
arm_convolve_HWC_q15_basic(const q15_t * Im_in,const uint16_t dim_im_in,const uint16_t ch_im_in,const q15_t * wt,const uint16_t ch_im_out,const uint16_t dim_kernel,const uint16_t padding,const uint16_t stride,const q15_t * bias,const uint16_t bias_shift,const uint16_t out_shift,q15_t * Im_out,const uint16_t dim_im_out,q15_t * bufferA,q7_t * bufferB)74 arm_status arm_convolve_HWC_q15_basic(const q15_t *Im_in,
75 const uint16_t dim_im_in,
76 const uint16_t ch_im_in,
77 const q15_t *wt,
78 const uint16_t ch_im_out,
79 const uint16_t dim_kernel,
80 const uint16_t padding,
81 const uint16_t stride,
82 const q15_t *bias,
83 const uint16_t bias_shift,
84 const uint16_t out_shift,
85 q15_t *Im_out,
86 const uint16_t dim_im_out,
87 q15_t *bufferA,
88 q7_t *bufferB)
89 {
90 (void)bufferB;
91 #if defined(ARM_MATH_DSP)
92 /* Run the following code for Cortex-M4 and Cortex-M7 */
93
94 int16_t i_out_y, i_out_x, i_ker_y, i_ker_x;
95
96 uint16_t im2col_out_pixel_index = 0;
97 q15_t *pBuffer = bufferA;
98 q15_t *pOut = Im_out;
99 q15_t *im_buffer = bufferA;
100 const q15_t *pA;
101 int i;
102
103 /* This part implements the im2col function */
104 for (i_out_y = 0; i_out_y < dim_im_out; i_out_y++)
105 {
106 for (i_out_x = 0; i_out_x < dim_im_out; i_out_x++)
107 {
108 for (i_ker_y = i_out_y * stride - padding; i_ker_y < i_out_y * stride - padding + dim_kernel; i_ker_y++)
109 {
110 for (i_ker_x = i_out_x * stride - padding; i_ker_x < i_out_x * stride - padding + dim_kernel; i_ker_x++)
111 {
112 if (i_ker_y < 0 || i_ker_y >= dim_im_in || i_ker_x < 0 || i_ker_x >= dim_im_in)
113 {
114 /* Filling 0 for out-of-bound paddings */
115 /* arm_fill_q15(0, pBuffer, ch_im_in); */
116 memset(pBuffer, 0, sizeof(q15_t) * ch_im_in);
117 }
118 else
119 {
120 /* arm_copy_q15((q15_t *) Im_in + (i_ker_y * dim_im_in + i_ker_x) * ch_im_in, pBuffer,
121 * ch_im_in); */
122 memcpy(pBuffer,
123 (q15_t *)Im_in + (i_ker_y * dim_im_in + i_ker_x) * ch_im_in,
124 sizeof(q15_t) * ch_im_in);
125 }
126 pBuffer += ch_im_in;
127 }
128 }
129
130 pA = wt;
131 for (i = 0; i < ch_im_out; i++)
132 {
133 q31_t sum = ((q31_t)bias[i] << bias_shift) + NN_ROUND(out_shift);
134 const q15_t *pB = im_buffer;
135 uint16_t colCnt = ch_im_in * dim_kernel * dim_kernel >> 2;
136 while (colCnt)
137 {
138 q31_t inA1 = arm_nn_read_q15x2_ia(&pA);
139 q31_t inB1 = arm_nn_read_q15x2_ia(&pB);
140 q31_t inA2 = arm_nn_read_q15x2_ia(&pA);
141 q31_t inB2 = arm_nn_read_q15x2_ia(&pB);
142
143 sum = __SMLAD(inA1, inB1, sum);
144 sum = __SMLAD(inA2, inB2, sum);
145
146 colCnt--;
147 }
148 colCnt = ch_im_in * dim_kernel * dim_kernel & 0x3;
149 while (colCnt)
150 {
151 q15_t inA1 = *pA++;
152 q15_t inB1 = *pB++;
153 sum += inA1 * inB1;
154 colCnt--;
155 }
156 *pOut = (q15_t)__SSAT((sum >> out_shift), 16);
157 pOut++;
158 }
159
160 /* counter reset */
161 pBuffer = im_buffer;
162 im2col_out_pixel_index++;
163 }
164 }
165
166 #else
167 (void)bufferA;
168 /* Run the following code as reference implementation for Cortex-M0 and Cortex-M3 */
169 int i, j, k, l, m, n;
170 int conv_out;
171 int in_row, in_col;
172
173 for (i = 0; i < ch_im_out; i++)
174 {
175 for (j = 0; j < dim_im_out; j++)
176 {
177 for (k = 0; k < dim_im_out; k++)
178 {
179 conv_out = ((q31_t)bias[i] << bias_shift) + NN_ROUND(out_shift);
180 for (m = 0; m < dim_kernel; m++)
181 {
182 for (n = 0; n < dim_kernel; n++)
183 {
184 in_row = stride * j + m - padding;
185 in_col = stride * k + n - padding;
186 if (in_row >= 0 && in_col >= 0 && in_row < dim_im_in && in_col < dim_im_in)
187 {
188 for (l = 0; l < ch_im_in; l++)
189 {
190 conv_out += Im_in[(in_row * dim_im_in + in_col) * ch_im_in + l] *
191 wt[i * ch_im_in * dim_kernel * dim_kernel + (m * dim_kernel + n) * ch_im_in + l];
192 }
193 }
194 }
195 }
196 Im_out[i + (j * dim_im_out + k) * ch_im_out] = (q15_t)__SSAT((conv_out >> out_shift), 16);
197 }
198 }
199 }
200
201 #endif /* ARM_MATH_DSP */
202
203 /* Return to application */
204 return ARM_MATH_SUCCESS;
205 }
206
207 /**
208 * @} end of NNConv group
209 */
210
