This is an old revision of the document!

This GEM Python host example uses the code generated from TransSECS using the Java/Javascript deployment option.

Most of the complexity is removed by the definitions you created in TransSECS.

The python wrapper uses the https://pypi.org/project/JPype1/ library to directly interface with the Java code.

Message notifications are received as JSON maps so that each of the published elements in the message are available directly.

For the host,copy the GEMHostRuntime.jar from the TransSECS GEMHost project into the build folder

The samples, even though simple, demonstrates all the features required of a tool and the ability to collect data from a host.

In the host code, publish variables you need to change in the interface, here the port, hostname, deviceid, etc. and subscribe to elements to receive data updates. Here an event (loaded) and to values (ppid and wafer count). The event is received as a JSON structure.

For example, to set the hostname, you publish to that variable:

    wrapper.publish_string("gemhost/configuration/equipmenthostname", "localhost").unwrap();

And Events (CEIDs) received as JSON Strings that contains the values configured in TransSECS. For example, a subscription to the “loaded” event might deliver a JSON string similar to this:

 { "LOADED": [  { "RPTID103": [ {"LOTID":"", "type":20 },{"PPID":"recipename", "type":20 },{"WaferCount":"1", "type":54 } ], "rptid":103} ], "ceid":7503, "timestamp":"2021-08-10 19:58:28.802"}

The sample code receives and unpacks that structure:

    wrapper.subscribe("gemhost/variables/ceid/loaded", |topic,value| {
        println!("Callback called on {}:", topic);
        if let Value::String(string_value) = value.value {
            // The ceid appears as a json object, which we can parse for example with serde_json
            let parsed:LoadedCeid = serde_json::from_str(&string_value).unwrap();
            // We'll just immediately reserialize the json to demonstrate that we have the fields
            println!("{}", serde_json::to_string_pretty(&parsed).unwrap());
        }
    }).unwrap();

The tool can subscribe to be notified of the change in value of any VID - used for ECIDs and GEM internal variables:

    wrapper.subscribe("gemhost/variables/vid/lotid", |topic,value| {
        println!("Callback called on {} with {:?}", topic, value)
    }).unwrap();

Here's the code sample from the rustwrapper archive:

#!/usr/bin/python3
import jpype
from jpype import JProxy
import jpype.imports
from jpype.types import *
 
jpype.startJVM(classpath=['.', '/home/colin/TransSECS_Servers_2/Projects/GEMHost/GEMHostDeployment/GEMHostRuntime.jar', '/home/colin/TransSECS_Servers_2/Projects/GEMHost/generatedjars/GEMHost.jar', '/home/colin/Documents/workspace-spring-tool-suite-4-4.2.2.RELEASE/MIStudio/vib/vib/lib/json-20190722.jar', '/home/colin/Documents/workspace-spring-tool-suite-4-4.2.2.RELEASE/MIStudio/classes'])
 
from com.ergotech.util import SimulationManager
from deploy.GEMHost import EquipmentController
 
import time
 
hostname =  "localhost"
port = 5010
deviceid = 1
 
SimulationManager.getSimulationManager().setSimulating(False)
 
host = EquipmentController()
host.setEquipmentHostName(hostname)
host.setActivePort(port)
host.setDeviceId(deviceid)
host.init()
host.start()
 
def event_received(ceid, event_report_values):
	print("Event received: " + str(ceid) + " with values:\n" + str(event_report_values))
 
d = {'eventReceived': event_received }
listener_proxy = JProxy("com.ergotech.transsecs.secs.host.EventListener", dict=d)
 
# Add a listener for all events
host.setGlobalEventListener(listener_proxy)
 
while True:
    print('GEMHost running...')
    time.sleep(10)