Skip to content

BOM Pre-Check#

From SMT Template version 3.2.0 onwards

Overview#

This feature compares the ASM Recipe component data by comparing it with the material BOM existing in MES.

How it works#

This feature compares the data supplied by ASM in RecipeDetails object (via SiplacePro.Event.RecipeDetails event) against the material BOM existing in MES, for validation purposes.

The RecipeDetails object is requested by OIB Automation Controller, when the panel is entering the equipment. After the relevant information is parsed, it is sent as input for the service ValidatePlacementList for comparison against the current BOM material.

For more information about ValidatePlacementList check here.

At ASM RecipeDetails, example below, within the PlacementLists section the ComponentName value is mapped to item Product in MES BOM and each ReferenceDesignator should be added to the corresponding item Designator.

Show Recipe Details Example 
(...)
    "Boards": [
        {
            "FullPath": "SMTTemplate\\SMT_Product",
            "BoardSide": "Top",
            "PlacementLists": [
                {
                    "PlacementListFullPath": "Demo Placement Lists\\Copy of Placement List ASM Simple Product[4868]",
                    "ClusterName": "Cluster 9",
                    "ComponentPlacements": [
                        {
                            "ReferenceDesignator": "C3",
                            "ComponentName": "0201R",
                            "ComponentFullPath": "Demo Components\\0201R",
                            "ComponentShapeFullPath": "Demo Component Shapes\\98",
                            "OffsetX": 1.0,
                            "OffsetY": 8.0,
                            "Angle": 1.570796326794897,
                            "Level": 0,
                            "Omit": false,
                            "Exclusive": false,
                            "Glue": false,
                            "AlternativeComponents": []
                        },
                        {
                            "ReferenceDesignator": "C1",
                            "ComponentName": "0201R",
                            "ComponentFullPath": "Demo Components\\0201R",
                            "ComponentShapeFullPath": "Demo Component Shapes\\98",
                            "OffsetX": 1.0,
                            "OffsetY": 1.0,
                            "Angle": 1.570796326794897,
                            "Level": 0,
                            "Omit": false,
                            "Exclusive": false,
                            "Glue": false,
                            "AlternativeComponents": []
                        },
                        {
                            "ReferenceDesignator": "C5",
                            "ComponentName": "SOT23",
                            "ComponentFullPath": "Demo Components\\SOT23",
                            "ComponentShapeFullPath": "Demo Component Shapes\\400",
                            "OffsetX": 4.5,
                            "OffsetY": 4.5,
                            "Angle": 0.0,
                            "Level": 0,
                            "Omit": false,
                            "Exclusive": false,
                            "Glue": false,
                            "AlternativeComponents": [
                                {
                                    "Name": "SMT_Component_3",
                                    "FullPath": "Demo Components\\SMT_Component_3"
                                }
                            ]
                        },
                        {
                            "ReferenceDesignator": "C4",
                            "ComponentName": "0201R",
                            "ComponentFullPath": "Demo Components\\0201R",
                            "ComponentShapeFullPath": "Demo Component Shapes\\98",
                            "OffsetX": 8.0,
                            "OffsetY": 8.0,
                            "Angle": 1.570796326794897,
                            "Level": 0,
                            "Omit": false,
                            "Exclusive": false,
                            "Glue": false,
                            "AlternativeComponents": []
                        },
                        {
                            "ReferenceDesignator": "C2",
                            "ComponentName": "0201R",
                            "ComponentFullPath": "Demo Components\\0201R",
                            "ComponentShapeFullPath": "Demo Component Shapes\\98",
                            "OffsetX": 8.0,
                            "OffsetY": 1.0,
                            "Angle": 1.5707963267949,
                            "Level": 0,
                            "Omit": false,
                            "Exclusive": false,
                            "Glue": false,
                            "AlternativeComponents": []
                        }
                    ]
                }
            ]
        }
    ]
    (...)

The Automation Controller will parse this event and send a list of Reference Designators with the corresponding Products, retrieving from PlacementList the main ComponentName property and AlternativeComponents list.

Placement List 
    PlacementLists: '[
    {
        "ReferenceDesignator": "C3",
        "ComponentNames": [
        "0201R"
        ]
    },
    {
        "ReferenceDesignator": "C1",
        "ComponentNames": [
        "0201R"
        ]
    },
    {
        "ReferenceDesignator": "C5",
        "ComponentNames": [
        "SOT23",
        "SMT_Component_3"
        ]
    },
    {
        "ReferenceDesignator": "C4",
        "ComponentNames": [
        "0201R"
        ]
    },
    {
        "ReferenceDesignator": "C2",
        "ComponentNames": [
        "0201R"
        ]
    }
    ]'

Persistency Handling#

After the first successful validation of the BOM, a key named BomValidated_<Resource Name> will be stored in persistency with the value true. This allows subsequent requests to bypass validation until a new recipe is downloaded to the equipment.

If you need to trigger a new validation on the next board request event, you can send a message bus message to the Area configured for the OIB Controller. Use the action group SMT.IoT.Utilities.ResetPreBomValidation and include the ResourceName in the message body.

Show DEE Example 
UseReference("", "Cmf.Foundation.Common.Exceptions");
UseReference("Cmf.Foundation.BusinessObjects.dll", "Cmf.Foundation.BusinessObjects");
UseReference("Cmf.Foundation.BusinessOrchestration.dll", "");
UseReference("", "Cmf.Foundation.Common.Exceptions");
UseReference("", "Cmf.Foundation.Common");
UseReference("Cmf.Navigo.BusinessObjects.dll", "Cmf.Navigo.BusinessObjects");

var serviceProvider = (IServiceProvider)Input["ServiceProvider"];
IArea area = serviceProvider.GetService<IArea>();
area.Name = "SMT_Production Line";
area.Load();

var instance = area.GetAutomationControllerInstance();
if (instance == null)
{
    throw new Exception("Area not connected to any IoT instance");
}
else
{
    var args = new
    {
        ResourceName = "SMT_Pick_Place_1"
    };

    instance.Publish("SMT.IoT.Utilities.ResetPreBomValidation", args.ToJsonString());
}