blob: 0a356475c014d03c30f53839f236ca6eae83911e [file] [log] [blame]
Tim Hall79d07d22020-04-27 18:20:16 +01001# Copyright (C) 2020 Arm Limited or its affiliates. All rights reserved.
2#
3# SPDX-License-Identifier: Apache-2.0
4#
5# Licensed under the Apache License, Version 2.0 (the License); you may
6# not use this file except in compliance with the License.
7# You may obtain a copy of the License at
8#
9# www.apache.org/licenses/LICENSE-2.0
10#
11# Unless required by applicable law or agreed to in writing, software
12# distributed under the License is distributed on an AS IS BASIS, WITHOUT
13# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14# See the License for the specific language governing permissions and
15# limitations under the License.
Tim Hall79d07d22020-04-27 18:20:16 +010016# Description:
17# Register level (low-level) command stream generation for Ethos-U55. Takes a high-level command stream and generates
18# all the register settings. Calculates dependencies between commands and inserts wait operations. And generates a bit
19# stream suitable for interpretation by the Ethos-U55 processor.
Tim Hall79d07d22020-04-27 18:20:16 +010020from collections import defaultdict
Tim Hall289a41d2020-08-04 21:40:14 +010021from collections import namedtuple
Diego Russoe8a10452020-04-21 17:39:10 +010022from enum import Enum
23from enum import IntEnum
Diego Russoea6111a2020-04-14 18:41:58 +010024
25import numpy as np
26
27from . import scaling
Diego Russoe8a10452020-04-21 17:39:10 +010028from .architecture_features import ArchitectureFeatures
29from .architecture_features import Block
30from .architecture_features import Kernel
31from .architecture_features import Rect
32from .architecture_features import SharedBufferArea
33from .architecture_features import SHRAMElements
34from .data_type import BaseType
35from .data_type import DataType
36from .ethos_u55_regs.ethos_u55_regs import acc_format
37from .ethos_u55_regs.ethos_u55_regs import activation
38from .ethos_u55_regs.ethos_u55_regs import cmd0
39from .ethos_u55_regs.ethos_u55_regs import cmd1
40from .ethos_u55_regs.ethos_u55_regs import elementwise_mode
41from .ethos_u55_regs.ethos_u55_regs import ifm_precision
Fredrik Svedberga0c36242020-06-03 15:43:31 +020042from .ethos_u55_regs.ethos_u55_regs import pooling_mode
Jacob Bohlincf7da102020-05-20 09:03:40 +020043from .ethos_u55_regs.ethos_u55_regs import resampling_mode
Diego Russoe8a10452020-04-21 17:39:10 +010044from .ethos_u55_regs.ethos_u55_regs import rounding
Tim Hall79d07d22020-04-27 18:20:16 +010045from .high_level_command_stream import CommandType
Diego Russoe8a10452020-04-21 17:39:10 +010046from .numeric_util import clamp_sigmoid
47from .numeric_util import clamp_tanh
Louis Verhaardb2fb2122020-06-04 15:51:24 +020048from .numeric_util import full_shape
Diego Russoe8a10452020-04-21 17:39:10 +010049from .numeric_util import quantise_float32
50from .numeric_util import round_away_zero
Diego Russoe8a10452020-04-21 17:39:10 +010051from .numeric_util import round_up_to_int
Tim Hall79d07d22020-04-27 18:20:16 +010052from .operation import NpuBlockType
Patrik Gustavssoneca2e952020-05-27 09:15:11 +020053from .tensor import MemType
Diego Russoe8a10452020-04-21 17:39:10 +010054from .tensor import TensorBlockTraversal
55from .tensor import TensorFormat
Fredrik Svedberga0c36242020-06-03 15:43:31 +020056from .tensor import TensorPurpose
Tim Hall79d07d22020-04-27 18:20:16 +010057
58
59class RegisterMachine:
60 def __init__(self):
61 self.n_banks = 1
62 self.registers = [defaultdict(lambda: None) for _ in range(self.n_banks)]
63 self.bank_idx = 0
64
65 def set_register(self, reg, value):
66 is_changed = self.registers[self.bank_idx][reg] != value
67 self.registers[self.bank_idx][reg] = value
68 # is_changed = True # force command
69 return is_changed
70
71 def switch_bank(self):
72 self.bank_idx = (self.bank_idx + 1) % self.n_banks
73
74
75class CmdMode(IntEnum):
76 NoPayload = 0x0000
77 Payload32 = 0x4000
78 Mask = 0xC000
79 CmdOpMask = 0x03FF
80
81
82class BasePointerIndex(IntEnum):
Patrik Gustavssoneca2e952020-05-27 09:15:11 +020083 WeightTensor = 0 # base address index for the Weight tensor
84 ScratchTensor = 1 # base address index for the Scratch_tensor in the TensorArena
85 ScratchFastTensor = 2 # base address for the Scratch_fast_tensor
Fredrik Svedberga0c36242020-06-03 15:43:31 +020086 Mem2Mem = (1 << 8) | (3 << 0) # base address slot for memory 2 memory transfer
Tim Hall79d07d22020-04-27 18:20:16 +010087
88
89# TODO: Replace with definitions from ethos_u55_regs
90class IFM2Broadcast(IntEnum):
91 BroadcastHdim = 1 << 0
92 BroadcastWdim = 1 << 1
93 BroadcastCdim = 1 << 2
94 ReverseOperandOrder = 1 << 6
95 UseIFM2Scalar = 1 << 7
96
97
98class CommandStreamEmitter:
99 def __init__(self):
100 self.cmd_stream = []
101 self.reg_machine = [RegisterMachine(), RegisterMachine()]
102 self.last_absolute_wait = defaultdict(int)
103
104 def get_reg_machine(self, cmd):
105 if "DMA" in cmd.name:
106 return self.reg_machine[1]
107 else:
108 return self.reg_machine[0]
109
110 def size_in_bytes(self):
111 sz = 0
112 for cmd in self.cmd_stream:
113 sz += len(cmd) * 4
114 return sz
115
116 def to_list(self):
117 return [elem for cmd in self.cmd_stream for elem in cmd]
118
119 def print_cmds(self):
120 print("Code: Command: Param: Payload:")
121 for words_for_one_command in self.cmd_stream:
122 code = words_for_one_command[0] & 0x0000FFFF # lower 16 bits
123 param = words_for_one_command[0] >> 16 # higher 16 bits
124
125 payload_mode = CmdMode(code & CmdMode.Mask)
126
127 # code and command
128 s = " 0x%04x " % code
129 if payload_mode == CmdMode.NoPayload:
130 s += str(cmd0(code & CmdMode.CmdOpMask))
131 else:
132 s += str(cmd1(code & CmdMode.CmdOpMask))
133
134 s = s.ljust(40)
135 s += "%5d" % param
136
137 # payload
138 if payload_mode == CmdMode.Payload32:
139 s += " 0x%08x (%d)" % (words_for_one_command[1], words_for_one_command[1])
140 else:
141 s += " -"
142
143 print(s)
144
145 def cmd0_with_param(self, cmd, param):
146 if isinstance(param, Enum):
147 param = int(param.value)
148 else:
149 param = int(param)
150 param = param & 0xFFFF
151 command = cmd.value | (param << 16)
152 if not self.get_reg_machine(cmd).set_register(cmd, (command, param)):
153 return
154
155 # This is not a redundant command, actually write it
156 self.cmd_stream.append((command,))
157
158 def cmd1_with_offset(self, cmd, offset, param=0x0):
159 offset = int(offset) & 0xFFFFFFFFF
160 command = cmd.value | CmdMode.Payload32.value | (param << 16)
161
162 if not self.get_reg_machine(cmd).set_register(cmd, (command, offset)):
163 return
164
165 # This is not a redundant command, actually write it
166 self.cmd_stream.append((command, offset))
167
Tim Hall289a41d2020-08-04 21:40:14 +0100168 def cmd_wait(self, cmd, channel, outstanding_count):
169 param = (16 * channel) + outstanding_count
Tim Hall79d07d22020-04-27 18:20:16 +0100170 command = ((param & 0xFFFF) << 16) | cmd.value
171 self.cmd_stream.append((command,))
172
173 def cmd_do_operation(self, cmd, param=0):
174 param = int(param)
175 command = ((param & 0xFFFF) << 16) | cmd.value
176
177 self.cmd_stream.append((command,))
178 self.get_reg_machine(cmd).switch_bank()
179
180
Tim Hall289a41d2020-08-04 21:40:14 +0100181Watermark = namedtuple("Watermark", ["npu", "dma"])
Tim Hall79d07d22020-04-27 18:20:16 +0100182
Tim Hall79d07d22020-04-27 18:20:16 +0100183
Tim Hall289a41d2020-08-04 21:40:14 +0100184def get_cmd_wait_dependency(arch, cmd_stream, memory_accesses, cmd_index, watermark: Watermark):
185 cmd = cmd_stream[cmd_index]
186 cmd_access = memory_accesses[cmd]
187 index = cmd_index - 1
Tim Hall79d07d22020-04-27 18:20:16 +0100188
Tim Hall289a41d2020-08-04 21:40:14 +0100189 # NPU dependency tracking
190 npu_outstanding = -1
191 npu_ops = 0
192 npu_index = watermark.npu
Tim Hall79d07d22020-04-27 18:20:16 +0100193
Tim Hall289a41d2020-08-04 21:40:14 +0100194 # DMA dependency tracking
195 dma_outstanding = -1
196 dma_ops = 0
197 dma_index = watermark.dma
Tim Hall79d07d22020-04-27 18:20:16 +0100198
Tim Hall289a41d2020-08-04 21:40:14 +0100199 # Seek back in the command stream looking for NPU or DMA dependencies
200 # but only as far as the first dependency or the watermarks (dependencies
201 # before this point have been satisfied already).
202 # The watermark moves to after the latest element we must wait for, not
203 # the command that issues the wait.
204 # NPU->NPU dependency is handled via blockdep.
205 while (index >= npu_index) or (index >= dma_index):
206 prev_cmd = cmd_stream[index]
207 prev_access = memory_accesses[prev_cmd]
Tim Hall79d07d22020-04-27 18:20:16 +0100208
Tim Hall289a41d2020-08-04 21:40:14 +0100209 # Check DMA consuming NPU output
210 if prev_cmd.cmdtype == CommandType.NpuStripe:
211 if index >= npu_index:
212 if (cmd.cmdtype == CommandType.DMA) and (npu_outstanding == -1) and prev_access.conflicts(cmd_access):
213 npu_outstanding = npu_ops
214 npu_ops = npu_ops + 1 # Count NPU ops in the pipeline
215 if npu_ops >= arch.max_outstanding_kernels:
216 npu_index = max(index + 1, npu_index)
Tim Hall79d07d22020-04-27 18:20:16 +0100217
Tim Hall289a41d2020-08-04 21:40:14 +0100218 # Check NPU consuming DMA output
219 elif prev_cmd.cmdtype == CommandType.DMA:
220 if index >= dma_index:
221 if cmd.cmdtype == CommandType.NpuStripe:
222 if (dma_outstanding == -1) and prev_access.conflicts(cmd_access):
223 dma_outstanding = dma_ops
224 dma_ops = dma_ops + 1 # Count DMA ops in the pipeline
225 if dma_ops >= arch.max_outstanding_dma:
226 dma_index = max(index + 1, dma_index)
Tim Hall79d07d22020-04-27 18:20:16 +0100227
Tim Hall289a41d2020-08-04 21:40:14 +0100228 index = index - 1
Tim Hall79d07d22020-04-27 18:20:16 +0100229
Tim Hall289a41d2020-08-04 21:40:14 +0100230 # Update DMA watermark if we didn't see any and the NPU pipeline is full
231 if (dma_ops == 0) and (npu_ops >= arch.max_outstanding_kernels):
232 dma_index = cmd_index
233
234 # Bring the search watermark forwards as we complete for those dependencies
235 watermark = Watermark(npu_index, dma_index)
236 outstanding = Watermark(npu_outstanding, dma_outstanding)
237
238 return watermark, outstanding
Tim Hall79d07d22020-04-27 18:20:16 +0100239
240
241def get_op_kernel(ps):
242 if ps.primary_op is None:
243 return None
244
245 strides = ps.primary_op.attrs.get("strides", (1, 1, 1, 1))
246 dilation = ps.primary_op.attrs.get("dilation", (1, 1, 1, 1))
247 if ps.weight_tensor:
248 if ps.npu_block_type in set((NpuBlockType.VectorProduct, NpuBlockType.ElementWise)):
249 k_h = 1
250 k_w = 1
251 else:
252 k_h = ps.weight_tensor.shape[0]
253 k_w = ps.weight_tensor.shape[1]
254 else:
255 k_h = ps.primary_op.attrs.get("filter_height", 1)
256 k_w = ps.primary_op.attrs.get("filter_width", 1)
257
258 return Kernel(k_w, k_h, strides[2], strides[1], dilation[2], dilation[1])
259
260
Tim Hall79d07d22020-04-27 18:20:16 +0100261def has_prev_op_dependency(prev_cmd, cmd):
262 if prev_cmd is None:
263 return False
264 if (prev_cmd.cmdtype == cmd.cmdtype == CommandType.NpuStripe) and (prev_cmd.ps != cmd.ps):
Louis Verhaard0b8268a2020-08-05 16:11:29 +0200265 if prev_cmd.ofm_tensor.equivalent(cmd.ifm_tensor):
Tim Hall79d07d22020-04-27 18:20:16 +0100266 return True
Tim Hall90337952020-05-07 16:42:35 +0100267 elif cmd.ifm2_tensor is not None:
Louis Verhaard0b8268a2020-08-05 16:11:29 +0200268 return prev_cmd.ofm_tensor.equivalent(cmd.ifm2_tensor)
Tim Hall79d07d22020-04-27 18:20:16 +0100269 return False
270
271
272def get_op_ofm_rect(cmd):
Charles Xu3e9c4342020-04-22 08:31:43 +0200273 start = full_shape(4, cmd.ofm_box.start_coord, 0)
274 end = full_shape(4, cmd.ofm_box.end_coord, 1)
Tim Hall79d07d22020-04-27 18:20:16 +0100275 return Rect(start[-2], start[-3], start[-1], end[-2] - 1, end[-3] - 1, end[-1] - 1)
276
277
278def get_op_ifm_rect(cmd):
Charles Xu3e9c4342020-04-22 08:31:43 +0200279 start = full_shape(4, cmd.ifm_box.start_coord, 0)
280 end = full_shape(4, cmd.ifm_box.end_coord, 1)
Tim Hall79d07d22020-04-27 18:20:16 +0100281 return Rect(start[-2], start[-3], start[-1], end[-2] - 1, end[-3] - 1, end[-1] - 1)
282
283
284def get_op_ifmofm_block_depth(arch, cmd):
285 # Note: NOT equivalent to the normal ifm block depth calculation since
286 # it takes into account 'depthless' block operations by returning full
287 # depth
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200288 if cmd.ps.npu_block_type in (
289 NpuBlockType.ConvolutionDepthWise,
290 NpuBlockType.Pooling,
291 NpuBlockType.ElementWise,
292 NpuBlockType.ReduceSum,
293 ):
Tim Hall79d07d22020-04-27 18:20:16 +0100294 return cmd.ofm_box.get_size_shape()[-1]
295
296 return arch.calc_ifm_block_depth(cmd.ifm_box.get_size_shape()[-1], cmd.ifm_tensor.dtype.bits)
297
298
299def get_op_padding_lt(cmd):
300 if cmd.ps.npu_block_type not in (
301 NpuBlockType.ConvolutionDepthWise,
302 NpuBlockType.Pooling,
303 NpuBlockType.ConvolutionMxN,
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200304 NpuBlockType.ReduceSum,
Tim Hall79d07d22020-04-27 18:20:16 +0100305 ):
306 return (0, 0)
307
308 explicit_padding = list(cmd.ps.primary_op.attrs["explicit_padding"]) # (top, left, bottom, right)
309
310 # Check if this is for horizontal ifm streaming
311 if not (cmd.is_first_h_stripe and cmd.is_last_h_stripe):
312 explicit_padding[0] = cmd.pad_top
313 explicit_padding[2] = cmd.pad_bottom
314
315 return (explicit_padding[1], explicit_padding[0])
316
317
Jacob Bohline99b8932020-07-13 16:01:51 +0200318def ifm_ifm2_correct_order(ifm_shape, ifm2_shape):
319 if ifm_shape == []:
320 # Scalar needs to be in IFM2
321 return False
322 elif ifm2_shape == []:
323 return True
324
325 for ifm, ifm2 in zip(ifm_shape, ifm2_shape):
326 if ifm != ifm2 and ifm == 1:
327 # Broadcasted FM needs to be in IFM2
328 return False
329
330 return True
331
332
Tim Hall79d07d22020-04-27 18:20:16 +0100333def generate_register_command_stream(nng, sg, arch, verbose=False):
334 emit = CommandStreamEmitter()
335
Patrik Gustavssoneca2e952020-05-27 09:15:11 +0200336 if arch.feature_map_storage_mem_area == arch.fast_storage_mem_area:
337 base_ptr_idx_map = {
338 MemType.Permanent_NPU: BasePointerIndex.WeightTensor,
339 MemType.Permanent_CPU: BasePointerIndex.WeightTensor,
340 MemType.Scratch: BasePointerIndex.ScratchTensor,
341 MemType.Scratch_fast: BasePointerIndex.ScratchTensor,
342 }
343 else:
344 base_ptr_idx_map = {
345 MemType.Permanent_NPU: BasePointerIndex.WeightTensor,
346 MemType.Permanent_CPU: BasePointerIndex.WeightTensor,
347 MemType.Scratch: BasePointerIndex.ScratchTensor,
348 MemType.Scratch_fast: BasePointerIndex.ScratchFastTensor,
349 }
Tim Hall79d07d22020-04-27 18:20:16 +0100350
351 # Maps an AccumulatorType enum to the corresponding acc_format value
352 acc_format_map = {
353 SHRAMElements.Acc16: acc_format.FP_S5_10.value,
354 SHRAMElements.Acc32: acc_format.INT_32BIT.value,
355 SHRAMElements.Acc40: acc_format.INT_40BIT.value,
356 }
357
358 # Maps an elementwise op type to an elementwise_mode enum value used by NPU_OP_ELEMENTWISE
359 elementwise_mode_map = {
360 "MulAct": elementwise_mode.MUL.value,
361 "AddAct": elementwise_mode.ADD.value,
362 "SubAct": elementwise_mode.SUB.value,
363 "Minimum": elementwise_mode.MIN.value,
364 "Maximum": elementwise_mode.MAX.value,
365 "LeakyRelu": elementwise_mode.LRELU.value,
366 "Abs": elementwise_mode.ABS.value,
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200367 "CLZ": elementwise_mode.CLZ.value,
368 "SHR": elementwise_mode.SHR.value,
369 "SHL": elementwise_mode.SHL.value,
Tim Hall79d07d22020-04-27 18:20:16 +0100370 }
371
372 cmd_stream = []
Tim Hall289a41d2020-08-04 21:40:14 +0100373 memory_accesses = {}
Tim Hall79d07d22020-04-27 18:20:16 +0100374 for cmd in sg.high_level_command_stream:
375 if cmd.cmdtype == CommandType.NpuStripe and cmd.ps.npu_block_type == NpuBlockType.Default:
376 print("Warning: Skipping register command stream generation for", cmd.ps)
377 else:
378 cmd_stream.append(cmd)
Tim Hall289a41d2020-08-04 21:40:14 +0100379 memory_accesses[cmd] = cmd.get_memory_accesses()
Tim Hall79d07d22020-04-27 18:20:16 +0100380
Tim Hall289a41d2020-08-04 21:40:14 +0100381 def emit_cmd_waits(cmd_waits):
382 if cmd_waits.npu >= 0:
383 emit.cmd_wait(cmd0.NPU_OP_KERNEL_WAIT, 0, cmd_waits.npu)
384
385 if cmd_waits.dma >= 0:
386 emit.cmd_wait(cmd0.NPU_OP_DMA_WAIT, 0, cmd_waits.dma)
Tim Hall79d07d22020-04-27 18:20:16 +0100387
388 # Initialise operator dependency state
389 prev_ifm_rect = cur_ifm_rect = None
390 prev_ifm_block_depth = cur_ifm_block_depth = None
391 prev_ofm_rect = cur_ofm_rect = None
392 prev_ofm_block = cur_ofm_block = None
393 prev_kernel = cur_kernel = None
394 prev_cmd = None
395
Tim Hall42e41892020-07-06 10:51:31 +0100396 if arch.is_yoda_system:
Jacob Bohlin0b9ca782020-07-09 11:16:30 +0200397 emit.cmd0_with_param(cmd0.NPU_SET_PARALLEL_MODE, arch.ncores - 1)
Tim Hallf7e810a2020-06-25 15:04:31 +0100398
Tim Hall289a41d2020-08-04 21:40:14 +0100399 dep_watermark = Watermark(0, 0)
400
401 for cmd_index, cmd in enumerate(cmd_stream):
402 dep_watermark, cmd_waits = get_cmd_wait_dependency(arch, cmd_stream, memory_accesses, cmd_index, dep_watermark)
403
Tim Hall79d07d22020-04-27 18:20:16 +0100404 if cmd.cmdtype == CommandType.DMA:
405 start_coord = cmd.box.start_coord
406
407 src_addr = cmd.in_tensor.address_for_coordinate(start_coord)
408 dst_addr = cmd.out_tensor.address_for_coordinate(start_coord)
409
410 if cmd.in_tensor.compressed_values is not None:
411 stream_index = cmd.in_tensor.compressed_stream_index_from_coord(start_coord)
412 sz = cmd.in_tensor.size_of_compressed_stream(stream_index)
413 else:
414 sz = cmd.in_tensor.address_for_coordinate(cmd.box.end_coord, is_top_box=True) - src_addr
415
Patrik Gustavssoneca2e952020-05-27 09:15:11 +0200416 emit.cmd0_with_param(cmd0.NPU_SET_DMA0_SRC_REGION, base_ptr_idx_map[cmd.in_tensor.mem_type])
Tim Hall79d07d22020-04-27 18:20:16 +0100417 emit.cmd1_with_offset(cmd1.NPU_SET_DMA0_SRC, src_addr)
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200418 if cmd.out_tensor.purpose == TensorPurpose.LUT:
419 emit.cmd0_with_param(cmd0.NPU_SET_DMA0_DST_REGION, BasePointerIndex.Mem2Mem)
420 else:
421 emit.cmd0_with_param(cmd0.NPU_SET_DMA0_DST_REGION, base_ptr_idx_map[cmd.out_tensor.mem_type])
Patrik Gustavssoneca2e952020-05-27 09:15:11 +0200422
Tim Hall79d07d22020-04-27 18:20:16 +0100423 emit.cmd1_with_offset(cmd1.NPU_SET_DMA0_DST, dst_addr)
424 emit.cmd1_with_offset(cmd1.NPU_SET_DMA0_LEN, sz)
425 dma_channel = 0
426 mode = 0 # From external to external
427
Tim Hall289a41d2020-08-04 21:40:14 +0100428 emit_cmd_waits(cmd_waits)
Tim Hall79d07d22020-04-27 18:20:16 +0100429 emit.cmd_do_operation(cmd0.NPU_OP_DMA_START, dma_channel * 16 + mode)
430
431 elif cmd.cmdtype == CommandType.NpuStripe:
432
433 ps = cmd.ps
434 primary_op = ps.primary_op
435 npu_block_type = ps.npu_block_type
436 # Specifies if global scale from the NPU_SET_OFM_SCALE register should be used instead of per-channel scale
437 use_global_scale = False
438 # Specifies type of rounding to be used.
Tim Halld775e372020-08-28 18:33:38 +0100439 rounding_mode = (
440 rounding.NATURAL if primary_op.attrs.get("rounding_mode", "") == b"NATURAL" else rounding.TFL
441 )
Louis Verhaardb2fb2122020-06-04 15:51:24 +0200442 if primary_op.type == "ResizeBilinear":
Dwight Lidman3ec04ac2020-04-30 11:54:48 +0200443 rounding_mode = rounding.TRUNCATE
Tim Hall79d07d22020-04-27 18:20:16 +0100444 fmf = primary_op.attrs.get("fused_memory_function", None)
445 faf = primary_op.attrs.get("fused_activation_function", None)
Jacob Bohlin9fbc4912020-06-29 11:58:50 +0200446 fused_quantize = any(op.type == "Quantize" for op in ps.ops)
Louis Verhaardd7911c42020-08-25 13:36:41 +0200447 # Force output scale, used in operations with fused LUT
448 # Note: with current LUT support, forced_ofm_quantization is always equal to cmd.ofm_tensor.quantization
449 # except when primary_op is AddAct + 0 (no-op) + LUT
450 forced_ofm_quantization = primary_op.attrs.get("forced_output_quantization", None)
451 ofm_quant = cmd.ofm_tensor.quantization
452 if forced_ofm_quantization is not None:
453 ofm_quant = forced_ofm_quantization
Tim Hall79d07d22020-04-27 18:20:16 +0100454
455 # Specifies which operand to apply scaling to in bitexact elementwise ADD/SUB
456 op_to_scale = 0
457
458 # Update state history
459 prev_ifm_rect = cur_ifm_rect
460 prev_ifm_block_depth = cur_ifm_block_depth
461 prev_ofm_rect = cur_ofm_rect
462 prev_ofm_block = cur_ofm_block
463 prev_kernel = cur_kernel
Louis Verhaardb2fb2122020-06-04 15:51:24 +0200464 cur_kernel = get_op_kernel(ps)
Tim Hall79d07d22020-04-27 18:20:16 +0100465
466 block_config = ps.block_config
467 emit.cmd0_with_param(cmd0.NPU_SET_OFM_BLK_HEIGHT_M1, block_config[0] - 1)
468 emit.cmd0_with_param(cmd0.NPU_SET_OFM_BLK_WIDTH_M1, block_config[1] - 1)
469 emit.cmd0_with_param(cmd0.NPU_SET_OFM_BLK_DEPTH_M1, block_config[3] - 1)
470
471 shared_buffer = ps.shared_buffer
472
473 if npu_block_type == NpuBlockType.ElementWise:
Jacob Bohlinbe733cf2020-08-13 10:21:34 +0200474 ifm2_broadcast = 0
Tim Hall79d07d22020-04-27 18:20:16 +0100475
Jacob Bohlinbf612682020-08-13 09:37:02 +0200476 if cmd.ifm2_tensor and not ifm_ifm2_correct_order(cmd.ifm_tensor.shape, cmd.ifm2_tensor.shape):
Tim Hall79d07d22020-04-27 18:20:16 +0100477 # The scalar has to be the ifm2 tensor so switch the ifms
478 cmd.ifm_tensor, cmd.ifm2_tensor = cmd.ifm2_tensor, cmd.ifm_tensor
479 cmd.ifm_box, cmd.ifm2_box = cmd.ifm2_box, cmd.ifm_box
480
481 # Set ReverseOperandOrder bit to IFM2_BROADCAST
482 ifm2_broadcast |= IFM2Broadcast.ReverseOperandOrder
483
484 # Calculate scales needed for arithmetic elementwise operators
485 if primary_op.type in set(("AddAct", "MulAct", "SubAct",)):
486 input_scale = cmd.ifm_tensor.quantization.scale_f32
487 input2_scale = cmd.ifm2_tensor.quantization.scale_f32
Louis Verhaardd7911c42020-08-25 13:36:41 +0200488 output_scale = ofm_quant.scale_f32
Tim Hall79d07d22020-04-27 18:20:16 +0100489 use_global_scale = True
490
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200491 if output_scale is not None and faf in ("Sigmoid", "Tanh"):
492 output_scale = 1 / 0x3000
Tim Hall79d07d22020-04-27 18:20:16 +0100493
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200494 if primary_op.type == "MulAct":
495 if None in (input_scale, input2_scale, output_scale):
496 ofm_scale = 1
497 shift = 0
498 else:
499 ofm_scale, shift = scaling.elementwise_mul_scale(input_scale, input2_scale, output_scale)
Tim Hall79d07d22020-04-27 18:20:16 +0100500 emit.cmd1_with_offset(cmd1.NPU_SET_OFM_SCALE, ofm_scale, shift)
501 else: # AddAct/SubAct
Charles Xu9a03fdf2020-07-02 15:12:40 +0200502 # Force output scale same as the input scale for
Louis Verhaardd7911c42020-08-25 13:36:41 +0200503 # resizebilinear 1x1 that is converted to add
Charles Xu9a03fdf2020-07-02 15:12:40 +0200504 if "resizebilinear" in primary_op.attrs:
505 output_scale = input2_scale
506
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200507 if None in (input_scale, input2_scale, output_scale):
508 opa_scale = opb_scale = ofm_scale = 1
509 opa_shift = shift = 0
Fredrik Svedberg597fd3f2020-08-13 10:02:53 +0200510 ofm_scale, shift = primary_op.attrs.get("rescale", [1, 0])
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200511 elif input_scale == input2_scale:
Tim Hall79d07d22020-04-27 18:20:16 +0100512 opa_scale, opb_scale, ofm_scale, shift = scaling.simplified_elementwise_add_sub_scale(
513 input_scale, input2_scale, output_scale
514 )
515 opa_shift = 0 # Unused for this case
516 else:
517 # Use advanced implementation only when input scales differ
518 bitdepth = cmd.ifm_tensor.dtype.bits
519 (
520 opa_scale,
521 opa_shift,
522 ofm_scale,
523 shift,
524 op_to_scale,
525 ) = scaling.advanced_elementwise_add_sub_scale(
526 input_scale, input2_scale, output_scale, bitdepth
527 )
528 opb_scale = 0 # Unused for this case
529 if ifm2_broadcast & IFM2Broadcast.ReverseOperandOrder:
530 # If the operand order is reversed we also have to swap which operand is scaled
531 if op_to_scale == scaling.OperandToScale.OPa:
532 op_to_scale = scaling.OperandToScale.OPb
533 else:
534 op_to_scale = scaling.OperandToScale.OPa
535
536 emit.cmd1_with_offset(cmd1.NPU_SET_OPA_SCALE, opa_scale, opa_shift)
537 emit.cmd1_with_offset(cmd1.NPU_SET_OPB_SCALE, opb_scale)
538 emit.cmd1_with_offset(cmd1.NPU_SET_OFM_SCALE, ofm_scale, shift)
539
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200540 elif primary_op.type in set(("LeakyRelu", "Abs",)):
Louis Verhaardd7911c42020-08-25 13:36:41 +0200541 output_scale = ofm_quant.scale_f32
Tim Hall79d07d22020-04-27 18:20:16 +0100542 use_global_scale = True
543
544 if primary_op.type == "LeakyRelu":
Louis Verhaard58520b92020-08-24 16:45:38 +0200545 output_scale = primary_op.attrs["alpha"]
Tim Hall79d07d22020-04-27 18:20:16 +0100546
547 ofm_scale, shift = scaling.quantise_scale(output_scale)
548 emit.cmd1_with_offset(cmd1.NPU_SET_OFM_SCALE, ofm_scale, shift)
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200549 else:
550 emit.cmd1_with_offset(cmd1.NPU_SET_OFM_SCALE, 1, 0)
Tim Hall79d07d22020-04-27 18:20:16 +0100551
Louis Verhaard0b8268a2020-08-05 16:11:29 +0200552 # For elementwise set the required SHRAM to be equal to the total size of available SHRAM
553 uses_lut = primary_op.activation_lut is not None
554 shram_required = arch.available_shram_banks(uses_lut)
Tim Hall79d07d22020-04-27 18:20:16 +0100555 emit.cmd0_with_param(cmd0.NPU_SET_IFM_IB_END, shram_required)
556
557 # Acc buffers not needed so set AB_START to size of SHRAM
Louis Verhaard0b8268a2020-08-05 16:11:29 +0200558 emit.cmd0_with_param(cmd0.NPU_SET_AB_START, shram_required)
Tim Hall79d07d22020-04-27 18:20:16 +0100559
560 # Is not a unary operator
561 if cmd.ifm2_tensor is not None:
562 if cmd.ifm2_tensor.shape == []:
563 # IFM2 is a constant, set UseIFM2Scalar bit to IFM2_BROADCAST
564 ifm2_broadcast |= IFM2Broadcast.UseIFM2Scalar
565 else:
566 ifm_box_shape = cmd.ifm_box.get_size_shape()
567 ifm2_box_shape = cmd.ifm2_box.get_size_shape()
568
569 if len(cmd.ifm_tensor.shape) > 1 and ifm_box_shape[1] != ifm2_box_shape[1]:
570 # Broadcast in 'H' dimension
571 assert cmd.ifm2_tensor.shape[1] == 1
572 ifm2_broadcast |= IFM2Broadcast.BroadcastHdim
573
574 if len(cmd.ifm_tensor.shape) > 2 and ifm_box_shape[2] != ifm2_box_shape[2]:
575 # Broadcast in 'W' dimension
576 assert cmd.ifm2_tensor.shape[2] == 1
577 ifm2_broadcast |= IFM2Broadcast.BroadcastWdim
578
579 if len(cmd.ifm_tensor.shape) > 3 and ifm_box_shape[3] != ifm2_box_shape[3]:
580 # Broadcast in 'C' dimension
581 assert cmd.ifm2_tensor.shape[3] == 1
582 ifm2_broadcast |= IFM2Broadcast.BroadcastCdim
583
584 # Set IFM2_IB_START to the latter half of the IB space
585 ifm_ib_start = shared_buffer.bank_locations[SharedBufferArea.IFM]
586 emit.cmd0_with_param(
587 cmd0.NPU_SET_IFM2_IB_START, (shram_required - ifm_ib_start) / 2 + ifm_ib_start
588 )
589
590 emit.cmd0_with_param(cmd0.NPU_SET_IFM2_BROADCAST, ifm2_broadcast)
591
592 else:
593 emit.cmd0_with_param(
594 cmd0.NPU_SET_IFM_IB_END,
595 shared_buffer.bank_locations[SharedBufferArea.IFM]
596 + shared_buffer.banks_required[SharedBufferArea.IFM],
597 )
598 emit.cmd0_with_param(cmd0.NPU_SET_AB_START, shared_buffer.bank_locations[SharedBufferArea.Accumulators])
599
600 emit.cmd0_with_param(cmd0.NPU_SET_ACC_FORMAT, acc_format_map[shared_buffer.use_accumulator_element])
601
Louis Verhaardb2fb2122020-06-04 15:51:24 +0200602 if primary_op.type == "ResizeBilinear":
Dwight Lidman3ec04ac2020-04-30 11:54:48 +0200603 # perform nearest neighbor upscale
Jacob Bohlincf7da102020-05-20 09:03:40 +0200604 emit.cmd0_with_param(cmd0.NPU_SET_IFM_UPSCALE, resampling_mode.NEAREST)
605 elif primary_op.type == "Conv2DBackpropInputSwitchedBias":
606 # perform insert zero upscale
607 emit.cmd0_with_param(cmd0.NPU_SET_IFM_UPSCALE, resampling_mode.TRANSPOSE)
Dwight Lidman3ec04ac2020-04-30 11:54:48 +0200608 else:
Jacob Bohlincf7da102020-05-20 09:03:40 +0200609 emit.cmd0_with_param(cmd0.NPU_SET_IFM_UPSCALE, resampling_mode.NONE)
Tim Hall79d07d22020-04-27 18:20:16 +0100610
611 if npu_block_type in set(
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200612 (
613 NpuBlockType.ConvolutionMxN,
614 NpuBlockType.ConvolutionDepthWise,
615 NpuBlockType.Pooling,
616 NpuBlockType.ReduceSum,
617 )
Tim Hall79d07d22020-04-27 18:20:16 +0100618 ):
619 # Set up padding
620 explicit_padding = list(primary_op.attrs["explicit_padding"]) # (top, left, bottom, right)
621
622 # Check if this is for horizontal ifm streaming
623 if not (cmd.is_first_h_stripe and cmd.is_last_h_stripe):
624 explicit_padding[0] = cmd.pad_top
625 explicit_padding[2] = cmd.pad_bottom
626
627 # Indexing from end since a 1x1 Avgpool might have been added with non 4-dimensional input/output,
628 # because of activation function needed to be fused.
629 if cmd.ifm_box.start_coord[-2] > 0:
630 explicit_padding[1] = 0
631 if cmd.ifm_box.end_coord[-2] < cmd.ifm_tensor.shape[-2]:
632 explicit_padding[3] = 0
Tim Hall79d07d22020-04-27 18:20:16 +0100633 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PAD_TOP, explicit_padding[0])
634 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PAD_LEFT, explicit_padding[1])
635 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PAD_BOTTOM, explicit_padding[2])
636 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PAD_RIGHT, explicit_padding[3])
637
Dwight Lidman0538a772020-05-06 14:09:17 +0200638 # set kernel x stride low bit
639 stride = primary_op.attrs["strides"][2] - 1 & 1
640 # set kernel y stride low bit
641 stride |= (primary_op.attrs["strides"][1] - 1 & 1) << 1
642 # set kernel x stride extension bits
643 stride |= (primary_op.attrs["strides"][2] - 1 >> 1) << 6
644 # set kernel y stride extension bits
645 stride |= (primary_op.attrs["strides"][1] - 1 >> 1) << 9
646
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200647 if npu_block_type in set((NpuBlockType.Pooling, NpuBlockType.ReduceSum)):
Tim Hall79d07d22020-04-27 18:20:16 +0100648 k_height, k_width = primary_op.attrs["ksize"][1:3]
649 emit.cmd0_with_param(cmd0.NPU_SET_KERNEL_HEIGHT_M1, k_height - 1)
650 emit.cmd0_with_param(cmd0.NPU_SET_KERNEL_WIDTH_M1, k_width - 1)
651
652 valid_padding = sum(explicit_padding) == 0
653
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200654 if (
655 primary_op.type in set(("AvgPool", "AvgPoolAct", "ResizeBilinear", "ReduceSum"))
656 and valid_padding
657 ):
Tim Hall79d07d22020-04-27 18:20:16 +0100658 # For valid padding vela has to output scaling values
659 if faf == "Sigmoid" or faf == "Tanh":
660 rescale = 0x3000 * cmd.ifm_tensor.quantization.scale_f32
Fredrik Svedberg620d88c2020-05-19 10:43:01 +0200661 if cmd.ifm_tensor.dtype == DataType.int16:
Charles Xuf8992312020-08-18 08:41:54 +0200662 # Calculate scale and shift for the output scale of 1/(3*4096)
663 shift = 0
664 max_rescale = np.iinfo(np.int16).max / 2
665 while rescale <= max_rescale and shift <= 30:
666 shift += 1
667 rescale *= 2
668 scale = int(rescale)
Fredrik Svedberg620d88c2020-05-19 10:43:01 +0200669 else:
Charles Xuf8992312020-08-18 08:41:54 +0200670 rescale_bits = len(bin(round_up_to_int(rescale))) - 2 + 1
671 scale, shift = scaling.quantise_pooling_scale(k_height * k_width, rescale_bits)
Fredrik Svedberg620d88c2020-05-19 10:43:01 +0200672 scale = int(round_away_zero(scale * rescale))
Jacob Bohlin9fbc4912020-06-29 11:58:50 +0200673 elif fused_quantize:
674 # Quantize op requires different scaling
675 ifm_scale_f64 = np.double(cmd.ifm_tensor.quantization.scale_f32)
Louis Verhaardd7911c42020-08-25 13:36:41 +0200676 ofm_scale_f64 = np.double(ofm_quant.scale_f32)
Jacob Bohlin9fbc4912020-06-29 11:58:50 +0200677 scale, shift = scaling.quantise_scale(ifm_scale_f64 / ofm_scale_f64)
Charles Xu87c13502020-08-06 12:17:26 +0200678 elif primary_op.type == "ResizeBilinear" and "rescale" in primary_op.attrs:
679 rescale = primary_op.attrs["rescale"]
680 rescale_bits = len(bin(round_up_to_int(rescale))) - 2 + 1
681 scale, shift = scaling.quantise_pooling_scale(k_height * k_width, rescale_bits)
682 scale = int(round_away_zero(scale * rescale))
Tim Hall79d07d22020-04-27 18:20:16 +0100683 else:
684 # In case avg pool fused with concat or other memory operation, rescaling might be needed.
685 # k_height == k_width == 1 is allways true in this case
686 # Normally the scale is maximised, to get maximum precision, which means that
687 # if rescale != 1, scale need to consider the number of bits needed for rescaling
Louis Verhaardd7911c42020-08-25 13:36:41 +0200688 if None not in (ofm_quant.scale_f32, cmd.ifm_tensor.quantization.scale_f32,):
689 rescale = cmd.ifm_tensor.quantization.scale_f32 / ofm_quant.scale_f32
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200690 rescale_bits = 0
691 if k_height == k_width == 1:
692 if fmf == "ConcatSliceWrite":
693 rounding_mode = rounding.NATURAL
694 if rescale > 1:
695 rescale_bits = len(bin(round_up_to_int(rescale))) - 2 + 1
696 elif rescale < 1:
697 rescale_bits = -(len(bin(round_up_to_int(1 / rescale))) - 2 - 1)
698 scale, shift = scaling.quantise_pooling_scale(k_height * k_width, rescale_bits)
699 scale = int(round_away_zero(scale * rescale))
700 else:
701 scale = 1
702 shift = 0
Tim Hall79d07d22020-04-27 18:20:16 +0100703
704 emit.cmd1_with_offset(cmd1.NPU_SET_OFM_SCALE, scale, shift)
705 # Valid-padded average pool should use the global scale from
706 # NPU_SET_OFM_SCALE register, which is set above.
707 use_global_scale = True
708
709 else: # Convolution
710 assert cmd.weight_tensor.block_traversal != TensorBlockTraversal.Default
Fredrik Svedbergd67c0aa2020-03-30 13:15:28 +0200711 # Reduced precision quantization and natural rounding used for int16
712 if cmd.ifm_tensor.dtype == DataType.int16:
713 rounding_mode = rounding.NATURAL
Louis Verhaardb2fb2122020-06-04 15:51:24 +0200714 stride |= (cur_kernel.dilation.y - 1) << 4
715 stride |= (cur_kernel.dilation.x - 1) << 3
716 emit.cmd0_with_param(
717 cmd0.NPU_SET_KERNEL_HEIGHT_M1, cur_kernel.dilation.y * (cmd.weight_tensor.shape[0] - 1)
718 )
719 emit.cmd0_with_param(
720 cmd0.NPU_SET_KERNEL_WIDTH_M1, cur_kernel.dilation.x * (cmd.weight_tensor.shape[1] - 1)
721 )
Tim Hall79d07d22020-04-27 18:20:16 +0100722 if cmd.weight_tensor.block_traversal == TensorBlockTraversal.PartKernelFirst:
723 # Part-kernel-first weight ordering
724 assert npu_block_type == NpuBlockType.ConvolutionMxN
725 stride |= 1 << 2
726
727 emit.cmd0_with_param(cmd0.NPU_SET_KERNEL_STRIDE, stride)
728
729 elif npu_block_type in set((NpuBlockType.VectorProduct,)):
730 # Vector product is implemented using a 1x1 convolution so need
731 # to setup the appropriate padding and kernel info
732 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PAD_TOP, 0)
733 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PAD_LEFT, 0)
734 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PAD_BOTTOM, 0)
735 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PAD_RIGHT, 0)
736
737 # kernel stride reg = 0 means stride(1,1) + depth first weight
738 # order + dilation(0,0) + kernel_split_size=8
739 emit.cmd0_with_param(cmd0.NPU_SET_KERNEL_STRIDE, 0)
740
741 emit.cmd0_with_param(cmd0.NPU_SET_KERNEL_HEIGHT_M1, 0)
742 emit.cmd0_with_param(cmd0.NPU_SET_KERNEL_WIDTH_M1, 0)
743
744 if npu_block_type in set(
745 (NpuBlockType.ConvolutionMxN, NpuBlockType.ConvolutionDepthWise, NpuBlockType.VectorProduct)
746 ):
747 # Emit Weight base address commands, only maps the area required for
748 # this command's weights from the larger tensor.
749 stream_index = cmd.weight_tensor.compressed_stream_index_from_coord(cmd.weight_box.start_coord)
Tim Hallf7e810a2020-06-25 15:04:31 +0100750 weight_substream_offsets = cmd.weight_tensor.compressed_values_substream_offsets[stream_index]
Jacob Bohlin0b9ca782020-07-09 11:16:30 +0200751 substreams = len(weight_substream_offsets) - 1 # Offset list must terminate with full stream length
Tim Hallf7e810a2020-06-25 15:04:31 +0100752
753 # Extract weight substream offsets and calculate their lengths
754 assert len(weight_substream_offsets) > 1 and (weight_substream_offsets[0] == 0)
Tim Hall79d07d22020-04-27 18:20:16 +0100755 weight_addr = cmd.weight_tensor.address_for_coordinate(cmd.weight_box.start_coord)
Tim Hallf7e810a2020-06-25 15:04:31 +0100756
Tim Hall62316762020-06-25 16:55:02 +0100757 # Set weights sources for active and present cores
Jacob Bohlin0b9ca782020-07-09 11:16:30 +0200758 for core, param in enumerate(
759 [
760 (cmd1.NPU_SET_WEIGHT_BASE, cmd1.NPU_SET_WEIGHT_LENGTH),
761 (cmd1.NPU_SET_WEIGHT1_BASE, cmd1.NPU_SET_WEIGHT1_LENGTH),
762 ]
763 ):
Tim Hall62316762020-06-25 16:55:02 +0100764 if core < substreams:
Jacob Bohlin0b9ca782020-07-09 11:16:30 +0200765 emit.cmd1_with_offset(param[0], weight_addr + weight_substream_offsets[core])
766 emit.cmd1_with_offset(
767 param[1], weight_substream_offsets[core + 1] - weight_substream_offsets[core]
768 )
Tim Hall62316762020-06-25 16:55:02 +0100769 elif core < arch.ncores:
770 emit.cmd1_with_offset(param[0], weight_addr)
771 emit.cmd1_with_offset(param[1], 0)
Tim Hallf7e810a2020-06-25 15:04:31 +0100772
Patrik Gustavssoneca2e952020-05-27 09:15:11 +0200773 weight_region = base_ptr_idx_map[cmd.weight_tensor.mem_type]
Tim Hall79d07d22020-04-27 18:20:16 +0100774 emit.cmd0_with_param(cmd0.NPU_SET_WEIGHT_REGION, weight_region)
Tim Hall79d07d22020-04-27 18:20:16 +0100775
776 # Emit Scale & Bias base address commands, with length matching the amount required by
777 # the weight tensors.
778 if cmd.scale_tensor is not None:
Tim Hallf7e810a2020-06-25 15:04:31 +0100779 scale_substream_offsets = cmd.scale_tensor.compressed_values_substream_offsets[stream_index]
Jacob Bohlin0b9ca782020-07-09 11:16:30 +0200780 substreams = len(scale_substream_offsets) - 1 # Offset list must terminate with full stream length
Tim Hallf7e810a2020-06-25 15:04:31 +0100781
782 # Extract scale substream offsets and calculate their lengths
783 assert len(scale_substream_offsets) > 1 and (scale_substream_offsets[0] == 0)
Jacob Bohlin0b9ca782020-07-09 11:16:30 +0200784 scale_addr = cmd.scale_tensor.address_for_coordinate(cmd.weight_box.start_coord[-1:])
Tim Hallf7e810a2020-06-25 15:04:31 +0100785
Tim Hall62316762020-06-25 16:55:02 +0100786 # Set scale sources for active and present cores
Jacob Bohlin0b9ca782020-07-09 11:16:30 +0200787 for core, param in enumerate(
788 [
789 (cmd1.NPU_SET_SCALE_BASE, cmd1.NPU_SET_SCALE_LENGTH),
790 (cmd1.NPU_SET_SCALE1_BASE, cmd1.NPU_SET_SCALE1_LENGTH),
791 ]
792 ):
Tim Hall62316762020-06-25 16:55:02 +0100793 if core < substreams:
Jacob Bohlin0b9ca782020-07-09 11:16:30 +0200794 emit.cmd1_with_offset(param[0], scale_addr + scale_substream_offsets[core])
795 emit.cmd1_with_offset(
796 param[1], scale_substream_offsets[core + 1] - scale_substream_offsets[core]
797 )
Tim Hall62316762020-06-25 16:55:02 +0100798 elif core < arch.ncores:
799 emit.cmd1_with_offset(param[0], scale_addr)
800 emit.cmd1_with_offset(param[1], 0)
Tim Hallf7e810a2020-06-25 15:04:31 +0100801
Tim Hall79d07d22020-04-27 18:20:16 +0100802 # Emit base address for NPU to access scale & bias data
Patrik Gustavssoneca2e952020-05-27 09:15:11 +0200803 scale_region = base_ptr_idx_map[cmd.scale_tensor.mem_type]
Tim Hall79d07d22020-04-27 18:20:16 +0100804 emit.cmd0_with_param(cmd0.NPU_SET_SCALE_REGION, scale_region)
Tim Hall79d07d22020-04-27 18:20:16 +0100805
Louis Verhaardd7911c42020-08-25 13:36:41 +0200806 ofm_quant_qmin = ofm_quant.quant_min
807 ofm_quant_qmax = ofm_quant.quant_max
Tim Hall79d07d22020-04-27 18:20:16 +0100808 ifm_min = cmd.ifm_tensor.quantization.min
809 ifm_max = cmd.ifm_tensor.quantization.max
810
811 # Emit commands for any fused activation function
Diego Russoea6111a2020-04-14 18:41:58 +0100812 if faf is None:
Tim Hall79d07d22020-04-27 18:20:16 +0100813 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION, activation.NONE)
814 # Even if no activation function, values need to be set to override previous values
815 faf_min = ofm_quant_qmin
816 faf_max = ofm_quant_qmax
817 elif faf == "Relu":
818 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION, activation.NONE)
819 faf_min = quantise_float32(0.0, ofm_quant.scale_f32, ofm_quant.zero_point)
820 faf_max = ofm_quant_qmax
821 elif faf == "Relu6":
822 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION, activation.NONE)
823 faf_min = quantise_float32(0.0, ofm_quant.scale_f32, ofm_quant.zero_point)
824 faf_max = quantise_float32(6.0, ofm_quant.scale_f32, ofm_quant.zero_point)
825 elif faf == "ReluN1To1":
826 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION, activation.NONE)
827 faf_min = quantise_float32(-1.0, ofm_quant.scale_f32, ofm_quant.zero_point)
828 faf_max = quantise_float32(1.0, ofm_quant.scale_f32, ofm_quant.zero_point)
829 elif faf == "Tanh":
830 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION, activation.TANH)
Fredrik Svedberg620d88c2020-05-19 10:43:01 +0200831 if primary_op.type in set(("AvgPool", "AvgPoolAct", "ResizeBilinear")):
832 faf_min = quantise_float32(-1.0, ofm_quant.scale_f32, ofm_quant.zero_point)
833 faf_max = quantise_float32(1.0, ofm_quant.scale_f32, ofm_quant.zero_point)
834 else:
835 faf_min = quantise_float32(clamp_tanh(ifm_min), ofm_quant.scale_f32, ofm_quant.zero_point)
836 faf_max = quantise_float32(clamp_tanh(ifm_max), ofm_quant.scale_f32, ofm_quant.zero_point)
Tim Hall79d07d22020-04-27 18:20:16 +0100837 elif faf == "Sigmoid":
838 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION, activation.SIGMOID)
Fredrik Svedberg620d88c2020-05-19 10:43:01 +0200839 if primary_op.type in set(("AvgPool", "AvgPoolAct", "ResizeBilinear")):
840 faf_min = quantise_float32(0, ofm_quant.scale_f32, ofm_quant.zero_point)
841 faf_max = quantise_float32(1.0, ofm_quant.scale_f32, ofm_quant.zero_point)
842 else:
843 faf_min = quantise_float32(clamp_sigmoid(ifm_min), ofm_quant.scale_f32, ofm_quant.zero_point)
844 faf_max = quantise_float32(clamp_sigmoid(ifm_max), ofm_quant.scale_f32, ofm_quant.zero_point)
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200845 elif faf == "LUT":
Louis Verhaard0b8268a2020-08-05 16:11:29 +0200846 lut_index = int(activation.LUT_START.value) + primary_op.attrs.get("lut_index", -1)
847 assert activation.LUT_START.value <= lut_index <= activation.LUT_END.value, "LUT index out of range."
Fredrik Svedberg597fd3f2020-08-13 10:02:53 +0200848 if cmd.ofm_tensor.dtype == DataType.int32:
Fredrik Svedberg1575b942020-08-18 13:19:18 +0200849 lut_index |= 3 << 12 # Force I8 range
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200850 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION, lut_index)
851 faf_min = ofm_quant_qmin
852 faf_max = ofm_quant_qmax
Tim Hall79d07d22020-04-27 18:20:16 +0100853 else:
854 raise Exception("Unsupported fused_activation_function = " + faf)
855
856 # Activation range needs to be set based upon the quantisation range and the fused activation range
857 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION_MIN, max(ofm_quant_qmin, faf_min))
858 emit.cmd0_with_param(cmd0.NPU_SET_ACTIVATION_MAX, min(ofm_quant_qmax, faf_max))
859
860 out_shape = cmd.ofm_box.get_size_shape()
861 if len(out_shape) >= 4:
862 emit.cmd0_with_param(cmd0.NPU_SET_OFM_HEIGHT_M1, out_shape[-3] - 1)
863 else:
864 emit.cmd0_with_param(cmd0.NPU_SET_OFM_HEIGHT_M1, 0)
865 if len(out_shape) >= 2:
866 emit.cmd0_with_param(cmd0.NPU_SET_OFM_WIDTH_M1, out_shape[-2] - 1)
867 else:
868 emit.cmd0_with_param(cmd0.NPU_SET_OFM_WIDTH_M1, 0)
869 emit.cmd0_with_param(cmd0.NPU_SET_OFM_DEPTH_M1, out_shape[-1] - 1)
870
Fredrik Svedberga0c36242020-06-03 15:43:31 +0200871 if npu_block_type in set((NpuBlockType.ConvolutionMxN, NpuBlockType.VectorProduct, NpuBlockType.ReduceSum)):
Tim Hall79d07d22020-04-27 18:20:16 +0100872 in_shape = cmd.ifm_box.get_size_shape()
873 emit.cmd0_with_param(cmd0.NPU_SET_IFM_DEPTH_M1, in_shape[-1] - 1)
874 else:
875 emit.cmd0_with_param(cmd0.NPU_SET_IFM_DEPTH_M1, out_shape[-1] - 1)
876
Jacob Bohlin3c678292020-04-27 10:27:25 +0200877 for tens, box, region_op, ptr_ops, stride_ops, zero_point_op in (
Tim Hall79d07d22020-04-27 18:20:16 +0100878 (
879 cmd.ifm_tensor,
880 cmd.ifm_box,
Jacob Bohlin3c678292020-04-27 10:27:25 +0200881 cmd0.NPU_SET_IFM_REGION,
Tim Hall79d07d22020-04-27 18:20:16 +0100882 (cmd1.NPU_SET_IFM_BASE0, cmd1.NPU_SET_IFM_BASE1, cmd1.NPU_SET_IFM_BASE2, cmd1.NPU_SET_IFM_BASE3),
883 (cmd1.NPU_SET_IFM_STRIDE_C, cmd1.NPU_SET_IFM_STRIDE_Y, cmd1.NPU_SET_IFM_STRIDE_X),
884 cmd0.NPU_SET_IFM_ZERO_POINT,
885 ),
886 (
887 cmd.ifm2_tensor,
888 cmd.ifm2_box,
Jacob Bohlin3c678292020-04-27 10:27:25 +0200889 cmd0.NPU_SET_IFM2_REGION,
Tim Hall79d07d22020-04-27 18:20:16 +0100890 (
891 cmd1.NPU_SET_IFM2_BASE0,
892 cmd1.NPU_SET_IFM2_BASE1,
893 cmd1.NPU_SET_IFM2_BASE2,
894 cmd1.NPU_SET_IFM2_BASE3,
895 ),
896 (cmd1.NPU_SET_IFM2_STRIDE_C, cmd1.NPU_SET_IFM2_STRIDE_Y, cmd1.NPU_SET_IFM2_STRIDE_X),
897 cmd0.NPU_SET_IFM2_ZERO_POINT,
898 ),
899 (
900 cmd.ofm_tensor,
901 cmd.ofm_box,
Jacob Bohlin3c678292020-04-27 10:27:25 +0200902 cmd0.NPU_SET_OFM_REGION,
Tim Hall79d07d22020-04-27 18:20:16 +0100903 (cmd1.NPU_SET_OFM_BASE0, cmd1.NPU_SET_OFM_BASE1, cmd1.NPU_SET_OFM_BASE2, cmd1.NPU_SET_OFM_BASE3),
904 (cmd1.NPU_SET_OFM_STRIDE_C, cmd1.NPU_SET_OFM_STRIDE_Y, cmd1.NPU_SET_OFM_STRIDE_X),
905 cmd0.NPU_SET_OFM_ZERO_POINT,
906 ),
907 ):
908
Diego Russoea6111a2020-04-14 18:41:58 +0100909 if tens is None:
Tim Hall79d07d22020-04-27 18:20:16 +0100910 continue
911
Jacob Bohlin9fbc4912020-06-29 11:58:50 +0200912 need_zero_point = (faf is not None) or (fmf == "ConcatSliceWrite") or fused_quantize
Tim Hall79d07d22020-04-27 18:20:16 +0100913 if (
Fredrik Svedberg237d72d2020-08-28 18:12:28 +0200914 (
915 primary_op.type in set(("AvgPool", "AvgPoolAct", "ResizeBilinear", "CLZ", "SHL"))
916 and not need_zero_point
917 )
918 or (
919 tens.dtype == DataType.int32
920 and zero_point_op in (cmd0.NPU_SET_IFM_ZERO_POINT, cmd0.NPU_SET_IFM2_ZERO_POINT)
921 )
922 or tens.quantization is None
923 ):
Tim Hall79d07d22020-04-27 18:20:16 +0100924 # Actual integer operation, just set scale to 1 and zero point to 0
925 emit.cmd0_with_param(zero_point_op, 0)
926 else:
927 assert tens.quantization.zero_point is not None, "need an actual zero point set"
Louis Verhaardd7911c42020-08-25 13:36:41 +0200928 if cmd0.NPU_SET_OFM_ZERO_POINT == zero_point_op and forced_ofm_quantization is not None:
929 zero_point = forced_ofm_quantization.zero_point
930 elif (
Charles Xu9a03fdf2020-07-02 15:12:40 +0200931 "resizebilinear" in primary_op.attrs
932 and primary_op.type == "AddAct"
933 and cmd0.NPU_SET_OFM_ZERO_POINT == zero_point_op
934 ):
935 # Force output zero point same as the input zero point
Louis Verhaardd7911c42020-08-25 13:36:41 +0200936 # for resizebilinear 1x1 that is converted to add
Charles Xu9a03fdf2020-07-02 15:12:40 +0200937 zero_point = cmd.ifm2_tensor.quantization.zero_point
938 else:
939 zero_point = tens.quantization.zero_point
940 emit.cmd0_with_param(zero_point_op, int(zero_point))
Tim Hall79d07d22020-04-27 18:20:16 +0100941
942 if tens.shape == []:
943 # Empty shape, elementwise constant
Louis Verhaardc88a96f2020-06-10 09:04:33 +0200944 ifm2_scalar = tens.quant_values
Tim Hall79d07d22020-04-27 18:20:16 +0100945 assert ifm2_scalar.size == 1
Louis Verhaardc88a96f2020-06-10 09:04:33 +0200946 emit.cmd0_with_param(cmd0.NPU_SET_IFM2_SCALAR, int(ifm2_scalar.item(0)))
Tim Hall79d07d22020-04-27 18:20:16 +0100947 continue
948
949 height_0, height_1, width_0, addresses = tens.addresses_for_rolling_buffer(
950 box.start_coord, box.end_coord
951 )
952 if npu_block_type != NpuBlockType.VectorProduct:
953 if tens == cmd.ifm_tensor:
954 emit.cmd0_with_param(cmd0.NPU_SET_IFM_HEIGHT0_M1, height_0 - 1)
955 emit.cmd0_with_param(cmd0.NPU_SET_IFM_HEIGHT1_M1, height_1 - 1)
956 emit.cmd0_with_param(cmd0.NPU_SET_IFM_WIDTH0_M1, width_0 - 1)
957 elif tens == cmd.ofm_tensor:
958 emit.cmd0_with_param(cmd0.NPU_SET_OFM_HEIGHT0_M1, height_0 - 1)
959 emit.cmd0_with_param(cmd0.NPU_SET_OFM_HEIGHT1_M1, height_1 - 1)
960 emit.cmd0_with_param(cmd0.NPU_SET_OFM_WIDTH0_M1, width_0 - 1)
Louis Verhaard0cf06c72020-05-12 08:31:05 +0200961 if tens == cmd.ifm2_tensor:
Tim Hall79d07d22020-04-27 18:20:16 +0100962 emit.cmd0_with_param(cmd0.NPU_SET_IFM2_HEIGHT0_M1, height_0 - 1)
963 emit.cmd0_with_param(cmd0.NPU_SET_IFM2_HEIGHT1_M1, height_1 - 1)
964 emit.cmd0_with_param(cmd0.NPU_SET_IFM2_WIDTH0_M1, width_0 - 1)
965 else:
966 if len(out_shape) == 2:
967 # TODO: N is put in W-dimension for now
968 # Should be spread over H and W, but then block size selectetion,
969 # and stride calculation should be changed
970 if tens == cmd.ifm_tensor:
971 emit.cmd0_with_param(cmd0.NPU_SET_IFM_WIDTH0_M1, out_shape[-2] - 1)
972 elif tens == cmd.ofm_tensor:
973 emit.cmd0_with_param(cmd0.NPU_SET_OFM_WIDTH0_M1, out_shape[-2] - 1)
974 else:
975 assert False
976
Patrik Gustavssoneca2e952020-05-27 09:15:11 +0200977 emit.cmd0_with_param(region_op, base_ptr_idx_map[tens.mem_type])
Jacob Bohlin3c678292020-04-27 10:27:25 +0200978
Tim Hall79d07d22020-04-27 18:20:16 +0100979 for idx, addr in enumerate(addresses):
980 if addr is None:
981 addresses[idx] = 0
982
983 emit.cmd1_with_offset(ptr_ops[0], addresses[0])
984 emit.cmd1_with_offset(ptr_ops[1], addresses[1])
985 emit.cmd1_with_offset(ptr_ops[2], addresses[2])
986 emit.cmd1_with_offset(ptr_ops[3], addresses[3])
987
988 strides = tens.get_strides()
989 emit.cmd1_with_offset(stride_ops[0], strides[1]) # stride between 16-byte channel blocks (C)
990 emit.cmd1_with_offset(stride_ops[2], strides[3]) # stride between horisontal values (W)
991 emit.cmd1_with_offset(stride_ops[1], strides[2]) # stride between vertical values (H)
992
993 if tens.format == TensorFormat.NHCWB16:
994 # Check that all BasePointer addresses are aligned to 16 bytes
995 assert (int(addresses[0]) % 16) == 0
996 assert (int(addresses[1]) % 16) == 0
997 assert (int(addresses[2]) % 16) == 0
998 assert (int(addresses[3]) % 16) == 0
999
1000 ofm_dtype = cmd.ofm_tensor.dtype
1001 assert ofm_dtype.type & BaseType.Int
1002 prec = 0
1003 if ofm_dtype.size_in_bits() == 8:
1004 prec = 0
1005 elif ofm_dtype.size_in_bits() == 16:
1006 prec = 2
Fredrik Svedberga0c36242020-06-03 15:43:31 +02001007 elif ofm_dtype.size_in_bits() == 32:
1008 prec = 4
Tim Hall79d07d22020-04-27 18:20:16 +01001009 else:
1010 assert 0
1011
1012 if ofm_dtype.type & BaseType.Signed:
1013 prec += 1
1014
1015 if use_global_scale:
1016 # Set global scale bit, as opposed to using per channel scale
1017 prec |= 1 << 8
1018
1019 if cmd.ofm_tensor.format == TensorFormat.NHCWB16:
1020 prec |= 1 << 6
1021
1022 prec |= rounding_mode.value << 14
1023
1024 emit.cmd0_with_param(cmd0.NPU_SET_OFM_PRECISION, prec)
1025
1026 prec = None
1027 weight_bits = 8
1028 if cmd.weight_tensor is not None:
1029 weight_bits = cmd.weight_tensor.dtype.size_in_bits()
1030
1031 ifm_dtype = cmd.ifm_tensor.dtype
1032
1033 assert weight_bits == 8, "Unsupported weight bit depth"
Fredrik Svedberga0c36242020-06-03 15:43:31 +02001034 assert (
1035 ifm_dtype.size_in_bits() in {8, 16}
1036 or ifm_dtype.size_in_bits() == 32
1037 and npu_block_type in (NpuBlockType.ElementWise, NpuBlockType.ReduceSum)
1038 ), "Unsupported ifm bit depth"
Tim Hall79d07d22020-04-27 18:20:16 +01001039
1040 if ifm_dtype.size_in_bits() == 8:
1041 if ifm_dtype.type & BaseType.Signed:
Diqing Zhongfed918b2020-04-27 10:27:34 +02001042 prec = ifm_precision.S8
Tim Hall79d07d22020-04-27 18:20:16 +01001043 else:
Diqing Zhongfed918b2020-04-27 10:27:34 +02001044 prec = ifm_precision.U8
Tim Hall79d07d22020-04-27 18:20:16 +01001045 elif ifm_dtype.size_in_bits() == 16:
1046 if ifm_dtype.type & BaseType.Signed:
Diqing Zhongfed918b2020-04-27 10:27:34 +02001047 prec = ifm_precision.S16
Tim Hall79d07d22020-04-27 18:20:16 +01001048 else:
Diqing Zhongfed918b2020-04-27 10:27:34 +02001049 prec = ifm_precision.U16
Fredrik Svedberga0c36242020-06-03 15:43:31 +02001050 elif ifm_dtype == DataType.int32:
1051 prec = ifm_precision.S32
Tim Hall79d07d22020-04-27 18:20:16 +01001052
1053 ifm_prec = prec.value
1054 ifm2_prec = ifm_prec
1055
1056 if cmd.ifm_tensor.format == TensorFormat.NHCWB16:
1057 ifm_prec |= 1 << 6
1058
1059 ifm_prec |= op_to_scale << 8
1060
1061 emit.cmd0_with_param(cmd0.NPU_SET_IFM_PRECISION, ifm_prec)
1062
1063 if cmd.ifm2_tensor is not None:
1064 if cmd.ifm2_tensor.format == TensorFormat.NHCWB16:
1065 ifm2_prec |= 1 << 6
1066 emit.cmd0_with_param(cmd0.NPU_SET_IFM2_PRECISION, ifm2_prec)
1067
Tim Hall79d07d22020-04-27 18:20:16 +01001068 # Get op parameters
1069 cur_ifm_block_depth = get_op_ifmofm_block_depth(arch, cmd)
1070 cur_ofm_block = Block(ps.block_config[1], ps.block_config[0], ps.block_config[3])
1071 cur_ofm_rect = get_op_ofm_rect(cmd)
1072 cur_ifm_rect = get_op_ifm_rect(cmd)
Tim Hall79d07d22020-04-27 18:20:16 +01001073 cur_padLT = get_op_padding_lt(cmd)
1074 if (prev_kernel is not None) and (cur_kernel is not None) and has_prev_op_dependency(prev_cmd, cmd):
1075 if cmd.ifm_tensor.shape == prev_cmd.ofm_tensor.shape:
1076 blockdep = arch.calc_block_dep(
1077 prev_ifm_rect,
1078 prev_ofm_rect,
1079 prev_ifm_block_depth,
1080 prev_ofm_block,
1081 prev_kernel,
1082 cur_ifm_rect,
1083 cur_ofm_rect,
1084 cur_ifm_block_depth,
1085 cur_ofm_block,
1086 cur_kernel,
1087 cur_padLT,
1088 )
1089 else:
1090 blockdep = 0
1091 else:
1092 blockdep = ArchitectureFeatures.MAX_BLOCKDEP
1093
1094 # Set between every op (dependent or not)
1095 blockdep = min(blockdep, arch.max_blockdep)
1096 emit.cmd0_with_param(cmd0.NPU_SET_BLOCKDEP, blockdep)
1097 prev_cmd = cmd
1098
Tim Hall289a41d2020-08-04 21:40:14 +01001099 emit_cmd_waits(cmd_waits)
1100
Tim Hall79d07d22020-04-27 18:20:16 +01001101 if npu_block_type == NpuBlockType.ConvolutionMxN:
1102 emit.cmd_do_operation(cmd0.NPU_OP_CONV)
1103 elif npu_block_type == NpuBlockType.ConvolutionDepthWise:
1104 emit.cmd_do_operation(cmd0.NPU_OP_DEPTHWISE)
1105 elif npu_block_type == NpuBlockType.VectorProduct:
1106 # Vector product is implemented using a 1x1 convolution
1107 emit.cmd_do_operation(cmd0.NPU_OP_CONV)
1108 elif npu_block_type == NpuBlockType.Pooling:
Fredrik Svedberga0c36242020-06-03 15:43:31 +02001109 param = pooling_mode.MAX.value if "Max" in primary_op.type else pooling_mode.AVERAGE.value
Tim Hall79d07d22020-04-27 18:20:16 +01001110 emit.cmd_do_operation(cmd0.NPU_OP_POOL, param=param)
Fredrik Svedberga0c36242020-06-03 15:43:31 +02001111 elif npu_block_type == NpuBlockType.ReduceSum:
1112 emit.cmd_do_operation(cmd0.NPU_OP_POOL, param=pooling_mode.REDUCE_SUM.value)
Tim Hall79d07d22020-04-27 18:20:16 +01001113 elif npu_block_type == NpuBlockType.ElementWise:
1114 param = elementwise_mode_map[primary_op.type]
1115 emit.cmd_do_operation(cmd0.NPU_OP_ELEMENTWISE, param)
1116 else:
1117 print("Warning: Skipping register command stream generation for", ps)
1118
1119 # Fill in final part of command stream:
1120 emit.cmd_do_operation(cmd0.NPU_OP_STOP, param=0xFFFF)
1121
1122 sg.register_command_stream = emit.to_list()
1123 if verbose:
1124 emit.print_cmds()
1125 print("number of commands", len(emit.cmd_stream))
1126 print("command stream length in words", len(sg.register_command_stream))