Formulas Mapping¶
EnOS provides a set of formulas to process the collection and control points collected from or sent to the device. Edge then maps the processed points to the predefined measurement points in a model.
Features¶
The list of formulas is given as follows. Measurement points in the list are represented by y, while the collection and control points are represented by x(i), where i represents the order in which the points are collected.
| Formula Name | Description | Format in Template |
|---|---|---|
| NO_MAPPING | Do not map this measurement point to any collection or control point. | no_mapping |
| EQUAL | The value of the measurement point is equal to the value of the collection or control point, i.e. y=x | x |
| SUM | Sum up the value of all the collection points to be the measurement point y=x(1)+x(2)+…+x(i) | sum(X1,X2,…Xn) |
| SUBTRACTION | Substract one collection point from the other. | subtraction(a,b) |
| PRODUCT | Multiply the value of all the collection points to be the measurement point. You can configure an optional coefficient. y=a * x(1) * x(2) * … * x(i) * | product(X1,X2,…Xn,Coefficient a) |
| CROSS_PRODUCT | Calculate the inner product of all the collection points to be the measurement point. You can configure an optional coefficient (i.e. “Operand” parameter). Note that the order in which the collection points are collected is very important. y=a(x(1) * x(2)+x(3) * x(4)+…+x(i-1) * x(i) | cross_product(X1,X2,…Xn, Operator a) |
| RATIO | Calculate the ratio of two collection points to be the measurement point. Note that the order in which the collection points are collected is very important. y=x(1)/x(2) | ratio(Dividend, devisor) |
| LOGICAL_OR | Calculate multiple DI collection points with logical AND operation. | logical_or(X1,X2,…Xn) |
| LOGICAL_AND | Calculate multiple DI collection points with XOR operation. | logical_and(X1,X2,…Xn) |
| XOR | Perform the logical AND calculation for the collection points to be the measurement point. y=(x(1)|x(2)|…|x(i)) | Xor(X1,X2,…Xn) |
| RATIO_AGAINST_SUM | Perform the following calculation for three collection points to be the measurement point. y=x(1)/(x(2)+x(3)) | ratio_against_sum(a,b,c) |
| BIT_N | Take a specified bit out of an AI collection point and copy the bit to a measurement point together with an operand parameter indicating the location of the bit. For example, an operand of 0 indicates that the AI collection point taken is located at the first bit, and an operand of 15 indicates that the AI collection point taken is located at the 16th bit. | bit_n(X, Operator n) |
| BITS_M_TO_N | Consecutive multi-bit assignment formula, i.e. take multiple consecutive bits of an AI collection point and assign them to another measurement point together with 2 parameters: operand M (end bit) and operand N (start bit), M>N. For example, if M=7 and N=0, it means taking the 1st to the 8th bit of the collection point and assigning it to the new model point. | bits_m_to_n(X, Operator m, Operator n) |
| IF_EQUAL | Involve 3 operands. Operand 1 = a, operand 2 = b, operand 3 = c. The calculation is: if x == a, then y== b, else y==c. | if_equal(X1,b,c) |
| IF_RANGE | The input measurement point is named value and the four operators are A B C D. The operation logic is: if value >=B then return D; if value>A && value< B then return C. Else, return value. | if_range(X,a,b,c,d) |
| MULTICHANNEL | Map multiple collection points respectively to each component of an array. That is, y is an array: y={y[1], y[2], …, y[i]}, and y[1]=x(1), y[2]=x(2), …, y[i]=x(i), i<=32 | Formula not supported |
| CONNECT_STATE | The state of the device, which must be collected. | connect_state |
| MULTIBIT | y is an int32 array, and y={y[1],y[2]…,y[i]}, where: y[1].bit0=x(1).bit0, y[1].bit1=x(2).bit0, …, y[1].bit31=x(32).bit0, y[2].bit0=x(33).bit0, y[2].bit1=x(34).bit0, …, y[2].bit31=x(64).bit0, …, y[i].bit0=x(32(i-1)+1).bit0, y[i].bit1=x(32(i-1)+2).bit0, …, y[i].bit31=x(32(i-1)+32).bit0, i<=32 | Formula not supported |
| MULTICHANNERL_SHORTTOINT | Multiple AI collection points of short type is converted to INT32 arrays. | Formula not supported |
| ENUM_N | Map the collection points according to the ENUM type defined based on the model definition. | Formula not supported |
Formula Applicable To Non-array Measurement Points¶
- NO_MAPPING
- INVALID
- EQUAL
- SUM
- PRODUCT
- CROSS_PRODUCT
- RATIO
- LOGICAL_OR
- RATION_AGAINST_SUM
- BIT_N
- BITS_M_TO_N
- IF_EQUAL
Formula Applicable To Array Measurement Points¶
- NO_MAPPING
- INVALID
- EQUAL
- MULTICHANNEL
- MULTIBIT