FixPt Bitwise Operator

Perform the specified bitwise operation on the inputs.

Description

The FixPt Bitwise Operator block is a masked S-function that performs the specified bitwise operation on its operands.

Unlike the logic operations performed by the FixPt Logical Operator block, bitwise operations treat the operands as a vector of bits rather than a single number. You select the bitwise Boolean operation with the Operator parameter list. The supported operations are given below.

Operation

Description

AND

TRUE if the corresponding bits are all TRUE

OR

TRUE if at least one of the corresponding bits is TRUE

NAND

TRUE if at least one of the corresponding bits is FALSE

NOR

TRUE if no corresponding bits are TRUE

XOR

TRUE if an odd number of corresponding bits are TRUE

NOT

TRUE if the input is FALSE (available only for single input)


Unlike Simulink's Bitwise Logical Operator block, the FixPt Bitwise Operator block does not support shift operations. Refer to Shifts to learn how to perform shift operations with the Fixed-Point Blockset.
The size of the output depends on the number of inputs, their vector size, and the selected operator:

  • The NOT operator accepts only one input, which can be a scalar or a vector. If the input is a vector, the output is a vector of the same size containing the bitwise logical complements of the input vector elements.

  • For a single vector input, the block applies the operation (except the NOT operator) to all elements of the vector. If a bit mask is not specified, then the output is a scalar. If a bit mask is specified, then the output is a vector.

  • For two or more inputs, the block performs the operation between all of the inputs. If the inputs are vectors, the operation is performed between corresponding elements of the vectors to produce a vector output.

When configured as a multi-input XOR gate, this block performs an addition- modulo-two operation as mandated by the IEEE Standard for Logic Elements.

If the Use bit mask check box is not checked, then the block can accept multiple inputs. You select the number of input ports with the Number of input ports parameter. The input data types must be identical.

If the Use bit mask check box is checked, then a single input is associated with the bit mask you specify with the Bit mask parameter. You specify the bit mask using any valid MATLAB expression. For example, you can specify the bit mask 00100101 as 2^5+2^2+2^0. Alternatively, you can use strings to specify a hexadecimal bit mask such as {'FE73','12AC'}. If the bit mask is larger than the input signal data type, then it is ignored. 

The output data type, which is inherited from the driving block, should represent zero exactly. Data types that satisfy this condition include signed and unsigned integers and any floating-point data type.

The Treat mask as parameter list controls how the mask is treated. The possible values are Real World Value and Stored Integer. In terms of the general encoding scheme described in Scaling, Real World Value treats the mask as V = SQ + B where S is the slope and B is the bias. Stored Integer treats the mask as a stored integer, Q. For more information about this parameter list, refer to the FixPt Gateway In block.

Remarks

You can use the bit mask to perform a bit set or a bit clear on the input. To perform a bit set, you configure the Operator parameter list to OR and create a bit mask with a 1 for each corresponding input bit that you want to set to 1. To perform a bit clear, you configure the Operator parameter list to AND and create a bit mask with a 0 for each corresponding input bit that you want to set to 0.

For example, suppose you want to perform a bit set on the fourth bit of an 8-bit input vector. The bit mask would be 00010000, which you can specify as 2^4in the Bit mask parameter. To perform a bit clear, the bit mask would be 11101111, which you can specify as 2^7+2^6+2^5+2^3+2^2+2^1+2^0 in the Bit mask parameter.

Parameters and Dialog Box

  • Operator - The bitwise logical operator associated with the specified operands.

  • Use bit mask - Specify if the bit mask is used (single input only).

  • Number of input ports - The number of inputs.

  • Bit mask - The bit mask to associate with a single input.

  • Treat mask as - Treat the mask as a real-world value or as an integer.

Conversions

The Bit mask parameter is converted from a double to the input data type offline using round-to-nearest and saturation. Refer to Parameter Conversions for more information about parameter conversions.

Example

To help you understand the FixPt Bitwise Operator block logic operations, consider the fixed-point model shown below.

The Fixpt Constant blocks are configured to output an 8-bit unsigned integer (uint(8)). The results for all logic operations are shown below.

Operation

Binary Value

Decimal Value

AND

00101000

40

OR

11111101

253

NAND

11010111

215

NOR

00000010

2

XOR

11111000

248

NOT

N/A

N/A

Characteristics

Input Port

Any data type supported by the blockset

Output Port 

Same as the input

Direct Feedthrough

No

Sample Time

Inherited by driving block

Scalar Expansion

Of inputs

States

0

Vectorized

Yes