1*c217d954SCole Faust /*
2*c217d954SCole Faust * Copyright (c) 2020-2022 Arm Limited.
3*c217d954SCole Faust *
4*c217d954SCole Faust * SPDX-License-Identifier: MIT
5*c217d954SCole Faust *
6*c217d954SCole Faust * Permission is hereby granted, free of charge, to any person obtaining a copy
7*c217d954SCole Faust * of this software and associated documentation files (the "Software"), to
8*c217d954SCole Faust * deal in the Software without restriction, including without limitation the
9*c217d954SCole Faust * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
10*c217d954SCole Faust * sell copies of the Software, and to permit persons to whom the Software is
11*c217d954SCole Faust * furnished to do so, subject to the following conditions:
12*c217d954SCole Faust *
13*c217d954SCole Faust * The above copyright notice and this permission notice shall be included in all
14*c217d954SCole Faust * copies or substantial portions of the Software.
15*c217d954SCole Faust *
16*c217d954SCole Faust * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17*c217d954SCole Faust * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18*c217d954SCole Faust * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19*c217d954SCole Faust * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20*c217d954SCole Faust * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21*c217d954SCole Faust * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22*c217d954SCole Faust * SOFTWARE.
23*c217d954SCole Faust */
24*c217d954SCole Faust #include "arm_compute/runtime/CL/functions/CLQLSTMLayer.h"
25*c217d954SCole Faust
26*c217d954SCole Faust #include "arm_compute/core/KernelDescriptors.h"
27*c217d954SCole Faust #include "arm_compute/core/QuantizationInfo.h"
28*c217d954SCole Faust #include "arm_compute/core/Utils.h"
29*c217d954SCole Faust #include "arm_compute/core/Validate.h"
30*c217d954SCole Faust #include "arm_compute/core/utils/misc/InfoHelpers.h"
31*c217d954SCole Faust #include "arm_compute/core/utils/quantization/AsymmHelpers.h"
32*c217d954SCole Faust #include "arm_compute/runtime/CL/CLScheduler.h"
33*c217d954SCole Faust #include "src/core/CL/kernels/CLFillBorderKernel.h"
34*c217d954SCole Faust #include "src/core/CL/kernels/CLQLSTMLayerNormalizationKernel.h"
35*c217d954SCole Faust #include "src/core/helpers/WindowHelpers.h"
36*c217d954SCole Faust #include "src/gpu/cl/kernels/ClGemmLowpReductionKernel.h"
37*c217d954SCole Faust
38*c217d954SCole Faust #include "src/common/utils/Log.h"
39*c217d954SCole Faust
40*c217d954SCole Faust namespace arm_compute
41*c217d954SCole Faust {
42*c217d954SCole Faust using namespace arm_compute::utils::info_helpers;
43*c217d954SCole Faust using namespace arm_compute::opencl::kernels;
44*c217d954SCole Faust namespace
45*c217d954SCole Faust {
validate_mm(GEMMLowpOutputStageInfo & gemmlowp_info,const ITensorInfo * mm_input,const ITensorInfo * mm_weights,const ITensorInfo * bias,float gemmlowp_scale,const TensorInfo * mm_res_info,const TensorInfo * outstage_tensor_info)46*c217d954SCole Faust Status validate_mm(GEMMLowpOutputStageInfo &gemmlowp_info, const ITensorInfo *mm_input, const ITensorInfo *mm_weights, const ITensorInfo *bias,
47*c217d954SCole Faust float gemmlowp_scale, const TensorInfo *mm_res_info, const TensorInfo *outstage_tensor_info)
48*c217d954SCole Faust {
49*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLGEMMLowpMatrixMultiplyCore::validate(mm_input, mm_weights, nullptr, mm_res_info));
50*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(quantization::calculate_quantized_multiplier(gemmlowp_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift));
51*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLGEMMLowpOutputStage::validate(mm_res_info, bias, outstage_tensor_info, gemmlowp_info));
52*c217d954SCole Faust return Status{};
53*c217d954SCole Faust }
54*c217d954SCole Faust } // namespace
55*c217d954SCole Faust
validate(const ITensorInfo & src,const ITensorInfo & dst)56*c217d954SCole Faust Status CLQLSTMLayer::TensorCopyKernel::validate(const ITensorInfo &src, const ITensorInfo &dst)
57*c217d954SCole Faust {
58*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(src.tensor_shape().num_dimensions() > max_dimension_supported);
59*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(dst.tensor_shape().num_dimensions() > max_dimension_supported);
60*c217d954SCole Faust ARM_COMPUTE_ERROR_ON_MISMATCHING_DATA_TYPES(&src, &dst);
61*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(dst.tensor_shape().y() != src.tensor_shape().y());
62*c217d954SCole Faust return Status{};
63*c217d954SCole Faust }
64*c217d954SCole Faust
configure(ICLTensor & src,ICLTensor & dst)65*c217d954SCole Faust void CLQLSTMLayer::TensorCopyKernel::configure(ICLTensor &src, ICLTensor &dst)
66*c217d954SCole Faust {
67*c217d954SCole Faust ARM_COMPUTE_ERROR_THROW_ON(CLQLSTMLayer::TensorCopyKernel::validate(*src.info(), *dst.info()));
68*c217d954SCole Faust _src = &src;
69*c217d954SCole Faust _dst = &dst;
70*c217d954SCole Faust _row_size = std::min(_src->info()->tensor_shape().x(), _dst->info()->tensor_shape().x());
71*c217d954SCole Faust _window = calculate_max_window(*_src->info(), Steps());
72*c217d954SCole Faust }
73*c217d954SCole Faust
run()74*c217d954SCole Faust void CLQLSTMLayer::TensorCopyKernel::run()
75*c217d954SCole Faust {
76*c217d954SCole Faust auto &q = CLScheduler::get().queue();
77*c217d954SCole Faust
78*c217d954SCole Faust _src->map(q, true);
79*c217d954SCole Faust _dst->map(q, true);
80*c217d954SCole Faust
81*c217d954SCole Faust Iterator input_iter{ _src, _window };
82*c217d954SCole Faust Iterator output_iter{ _dst, _window };
83*c217d954SCole Faust
84*c217d954SCole Faust execute_window_loop(_window, [&](const Coordinates &)
85*c217d954SCole Faust {
86*c217d954SCole Faust memcpy(output_iter.ptr(), input_iter.ptr(), _row_size);
87*c217d954SCole Faust },
88*c217d954SCole Faust input_iter, output_iter);
89*c217d954SCole Faust
90*c217d954SCole Faust _src->unmap(q);
91*c217d954SCole Faust _dst->unmap(q);
92*c217d954SCole Faust }
93*c217d954SCole Faust
CLQLSTMLayer(std::shared_ptr<IMemoryManager> memory_manager)94*c217d954SCole Faust CLQLSTMLayer::CLQLSTMLayer(std::shared_ptr<IMemoryManager> memory_manager)
95*c217d954SCole Faust : _input_to_input_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
96*c217d954SCole Faust _recurrent_to_input_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
97*c217d954SCole Faust _input_to_forget_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
98*c217d954SCole Faust _recurrent_to_forget_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
99*c217d954SCole Faust _input_to_cell_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
100*c217d954SCole Faust _recurrent_to_cell_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
101*c217d954SCole Faust _input_to_output_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
102*c217d954SCole Faust _recurrent_to_output_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
103*c217d954SCole Faust _projection_reduction(std::make_unique<ClGemmLowpMatrixAReductionKernel>()),
104*c217d954SCole Faust _layer_norms(),
105*c217d954SCole Faust _copy_output()
106*c217d954SCole Faust {
107*c217d954SCole Faust for(auto &norm : _layer_norms)
108*c217d954SCole Faust {
109*c217d954SCole Faust norm = std::make_unique<CLQLSTMLayerNormalizationKernel>();
110*c217d954SCole Faust }
111*c217d954SCole Faust
112*c217d954SCole Faust _memory_group = MemoryGroup(std::move(memory_manager));
113*c217d954SCole Faust }
114*c217d954SCole Faust
115*c217d954SCole Faust CLQLSTMLayer::~CLQLSTMLayer() = default;
116*c217d954SCole Faust
configure_layer_norm(LayerNormGate g,const ICLTensor * in)117*c217d954SCole Faust void CLQLSTMLayer::configure_layer_norm(LayerNormGate g, const ICLTensor *in)
118*c217d954SCole Faust {
119*c217d954SCole Faust ARM_COMPUTE_ERROR_ON(!_has_layer_norm);
120*c217d954SCole Faust
121*c217d954SCole Faust CLTensor *out = &get_layer_norm_output(g);
122*c217d954SCole Faust _memory_group.manage(out);
123*c217d954SCole Faust out->allocator()->init(*(in->info()));
124*c217d954SCole Faust
125*c217d954SCole Faust get_layer_norm(g).configure(in, out, get_layer_norm_weight(g), get_layer_norm_bias(g));
126*c217d954SCole Faust }
127*c217d954SCole Faust
validate_layer_norm(const ITensorInfo & in,const ITensorInfo & weight,const ITensorInfo & bias)128*c217d954SCole Faust Status CLQLSTMLayer::validate_layer_norm(const ITensorInfo &in, const ITensorInfo &weight, const ITensorInfo &bias)
129*c217d954SCole Faust {
130*c217d954SCole Faust // Output quantization scale will be different, but ignored here
131*c217d954SCole Faust // since it will be configured at configure() stage.
132*c217d954SCole Faust const TensorInfo out
133*c217d954SCole Faust {
134*c217d954SCole Faust in
135*c217d954SCole Faust };
136*c217d954SCole Faust return CLQLSTMLayerNormalizationKernel::validate(&in, &out, &weight, &bias);
137*c217d954SCole Faust }
138*c217d954SCole Faust
configure_mm(const CLCompileContext & compile_context,CLGEMMLowpMatrixMultiplyCore & mm,CLGEMMLowpOutputStage & outstage,GEMMLowpOutputStageInfo & gemmlowp_info,const ICLTensor * mm_input,const ICLTensor * mm_weights,const ICLTensor * bias,CLTensor * mm_res,CLTensor * outstage_res,float gemmlowp_scale,const TensorInfo & mm_res_info,const TensorInfo & outstage_tensor_info)139*c217d954SCole Faust void CLQLSTMLayer::configure_mm(const CLCompileContext &compile_context, CLGEMMLowpMatrixMultiplyCore &mm, CLGEMMLowpOutputStage &outstage, GEMMLowpOutputStageInfo &gemmlowp_info,
140*c217d954SCole Faust const ICLTensor *mm_input, const ICLTensor *mm_weights, const ICLTensor *bias,
141*c217d954SCole Faust CLTensor *mm_res, CLTensor *outstage_res, float gemmlowp_scale,
142*c217d954SCole Faust const TensorInfo &mm_res_info, const TensorInfo &outstage_tensor_info)
143*c217d954SCole Faust {
144*c217d954SCole Faust _memory_group.manage(mm_res);
145*c217d954SCole Faust _memory_group.manage(outstage_res);
146*c217d954SCole Faust
147*c217d954SCole Faust mm_res->allocator()->init(mm_res_info);
148*c217d954SCole Faust outstage_res->allocator()->init(outstage_tensor_info);
149*c217d954SCole Faust
150*c217d954SCole Faust // Configure matrix-multiplication
151*c217d954SCole Faust mm.configure(compile_context, mm_input, mm_weights, nullptr, mm_res);
152*c217d954SCole Faust
153*c217d954SCole Faust // Configure output stage
154*c217d954SCole Faust quantization::calculate_quantized_multiplier(gemmlowp_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift);
155*c217d954SCole Faust outstage.configure(compile_context, mm_res, bias, outstage_res, gemmlowp_info);
156*c217d954SCole Faust mm_res->allocator()->allocate();
157*c217d954SCole Faust }
158*c217d954SCole Faust
configure(const ICLTensor * input,const ICLTensor * input_to_forget_weights,const ICLTensor * input_to_cell_weights,const ICLTensor * input_to_output_weights,const ICLTensor * recurrent_to_forget_weights,const ICLTensor * recurrent_to_cell_weights,const ICLTensor * recurrent_to_output_weights,const ICLTensor * forget_gate_bias,const ICLTensor * cell_bias,const ICLTensor * output_gate_bias,ICLTensor * cell_state_in,ICLTensor * output_state_in,ICLTensor * cell_state_out,ICLTensor * output_state_out,ICLTensor * output,const LSTMParams<ICLTensor> & lstm_params)159*c217d954SCole Faust void CLQLSTMLayer::configure(const ICLTensor *input,
160*c217d954SCole Faust const ICLTensor *input_to_forget_weights, const ICLTensor *input_to_cell_weights, const ICLTensor *input_to_output_weights,
161*c217d954SCole Faust const ICLTensor *recurrent_to_forget_weights, const ICLTensor *recurrent_to_cell_weights, const ICLTensor *recurrent_to_output_weights,
162*c217d954SCole Faust const ICLTensor *forget_gate_bias, const ICLTensor *cell_bias, const ICLTensor *output_gate_bias,
163*c217d954SCole Faust ICLTensor *cell_state_in, ICLTensor *output_state_in,
164*c217d954SCole Faust ICLTensor *cell_state_out, ICLTensor *output_state_out, ICLTensor *output,
165*c217d954SCole Faust const LSTMParams<ICLTensor> &lstm_params)
166*c217d954SCole Faust {
167*c217d954SCole Faust configure(CLKernelLibrary::get().get_compile_context(), input, input_to_forget_weights, input_to_cell_weights, input_to_output_weights,
168*c217d954SCole Faust recurrent_to_forget_weights, recurrent_to_cell_weights, recurrent_to_output_weights, forget_gate_bias, cell_bias, output_gate_bias,
169*c217d954SCole Faust cell_state_in, output_state_in, cell_state_out, output_state_out, output, lstm_params);
170*c217d954SCole Faust }
171*c217d954SCole Faust
configure(const CLCompileContext & compile_context,const ICLTensor * input,const ICLTensor * input_to_forget_weights,const ICLTensor * input_to_cell_weights,const ICLTensor * input_to_output_weights,const ICLTensor * recurrent_to_forget_weights,const ICLTensor * recurrent_to_cell_weights,const ICLTensor * recurrent_to_output_weights,const ICLTensor * forget_gate_bias,const ICLTensor * cell_bias,const ICLTensor * output_gate_bias,ICLTensor * cell_state_in,ICLTensor * output_state_in,ICLTensor * cell_state_out,ICLTensor * output_state_out,ICLTensor * output,const LSTMParams<ICLTensor> & lstm_params)172*c217d954SCole Faust void CLQLSTMLayer::configure(const CLCompileContext &compile_context, const ICLTensor *input,
173*c217d954SCole Faust const ICLTensor *input_to_forget_weights, const ICLTensor *input_to_cell_weights, const ICLTensor *input_to_output_weights,
174*c217d954SCole Faust const ICLTensor *recurrent_to_forget_weights, const ICLTensor *recurrent_to_cell_weights, const ICLTensor *recurrent_to_output_weights,
175*c217d954SCole Faust const ICLTensor *forget_gate_bias, const ICLTensor *cell_bias, const ICLTensor *output_gate_bias,
176*c217d954SCole Faust ICLTensor *cell_state_in, ICLTensor *output_state_in,
177*c217d954SCole Faust ICLTensor *cell_state_out, ICLTensor *output_state_out, ICLTensor *output,
178*c217d954SCole Faust const LSTMParams<ICLTensor> &lstm_params)
179*c217d954SCole Faust {
180*c217d954SCole Faust ARM_COMPUTE_ERROR_ON_NULLPTR(input, input_to_forget_weights, input_to_cell_weights, input_to_output_weights,
181*c217d954SCole Faust recurrent_to_forget_weights, recurrent_to_cell_weights, recurrent_to_output_weights,
182*c217d954SCole Faust forget_gate_bias, cell_bias, output_gate_bias, cell_state_in, output_state_in,
183*c217d954SCole Faust cell_state_out, output_state_out, output);
184*c217d954SCole Faust
185*c217d954SCole Faust ARM_COMPUTE_LOG_PARAMS(input, input_to_forget_weights, input_to_cell_weights, input_to_output_weights,
186*c217d954SCole Faust recurrent_to_forget_weights, recurrent_to_cell_weights, recurrent_to_output_weights,
187*c217d954SCole Faust forget_gate_bias, cell_bias, output_gate_bias, cell_state_in, output_state_in,
188*c217d954SCole Faust cell_state_out, output_state_out, output, lstm_params);
189*c217d954SCole Faust // Set lstm parameters
190*c217d954SCole Faust LSTMParams<ITensorInfo> lstm_params_info{};
191*c217d954SCole Faust build_lstm_params_tensor_info(lstm_params, &lstm_params_info);
192*c217d954SCole Faust
193*c217d954SCole Faust // Validate
194*c217d954SCole Faust ARM_COMPUTE_ERROR_THROW_ON(CLQLSTMLayer::validate(input->info(), input_to_forget_weights->info(), input_to_cell_weights->info(), input_to_output_weights->info(),
195*c217d954SCole Faust recurrent_to_forget_weights->info(), recurrent_to_cell_weights->info(), recurrent_to_output_weights->info(),
196*c217d954SCole Faust forget_gate_bias->info(), cell_bias->info(), output_gate_bias->info(),
197*c217d954SCole Faust cell_state_in->info(), output_state_in->info(), cell_state_out->info(), output_state_out->info(), output->info(),
198*c217d954SCole Faust lstm_params_info));
199*c217d954SCole Faust
200*c217d954SCole Faust const int batch_size = input->info()->dimension(1);
201*c217d954SCole Faust const int num_units = input_to_output_weights->info()->dimension(1);
202*c217d954SCole Faust const int output_size = output_state_out->info()->dimension(_out_state_output_size_dimension_idx);
203*c217d954SCole Faust
204*c217d954SCole Faust const UniformQuantizationInfo qinput = input->info()->quantization_info().uniform();
205*c217d954SCole Faust const UniformQuantizationInfo qcell_state_in = cell_state_in->info()->quantization_info().uniform();
206*c217d954SCole Faust const UniformQuantizationInfo qoutput_state_in = output_state_in->info()->quantization_info().uniform();
207*c217d954SCole Faust
208*c217d954SCole Faust _projection_bias = lstm_params.projection_bias();
209*c217d954SCole Faust _input_to_forget_weights = input_to_forget_weights;
210*c217d954SCole Faust _input_to_cell_weights = input_to_cell_weights;
211*c217d954SCole Faust _input_to_output_weights = input_to_output_weights;
212*c217d954SCole Faust _recurrent_to_forget_weights = recurrent_to_forget_weights;
213*c217d954SCole Faust _recurrent_to_cell_weights = recurrent_to_cell_weights;
214*c217d954SCole Faust _recurrent_to_output_weights = recurrent_to_output_weights;
215*c217d954SCole Faust _projection_weights = lstm_params.projection_weights();
216*c217d954SCole Faust
217*c217d954SCole Faust // Layer normalization
218*c217d954SCole Faust _has_layer_norm = lstm_params.use_layer_norm();
219*c217d954SCole Faust if(_has_layer_norm)
220*c217d954SCole Faust {
221*c217d954SCole Faust set_layer_norm_weight(lstm_params.forget_layer_norm_weights(), LayerNormGate::Forget);
222*c217d954SCole Faust set_layer_norm_weight(lstm_params.cell_layer_norm_weights(), LayerNormGate::Cell);
223*c217d954SCole Faust set_layer_norm_weight(lstm_params.input_layer_norm_weights(), LayerNormGate::Input);
224*c217d954SCole Faust set_layer_norm_weight(lstm_params.output_layer_norm_weights(), LayerNormGate::Output);
225*c217d954SCole Faust
226*c217d954SCole Faust set_layer_norm_bias(forget_gate_bias, LayerNormGate::Forget);
227*c217d954SCole Faust set_layer_norm_bias(cell_bias, LayerNormGate::Cell);
228*c217d954SCole Faust set_layer_norm_bias(lstm_params.input_gate_bias(), LayerNormGate::Input);
229*c217d954SCole Faust set_layer_norm_bias(output_gate_bias, LayerNormGate::Output);
230*c217d954SCole Faust }
231*c217d954SCole Faust
232*c217d954SCole Faust _has_cifg = lstm_params.has_cifg_opt();
233*c217d954SCole Faust _has_projection = lstm_params.has_projection();
234*c217d954SCole Faust _has_peephole = lstm_params.has_peephole_opt();
235*c217d954SCole Faust
236*c217d954SCole Faust // Calculate and decompose effective scales for optimizing matmul calculation
237*c217d954SCole Faust const int32_t cell_shift = log2(qcell_state_in.scale);
238*c217d954SCole Faust
239*c217d954SCole Faust // Calculate quantized parameters for clipping.
240*c217d954SCole Faust int16_t quantized_cell_clip = 0;
241*c217d954SCole Faust if(lstm_params.cell_clip() > 0.0f)
242*c217d954SCole Faust {
243*c217d954SCole Faust quantized_cell_clip = quantize_qsymm16(lstm_params.cell_clip(), qcell_state_in);
244*c217d954SCole Faust }
245*c217d954SCole Faust _has_cell_clipping = quantized_cell_clip > 0;
246*c217d954SCole Faust
247*c217d954SCole Faust // Precompute effective bias for optimizing the matmul computations.
248*c217d954SCole Faust if(!_has_cifg)
249*c217d954SCole Faust {
250*c217d954SCole Faust _input_to_input_weights = lstm_params.input_to_input_weights();
251*c217d954SCole Faust _recurrent_to_input_weights = lstm_params.recurrent_to_input_weights();
252*c217d954SCole Faust
253*c217d954SCole Faust _input_to_input_reduction->configure(compile_context, _input_to_input_weights->info(), _input_to_input_eff_bias.info(), GEMMLowpReductionKernelInfo(num_units, false, -qinput.offset, true));
254*c217d954SCole Faust _recurrent_to_input_reduction->configure(compile_context, _recurrent_to_input_weights->info(), _recurrent_to_input_eff_bias.info(), GEMMLowpReductionKernelInfo(num_units, false,
255*c217d954SCole Faust -qoutput_state_in.offset, true));
256*c217d954SCole Faust }
257*c217d954SCole Faust _input_to_forget_reduction->configure(compile_context, input_to_forget_weights->info(), _input_to_forget_eff_bias.info(), GEMMLowpReductionKernelInfo(num_units, false, -qinput.offset, true));
258*c217d954SCole Faust _recurrent_to_forget_reduction->configure(compile_context, recurrent_to_forget_weights->info(), _recurrent_to_forget_eff_bias.info(), GEMMLowpReductionKernelInfo(num_units, false,
259*c217d954SCole Faust -qoutput_state_in.offset, true));
260*c217d954SCole Faust _input_to_cell_reduction->configure(compile_context, input_to_cell_weights->info(), _input_to_cell_eff_bias.info(), GEMMLowpReductionKernelInfo(num_units, false, -qinput.offset, true));
261*c217d954SCole Faust _recurrent_to_cell_reduction->configure(compile_context, recurrent_to_cell_weights->info(), _recurrent_to_cell_eff_bias.info(), GEMMLowpReductionKernelInfo(num_units, false, -qoutput_state_in.offset,
262*c217d954SCole Faust true));
263*c217d954SCole Faust _input_to_output_reduction->configure(compile_context, input_to_output_weights->info(), _input_to_output_eff_bias.info(), GEMMLowpReductionKernelInfo(num_units, false, -qinput.offset, true));
264*c217d954SCole Faust _recurrent_to_output_reduction->configure(compile_context, recurrent_to_output_weights->info(), _recurrent_to_output_eff_bias.info(), GEMMLowpReductionKernelInfo(num_units, false,
265*c217d954SCole Faust -qoutput_state_in.offset, true));
266*c217d954SCole Faust if(_has_projection)
267*c217d954SCole Faust {
268*c217d954SCole Faust _projection_reduction->configure(compile_context, _projection_weights->info(), _projection_eff_bias.info(), GEMMLowpReductionKernelInfo(output_size, false, lstm_params.hidden_state_zero(), true));
269*c217d954SCole Faust if(_projection_bias != nullptr)
270*c217d954SCole Faust {
271*c217d954SCole Faust _projection_bias_add.configure(compile_context, _projection_bias, &_projection_eff_bias, &_projection_eff_bias, ConvertPolicy::SATURATE);
272*c217d954SCole Faust }
273*c217d954SCole Faust }
274*c217d954SCole Faust
275*c217d954SCole Faust // Pre-transpose weights to be used in GEMM.
276*c217d954SCole Faust _transpose_input_to_forget_weights.configure(compile_context, input_to_forget_weights, &_input_to_forget_weights_transposed);
277*c217d954SCole Faust _transpose_input_to_cell_weights.configure(compile_context, input_to_cell_weights, &_input_to_cell_weights_transposed);
278*c217d954SCole Faust _transpose_input_to_output_weights.configure(compile_context, input_to_output_weights, &_input_to_output_weights_transposed);
279*c217d954SCole Faust _transpose_recurrent_to_forget_weights.configure(compile_context, recurrent_to_forget_weights, &_recurrent_to_forget_weights_transposed);
280*c217d954SCole Faust _transpose_recurrent_to_cell_weights.configure(compile_context, recurrent_to_cell_weights, &_recurrent_to_cell_weights_transposed);
281*c217d954SCole Faust _transpose_recurrent_to_output_weights.configure(compile_context, recurrent_to_output_weights, &_recurrent_to_output_weights_transposed);
282*c217d954SCole Faust if(!_has_cifg)
283*c217d954SCole Faust {
284*c217d954SCole Faust _transpose_input_to_input_weights.configure(compile_context, lstm_params.input_to_input_weights(), &_input_to_input_weights_transposed);
285*c217d954SCole Faust _transpose_recurrent_to_input_weights.configure(compile_context, lstm_params.recurrent_to_input_weights(), &_recurrent_to_input_weights_transposed);
286*c217d954SCole Faust }
287*c217d954SCole Faust if(_has_projection)
288*c217d954SCole Faust {
289*c217d954SCole Faust _transpose_projection_weights.configure(compile_context, _projection_weights, &_projection_weights_transposed);
290*c217d954SCole Faust }
291*c217d954SCole Faust
292*c217d954SCole Faust GEMMLowpOutputStageInfo gemmlowp_info;
293*c217d954SCole Faust gemmlowp_info.type = GEMMLowpOutputStageType::QUANTIZE_DOWN_FIXEDPOINT;
294*c217d954SCole Faust gemmlowp_info.gemmlowp_min_bound = std::numeric_limits<int16_t>::lowest();
295*c217d954SCole Faust gemmlowp_info.gemmlowp_max_bound = std::numeric_limits<int16_t>::max();
296*c217d954SCole Faust gemmlowp_info.output_data_type = DataType::QSYMM16;
297*c217d954SCole Faust
298*c217d954SCole Faust const TensorInfo mm_out_info(TensorShape(num_units, batch_size), 1, DataType::S32);
299*c217d954SCole Faust // Forget gate.
300*c217d954SCole Faust const TensorInfo forget_gate_outstage_info(mm_out_info.tensor_shape(), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.forget_intermediate_scale(), 0));
301*c217d954SCole Faust const float input_to_forget_scale = input_to_forget_weights->info()->quantization_info().uniform().scale * qinput.scale / lstm_params.forget_intermediate_scale();
302*c217d954SCole Faust configure_mm(compile_context, _mm_input_to_forget, _input_to_forget_outstage, gemmlowp_info,
303*c217d954SCole Faust input, &_input_to_forget_weights_transposed, &_input_to_forget_eff_bias,
304*c217d954SCole Faust &_mm_input_to_forget_res, &_input_to_forget_outstage_res, input_to_forget_scale,
305*c217d954SCole Faust mm_out_info, forget_gate_outstage_info);
306*c217d954SCole Faust
307*c217d954SCole Faust const float recurrent_to_forget_scale = recurrent_to_forget_weights->info()->quantization_info().uniform().scale * qoutput_state_in.scale / lstm_params.forget_intermediate_scale();
308*c217d954SCole Faust configure_mm(compile_context, _mm_recurrent_to_forget, _recurrent_to_forget_outstage, gemmlowp_info,
309*c217d954SCole Faust output_state_in, &_recurrent_to_forget_weights_transposed, &_recurrent_to_forget_eff_bias,
310*c217d954SCole Faust &_mm_recurrent_to_forget_res, &_recurrent_to_forget_outstage_res, recurrent_to_forget_scale,
311*c217d954SCole Faust mm_out_info, forget_gate_outstage_info);
312*c217d954SCole Faust
313*c217d954SCole Faust _accumulate_input_recurrent_forget.configure(compile_context, &_input_to_forget_outstage_res, &_recurrent_to_forget_outstage_res, &_recurrent_to_forget_outstage_res,
314*c217d954SCole Faust ConvertPolicy::SATURATE);
315*c217d954SCole Faust _input_to_forget_outstage_res.allocator()->allocate();
316*c217d954SCole Faust
317*c217d954SCole Faust if(_has_peephole)
318*c217d954SCole Faust {
319*c217d954SCole Faust _mul_cell_to_forget_res.allocator()->init(TensorInfo(cell_state_in->info()->tensor_shape(), 1, DataType::S32));
320*c217d954SCole Faust _memory_group.manage(&_mul_cell_to_forget_res);
321*c217d954SCole Faust _pixelwise_mul_cell_to_forget.configure(compile_context, cell_state_in, lstm_params.cell_to_forget_weights(), &_mul_cell_to_forget_res, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO);
322*c217d954SCole Faust _cell_to_forget_outstage_res.allocator()->init(TensorInfo(_mul_cell_to_forget_res.info()->tensor_shape(), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.forget_intermediate_scale(), 0)));
323*c217d954SCole Faust _memory_group.manage(&_cell_to_forget_outstage_res);
324*c217d954SCole Faust const float cell_to_forget_scale = std::pow(2, cell_shift) * lstm_params.cell_to_forget_weights()->info()->quantization_info().uniform().scale / lstm_params.forget_intermediate_scale();
325*c217d954SCole Faust quantization::calculate_quantized_multiplier(cell_to_forget_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift);
326*c217d954SCole Faust _cell_to_forget_outstage.configure(compile_context, &_mul_cell_to_forget_res, nullptr, &_cell_to_forget_outstage_res, gemmlowp_info);
327*c217d954SCole Faust _mul_cell_to_forget_res.allocator()->allocate();
328*c217d954SCole Faust _accumulate_cell_forget.configure(compile_context, &_recurrent_to_forget_outstage_res, &_cell_to_forget_outstage_res, &_recurrent_to_forget_outstage_res,
329*c217d954SCole Faust ConvertPolicy::SATURATE);
330*c217d954SCole Faust _cell_to_forget_outstage_res.allocator()->allocate();
331*c217d954SCole Faust }
332*c217d954SCole Faust
333*c217d954SCole Faust CLTensor *forget_activation_input = &_recurrent_to_forget_outstage_res;
334*c217d954SCole Faust
335*c217d954SCole Faust if(_has_layer_norm)
336*c217d954SCole Faust {
337*c217d954SCole Faust configure_layer_norm(LayerNormGate::Forget, &_recurrent_to_forget_outstage_res);
338*c217d954SCole Faust _recurrent_to_forget_outstage_res.allocator()->allocate();
339*c217d954SCole Faust forget_activation_input = &get_layer_norm_output(LayerNormGate::Forget);
340*c217d954SCole Faust }
341*c217d954SCole Faust
342*c217d954SCole Faust // Output quantization info of Sigmoid and Tanh activations
343*c217d954SCole Faust const QuantizationInfo sigmoid_tanh_outqinfo(1.f / 32768.f, 0);
344*c217d954SCole Faust
345*c217d954SCole Faust const TensorInfo forget_gate_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, sigmoid_tanh_outqinfo);
346*c217d954SCole Faust _memory_group.manage(&_forget_gate);
347*c217d954SCole Faust _forget_gate.allocator()->init(forget_gate_info);
348*c217d954SCole Faust _forget_gate_sigmoid.configure(compile_context, forget_activation_input, &_forget_gate, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LOGISTIC));
349*c217d954SCole Faust forget_activation_input->allocator()->allocate();
350*c217d954SCole Faust
351*c217d954SCole Faust // Modulation gate.
352*c217d954SCole Faust const TensorInfo cell_outstage_info(mm_out_info.tensor_shape(), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.cell_intermediate_scale(), 0));
353*c217d954SCole Faust const float input_to_cell_scale = input_to_cell_weights->info()->quantization_info().uniform().scale * qinput.scale / lstm_params.cell_intermediate_scale();
354*c217d954SCole Faust configure_mm(compile_context, _mm_input_to_cell, _input_to_cell_outstage, gemmlowp_info,
355*c217d954SCole Faust input, &_input_to_cell_weights_transposed, &_input_to_cell_eff_bias,
356*c217d954SCole Faust &_mm_input_to_cell_res, &_input_to_cell_outstage_res, input_to_cell_scale,
357*c217d954SCole Faust mm_out_info, cell_outstage_info);
358*c217d954SCole Faust
359*c217d954SCole Faust const float recurrent_to_cell_scale = recurrent_to_cell_weights->info()->quantization_info().uniform().scale * qoutput_state_in.scale / lstm_params.cell_intermediate_scale();
360*c217d954SCole Faust configure_mm(compile_context, _mm_recurrent_to_cell, _recurrent_to_cell_outstage, gemmlowp_info,
361*c217d954SCole Faust output_state_in, &_recurrent_to_cell_weights_transposed, &_recurrent_to_cell_eff_bias,
362*c217d954SCole Faust &_mm_recurrent_to_cell_res, &_recurrent_to_cell_outstage_res, recurrent_to_cell_scale,
363*c217d954SCole Faust mm_out_info, cell_outstage_info);
364*c217d954SCole Faust
365*c217d954SCole Faust _accumulate_input_recurrent_modulation.configure(compile_context, &_input_to_cell_outstage_res, &_recurrent_to_cell_outstage_res, &_recurrent_to_cell_outstage_res,
366*c217d954SCole Faust ConvertPolicy::SATURATE);
367*c217d954SCole Faust _input_to_cell_outstage_res.allocator()->allocate();
368*c217d954SCole Faust
369*c217d954SCole Faust CLTensor *cell_activation_input = &_recurrent_to_cell_outstage_res;
370*c217d954SCole Faust
371*c217d954SCole Faust if(_has_layer_norm)
372*c217d954SCole Faust {
373*c217d954SCole Faust configure_layer_norm(LayerNormGate::Cell, &_recurrent_to_cell_outstage_res);
374*c217d954SCole Faust _recurrent_to_cell_outstage_res.allocator()->allocate();
375*c217d954SCole Faust cell_activation_input = &get_layer_norm_output(LayerNormGate::Cell);
376*c217d954SCole Faust }
377*c217d954SCole Faust
378*c217d954SCole Faust const TensorInfo cell_gate_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, sigmoid_tanh_outqinfo);
379*c217d954SCole Faust _memory_group.manage(&_cell_gate);
380*c217d954SCole Faust _cell_gate.allocator()->init(cell_gate_info);
381*c217d954SCole Faust _cell_gate_tanh.configure(compile_context, cell_activation_input, &_cell_gate, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::TANH, 1.f, 1.f));
382*c217d954SCole Faust cell_activation_input->allocator()->allocate();
383*c217d954SCole Faust
384*c217d954SCole Faust // Input gate.
385*c217d954SCole Faust const TensorInfo input_gate_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, sigmoid_tanh_outqinfo);
386*c217d954SCole Faust _input_gate.allocator()->init(input_gate_info);
387*c217d954SCole Faust _memory_group.manage(&_input_gate);
388*c217d954SCole Faust if(_has_cifg)
389*c217d954SCole Faust {
390*c217d954SCole Faust _ones.allocator()->init(*_forget_gate.info());
391*c217d954SCole Faust _input_gate_sub.configure(compile_context, &_ones, &_forget_gate, &_input_gate, ConvertPolicy::SATURATE);
392*c217d954SCole Faust _ones.allocator()->allocate();
393*c217d954SCole Faust }
394*c217d954SCole Faust else
395*c217d954SCole Faust {
396*c217d954SCole Faust const TensorInfo input_outstage_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.input_intermediate_scale(), 0));
397*c217d954SCole Faust const float input_to_input_scale = _input_to_input_weights->info()->quantization_info().uniform().scale * qinput.scale / lstm_params.input_intermediate_scale();
398*c217d954SCole Faust configure_mm(compile_context, _mm_input_to_input, _input_to_input_outstage, gemmlowp_info,
399*c217d954SCole Faust input, &_input_to_input_weights_transposed, &_input_to_input_eff_bias,
400*c217d954SCole Faust &_mm_input_to_input_res, &_input_to_input_outstage_res, input_to_input_scale,
401*c217d954SCole Faust mm_out_info, input_outstage_info);
402*c217d954SCole Faust
403*c217d954SCole Faust const float recurrent_to_input_scale = _recurrent_to_input_weights->info()->quantization_info().uniform().scale * qoutput_state_in.scale / lstm_params.input_intermediate_scale();
404*c217d954SCole Faust configure_mm(compile_context, _mm_recurrent_to_input, _recurrent_to_input_outstage, gemmlowp_info,
405*c217d954SCole Faust output_state_in, &_recurrent_to_input_weights_transposed, &_recurrent_to_input_eff_bias,
406*c217d954SCole Faust &_mm_recurrent_to_input_res, &_recurrent_to_input_outstage_res, recurrent_to_input_scale,
407*c217d954SCole Faust mm_out_info, input_outstage_info);
408*c217d954SCole Faust _accumulate_input_recurrent_input.configure(compile_context, &_input_to_input_outstage_res, &_recurrent_to_input_outstage_res, &_recurrent_to_input_outstage_res,
409*c217d954SCole Faust ConvertPolicy::SATURATE);
410*c217d954SCole Faust _input_to_input_outstage_res.allocator()->allocate();
411*c217d954SCole Faust
412*c217d954SCole Faust if(_has_peephole)
413*c217d954SCole Faust {
414*c217d954SCole Faust _mul_cell_to_input_res.allocator()->init(TensorInfo(cell_state_in->info()->tensor_shape(), 1, DataType::S32));
415*c217d954SCole Faust _memory_group.manage(&_mul_cell_to_input_res);
416*c217d954SCole Faust _pixelwise_mul_cell_to_input.configure(compile_context, cell_state_in, lstm_params.cell_to_input_weights(), &_mul_cell_to_input_res, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO);
417*c217d954SCole Faust const float cell_to_input_scale = std::pow(2, cell_shift) * lstm_params.cell_to_input_weights()->info()->quantization_info().uniform().scale / lstm_params.input_intermediate_scale();
418*c217d954SCole Faust quantization::calculate_quantized_multiplier(cell_to_input_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift);
419*c217d954SCole Faust _cell_to_input_outstage_res.allocator()->init(TensorInfo(_mul_cell_to_input_res.info()->tensor_shape(), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.input_intermediate_scale(), 0)));
420*c217d954SCole Faust _memory_group.manage(&_cell_to_input_outstage_res);
421*c217d954SCole Faust _cell_to_input_outstage.configure(compile_context, &_mul_cell_to_input_res, nullptr, &_cell_to_input_outstage_res, gemmlowp_info);
422*c217d954SCole Faust _mul_cell_to_input_res.allocator()->allocate();
423*c217d954SCole Faust _accumulate_cell_input.configure(&_recurrent_to_input_outstage_res, &_cell_to_input_outstage_res, &_recurrent_to_input_outstage_res, ConvertPolicy::SATURATE);
424*c217d954SCole Faust _cell_to_input_outstage_res.allocator()->allocate();
425*c217d954SCole Faust }
426*c217d954SCole Faust
427*c217d954SCole Faust CLTensor *input_activation_input = &_recurrent_to_input_outstage_res;
428*c217d954SCole Faust
429*c217d954SCole Faust if(_has_layer_norm)
430*c217d954SCole Faust {
431*c217d954SCole Faust configure_layer_norm(LayerNormGate::Input, &_recurrent_to_input_outstage_res);
432*c217d954SCole Faust _recurrent_to_input_outstage_res.allocator()->allocate();
433*c217d954SCole Faust input_activation_input = &get_layer_norm_output(LayerNormGate::Input);
434*c217d954SCole Faust }
435*c217d954SCole Faust
436*c217d954SCole Faust _input_gate_sigmoid.configure(compile_context, input_activation_input, &_input_gate, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LOGISTIC));
437*c217d954SCole Faust input_activation_input->allocator()->allocate();
438*c217d954SCole Faust }
439*c217d954SCole Faust // Cell.
440*c217d954SCole Faust // TODO(COMPMID-3396): Perform multiplication in the quantized domain in CLPixelWiseMultiplication
441*c217d954SCole Faust _pixelwise_mul_forget_cell.configure(compile_context, &_forget_gate, cell_state_in, &_forget_gate, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO);
442*c217d954SCole Faust const float cell_gate_scale = _cell_gate.info()->quantization_info().uniform().scale;
443*c217d954SCole Faust const float mul_input_cell_scale = cell_gate_scale * std::pow(2, 15 + cell_shift);
444*c217d954SCole Faust const TensorInfo mul_input_cell_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, QuantizationInfo(mul_input_cell_scale, 0));
445*c217d954SCole Faust _memory_group.manage(&_mul_input_cell_res);
446*c217d954SCole Faust _mul_input_cell_res.allocator()->init(mul_input_cell_info);
447*c217d954SCole Faust _pixelwise_mul_input_cell.configure(compile_context, &_input_gate, &_cell_gate, &_mul_input_cell_res, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO);
448*c217d954SCole Faust _cell_gate.allocator()->allocate();
449*c217d954SCole Faust _add_forget_cell.configure(compile_context, &_forget_gate, &_mul_input_cell_res, cell_state_out, ConvertPolicy::SATURATE);
450*c217d954SCole Faust _mul_input_cell_res.allocator()->allocate();
451*c217d954SCole Faust _forget_gate.allocator()->allocate();
452*c217d954SCole Faust if(_has_cell_clipping)
453*c217d954SCole Faust {
454*c217d954SCole Faust _cell_clip.configure(compile_context, cell_state_out, nullptr, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU, -quantized_cell_clip, quantized_cell_clip));
455*c217d954SCole Faust }
456*c217d954SCole Faust // Output gate.
457*c217d954SCole Faust const TensorInfo output_outstage_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.output_intermediate_scale(), 0));
458*c217d954SCole Faust const float input_to_output_scale = input_to_output_weights->info()->quantization_info().uniform().scale * qinput.scale / lstm_params.output_intermediate_scale();
459*c217d954SCole Faust configure_mm(compile_context, _mm_input_to_output, _input_to_output_outstage, gemmlowp_info,
460*c217d954SCole Faust input, &_input_to_output_weights_transposed, &_input_to_output_eff_bias,
461*c217d954SCole Faust &_mm_input_to_output_res, &_input_to_output_outstage_res, input_to_output_scale,
462*c217d954SCole Faust mm_out_info, output_outstage_info);
463*c217d954SCole Faust
464*c217d954SCole Faust const float recurrent_to_output_scale = recurrent_to_output_weights->info()->quantization_info().uniform().scale * qoutput_state_in.scale / lstm_params.output_intermediate_scale();
465*c217d954SCole Faust configure_mm(compile_context, _mm_recurrent_to_output, _recurrent_to_output_outstage, gemmlowp_info,
466*c217d954SCole Faust output_state_in, &_recurrent_to_output_weights_transposed, &_recurrent_to_output_eff_bias,
467*c217d954SCole Faust &_mm_recurrent_to_output_res, &_recurrent_to_output_outstage_res, recurrent_to_output_scale,
468*c217d954SCole Faust mm_out_info, output_outstage_info);
469*c217d954SCole Faust
470*c217d954SCole Faust _accumulate_input_recurrent_output.configure(compile_context, &_recurrent_to_output_outstage_res, &_input_to_output_outstage_res, &_recurrent_to_output_outstage_res,
471*c217d954SCole Faust ConvertPolicy::SATURATE);
472*c217d954SCole Faust _input_to_output_outstage_res.allocator()->allocate();
473*c217d954SCole Faust
474*c217d954SCole Faust if(_has_peephole)
475*c217d954SCole Faust {
476*c217d954SCole Faust // TODO(COMPMID-3396): Perform multiplication in the quantized domain in CLPixelWiseMultiplication
477*c217d954SCole Faust // Here we are not using the output stage because all operations are done in float
478*c217d954SCole Faust _mul_cell_to_output_res.allocator()->init(TensorInfo(cell_state_out->info()->tensor_shape(), 1, DataType::S32));
479*c217d954SCole Faust _memory_group.manage(&_mul_cell_to_output_res);
480*c217d954SCole Faust _pixelwise_mul_cell_to_output.configure(compile_context, cell_state_out, lstm_params.cell_to_output_weights(), &_mul_cell_to_output_res, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO);
481*c217d954SCole Faust
482*c217d954SCole Faust const float cell_to_output_scale = std::pow(2, cell_shift) * lstm_params.cell_to_output_weights()->info()->quantization_info().uniform().scale / lstm_params.output_intermediate_scale();
483*c217d954SCole Faust quantization::calculate_quantized_multiplier(cell_to_output_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift);
484*c217d954SCole Faust _cell_to_output_outstage_res.allocator()->init(TensorInfo(_mul_cell_to_output_res.info()->tensor_shape(), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.output_intermediate_scale(), 0)));
485*c217d954SCole Faust _memory_group.manage(&_cell_to_output_outstage_res);
486*c217d954SCole Faust _cell_to_output_outstage.configure(compile_context, &_mul_cell_to_output_res, nullptr, &_cell_to_output_outstage_res, gemmlowp_info);
487*c217d954SCole Faust _mul_cell_to_output_res.allocator()->allocate();
488*c217d954SCole Faust
489*c217d954SCole Faust _accumulate_cell_to_output.configure(compile_context, &_recurrent_to_output_outstage_res, &_cell_to_output_outstage_res, &_recurrent_to_output_outstage_res,
490*c217d954SCole Faust ConvertPolicy::SATURATE);
491*c217d954SCole Faust _cell_to_output_outstage_res.allocator()->allocate();
492*c217d954SCole Faust }
493*c217d954SCole Faust
494*c217d954SCole Faust CLTensor *output_activation_input = &_recurrent_to_output_outstage_res;
495*c217d954SCole Faust
496*c217d954SCole Faust if(_has_layer_norm)
497*c217d954SCole Faust {
498*c217d954SCole Faust configure_layer_norm(LayerNormGate::Output, &_recurrent_to_output_outstage_res);
499*c217d954SCole Faust _recurrent_to_output_outstage_res.allocator()->allocate();
500*c217d954SCole Faust output_activation_input = &get_layer_norm_output(LayerNormGate::Output);
501*c217d954SCole Faust }
502*c217d954SCole Faust
503*c217d954SCole Faust const TensorInfo output_gate_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, sigmoid_tanh_outqinfo);
504*c217d954SCole Faust _memory_group.manage(&_output_gate);
505*c217d954SCole Faust _output_gate.allocator()->init(output_gate_info);
506*c217d954SCole Faust _output_gate_sigmoid.configure(compile_context, output_activation_input, &_output_gate, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LOGISTIC));
507*c217d954SCole Faust output_activation_input->allocator()->allocate();
508*c217d954SCole Faust
509*c217d954SCole Faust // Hidden.
510*c217d954SCole Faust _hidden_tanh.configure(compile_context, cell_state_out, &_input_gate, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::TANH, 1.f, 1.f));
511*c217d954SCole Faust // TODO(COMPMID-3396): Perform multiplication in the quantized domain in CLPixelWiseMultiplication
512*c217d954SCole Faust _memory_group.manage(&_hidden_mul_res);
513*c217d954SCole Faust const TensorInfo hidden_mul_res(_input_gate.info()->tensor_shape(), 1, DataType::S32);
514*c217d954SCole Faust _hidden_mul_res.allocator()->init(hidden_mul_res);
515*c217d954SCole Faust _pixelwise_mul_hidden.configure(compile_context, &_output_gate, &_input_gate, &_hidden_mul_res, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO);
516*c217d954SCole Faust _output_gate.allocator()->allocate();
517*c217d954SCole Faust _input_gate.allocator()->allocate();
518*c217d954SCole Faust const float hidden_state_scale = std::pow(2, -15) / lstm_params.hidden_state_scale() * std::pow(2, -15);
519*c217d954SCole Faust quantization::calculate_quantized_multiplier(hidden_state_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift, /* ignore_epsilon */ true);
520*c217d954SCole Faust gemmlowp_info.gemmlowp_offset = lstm_params.hidden_state_zero();
521*c217d954SCole Faust gemmlowp_info.output_data_type = output_state_in->info()->data_type();
522*c217d954SCole Faust
523*c217d954SCole Faust _projection_tensor_copy_required = (num_units != output_size);
524*c217d954SCole Faust ICLTensor *hidden_gate_result = output_state_out;
525*c217d954SCole Faust
526*c217d954SCole Faust _memory_group.manage(&_hidden_gate);
527*c217d954SCole Faust
528*c217d954SCole Faust if(_projection_tensor_copy_required)
529*c217d954SCole Faust {
530*c217d954SCole Faust _hidden_gate.allocator()->init(*output_state_out->info());
531*c217d954SCole Faust _hidden_gate.info()->set_tensor_shape(_hidden_mul_res.info()->tensor_shape());
532*c217d954SCole Faust hidden_gate_result = &_hidden_gate;
533*c217d954SCole Faust }
534*c217d954SCole Faust
535*c217d954SCole Faust _hidden_outstage.configure(compile_context, &_hidden_mul_res, nullptr, hidden_gate_result, gemmlowp_info);
536*c217d954SCole Faust _hidden_mul_res.allocator()->allocate();
537*c217d954SCole Faust
538*c217d954SCole Faust // Projection.
539*c217d954SCole Faust if(_has_projection)
540*c217d954SCole Faust {
541*c217d954SCole Faust const TensorInfo projection_outstage_info(*output_state_out->info());
542*c217d954SCole Faust const UniformQuantizationInfo qprojection = _projection_weights->info()->quantization_info().uniform();
543*c217d954SCole Faust const float projection_scale = qprojection.scale * lstm_params.hidden_state_scale() / qoutput_state_in.scale;
544*c217d954SCole Faust gemmlowp_info.gemmlowp_offset = qoutput_state_in.offset;
545*c217d954SCole Faust gemmlowp_info.gemmlowp_min_bound = std::numeric_limits<int8_t>::lowest();
546*c217d954SCole Faust gemmlowp_info.gemmlowp_max_bound = std::numeric_limits<int8_t>::max();
547*c217d954SCole Faust gemmlowp_info.output_data_type = DataType::QASYMM8_SIGNED;
548*c217d954SCole Faust
549*c217d954SCole Faust TensorInfo projection_mm_out_info{ mm_out_info };
550*c217d954SCole Faust projection_mm_out_info.set_tensor_shape(TensorShape(output_size, batch_size));
551*c217d954SCole Faust
552*c217d954SCole Faust configure_mm(compile_context, _mm_projection, _projection_outstage, gemmlowp_info,
553*c217d954SCole Faust hidden_gate_result, &_projection_weights_transposed, &_projection_eff_bias,
554*c217d954SCole Faust &_mm_projection_res, &_projection_outstage_res, projection_scale,
555*c217d954SCole Faust projection_mm_out_info, projection_outstage_info);
556*c217d954SCole Faust
557*c217d954SCole Faust ICLTensor *accumulate_destination = output_state_out;
558*c217d954SCole Faust
559*c217d954SCole Faust if(_projection_tensor_copy_required)
560*c217d954SCole Faust {
561*c217d954SCole Faust _hidden_gate.allocator()->allocate();
562*c217d954SCole Faust _projection_accumulate_res.allocator()->init(*output_state_in->info());
563*c217d954SCole Faust _projection_accumulate_res.info()->set_tensor_shape(_projection_outstage_res.info()->tensor_shape());
564*c217d954SCole Faust _projection_output_to_accumulate_copy.configure(*output_state_in, _projection_accumulate_res);
565*c217d954SCole Faust accumulate_destination = &_projection_accumulate_res;
566*c217d954SCole Faust }
567*c217d954SCole Faust
568*c217d954SCole Faust _accumulate_projection.configure(compile_context, &_projection_outstage_res, accumulate_destination, accumulate_destination, ConvertPolicy::SATURATE);
569*c217d954SCole Faust _projection_outstage_res.allocator()->allocate();
570*c217d954SCole Faust
571*c217d954SCole Faust if(_projection_tensor_copy_required)
572*c217d954SCole Faust {
573*c217d954SCole Faust _projection_accumulate_to_output_copy.configure(_projection_accumulate_res, *output_state_out);
574*c217d954SCole Faust _projection_accumulate_res.allocator()->allocate();
575*c217d954SCole Faust }
576*c217d954SCole Faust
577*c217d954SCole Faust int8_t quantized_projection_clip{ 0 };
578*c217d954SCole Faust if(lstm_params.projection_clip() > 0.0f)
579*c217d954SCole Faust {
580*c217d954SCole Faust quantized_projection_clip = utility::clamp<int8_t>(lstm_params.projection_clip() / qprojection.scale, -128, 127);
581*c217d954SCole Faust }
582*c217d954SCole Faust
583*c217d954SCole Faust if(quantized_projection_clip > 0)
584*c217d954SCole Faust {
585*c217d954SCole Faust _projection_clip.configure(compile_context, output_state_out, nullptr, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU, -quantized_projection_clip,
586*c217d954SCole Faust quantized_projection_clip));
587*c217d954SCole Faust _has_projection_clipping = true;
588*c217d954SCole Faust }
589*c217d954SCole Faust }
590*c217d954SCole Faust else
591*c217d954SCole Faust {
592*c217d954SCole Faust if(_projection_tensor_copy_required)
593*c217d954SCole Faust {
594*c217d954SCole Faust _hidden_to_output_copy.configure(_hidden_gate, *output_state_out);
595*c217d954SCole Faust _hidden_gate.allocator()->allocate();
596*c217d954SCole Faust }
597*c217d954SCole Faust }
598*c217d954SCole Faust
599*c217d954SCole Faust // Copy output_state_out to output
600*c217d954SCole Faust _copy_output.configure(compile_context, output_state_out, output);
601*c217d954SCole Faust }
602*c217d954SCole Faust
validate(const ITensorInfo * input,const ITensorInfo * input_to_forget_weights,const ITensorInfo * input_to_cell_weights,const ITensorInfo * input_to_output_weights,const ITensorInfo * recurrent_to_forget_weights,const ITensorInfo * recurrent_to_cell_weights,const ITensorInfo * recurrent_to_output_weights,const ITensorInfo * forget_gate_bias,const ITensorInfo * cell_bias,const ITensorInfo * output_gate_bias,const ITensorInfo * cell_state_in,const ITensorInfo * output_state_in,const ITensorInfo * cell_state_out,const ITensorInfo * output_state_out,const ITensorInfo * output,const LSTMParams<ITensorInfo> & lstm_params)603*c217d954SCole Faust Status CLQLSTMLayer::validate(const ITensorInfo *input,
604*c217d954SCole Faust const ITensorInfo *input_to_forget_weights, const ITensorInfo *input_to_cell_weights, const ITensorInfo *input_to_output_weights,
605*c217d954SCole Faust const ITensorInfo *recurrent_to_forget_weights, const ITensorInfo *recurrent_to_cell_weights, const ITensorInfo *recurrent_to_output_weights,
606*c217d954SCole Faust const ITensorInfo *forget_gate_bias, const ITensorInfo *cell_bias, const ITensorInfo *output_gate_bias,
607*c217d954SCole Faust const ITensorInfo *cell_state_in, const ITensorInfo *output_state_in,
608*c217d954SCole Faust const ITensorInfo *cell_state_out, const ITensorInfo *output_state_out, const ITensorInfo *output,
609*c217d954SCole Faust const LSTMParams<ITensorInfo> &lstm_params)
610*c217d954SCole Faust {
611*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_NULLPTR(input, input_to_forget_weights, input_to_cell_weights, input_to_output_weights, recurrent_to_forget_weights, recurrent_to_cell_weights,
612*c217d954SCole Faust recurrent_to_output_weights, forget_gate_bias, cell_bias, output_gate_bias, cell_state_in, output_state_in,
613*c217d954SCole Faust cell_state_out, output_state_out, output);
614*c217d954SCole Faust
615*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(input, 1, DataType::QASYMM8_SIGNED);
616*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MSG(input->num_dimensions() != 2, "Input must have exactly 2 dimensions");
617*c217d954SCole Faust
618*c217d954SCole Faust const unsigned int input_size = input->dimension(0);
619*c217d954SCole Faust const unsigned int batch_size = input->dimension(1);
620*c217d954SCole Faust const unsigned int num_units = input_to_output_weights->dimension(1);
621*c217d954SCole Faust const unsigned int output_size = output_state_out->dimension(_out_state_output_size_dimension_idx);
622*c217d954SCole Faust
623*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(input_to_output_weights->num_dimensions() != 2);
624*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(input_to_output_weights->dimension(0) != input_size);
625*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(input_to_output_weights, input_to_forget_weights, input_to_cell_weights);
626*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(recurrent_to_output_weights->num_dimensions() != 2);
627*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(recurrent_to_output_weights->dimension(1) != num_units);
628*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(recurrent_to_output_weights, recurrent_to_forget_weights, recurrent_to_cell_weights);
629*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(input_to_forget_weights, 1, DataType::QSYMM8);
630*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input_to_forget_weights, input_to_cell_weights, input_to_output_weights,
631*c217d954SCole Faust recurrent_to_forget_weights, recurrent_to_cell_weights, recurrent_to_output_weights);
632*c217d954SCole Faust
633*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(forget_gate_bias->num_dimensions() != 1);
634*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(forget_gate_bias->dimension(0) != num_units);
635*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(forget_gate_bias, cell_bias, output_gate_bias);
636*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(forget_gate_bias, 1, DataType::S32);
637*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(forget_gate_bias, cell_bias, output_gate_bias);
638*c217d954SCole Faust
639*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(cell_state_in->num_dimensions() != 2);
640*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(cell_state_in->dimension(0) != num_units);
641*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(cell_state_in->dimension(1) != batch_size);
642*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(cell_state_in, 1, DataType::QSYMM16);
643*c217d954SCole Faust
644*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(output_state_in->num_dimensions() != 2);
645*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(output_state_in->dimension(0) != output_size);
646*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(output_state_in->dimension(1) != batch_size);
647*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input, output_state_in);
648*c217d954SCole Faust
649*c217d954SCole Faust // Check whether peephole weights are all there or none
650*c217d954SCole Faust if(lstm_params.has_peephole_opt())
651*c217d954SCole Faust {
652*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_NULLPTR(lstm_params.cell_to_forget_weights(), lstm_params.cell_to_output_weights());
653*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(lstm_params.cell_to_forget_weights(), 1, DataType::QSYMM16);
654*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(lstm_params.cell_to_forget_weights()->num_dimensions() != 1);
655*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(lstm_params.cell_to_forget_weights()->dimension(0) != num_units);
656*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(lstm_params.cell_to_forget_weights(), lstm_params.cell_to_output_weights());
657*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(lstm_params.cell_to_forget_weights(), lstm_params.cell_to_output_weights());
658*c217d954SCole Faust
659*c217d954SCole Faust if(!lstm_params.has_cifg_opt())
660*c217d954SCole Faust {
661*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_NULLPTR(lstm_params.cell_to_input_weights());
662*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(lstm_params.cell_to_forget_weights(), lstm_params.cell_to_input_weights());
663*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(lstm_params.cell_to_forget_weights(), lstm_params.cell_to_input_weights());
664*c217d954SCole Faust }
665*c217d954SCole Faust }
666*c217d954SCole Faust
667*c217d954SCole Faust const UniformQuantizationInfo qinput = input->quantization_info().uniform();
668*c217d954SCole Faust const UniformQuantizationInfo qcell_state_in = cell_state_in->quantization_info().uniform();
669*c217d954SCole Faust const UniformQuantizationInfo qoutput_state_in = output_state_in->quantization_info().uniform();
670*c217d954SCole Faust
671*c217d954SCole Faust // Calculate and decompose effective scales for optimizing matmul calculation
672*c217d954SCole Faust const int32_t cell_shift = log2(qcell_state_in.scale);
673*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(cell_shift > -9);
674*c217d954SCole Faust
675*c217d954SCole Faust // Calculate quantized parameters for clipping.
676*c217d954SCole Faust int16_t quantized_cell_clip = 0;
677*c217d954SCole Faust if(lstm_params.cell_clip() > 0.0f)
678*c217d954SCole Faust {
679*c217d954SCole Faust quantized_cell_clip = quantize_qsymm16(lstm_params.cell_clip(), qcell_state_in);
680*c217d954SCole Faust }
681*c217d954SCole Faust
682*c217d954SCole Faust // Precompute effective bias for optimizing the matmul computations.
683*c217d954SCole Faust const TensorInfo eff_bias_info(TensorShape(num_units), 1, DataType::S32);
684*c217d954SCole Faust const TensorInfo projection_eff_bias_info(TensorShape(output_size), 1, DataType::S32);
685*c217d954SCole Faust if(!lstm_params.has_cifg_opt())
686*c217d954SCole Faust {
687*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(lstm_params.input_to_input_weights(), &eff_bias_info, GEMMLowpReductionKernelInfo(num_units, false, -qinput.offset, true)));
688*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(lstm_params.recurrent_to_input_weights(), &eff_bias_info, GEMMLowpReductionKernelInfo(num_units, false, -qoutput_state_in.offset,
689*c217d954SCole Faust true)));
690*c217d954SCole Faust }
691*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(input_to_forget_weights, &eff_bias_info, GEMMLowpReductionKernelInfo(num_units, false, -qinput.offset, true)));
692*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(recurrent_to_forget_weights, &eff_bias_info, GEMMLowpReductionKernelInfo(num_units, false, -qoutput_state_in.offset, true)));
693*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(input_to_cell_weights, &eff_bias_info, GEMMLowpReductionKernelInfo(num_units, false, -qinput.offset, true)));
694*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(recurrent_to_cell_weights, &eff_bias_info, GEMMLowpReductionKernelInfo(num_units, false, -qoutput_state_in.offset, true)));
695*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(input_to_output_weights, &eff_bias_info, GEMMLowpReductionKernelInfo(num_units, false, -qinput.offset, true)));
696*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(recurrent_to_output_weights, &eff_bias_info, GEMMLowpReductionKernelInfo(num_units, false, -qoutput_state_in.offset, true)));
697*c217d954SCole Faust if(lstm_params.has_projection())
698*c217d954SCole Faust {
699*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(ClGemmLowpMatrixAReductionKernel::validate(lstm_params.projection_weights(), &projection_eff_bias_info, GEMMLowpReductionKernelInfo(output_size, false,
700*c217d954SCole Faust lstm_params.hidden_state_zero(),
701*c217d954SCole Faust true)));
702*c217d954SCole Faust if(lstm_params.projection_bias() != nullptr)
703*c217d954SCole Faust {
704*c217d954SCole Faust ARM_COMPUTE_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(lstm_params.projection_bias(), 1, DataType::S32);
705*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(lstm_params.projection_bias(), &projection_eff_bias_info,
706*c217d954SCole Faust &projection_eff_bias_info, ConvertPolicy::SATURATE));
707*c217d954SCole Faust }
708*c217d954SCole Faust }
709*c217d954SCole Faust
710*c217d954SCole Faust const TensorInfo input_weights_transposed(TensorShape(num_units, input_size), 1, input_to_forget_weights->data_type(), input_to_forget_weights->quantization_info());
711*c217d954SCole Faust const TensorInfo recurrent_weights_transposed(TensorShape(num_units, output_size), 1, recurrent_to_forget_weights->data_type(), recurrent_to_forget_weights->quantization_info());
712*c217d954SCole Faust
713*c217d954SCole Faust // Validate weights transpose
714*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(input_to_forget_weights, &input_weights_transposed));
715*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(input_to_cell_weights, &input_weights_transposed));
716*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(input_to_output_weights, &input_weights_transposed));
717*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(recurrent_to_forget_weights, &recurrent_weights_transposed));
718*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(recurrent_to_cell_weights, &recurrent_weights_transposed));
719*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(recurrent_to_output_weights, &recurrent_weights_transposed));
720*c217d954SCole Faust if(!lstm_params.has_cifg_opt())
721*c217d954SCole Faust {
722*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(lstm_params.input_to_input_weights(), &input_weights_transposed));
723*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(lstm_params.recurrent_to_input_weights(), &recurrent_weights_transposed));
724*c217d954SCole Faust }
725*c217d954SCole Faust if(lstm_params.has_projection())
726*c217d954SCole Faust {
727*c217d954SCole Faust const TensorInfo projection_weights_transposed(TensorShape(output_size, num_units), 1, lstm_params.projection_weights()->data_type(), lstm_params.projection_weights()->quantization_info());
728*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLTranspose::validate(lstm_params.projection_weights(), &projection_weights_transposed));
729*c217d954SCole Faust }
730*c217d954SCole Faust
731*c217d954SCole Faust GEMMLowpOutputStageInfo gemmlowp_info;
732*c217d954SCole Faust gemmlowp_info.type = GEMMLowpOutputStageType::QUANTIZE_DOWN_FIXEDPOINT;
733*c217d954SCole Faust gemmlowp_info.gemmlowp_min_bound = std::numeric_limits<int16_t>::lowest();
734*c217d954SCole Faust gemmlowp_info.gemmlowp_max_bound = std::numeric_limits<int16_t>::max();
735*c217d954SCole Faust gemmlowp_info.output_data_type = DataType::QSYMM16;
736*c217d954SCole Faust
737*c217d954SCole Faust const bool has_layer_norm = lstm_params.use_layer_norm();
738*c217d954SCole Faust
739*c217d954SCole Faust // Forget gate.
740*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(lstm_params.forget_intermediate_scale() == 0);
741*c217d954SCole Faust const TensorInfo forget_outstage_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.forget_intermediate_scale(), 0));
742*c217d954SCole Faust const TensorInfo mm_out_info(TensorShape(num_units, batch_size), 1, DataType::S32);
743*c217d954SCole Faust const float input_to_forget_scale = input_to_forget_weights->quantization_info().uniform().scale * qinput.scale / lstm_params.forget_intermediate_scale();
744*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, input, &input_weights_transposed, &eff_bias_info, input_to_forget_scale, &mm_out_info, &forget_outstage_info));
745*c217d954SCole Faust
746*c217d954SCole Faust const float recurrent_to_forget_scale = recurrent_to_forget_weights->quantization_info().uniform().scale * qoutput_state_in.scale / lstm_params.forget_intermediate_scale();
747*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, output_state_in, &recurrent_weights_transposed, &eff_bias_info, recurrent_to_forget_scale, &mm_out_info, &forget_outstage_info));
748*c217d954SCole Faust
749*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(&forget_outstage_info, &forget_outstage_info, &forget_outstage_info, ConvertPolicy::SATURATE));
750*c217d954SCole Faust
751*c217d954SCole Faust if(lstm_params.has_peephole_opt())
752*c217d954SCole Faust {
753*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(lstm_params.cell_to_forget_weights(), 1, DataType::QSYMM16);
754*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLPixelWiseMultiplication::validate(cell_state_in, lstm_params.cell_to_forget_weights(), &mm_out_info, 1.f, ConvertPolicy::SATURATE,
755*c217d954SCole Faust RoundingPolicy::TO_ZERO));
756*c217d954SCole Faust const float cell_to_forget_scale = std::pow(2, cell_shift) * lstm_params.cell_to_forget_weights()->quantization_info().uniform().scale / lstm_params.forget_intermediate_scale();
757*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(quantization::calculate_quantized_multiplier(cell_to_forget_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift));
758*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLGEMMLowpOutputStage::validate(&mm_out_info, nullptr, &forget_outstage_info, gemmlowp_info));
759*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(&forget_outstage_info, &forget_outstage_info, &forget_outstage_info, ConvertPolicy::SATURATE));
760*c217d954SCole Faust }
761*c217d954SCole Faust
762*c217d954SCole Faust if(has_layer_norm)
763*c217d954SCole Faust {
764*c217d954SCole Faust const ITensorInfo *w_info = lstm_params.forget_layer_norm_weights();
765*c217d954SCole Faust const ITensorInfo *b_info = forget_gate_bias;
766*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_layer_norm(forget_outstage_info, *w_info, *b_info));
767*c217d954SCole Faust }
768*c217d954SCole Faust
769*c217d954SCole Faust // Output quantization info of Sigmoid and Tanh activations
770*c217d954SCole Faust const QuantizationInfo sigmoid_tanh_outqinfo(1.f / 32768.f, 0);
771*c217d954SCole Faust
772*c217d954SCole Faust const TensorInfo forget_gate_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, sigmoid_tanh_outqinfo);
773*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLActivationLayer::validate(&forget_outstage_info, &forget_gate_info, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LOGISTIC)));
774*c217d954SCole Faust
775*c217d954SCole Faust // Modulation gate.
776*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(lstm_params.cell_intermediate_scale() == 0);
777*c217d954SCole Faust const TensorInfo cell_outstage_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.cell_intermediate_scale(), 0));
778*c217d954SCole Faust const float input_to_cell_scale = input_to_cell_weights->quantization_info().uniform().scale * qinput.scale / lstm_params.cell_intermediate_scale();
779*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, input, &input_weights_transposed, &eff_bias_info, input_to_cell_scale, &mm_out_info, &cell_outstage_info));
780*c217d954SCole Faust
781*c217d954SCole Faust const float recurrent_to_cell_scale = recurrent_to_cell_weights->quantization_info().uniform().scale * qoutput_state_in.scale / lstm_params.cell_intermediate_scale();
782*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, output_state_in, &recurrent_weights_transposed, &eff_bias_info, recurrent_to_cell_scale, &mm_out_info, &cell_outstage_info));
783*c217d954SCole Faust
784*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(&cell_outstage_info, &cell_outstage_info, &cell_outstage_info, ConvertPolicy::SATURATE));
785*c217d954SCole Faust
786*c217d954SCole Faust if(has_layer_norm)
787*c217d954SCole Faust {
788*c217d954SCole Faust const ITensorInfo *w_info = lstm_params.cell_layer_norm_weights();
789*c217d954SCole Faust const ITensorInfo *b_info = cell_bias;
790*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_layer_norm(cell_outstage_info, *w_info, *b_info));
791*c217d954SCole Faust }
792*c217d954SCole Faust
793*c217d954SCole Faust const TensorInfo cell_gate_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, sigmoid_tanh_outqinfo);
794*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLActivationLayer::validate(&cell_outstage_info, &cell_gate_info, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::TANH, 1.f, 1.f)));
795*c217d954SCole Faust
796*c217d954SCole Faust // Input gate.
797*c217d954SCole Faust const TensorInfo input_gate_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, sigmoid_tanh_outqinfo);
798*c217d954SCole Faust if(lstm_params.has_cifg_opt())
799*c217d954SCole Faust {
800*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MSG(lstm_params.input_gate_bias() != nullptr, "Input gate bias must not be present when CIFG is used");
801*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticSubtraction::validate(&input_gate_info, &forget_gate_info, &forget_gate_info, ConvertPolicy::SATURATE));
802*c217d954SCole Faust }
803*c217d954SCole Faust else
804*c217d954SCole Faust {
805*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_NULLPTR(lstm_params.input_to_input_weights(), lstm_params.recurrent_to_input_weights(), lstm_params.input_gate_bias());
806*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input_to_forget_weights, lstm_params.input_to_input_weights(), lstm_params.recurrent_to_input_weights());
807*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(input_to_forget_weights, lstm_params.input_to_input_weights());
808*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(recurrent_to_forget_weights, lstm_params.recurrent_to_input_weights());
809*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(forget_gate_bias, lstm_params.input_gate_bias());
810*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(forget_gate_bias, lstm_params.input_gate_bias());
811*c217d954SCole Faust
812*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(lstm_params.input_intermediate_scale() == 0);
813*c217d954SCole Faust const TensorInfo input_outstage_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.input_intermediate_scale(), 0));
814*c217d954SCole Faust const float input_to_input_scale = lstm_params.input_to_input_weights()->quantization_info().uniform().scale * qinput.scale / lstm_params.input_intermediate_scale();
815*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, input, &input_weights_transposed, &eff_bias_info, input_to_input_scale, &mm_out_info, &input_outstage_info));
816*c217d954SCole Faust
817*c217d954SCole Faust const float recurrent_to_input_scale = lstm_params.recurrent_to_input_weights()->quantization_info().uniform().scale * qoutput_state_in.scale / lstm_params.input_intermediate_scale();
818*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, output_state_in, &recurrent_weights_transposed, &eff_bias_info, recurrent_to_input_scale, &mm_out_info, &input_outstage_info));
819*c217d954SCole Faust
820*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(&input_outstage_info, &input_outstage_info, &input_outstage_info, ConvertPolicy::SATURATE));
821*c217d954SCole Faust
822*c217d954SCole Faust if(lstm_params.has_peephole_opt())
823*c217d954SCole Faust {
824*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLPixelWiseMultiplication::validate(cell_state_in, lstm_params.cell_to_input_weights(), &mm_out_info, 1.f, ConvertPolicy::SATURATE,
825*c217d954SCole Faust RoundingPolicy::TO_ZERO));
826*c217d954SCole Faust const float cell_to_input_scale = std::pow(2, cell_shift) * lstm_params.cell_to_input_weights()->quantization_info().uniform().scale / lstm_params.input_intermediate_scale();
827*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(quantization::calculate_quantized_multiplier(cell_to_input_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift));
828*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLGEMMLowpOutputStage::validate(&mm_out_info, &eff_bias_info, &input_outstage_info, gemmlowp_info));
829*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(&input_outstage_info, &input_outstage_info, &input_outstage_info, ConvertPolicy::SATURATE));
830*c217d954SCole Faust }
831*c217d954SCole Faust
832*c217d954SCole Faust if(has_layer_norm)
833*c217d954SCole Faust {
834*c217d954SCole Faust const ITensorInfo *w_info = lstm_params.input_layer_norm_weights();
835*c217d954SCole Faust const ITensorInfo *b_info = lstm_params.input_gate_bias();
836*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_layer_norm(cell_outstage_info, *w_info, *b_info));
837*c217d954SCole Faust }
838*c217d954SCole Faust
839*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLActivationLayer::validate(&input_outstage_info, &input_gate_info, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LOGISTIC, 1.f, 1.f)));
840*c217d954SCole Faust }
841*c217d954SCole Faust // Cell.
842*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLPixelWiseMultiplication::validate(&forget_gate_info, cell_state_in, &forget_gate_info, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO));
843*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLPixelWiseMultiplication::validate(&input_gate_info, cell_state_in, &cell_gate_info, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO));
844*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(&forget_gate_info, &cell_gate_info, cell_state_out, ConvertPolicy::SATURATE));
845*c217d954SCole Faust if(quantized_cell_clip > 0)
846*c217d954SCole Faust {
847*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLActivationLayer::validate(cell_state_out, nullptr, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU, -quantized_cell_clip,
848*c217d954SCole Faust quantized_cell_clip)));
849*c217d954SCole Faust }
850*c217d954SCole Faust // Output gate.
851*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(lstm_params.output_intermediate_scale() == 0);
852*c217d954SCole Faust const TensorInfo output_outstage_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, QuantizationInfo(lstm_params.output_intermediate_scale(), 0));
853*c217d954SCole Faust const float input_to_output_scale = input_to_output_weights->quantization_info().uniform().scale * qinput.scale / lstm_params.output_intermediate_scale();
854*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, input, &input_weights_transposed, &eff_bias_info, input_to_output_scale, &mm_out_info, &output_outstage_info));
855*c217d954SCole Faust
856*c217d954SCole Faust const float recurrent_to_output_scale = recurrent_to_output_weights->quantization_info().uniform().scale * qoutput_state_in.scale / lstm_params.output_intermediate_scale();
857*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, output_state_in, &recurrent_weights_transposed, &eff_bias_info, recurrent_to_output_scale, &mm_out_info, &output_outstage_info));
858*c217d954SCole Faust
859*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(&output_outstage_info, &output_outstage_info, &output_outstage_info, ConvertPolicy::SATURATE));
860*c217d954SCole Faust if(lstm_params.has_peephole_opt())
861*c217d954SCole Faust {
862*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_DATA_TYPE_CHANNEL_NOT_IN(lstm_params.cell_to_output_weights(), 1, DataType::QSYMM16);
863*c217d954SCole Faust // TODO(COMPMID-3395): Perform multiplication in the quantized domain in NEPixelWiseMultiplicationKernel
864*c217d954SCole Faust // Here we are not using the output stage because all operations are done in float
865*c217d954SCole Faust // const float cell_to_output_scale = std::pow(2, cell_shift) * lstm_params.cell_to_output_weights()->quantization_info().uniform().scale / lstm_params.output_intermediate_scale();
866*c217d954SCole Faust // ARM_COMPUTE_RETURN_ON_ERROR(quantization::calculate_quantized_multiplier(cell_to_output_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift));
867*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLPixelWiseMultiplication::validate(cell_state_out, lstm_params.cell_to_output_weights(), &output_outstage_info, 1.f, ConvertPolicy::SATURATE,
868*c217d954SCole Faust RoundingPolicy::TO_ZERO));
869*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(&output_outstage_info, &output_outstage_info, &output_outstage_info, ConvertPolicy::SATURATE));
870*c217d954SCole Faust }
871*c217d954SCole Faust
872*c217d954SCole Faust if(has_layer_norm)
873*c217d954SCole Faust {
874*c217d954SCole Faust const ITensorInfo *w_info = lstm_params.output_layer_norm_weights();
875*c217d954SCole Faust const ITensorInfo *b_info = output_gate_bias;
876*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_layer_norm(output_outstage_info, *w_info, *b_info));
877*c217d954SCole Faust }
878*c217d954SCole Faust
879*c217d954SCole Faust const TensorInfo output_gate_info(TensorShape(num_units, batch_size), 1, DataType::QSYMM16, sigmoid_tanh_outqinfo);
880*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLActivationLayer::validate(&output_outstage_info, &output_gate_info, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LOGISTIC)));
881*c217d954SCole Faust
882*c217d954SCole Faust // Hidden.
883*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLActivationLayer::validate(cell_state_out, &input_gate_info, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::TANH, 1.f, 1.f)));
884*c217d954SCole Faust const TensorInfo hidden_mul_res(TensorShape(num_units, batch_size), 1, DataType::S32);
885*c217d954SCole Faust const TensorInfo hidden_out_info(TensorShape(num_units, batch_size), 1, DataType::QASYMM8_SIGNED);
886*c217d954SCole Faust
887*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(lstm_params.hidden_state_scale() == 0);
888*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLPixelWiseMultiplication::validate(&output_gate_info, &input_gate_info, &hidden_mul_res, 1.f, ConvertPolicy::SATURATE, RoundingPolicy::TO_ZERO));
889*c217d954SCole Faust const float hidden_state_scale = std::pow(2, -15) / lstm_params.hidden_state_scale() * std::pow(2, -15);
890*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(quantization::calculate_quantized_multiplier(hidden_state_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift, /* ignore_epsilon */ true));
891*c217d954SCole Faust gemmlowp_info.gemmlowp_offset = lstm_params.hidden_state_zero();
892*c217d954SCole Faust gemmlowp_info.output_data_type = hidden_out_info.data_type();
893*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLGEMMLowpOutputStage::validate(&hidden_mul_res, nullptr, &hidden_out_info, gemmlowp_info));
894*c217d954SCole Faust
895*c217d954SCole Faust const bool projection_tensor_copy_required = num_units != output_size;
896*c217d954SCole Faust
897*c217d954SCole Faust // Projection.
898*c217d954SCole Faust if(lstm_params.has_projection())
899*c217d954SCole Faust {
900*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(recurrent_to_forget_weights, lstm_params.projection_weights());
901*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON(qoutput_state_in.scale == 0);
902*c217d954SCole Faust
903*c217d954SCole Faust const UniformQuantizationInfo qprojection = lstm_params.projection_weights()->quantization_info().uniform();
904*c217d954SCole Faust const float projection_scale = qprojection.scale * lstm_params.hidden_state_scale() / qoutput_state_in.scale;
905*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(quantization::calculate_quantized_multiplier(projection_scale, &gemmlowp_info.gemmlowp_multiplier, &gemmlowp_info.gemmlowp_shift));
906*c217d954SCole Faust gemmlowp_info.gemmlowp_offset = qoutput_state_in.offset;
907*c217d954SCole Faust gemmlowp_info.gemmlowp_min_bound = std::numeric_limits<int8_t>::lowest();
908*c217d954SCole Faust gemmlowp_info.gemmlowp_max_bound = std::numeric_limits<int8_t>::max();
909*c217d954SCole Faust gemmlowp_info.output_data_type = DataType::QASYMM8_SIGNED;
910*c217d954SCole Faust
911*c217d954SCole Faust const TensorInfo projection_outstage_info(*output_state_out);
912*c217d954SCole Faust const TensorInfo projection_weights_transposed(TensorShape(output_size, num_units), 1, lstm_params.projection_weights()->data_type(), lstm_params.projection_weights()->quantization_info());
913*c217d954SCole Faust
914*c217d954SCole Faust TensorInfo projection_mm_out_info{ mm_out_info };
915*c217d954SCole Faust projection_mm_out_info.set_tensor_shape(TensorShape(output_size, batch_size));
916*c217d954SCole Faust
917*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(validate_mm(gemmlowp_info, &hidden_out_info, &projection_weights_transposed, &projection_eff_bias_info, projection_scale, &projection_mm_out_info,
918*c217d954SCole Faust &projection_outstage_info));
919*c217d954SCole Faust
920*c217d954SCole Faust if(projection_tensor_copy_required)
921*c217d954SCole Faust {
922*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLQLSTMLayer::TensorCopyKernel::validate(*output_state_in, projection_outstage_info));
923*c217d954SCole Faust }
924*c217d954SCole Faust
925*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLArithmeticAddition::validate(output_state_out, output_state_out, output_state_out, ConvertPolicy::SATURATE));
926*c217d954SCole Faust
927*c217d954SCole Faust if(projection_tensor_copy_required)
928*c217d954SCole Faust {
929*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLQLSTMLayer::TensorCopyKernel::validate(projection_outstage_info, *output_state_out));
930*c217d954SCole Faust }
931*c217d954SCole Faust
932*c217d954SCole Faust int8_t quantized_projection_clip{ 0 };
933*c217d954SCole Faust if(lstm_params.projection_clip() > 0.0f)
934*c217d954SCole Faust {
935*c217d954SCole Faust quantized_projection_clip = quantize_qasymm8_signed(lstm_params.projection_clip(), qprojection);
936*c217d954SCole Faust }
937*c217d954SCole Faust
938*c217d954SCole Faust if(quantized_projection_clip > 0)
939*c217d954SCole Faust {
940*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLActivationLayer::validate(output_state_out, nullptr, ActivationLayerInfo(ActivationLayerInfo::ActivationFunction::LU_BOUNDED_RELU, -quantized_projection_clip,
941*c217d954SCole Faust quantized_projection_clip)));
942*c217d954SCole Faust }
943*c217d954SCole Faust }
944*c217d954SCole Faust else
945*c217d954SCole Faust {
946*c217d954SCole Faust if(projection_tensor_copy_required)
947*c217d954SCole Faust {
948*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLQLSTMLayer::TensorCopyKernel::validate(hidden_out_info, *output_state_out));
949*c217d954SCole Faust }
950*c217d954SCole Faust }
951*c217d954SCole Faust
952*c217d954SCole Faust if(cell_state_out->total_size() > 0)
953*c217d954SCole Faust {
954*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(cell_state_in, cell_state_out);
955*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(cell_state_in, cell_state_out);
956*c217d954SCole Faust }
957*c217d954SCole Faust
958*c217d954SCole Faust if(output_state_out->total_size() > 0)
959*c217d954SCole Faust {
960*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_DATA_TYPES(input, output_state_out);
961*c217d954SCole Faust ARM_COMPUTE_RETURN_ERROR_ON_MISMATCHING_SHAPES(output_state_in, output_state_out);
962*c217d954SCole Faust }
963*c217d954SCole Faust
964*c217d954SCole Faust ARM_COMPUTE_RETURN_ON_ERROR(CLCopy::validate(output_state_out, output));
965*c217d954SCole Faust return Status{};
966*c217d954SCole Faust }
967*c217d954SCole Faust
run()968*c217d954SCole Faust void CLQLSTMLayer::run()
969*c217d954SCole Faust {
970*c217d954SCole Faust prepare();
971*c217d954SCole Faust
972*c217d954SCole Faust // Acquire all the temporaries
973*c217d954SCole Faust MemoryGroupResourceScope scope_mg(_memory_group);
974*c217d954SCole Faust
975*c217d954SCole Faust // Forget gate.
976*c217d954SCole Faust _mm_input_to_forget.run();
977*c217d954SCole Faust _input_to_forget_outstage.run();
978*c217d954SCole Faust
979*c217d954SCole Faust _mm_recurrent_to_forget.run();
980*c217d954SCole Faust _recurrent_to_forget_outstage.run();
981*c217d954SCole Faust _accumulate_input_recurrent_forget.run();
982*c217d954SCole Faust
983*c217d954SCole Faust if(_has_peephole)
984*c217d954SCole Faust {
985*c217d954SCole Faust _pixelwise_mul_cell_to_forget.run();
986*c217d954SCole Faust _cell_to_forget_outstage.run();
987*c217d954SCole Faust _accumulate_cell_forget.run();
988*c217d954SCole Faust }
989*c217d954SCole Faust
990*c217d954SCole Faust if(_has_layer_norm)
991*c217d954SCole Faust {
992*c217d954SCole Faust CLScheduler::get().enqueue(get_layer_norm(LayerNormGate::Forget));
993*c217d954SCole Faust }
994*c217d954SCole Faust
995*c217d954SCole Faust _forget_gate_sigmoid.run();
996*c217d954SCole Faust
997*c217d954SCole Faust // Modulation gate.
998*c217d954SCole Faust _mm_input_to_cell.run();
999*c217d954SCole Faust _input_to_cell_outstage.run();
1000*c217d954SCole Faust
1001*c217d954SCole Faust _mm_recurrent_to_cell.run();
1002*c217d954SCole Faust _recurrent_to_cell_outstage.run();
1003*c217d954SCole Faust _accumulate_input_recurrent_modulation.run();
1004*c217d954SCole Faust
1005*c217d954SCole Faust if(_has_layer_norm)
1006*c217d954SCole Faust {
1007*c217d954SCole Faust CLScheduler::get().enqueue(get_layer_norm(LayerNormGate::Cell));
1008*c217d954SCole Faust }
1009*c217d954SCole Faust
1010*c217d954SCole Faust _cell_gate_tanh.run();
1011*c217d954SCole Faust
1012*c217d954SCole Faust // Input gate
1013*c217d954SCole Faust if(_has_cifg)
1014*c217d954SCole Faust {
1015*c217d954SCole Faust _input_gate_sub.run();
1016*c217d954SCole Faust }
1017*c217d954SCole Faust else
1018*c217d954SCole Faust {
1019*c217d954SCole Faust _mm_input_to_input.run();
1020*c217d954SCole Faust _input_to_input_outstage.run();
1021*c217d954SCole Faust _mm_recurrent_to_input.run();
1022*c217d954SCole Faust _recurrent_to_input_outstage.run();
1023*c217d954SCole Faust _accumulate_input_recurrent_input.run();
1024*c217d954SCole Faust
1025*c217d954SCole Faust if(_has_peephole)
1026*c217d954SCole Faust {
1027*c217d954SCole Faust _pixelwise_mul_cell_to_input.run();
1028*c217d954SCole Faust _cell_to_input_outstage.run();
1029*c217d954SCole Faust _accumulate_cell_input.run();
1030*c217d954SCole Faust }
1031*c217d954SCole Faust
1032*c217d954SCole Faust if(_has_layer_norm)
1033*c217d954SCole Faust {
1034*c217d954SCole Faust CLScheduler::get().enqueue(get_layer_norm(LayerNormGate::Input));
1035*c217d954SCole Faust }
1036*c217d954SCole Faust
1037*c217d954SCole Faust _input_gate_sigmoid.run();
1038*c217d954SCole Faust }
1039*c217d954SCole Faust
1040*c217d954SCole Faust // Cell.
1041*c217d954SCole Faust _pixelwise_mul_forget_cell.run();
1042*c217d954SCole Faust _pixelwise_mul_input_cell.run();
1043*c217d954SCole Faust _add_forget_cell.run();
1044*c217d954SCole Faust if(_has_cell_clipping)
1045*c217d954SCole Faust {
1046*c217d954SCole Faust _cell_clip.run();
1047*c217d954SCole Faust }
1048*c217d954SCole Faust
1049*c217d954SCole Faust // Output gate.
1050*c217d954SCole Faust _mm_input_to_output.run();
1051*c217d954SCole Faust _input_to_output_outstage.run();
1052*c217d954SCole Faust _mm_recurrent_to_output.run();
1053*c217d954SCole Faust _recurrent_to_output_outstage.run();
1054*c217d954SCole Faust _accumulate_input_recurrent_output.run();
1055*c217d954SCole Faust if(_has_peephole)
1056*c217d954SCole Faust {
1057*c217d954SCole Faust _pixelwise_mul_cell_to_output.run();
1058*c217d954SCole Faust _cell_to_output_outstage.run();
1059*c217d954SCole Faust _accumulate_cell_to_output.run();
1060*c217d954SCole Faust }
1061*c217d954SCole Faust
1062*c217d954SCole Faust if(_has_layer_norm)
1063*c217d954SCole Faust {
1064*c217d954SCole Faust CLScheduler::get().enqueue(get_layer_norm(LayerNormGate::Output));
1065*c217d954SCole Faust }
1066*c217d954SCole Faust
1067*c217d954SCole Faust _output_gate_sigmoid.run();
1068*c217d954SCole Faust
1069*c217d954SCole Faust // Hidden.
1070*c217d954SCole Faust _hidden_tanh.run();
1071*c217d954SCole Faust _pixelwise_mul_hidden.run();
1072*c217d954SCole Faust _hidden_outstage.run();
1073*c217d954SCole Faust
1074*c217d954SCole Faust // Projection.
1075*c217d954SCole Faust if(_has_projection)
1076*c217d954SCole Faust {
1077*c217d954SCole Faust _mm_projection.run();
1078*c217d954SCole Faust _projection_outstage.run();
1079*c217d954SCole Faust
1080*c217d954SCole Faust if(_projection_tensor_copy_required)
1081*c217d954SCole Faust {
1082*c217d954SCole Faust _projection_output_to_accumulate_copy.run();
1083*c217d954SCole Faust }
1084*c217d954SCole Faust
1085*c217d954SCole Faust _accumulate_projection.run();
1086*c217d954SCole Faust
1087*c217d954SCole Faust if(_projection_tensor_copy_required)
1088*c217d954SCole Faust {
1089*c217d954SCole Faust _projection_accumulate_to_output_copy.run();
1090*c217d954SCole Faust }
1091*c217d954SCole Faust
1092*c217d954SCole Faust if(_has_projection_clipping)
1093*c217d954SCole Faust {
1094*c217d954SCole Faust _projection_clip.run();
1095*c217d954SCole Faust }
1096*c217d954SCole Faust }
1097*c217d954SCole Faust else
1098*c217d954SCole Faust {
1099*c217d954SCole Faust if(_projection_tensor_copy_required)
1100*c217d954SCole Faust {
1101*c217d954SCole Faust _hidden_to_output_copy.run();
1102*c217d954SCole Faust }
1103*c217d954SCole Faust }
1104*c217d954SCole Faust
1105*c217d954SCole Faust // Copy output_state_out to output
1106*c217d954SCole Faust _copy_output.run();
1107*c217d954SCole Faust }
1108*c217d954SCole Faust
prepare()1109*c217d954SCole Faust void CLQLSTMLayer::prepare()
1110*c217d954SCole Faust {
1111*c217d954SCole Faust if(!_is_prepared)
1112*c217d954SCole Faust {
1113*c217d954SCole Faust // Pre-transpose weights to be used in GEMM.
1114*c217d954SCole Faust _input_to_forget_weights_transposed.allocator()->allocate();
1115*c217d954SCole Faust _input_to_cell_weights_transposed.allocator()->allocate();
1116*c217d954SCole Faust _input_to_output_weights_transposed.allocator()->allocate();
1117*c217d954SCole Faust _recurrent_to_forget_weights_transposed.allocator()->allocate();
1118*c217d954SCole Faust _recurrent_to_cell_weights_transposed.allocator()->allocate();
1119*c217d954SCole Faust _recurrent_to_output_weights_transposed.allocator()->allocate();
1120*c217d954SCole Faust _transpose_input_to_forget_weights.run();
1121*c217d954SCole Faust _transpose_input_to_cell_weights.run();
1122*c217d954SCole Faust _transpose_input_to_output_weights.run();
1123*c217d954SCole Faust _transpose_recurrent_to_forget_weights.run();
1124*c217d954SCole Faust _transpose_recurrent_to_cell_weights.run();
1125*c217d954SCole Faust _transpose_recurrent_to_output_weights.run();
1126*c217d954SCole Faust
1127*c217d954SCole Faust // Precompute effective biases
1128*c217d954SCole Faust if(_has_cifg)
1129*c217d954SCole Faust {
1130*c217d954SCole Faust _ones.map(true);
1131*c217d954SCole Faust std::fill_n(reinterpret_cast<int16_t *>(_ones.buffer()), _ones.info()->total_size() / _ones.info()->element_size(), 32767);
1132*c217d954SCole Faust _ones.unmap();
1133*c217d954SCole Faust }
1134*c217d954SCole Faust else
1135*c217d954SCole Faust {
1136*c217d954SCole Faust _input_to_input_eff_bias.allocator()->allocate();
1137*c217d954SCole Faust _recurrent_to_input_eff_bias.allocator()->allocate();
1138*c217d954SCole Faust
1139*c217d954SCole Faust ITensorPack input_to_input_red_pack = { { ACL_SRC, _input_to_input_weights }, { ACL_DST, &_input_to_input_eff_bias } };
1140*c217d954SCole Faust CLScheduler::get().enqueue_op(*_input_to_input_reduction, input_to_input_red_pack, false);
1141*c217d954SCole Faust
1142*c217d954SCole Faust ITensorPack rec_to_input_red_pack = { { ACL_SRC, _recurrent_to_input_weights }, { ACL_DST, &_recurrent_to_input_eff_bias } };
1143*c217d954SCole Faust CLScheduler::get().enqueue_op(*_recurrent_to_input_reduction, rec_to_input_red_pack, false);
1144*c217d954SCole Faust
1145*c217d954SCole Faust _input_to_input_weights_transposed.allocator()->allocate();
1146*c217d954SCole Faust _recurrent_to_input_weights_transposed.allocator()->allocate();
1147*c217d954SCole Faust _transpose_input_to_input_weights.run();
1148*c217d954SCole Faust _transpose_recurrent_to_input_weights.run();
1149*c217d954SCole Faust _input_to_input_weights->mark_as_unused();
1150*c217d954SCole Faust _recurrent_to_input_weights->mark_as_unused();
1151*c217d954SCole Faust }
1152*c217d954SCole Faust _input_to_forget_eff_bias.allocator()->allocate();
1153*c217d954SCole Faust _recurrent_to_forget_eff_bias.allocator()->allocate();
1154*c217d954SCole Faust _input_to_cell_eff_bias.allocator()->allocate();
1155*c217d954SCole Faust _recurrent_to_cell_eff_bias.allocator()->allocate();
1156*c217d954SCole Faust _input_to_output_eff_bias.allocator()->allocate();
1157*c217d954SCole Faust _recurrent_to_output_eff_bias.allocator()->allocate();
1158*c217d954SCole Faust
1159*c217d954SCole Faust ITensorPack input_to_forget_red_pack = { { ACL_SRC, _input_to_forget_weights }, { ACL_DST, &_input_to_forget_eff_bias } };
1160*c217d954SCole Faust CLScheduler::get().enqueue_op(*_input_to_forget_reduction, input_to_forget_red_pack, false);
1161*c217d954SCole Faust
1162*c217d954SCole Faust ITensorPack rec_to_forget_red_pack = { { ACL_SRC, _recurrent_to_forget_weights }, { ACL_DST, &_recurrent_to_forget_eff_bias } };
1163*c217d954SCole Faust CLScheduler::get().enqueue_op(*_recurrent_to_forget_reduction, rec_to_forget_red_pack, false);
1164*c217d954SCole Faust
1165*c217d954SCole Faust ITensorPack input_to_cell_red_pack = { { ACL_SRC, _input_to_cell_weights }, { ACL_DST, &_input_to_cell_eff_bias } };
1166*c217d954SCole Faust CLScheduler::get().enqueue_op(*_input_to_cell_reduction, input_to_cell_red_pack, false);
1167*c217d954SCole Faust
1168*c217d954SCole Faust ITensorPack rec_to_cell_red_pack = { { ACL_SRC, _recurrent_to_cell_weights }, { ACL_DST, &_recurrent_to_cell_eff_bias } };
1169*c217d954SCole Faust CLScheduler::get().enqueue_op(*_recurrent_to_cell_reduction, rec_to_cell_red_pack, false);
1170*c217d954SCole Faust
1171*c217d954SCole Faust ITensorPack input_to_output_red_pack = { { ACL_SRC, _input_to_output_weights }, { ACL_DST, &_input_to_output_eff_bias } };
1172*c217d954SCole Faust CLScheduler::get().enqueue_op(*_input_to_output_reduction, input_to_output_red_pack, false);
1173*c217d954SCole Faust
1174*c217d954SCole Faust ITensorPack rec_to_output_red_pack = { { ACL_SRC, _recurrent_to_output_weights }, { ACL_DST, &_recurrent_to_output_eff_bias } };
1175*c217d954SCole Faust CLScheduler::get().enqueue_op(*_recurrent_to_output_reduction, rec_to_output_red_pack, false);
1176*c217d954SCole Faust
1177*c217d954SCole Faust if(_has_projection)
1178*c217d954SCole Faust {
1179*c217d954SCole Faust _projection_eff_bias.allocator()->allocate();
1180*c217d954SCole Faust ITensorPack proj_red_pack{ { ACL_SRC, _projection_weights }, { ACL_DST, &_projection_eff_bias } };
1181*c217d954SCole Faust CLScheduler::get().enqueue_op(*_projection_reduction, proj_red_pack, false);
1182*c217d954SCole Faust if(_projection_bias != nullptr)
1183*c217d954SCole Faust {
1184*c217d954SCole Faust _projection_bias_add.run();
1185*c217d954SCole Faust _projection_bias->mark_as_unused();
1186*c217d954SCole Faust }
1187*c217d954SCole Faust
1188*c217d954SCole Faust _projection_weights_transposed.allocator()->allocate();
1189*c217d954SCole Faust _transpose_projection_weights.run();
1190*c217d954SCole Faust _projection_weights->mark_as_unused();
1191*c217d954SCole Faust
1192*c217d954SCole Faust if(!_projection_tensor_copy_required)
1193*c217d954SCole Faust {
1194*c217d954SCole Faust _hidden_gate.mark_as_unused();
1195*c217d954SCole Faust _projection_accumulate_res.mark_as_unused();
1196*c217d954SCole Faust }
1197*c217d954SCole Faust }
1198*c217d954SCole Faust
1199*c217d954SCole Faust // Mark weights as unused
1200*c217d954SCole Faust _input_to_forget_weights->mark_as_unused();
1201*c217d954SCole Faust _input_to_cell_weights->mark_as_unused();
1202*c217d954SCole Faust _input_to_output_weights->mark_as_unused();
1203*c217d954SCole Faust _recurrent_to_forget_weights->mark_as_unused();
1204*c217d954SCole Faust _recurrent_to_cell_weights->mark_as_unused();
1205*c217d954SCole Faust _recurrent_to_output_weights->mark_as_unused();
1206*c217d954SCole Faust
1207*c217d954SCole Faust CLScheduler::get().queue().finish();
1208*c217d954SCole Faust _is_prepared = true;
1209*c217d954SCole Faust }
1210*c217d954SCole Faust }
1211*c217d954SCole Faust
1212*c217d954SCole Faust } // namespace arm_compute
1213