/****************************************************************************** * * Copyright (c) 2019 Intel. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * *******************************************************************************/ /** * @brief xRAN BFP compression/decompression utilities functions * * @file xran_bfp_utils.hpp * @ingroup group_source_xran * @author Intel Corporation **/ #pragma once #include namespace BlockFloatCompander { /// Define function signatures for byte packing functions typedef __m512i(*PackFunction)(const __m512i); typedef __m512i(*UnpackFunction)(const uint8_t*); typedef __m256i(*UnpackFunction256)(const uint8_t*); /// Calculate exponent based on 16 max abs values using leading zero count. inline __m512i maskUpperWord(const __m512i inData) { const auto k_upperWordMask = _mm512_set_epi64(0x0000FFFF0000FFFF, 0x0000FFFF0000FFFF, 0x0000FFFF0000FFFF, 0x0000FFFF0000FFFF, 0x0000FFFF0000FFFF, 0x0000FFFF0000FFFF, 0x0000FFFF0000FFFF, 0x0000FFFF0000FFFF); return _mm512_and_epi64(inData, k_upperWordMask); } /// Calculate exponent based on 16 max abs values using leading zero count. inline __m512i expLzCnt(const __m512i maxAbs, const __m512i totShiftBits) { /// Compute exponent const auto lzCount = _mm512_lzcnt_epi32(maxAbs); return _mm512_subs_epu16(totShiftBits, lzCount); } inline int horizontalMax1x32(const __m512i maxAbsReg) { /// Swap each IQ pair in each lane (via 32b rotation) and compute max of /// each pair. const auto maxRot16 = _mm512_rol_epi32(maxAbsReg, BlockFloatCompander::k_numBitsIQ); const auto maxAbsIQ = _mm512_max_epi16(maxAbsReg, maxRot16); /// Convert to 32b by removing repeated values in maxAbs const auto maxAbs32 = maskUpperWord(maxAbsIQ); /// Return reduced max return _mm512_reduce_max_epi32(maxAbs32); } /// Pack compressed 9 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 inline __m512i networkBytePack9b(const __m512i compData) { /// Logical shift left to align network order byte parts const __m512i k_shiftLeft = _mm512_set_epi64(0x0000000100020003, 0x0004000500060007, 0x0000000100020003, 0x0004000500060007, 0x0000000100020003, 0x0004000500060007, 0x0000000100020003, 0x0004000500060007); const auto compDataPacked = _mm512_sllv_epi16(compData, k_shiftLeft); /// First epi8 shuffle of even indexed samples const __m512i k_byteShuffleMask1 = _mm512_set_epi64(0x0000000000000000, 0x0C0D080904050001, 0x0000000000000000, 0x0C0D080904050001, 0x0000000000000000, 0x0C0D080904050001, 0x0000000000000000, 0x0C0D080904050001); constexpr uint64_t k_byteMask1 = 0x00FF00FF00FF00FF; const auto compDataShuff1 = _mm512_maskz_shuffle_epi8(k_byteMask1, compDataPacked, k_byteShuffleMask1); /// Second epi8 shuffle of odd indexed samples const __m512i k_byteShuffleMask2 = _mm512_set_epi64(0x000000000000000E, 0x0F0A0B0607020300, 0x000000000000000E, 0x0F0A0B0607020300, 0x000000000000000E, 0x0F0A0B0607020300, 0x000000000000000E, 0x0F0A0B0607020300); constexpr uint64_t k_byteMask2 = 0x01FE01FE01FE01FE; const auto compDataShuff2 = _mm512_maskz_shuffle_epi8(k_byteMask2, compDataPacked, k_byteShuffleMask2); /// Ternary blend of the two shuffled results const __m512i k_ternLogSelect = _mm512_set_epi64(0x00000000000000FF, 0x01FC07F01FC07F00, 0x00000000000000FF, 0x01FC07F01FC07F00, 0x00000000000000FF, 0x01FC07F01FC07F00, 0x00000000000000FF, 0x01FC07F01FC07F00); return _mm512_ternarylogic_epi64(compDataShuff1, compDataShuff2, k_ternLogSelect, 0xd8); } /// Pack compressed 10 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 inline __m512i networkBytePack10b(const __m512i compData) { /// Logical shift left to align network order byte parts const __m512i k_shiftLeft = _mm512_set_epi64(0x0000000200040006, 0x0000000200040006, 0x0000000200040006, 0x0000000200040006, 0x0000000200040006, 0x0000000200040006, 0x0000000200040006, 0x0000000200040006); const auto compDataPacked = _mm512_sllv_epi16(compData, k_shiftLeft); /// First epi8 shuffle of even indexed samples const __m512i k_byteShuffleMask1 = _mm512_set_epi64(0x000000000000000C, 0x0D08090004050001, 0x000000000000000C, 0x0D08090004050001, 0x000000000000000C, 0x0D08090004050001, 0x000000000000000C, 0x0D08090004050001); constexpr uint64_t k_byteMask1 = 0x01EF01EF01EF01EF; const auto compDataShuff1 = _mm512_maskz_shuffle_epi8(k_byteMask1, compDataPacked, k_byteShuffleMask1); /// Second epi8 shuffle of odd indexed samples const __m512i k_byteShuffleMask2 = _mm512_set_epi64(0x0000000000000E0F, 0x0A0B000607020300, 0x0000000000000E0F, 0x0A0B000607020300, 0x0000000000000E0F, 0x0A0B000607020300, 0x0000000000000E0F, 0x0A0B000607020300); constexpr uint64_t k_byteMask2 = 0x03DE03DE03DE03DE; const auto compDataShuff2 = _mm512_maskz_shuffle_epi8(k_byteMask2, compDataPacked, k_byteShuffleMask2); /// Ternary blend of the two shuffled results const __m512i k_ternLogSelect = _mm512_set_epi64(0x000000000000FF03, 0xF03F00FF03F03F00, 0x000000000000FF03, 0xF03F00FF03F03F00, 0x000000000000FF03, 0xF03F00FF03F03F00, 0x000000000000FF03, 0xF03F00FF03F03F00); return _mm512_ternarylogic_epi64(compDataShuff1, compDataShuff2, k_ternLogSelect, 0xd8); } /// Pack compressed 12 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 inline __m512i networkBytePack12b(const __m512i compData) { /// Logical shift left to align network order byte parts const __m512i k_shiftLeft = _mm512_set_epi64(0x0000000400000004, 0x0000000400000004, 0x0000000400000004, 0x0000000400000004, 0x0000000400000004, 0x0000000400000004, 0x0000000400000004, 0x0000000400000004); const auto compDataPacked = _mm512_sllv_epi16(compData, k_shiftLeft); /// First epi8 shuffle of even indexed samples const __m512i k_byteShuffleMask1 = _mm512_set_epi64(0x00000000000C0D00, 0x0809000405000001, 0x00000000000C0D00, 0x0809000405000001, 0x00000000000C0D00, 0x0809000405000001, 0x00000000000C0D00, 0x0809000405000001); constexpr uint64_t k_byteMask1 = 0x06DB06DB06DB06DB; const auto compDataShuff1 = _mm512_maskz_shuffle_epi8(k_byteMask1, compDataPacked, k_byteShuffleMask1); /// Second epi8 shuffle of odd indexed samples const __m512i k_byteShuffleMask2 = _mm512_set_epi64(0x000000000E0F000A, 0x0B00060700020300, 0x000000000E0F000A, 0x0B00060700020300, 0x000000000E0F000A, 0x0B00060700020300, 0x000000000E0F000A, 0x0B00060700020300); constexpr uint64_t k_byteMask2 = 0x0DB60DB60DB60DB6; const auto compDataShuff2 = _mm512_maskz_shuffle_epi8(k_byteMask2, compDataPacked, k_byteShuffleMask2); /// Ternary blend of the two shuffled results const __m512i k_ternLogSelect = _mm512_set_epi64(0x00000000FF0F00FF, 0x0F00FF0F00FF0F00, 0x00000000FF0F00FF, 0x0F00FF0F00FF0F00, 0x00000000FF0F00FF, 0x0F00FF0F00FF0F00, 0x00000000FF0F00FF, 0x0F00FF0F00FF0F00); return _mm512_ternarylogic_epi64(compDataShuff1, compDataShuff2, k_ternLogSelect, 0xd8); } /// Unpack compressed 9 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 inline __m512i networkByteUnpack9b(const uint8_t* inData) { /// Align chunks of compressed bytes into lanes to allow for expansion const __m512i* rawDataIn = reinterpret_cast(inData); const auto k_expPerm = _mm512_set_epi32(9, 8, 7, 6, 7, 6, 5, 4, 5, 4, 3, 2, 3, 2, 1, 0); const auto inLaneAlign = _mm512_permutexvar_epi32(k_expPerm, *rawDataIn); /// Byte shuffle to get all bits for each sample into 16b chunks /// Due to previous permute to get chunks of bytes into each lane, there is /// a different shuffle offset in each lane const __m512i k_byteShuffleMask = _mm512_set_epi64(0x0A0B090A08090708, 0x0607050604050304, 0x090A080907080607, 0x0506040503040203, 0x0809070806070506, 0x0405030402030102, 0x0708060705060405, 0x0304020301020001); const auto inDatContig = _mm512_shuffle_epi8(inLaneAlign, k_byteShuffleMask); /// Logical shift left to set sign bit const __m512i k_slBits = _mm512_set_epi64(0x0007000600050004, 0x0003000200010000, 0x0007000600050004, 0x0003000200010000, 0x0007000600050004, 0x0003000200010000, 0x0007000600050004, 0x0003000200010000); const auto inSetSign = _mm512_sllv_epi16(inDatContig, k_slBits); /// Mask to zero unwanted bits const __m512i k_expMask = _mm512_set1_epi16(0xFF80); return _mm512_and_epi64(inSetSign, k_expMask); } /// Unpack compressed 10 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 inline __m512i networkByteUnpack10b(const uint8_t* inData) { /// Align chunks of compressed bytes into lanes to allow for expansion const __m512i* rawDataIn = reinterpret_cast(inData); const auto k_expPerm = _mm512_set_epi32(10, 9, 8, 7, 8, 7, 6, 5, 5, 4, 3, 2, 3, 2, 1, 0); const auto inLaneAlign = _mm512_permutexvar_epi32(k_expPerm, *rawDataIn); /// Byte shuffle to get all bits for each sample into 16b chunks /// Due to previous permute to get chunks of bytes into each lane, lanes /// 0 and 2 happen to be aligned, but lane 1 is offset by 2 bytes const __m512i k_byteShuffleMask = _mm512_set_epi64(0x0A0B090A08090708, 0x0506040503040203, 0x0809070806070506, 0x0304020301020001, 0x0A0B090A08090708, 0x0506040503040203, 0x0809070806070506, 0x0304020301020001); const auto inDatContig = _mm512_shuffle_epi8(inLaneAlign, k_byteShuffleMask); /// Logical shift left to set sign bit const __m512i k_slBits = _mm512_set_epi64(0x0006000400020000, 0x0006000400020000, 0x0006000400020000, 0x0006000400020000, 0x0006000400020000, 0x0006000400020000, 0x0006000400020000, 0x0006000400020000); const auto inSetSign = _mm512_sllv_epi16(inDatContig, k_slBits); /// Mask to zero unwanted bits const __m512i k_expMask = _mm512_set1_epi16(0xFFC0); return _mm512_and_epi64(inSetSign, k_expMask); } /// Unpack compressed 12 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 inline __m512i networkByteUnpack12b(const uint8_t* inData) { /// Align chunks of compressed bytes into lanes to allow for expansion const __m512i* rawDataIn = reinterpret_cast(inData); const auto k_expPerm = _mm512_set_epi32(12, 11, 10, 9, 9, 8, 7, 6, 6, 5, 4, 3, 3, 2, 1, 0); const auto inLaneAlign = _mm512_permutexvar_epi32(k_expPerm, *rawDataIn); /// Byte shuffle to get all bits for each sample into 16b chunks /// For 12b mantissa all lanes post-permute are aligned and require same shuffle offset const __m512i k_byteShuffleMask = _mm512_set_epi64(0x0A0B090A07080607, 0x0405030401020001, 0x0A0B090A07080607, 0x0405030401020001, 0x0A0B090A07080607, 0x0405030401020001, 0x0A0B090A07080607, 0x0405030401020001); const auto inDatContig = _mm512_shuffle_epi8(inLaneAlign, k_byteShuffleMask); /// Logical shift left to set sign bit const __m512i k_slBits = _mm512_set_epi64(0x0004000000040000, 0x0004000000040000, 0x0004000000040000, 0x0004000000040000, 0x0004000000040000, 0x0004000000040000, 0x0004000000040000, 0x0004000000040000); const auto inSetSign = _mm512_sllv_epi16(inDatContig, k_slBits); /// Mask to zero unwanted bits const __m512i k_expMask = _mm512_set1_epi16(0xFFF0); return _mm512_and_epi64(inSetSign, k_expMask); } /// Unpack compressed 9 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 /// This unpacking function is for 256b registers inline __m256i networkByteUnpack9b256(const uint8_t* inData) { /// Align chunks of compressed bytes into lanes to allow for expansion const __m256i* rawDataIn = reinterpret_cast(inData); const auto k_expPerm = _mm256_set_epi32(5, 4, 3, 2, 3, 2, 1, 0); const auto inLaneAlign = _mm256_permutexvar_epi32(k_expPerm, *rawDataIn); /// Byte shuffle to get all bits for each sample into 16b chunks /// Due to previous permute to get chunks of bytes into each lane, there is /// a different shuffle offset in each lane const __m256i k_byteShuffleMask = _mm256_set_epi64x(0x0809070806070506, 0x0405030402030102, 0x0708060705060405, 0x0304020301020001); const auto inDatContig = _mm256_shuffle_epi8(inLaneAlign, k_byteShuffleMask); /// Logical shift left to set sign bit const __m256i k_slBits = _mm256_set_epi64x(0x0007000600050004, 0x0003000200010000, 0x0007000600050004, 0x0003000200010000); const auto inSetSign = _mm256_sllv_epi16(inDatContig, k_slBits); /// Mask to zero unwanted bits const __m256i k_expMask = _mm256_set1_epi16(0xFF80); return _mm256_and_si256(inSetSign, k_expMask); } /// Unpack compressed 10 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 /// This unpacking function is for 256b registers inline __m256i networkByteUnpack10b256(const uint8_t* inData) { /// Align chunks of compressed bytes into lanes to allow for expansion const __m256i* rawDataIn = reinterpret_cast(inData); const auto k_expPerm = _mm256_set_epi32(5, 4, 3, 2, 3, 2, 1, 0); const auto inLaneAlign = _mm256_permutexvar_epi32(k_expPerm, *rawDataIn); /// Byte shuffle to get all bits for each sample into 16b chunks /// Due to previous permute to get chunks of bytes into each lane, lanes /// 0 and 2 happen to be aligned, but lane 1 is offset by 2 bytes const __m256i k_byteShuffleMask = _mm256_set_epi64x(0x0A0B090A08090708, 0x0506040503040203, 0x0809070806070506, 0x0304020301020001); const auto inDatContig = _mm256_shuffle_epi8(inLaneAlign, k_byteShuffleMask); /// Logical shift left to set sign bit const __m256i k_slBits = _mm256_set_epi64x(0x0006000400020000, 0x0006000400020000, 0x0006000400020000, 0x0006000400020000); const auto inSetSign = _mm256_sllv_epi16(inDatContig, k_slBits); /// Mask to zero unwanted bits const __m256i k_expMask = _mm256_set1_epi16(0xFFC0); return _mm256_and_si256(inSetSign, k_expMask); } /// Unpack compressed 12 bit data in network byte order /// See https://soco.intel.com/docs/DOC-2665619 /// This unpacking function is for 256b registers inline __m256i networkByteUnpack12b256(const uint8_t* inData) { /// Align chunks of compressed bytes into lanes to allow for expansion const __m256i* rawDataIn = reinterpret_cast(inData); const auto k_expPerm = _mm256_set_epi32(6, 5, 4, 3, 3, 2, 1, 0); const auto inLaneAlign = _mm256_permutexvar_epi32(k_expPerm, *rawDataIn); /// Byte shuffle to get all bits for each sample into 16b chunks /// For 12b mantissa all lanes post-permute are aligned and require same shuffle offset const __m256i k_byteShuffleMask = _mm256_set_epi64x(0x0A0B090A07080607, 0x0405030401020001, 0x0A0B090A07080607, 0x0405030401020001); const auto inDatContig = _mm256_shuffle_epi8(inLaneAlign, k_byteShuffleMask); /// Logical shift left to set sign bit const __m256i k_slBits = _mm256_set_epi64x(0x0004000000040000, 0x0004000000040000, 0x0004000000040000, 0x0004000000040000); const auto inSetSign = _mm256_sllv_epi16(inDatContig, k_slBits); /// Mask to zero unwanted bits const __m256i k_expMask = _mm256_set1_epi16(0xFFF0); return _mm256_and_si256(inSetSign, k_expMask); } }