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 | It is not recommended to import and export configuration through the mapping table. If necessary, you can copy and fill in the export format after a single configuration |
| MULTICHANNERL_SHORTTOINT | Multiple AI collection points of short type is converted to INT32 arrays. | It is not recommended to import and export configuration through the mapping table. If necessary, you can copy and fill in the export format after a single configuration |
| ENUM_N | Map the collection points according to the ENUM type defined based on the model definition. | It is not recommended to import and export configuration through the mapping table. If necessary, you can copy and fill in the export format after a single configuration |
| REPLACE_N | Replace collection point values with different model point values, and send them to the cloud | It is not recommended to import and export configuration through the mapping table. If necessary, you can copy and fill in the export format after a single configuration |
| CONTROL_SET_N | Send control values to the selected control point i.e. y=x | x |
| CONTROL_ENUM_N | Enum parameters of enum model points are replaced with different control point values, and send them to the cloud | It is not recommended to import and export configuration through the mapping table. If necessary, you can copy and fill in the export format after a single configuration |
| CONTROL_RELACE_N | Model point values are replaced with different control point values, and send them to the device | It is not recommended to import and export configuration through the mapping table. If necessary, you can copy and fill in the export format after a single configuration |
| CONTROL_BITS_M_TO_N | The control value is sent to the specified bit interval of the selected control point | It is not recommended to import and export configuration through the mapping table. If necessary, you can copy and fill in the export format after a single configuration |
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
- REPLACE_N
- CONTROL_RELACE_N
- CONTROL_BITS_M_TO_N
Formula Applicable To Array Measurement Points¶
- NO_MAPPING
- INVALID
- EQUAL
- MULTICHANNEL
- MULTIBIT
- MULTICHANNERL_SHORTTOINT
Formula Applicable To ENUM Measurement Points¶
- ENUM_N
- CONTROL_ENUM_N