Map Commands¶

`map:bins:clear_all`¶

Sentio Version: 2.8.1

Description: Sets bin codes of all dies and subsites to the NullBin code.

Parameters: None

Response:

Field	Type	Values
Setup	String	`OK`

`map:bins:get_bin`¶

Sentio Version: 2.9.2

Description: Retrieves the bin value of a die or subsite.

Parameters:

Parameter	Type	Notes
Column (opt.)	Integer	Relative to the grid origin
Row (opt.)	Integer	Relative to the grid origin
Subsite index (opt.)	Unsigned Integer	—

Response:

Field	Type
Bin	Integer

Remarks: If Column/Row are omitted, the currently active die is used (the current die of the stepping route, or the die the chuck last stepped to); an error occurs if no die is active. If Subsite index is omitted, the die's bin code is retrieved. An error occurs if the target has no bin code.

`map:bins:get_bin_info`¶

Sentio Version: 23.1.0

Description: Retrieves the bin information of a bin in the binning table.

Parameters:

Parameter	Type	Notes
Bin Index	Integer	≥0; must be lower than the total number of bins in the active binning table

Response:

Field	Type	Values
Bin index	Integer	Same value as the parameter
Description	String	Bin description
Bin Quality	String	`Pass`, `Fail`, `Undefined`
Color	String	An HTML color string, e.g. `#FF00FF00`

`map:bins:get_num_bins`¶

Sentio Version: 23.1.0

Description: Returns the number of bins in the binning table.

Parameters: None

Response:

Field	Type
Number of Bins	Integer

`map:bins:load`¶

Sentio Version: 2.8.1

Description: Loads a binning table from file.

Parameters:

Parameter	Type
Directory Path\Project Folder\Filename	String

Response:

Field	Type
Directory Path\Project Folder\Filename	String

Example:

Command:   map:bins:load C:\ProgramData\MPI Corporation\Sentio\config\defaults\default_bins.xbt
Response:  0,0,C:\ProgramData\MPI Corporation\Sentio\config\defaults\default_bins.xbt

Remarks: Path conventions: - If Directory path is omitted, the default project directory is used. - Project folder may contain subfolders and may be omitted if no Directory path is given (uses the current project folder; fails if no project is loaded). - If the string ends in .xbt, it is a file name; if the file name is omitted, the default bins.xbt is loaded from the specified folder.

`map:bins:set_all`¶

Sentio Version: 2.8.1

Description: Bins all existing dies of a map with a given value.

Parameters:

Parameter	Type	Values	Notes
Bin Value	Integer	—	If not present in the binning table, the die is marked black
Target (opt.)	String	`D` (default) = dies only; `S` = subsites only; `A` = all (dies and subsites)

Response:

Field	Type	Values
Setup	String	`OK`

Example:

Command:   map:bins:set_all -1
Response:  0,0,OK

`map:bins:set_bin`¶

Sentio Version: 2.8.1

Description: Sets the bin value of a die or subsite.

Parameters:

Parameter	Type	Notes
Bin	Integer	—
Column (opt.)	Integer	Relative to the grid origin
Row (opt.)	Integer	Relative to the grid origin
Subsite Index (opt.)	Unsigned Integer	—

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: If a subsite index is present, the bin applies to that subsite; otherwise to the die. Omitting column/row applies binning to the current die per the active routing table. Subsite binning is refused when only one subsite exists.

`map:bins:set_bin_info`¶

Sentio Version: 23.1.0

Description: Sets the bin information for a single bin in the binning table.

Parameters:

Parameter	Type	Values
Bin index	Integer	Index of the bin
Description	String	Bin description
Bin Quality	String	`Pass`, `Fail`, `Undefined`
Color	String	An HTML color string, e.g. `#FF00FF00`

Response:

Field	Type	Values
Default	String	`OK`

`map:bins:resize`¶

Sentio Version: 23.1.0

Description: Resizes the binning table.

Parameters:

Parameter	Type	Notes
Binning Table Size	Integer	Must be ≥1

Response:

Field	Type	Values
Default	String	`OK`

Remarks: Default bin definitions are created for new bins when the list size increases.

`map:bin_step_next_die`¶

Sentio Version: 2.8.1 (Subsite Index parameter added in 2.9.2)

Description: Assigns a bin to the current die and steps to the submitted subsite of the next die within the stepping route. Errors if the submitted subsite is not routable on the target die. If Subsite Index is omitted, the target subsite is the currently active subsite and the target die is the next one on the route where that subsite is routable.

Parameters:

Parameter	Type
Bin	Integer
Subsite Index (opt.)	Integer

Response:

Field	Type
Column Index	Integer
Row Index	Integer
Subsite Index	Integer

Remarks: If the current die is the last on the route, the bin code is set but no stepping occurs. If the command fails for any other reason, the bin code is not set.

Update Logs: 2.9.2 — added Subsite Index parameter.

`map:compensation:set_xy`¶

Sentio Version: 2.8.1

Description: Switches the lateral compensation type.

Parameters:

Parameter	Type	Values
Type	String	`none`, `onthefly`, `mapscan`, `thermal`

Response:

Field	Type	Values
Setup	String	`OK`

Example:

Command:   map:compensation:set_xy onthefly
Response:  0,0,OK

Remarks: This command only enables the compensation type; its parameters must be set up separately.

`map:compensation:set_z`¶

Sentio Version: 2.8.1

Description: Switches the vertical compensation type.

Parameters:

Parameter	Type	Values
Type	String	`none`, `onthefly`, `mapscan`

Response:

Field	Type	Values
Setup	String	`OK`

Example:

Command:   map:compensation:set_z topography
Response:  0,0,OK

Remarks: This command only enables the compensation type; its parameters must be set up separately.

`map:compensation:topography` [asynchronous]¶

Sentio Version: 3.0.2 (command code #2 added in 3.7.1)

Description: Starts execution of the topography function. Returns a response as soon as SENTIO receives the command.

Parameters:

Parameter	Type	Values
State	String	`Execute`, `Abort`

Response:

Field	Type	Values
Command ID	String	—
Setup	String	`OK`

Application Example:

Command:   map:compensation:topography execute
Response:  0,1,OK                              (executes topography build)

Command:   status:get_machine_status
Response:  0,0,Ready,Running                   (system running)

Command:   status:get_machine_status
Response:  0,0,Ready                           (topography build finished)

Command:   map:compensation:topography abort
Response:  0,2,OK                              (aborts topography build)

Update Logs: 3.7.1 — added command code (#2) for this asynchronous command.

`map:create`¶

Sentio Version: 2.8.1

Description: Creates a new wafer map.

Parameters:

Parameter	Type	Values	Notes
Type (opt.)	String	`Round`, `Rectangular`
Columns	Integer	—	Rectangular map only
Rows	Integer	—	Rectangular map only
Diameter [mm]	Integer	—	Round map only

Response:

Field	Type	Values
Setup	String	`OK`

`map:create_rect`¶

Sentio Version: 2.8.1

Description: Creates a new rectangular wafer map.

Parameters:

Parameter	Type
Columns	Integer
Rows	Integer

Response:

Field	Type	Values
Setup	String	`OK`

`map:die:add`¶

Sentio Version: 2.8.1

Description: Adds a die to the wafer map.

Parameters:

Parameter	Type
Columns Index	Integer
Rows Index	Integer

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: If the die already exists, "Die already present" is returned. A die entirely outside the wafer area cannot be added.

`map:die:get_current_index`¶

Sentio Version: 2.8.1

Description: Retrieves information about the current die.

Parameters: None

Response:

Field	Type	Notes
List Index	Unsigned Integer	Index in the routing list
Column Index	Integer	Relative to the grid origin
Row Index	Integer	Relative to the grid origin

Remarks: If no die is active, "No die active" is returned. If the active die is not part of the stepping route, List Index -1 is returned.

`map:die:get_current_subsite`¶

Sentio Version: 2.8.1

Description: Retrieves information about the currently active subsite.

Parameters: None

Response:

Field	Type	Notes
Subsite Index	Unsigned Integer	Index in the subsite list

Remarks: If no die is active, "No die active" is returned.

`map:die:remove`¶

Sentio Version: 2.8.1

Description: Removes a die from the wafer map.

Parameters:

Parameter	Type
Column Index	Integer
Row Index	Integer

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: If the die does not exist, "Die not present" is returned.

`map:die:select`¶

Sentio Version: 2.8.1

Description: Selects a die for stepping.

Parameters:

Parameter	Type
Column Index	Integer
Row Index	Integer

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: If the die does not exist, the command is not carried out and "Die not present" is returned.

`map:die:set_status`¶

Sentio Version: 2.8.1, updated 3.1.0

Description: Replaces map:die:add, map:die:remove, map:die:select, and map:die:unselect.

`map:die:unselect`¶

Sentio Version: 2.8.1

Description: Excludes a die from stepping.

Parameters:

Parameter	Type
Column Index	Integer
Row Index	Integer

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: If the die does not exist, "Die not present" is returned.

`map:get_axis_orient`¶

Sentio Version: 2.8.1

Description: Retrieves the axis orientation.

Parameters: None

Response:

Field	Type	Values
Orientation	String	`UR` (Y up, X right), `UL` (Y up, X left), `DR` (Y down, X right), `DL` (Y down, X left)

`map:get_diameter`¶

Sentio Version: 2.8.1

Description: Retrieves the wafer diameter.

Parameters: None

Response:

Field	Type
Diameter [mm]	Float

Remarks: Only for round wafer maps.

`map:get_die_seq`¶

Sentio Version: 2.8.1

Description: Retrieves the current die sequence number of the wafer map.

Parameters: None

Response:

Field	Type
Sequence Number	Integer

Remarks: Only for round wafer maps.

`map:get_flat_params`¶

Sentio Version: 2.8.1

Description: Retrieves the parameters of the wafer flat.

Parameters: None

Response:

Field	Type
Flat Angle [deg.]	Unsigned Integer
Flat Length [µm]	Unsigned Integer

Remarks: No longer supported — use map:get_orient_marker instead.

`map:get_grid_origin`¶

Sentio Version: 2.8.1

Description: Retrieves the origin of the grid within the base grid.

Parameters: None

Response:

Field	Type
Column	Integer
Row	Integer

`map:get_grid_params`¶

Sentio Version: 2.8.1

Description: Retrieves information about the die grid.

Parameters: None

Response:

Field	Type
Die width [µm]	Float
Die height [µm]	Float
Grid offset x [µm]	Float
Grid offset y [µm]	Float
Edge area size [µm]	Float

Remarks: Grid offset and edge area are always 0 for rectangular wafer maps.

`map:get_home_die`¶

Sentio Version: 2.8.1

Description: Retrieves the index coordinates of the home die.

Parameters: None

Response:

Field	Type	Notes
Column	Integer	Relative to grid origin
Row	Integer	Relative to grid origin

`map:get_index_size`¶

Sentio Version: 2.8.1

Description: Retrieves the die size.

Parameters: None

Response:

Field	Type
Die Width [µm]	Float
Die Height [µm]	Float

`map:get_num_cols`¶

Sentio Version: 2.8.1

Description: Retrieves the number of columns in the grid.

Parameters: None

Response:

Field	Type
Column Number	Integer

`map:get_num_dies`¶

Sentio Version: 2.8.1

Description: Retrieves the number of dies in the defined group.

Parameters:

Parameter	Type	Values
Group (opt.)	String	`Total` (all grid cells), `Present` (default), `Selected` (dies selected for test)

Response:

Field	Type
Number	Integer

Remarks: Not case sensitive; first character sufficient. Default is Present.

`map:get_num_rows`¶

Sentio Version: 2.8.1

Description: Retrieves the number of rows in the grid.

Parameters: None

Response:

Field	Type
Row Number	Integer

`map:get_orient_marker`¶

Sentio Version: 2.8.1

Description: Retrieves type and geometry of the wafer orientation marker.

Parameters: None

Response:

Field	Type	Values	Notes
Marker Type	String	`Flat`, `Notch`
Marker Angle [deg.]	Float	—
Marker Size [µm]	Float	—	Flat length / notch depth

Remarks: Marker type is not case sensitive.

`map:get_prop`¶

Sentio Version: 3.2.0 (col_row_swap added in 3.5.0)

Description: Generic function to retrieve the value of a specific data item from the map module.

Parameters:

Parameter	Type	Values
Property Name	String	`edge_area`, `die_reference`, `die_reference_is_set`, `grid_offset`, `street_size`, `die_size`, `wafer_marker`, `wafer_marker_angle`, `show_subsites`, `col_row_swap` (`"True"`/`"False"` — whether rows/columns are swapped)

Response: Depends on the data property.

Example:

Command:   map:get_prop show_subsites
Response:  0,0,True     (subsite rendering currently enabled in the wafer map)

Update Logs: 3.5.0 — added col_row_swap parameter.

`map:get_routing`¶

Sentio Version: 2.8.1

Description: Retrieves the routing scheme for die stepping.

Parameters: None

Response:

Field	Type	Values
Start Point	String	`UL` (Upper Left), `UR` (Upper Right), `LL` (Lower Left), `LR` (Lower Right)
Trace	String	`R` (Rows unidirectional), `C` (Columns unidirectional), `WR` (Winding Rows), `WC` (Winding Columns)

Remarks: Parameters not case sensitive. "Unidirectional" steps each row/column in the same direction; "Winding" alternates direction each row/column.

`map:get_street_size`¶

Sentio Version: 3.0.2

Description: Retrieves the street size. Rectangular maps and round maps optimized for discrete devices do not support a street size — 0,0 is returned in those cases.

Parameters: None

Response:

Field	Type
Die Width [µm]	Float
Die Height [µm]	Float

`map:open`¶

Sentio Version: 2.8.1

Description: Opens a wafer map file.

Parameters:

Parameter	Type
Directory Path\Project Folder\Filename	String

Response:

Field	Type
Directory Path\Project Folder\Filename	String

Examples:

Command:   map:open C:\Users\Project1\layout.xwmf
Response:  0,0,C:\Users\Project1\layout.xwmf

Command:   map:open Project1\layout.xwmf
Response:  0,0,Default project directory\Project1\layout.xwmf

Command:   map:open Project1\Version2\layout12.xwmf
Response:  0,0,Default project directory\Project1\Version2\layout12.xwmf

Command:   map:open layout.xwmf
Response:  0,0,Default project directory\current project folder\layout.xwmf

Command:   map:open C:\Users\Project1
Response:  0,0,C:\Users\Project1\wafermap.xwmf

Command:   map:open C:\Users\Project1\
Response:  0,0,C:\Users\Project1\wafermap.xwmf

Command:   map:open Project1
Response:  0,0,Default project directory\Project1\wafermap.xwmf

Remarks: Opening a map file does not affect the current project folder. Path conventions: - If Directory path is omitted, the default project directory is used. - Project folder may contain subfolders and may be omitted if no Directory path is given (uses the current project folder; fails if no project is loaded). - If the string ends in .xwmf, it is a file name; if the file name is omitted, wafermap.xwmf is loaded from the folder. - If file name is omitted, the trailing \ is optional.

`map:path:add_bins`¶

Sentio Version: 2.9.2

Description: Adds dies with distinct binning to the stepping path.

Parameters:

Parameter	Type	Values
Selection	Integer / String	Single value `{int}` (dies with that bin code); range `{int1}-{int2}` (dies with bin code in that range); `Pass` (bin quality Pass); `Fail` (bin quality Fail); `Undefined` (bin quality Undefined); `Unbinned` (dies not binned)

Response:

Field	Type
Path Length	Integer

Examples:

Command:   map:path:add_bins 1
Response:  0,0,3

Command:   map:path:add_bins 1-5
Response:  0,0,15

Command:   map:path:add_bins Pass
Response:  0,0,20

Command:   map:path:add_bins Unbinned
Response:  0,0,344

Command:   map:path:add_bins 1,5-10,15-20,Pass
Response:  0,0,18     (combining several selection expressions in one call)

Remarks: Selection is a list of an arbitrary number of expressions defining the affected dies. Expressions of type "Bin quality" and "Unbinned" are not case sensitive.

`map:path:create_from_bins`¶

Sentio Version: 2.9.2

Description: Creates a new stepping path from dies with distinct binning.

Parameters:

Parameter	Type	Values
Selection	Integer / String	Same expressions as `map:path:add_bins`

Response:

Field	Type
Path Length	Integer

Remarks: See map:path:add_bins for Selection expression syntax.

`map:path:get_die`¶

Sentio Version: 3.1.1

Description: Queries the die row/column by die sequence number.

Parameters:

Parameter	Type
Die Sequence Number	Integer

Response:

Field	Type
Row	Integer
Column	Integer

Example:

Command:   map:path:get_die 5
Response:  0,0,-1,1     (die -1,1 has sequence number 5)

`map:path:remove_bins`¶

Sentio Version: 2.9.2

Description: Removes dies with distinct binning from the stepping path.

Parameters:

Parameter	Type	Values
Selection	Integer / String	Same expressions as `map:path:add_bins`

Response:

Field	Type
Path Length	Integer

Remarks: See map:path:add_bins for Selection expression syntax.

`map:path:select_dies`¶

Sentio Version: 3.0.2

Description: Selects or deselects dies for testing. Selected dies render orange in the "Path" color scheme.

Parameters:

Parameter	Type	Values
Selection	Character	`n` = select none (deselect all); `a` = select all present dies (even entirely outside the wafer); `e` = select Good, Ugly and Edge dies (any corner inside the wafer shape); `u` = select Good and Ugly dies (dies entirely inside the wafer circle); `g` = select Good dies only (all four corners inside the wafer's quality radius)

Response:

Field	Type
Number of Selected Dies	Integer

`map:poi:add`¶

Sentio Version: 2.8.1

Description: Adds a new point of interest (POI) to SENTIO's wafer map POI list.

Parameters:

Parameter	Type	Notes
X [µm]	Float	—
Y [µm]	Float	—
Description (opt.)	String	Default = empty

Response:

Field	Type	Values
Setup	String	`OK`

Example:

Command:   map:poi:add 100,100,MyPointOfInterest
Response:  0,0,OK

Remarks: Syntax changed in SENTIO 3.4.0; SENTIO still generally accepts the old syntax.

`map:poi:get`¶

Sentio Version: 3.5.0

Description: Gets data of a single POI.

Parameters:

Parameter	Type	Notes
POI-Index	Integer	Index of the POI to query

Response:

Field	Type
X-Position	Float
Y-Position	Float
Description	String

Example:

Command:   map:poi:get
Response:  0,0,100,200,poidescription

`map:poi:get_num`¶

Sentio Version: 2.8.1

Description: Gets the total number of POIs.

Parameters: None

Response:

Field	Type
Total Number	Integer

Example:

Command:   map:poi:get_num
Response:  0,0,100

`map:poi:remove`¶

Sentio Version: 2.8.1

Description: Deletes a POI from the POI list.

Parameters:

Parameter	Type	Notes
Index (opt.)	Integer	Default = delete all

Response:

Field	Type	Values
Setup	String	`OK`

Example:

Command:   map:poi:remove 1
Response:  0,0,OK

`map:poi:reset`¶

Sentio Version: 2.8.1

Description: Clears all POI data.

Parameters:

Parameter	Type	Values	Notes
Stage (opt.)	String	`Chuck`, `Scope`	Which stage the POI list is bound to
XY-Reference (opt.)	String	`DieCenter`, `StageCenter`	Whether POI positions are relative to stage center or die center

Response:

Field	Type	Values
Setup	String	`OK`

Example:

Command:   map:poi:reset
Response:  0,0,OK     (clears all POI data)

`map:poi:step`¶

Sentio Version: 2.8.1

Description: Steps to the POI at the specified index.

Parameters:

Parameter	Type
POI Index	Integer

Response:

Field	Type
Column Index	Integer
Row Index	Integer
POI Index	Integer

Example:

Command:   map:poi:step 5
Response:  0,0,1,2,5     (steps to die col 1, row 2, POI index 5)

`map:poi:step_first`¶

Sentio Version: 2.8.1

Description: Steps to the first POI position.

Parameters: None

Response:

Field	Type
Column Index	Integer
Row Index	Integer
POI Index	Integer

Example:

Command:   map:poi:step_first
Response:  0,0,1,2,0

`map:poi:step_next`¶

Sentio Version: 2.8.1

Description: Steps to the next POI position.

Parameters: None

Response:

Field	Type
Column Index	Integer
Row Index	Integer
POI Index	Integer

Example:

Command:   map:poi:step_next
Response:  0,0,1,2,6

`map:save`¶

Sentio Version: 2.8.1

Description: Saves a wafer map to file.

Parameters:

Parameter	Type
Directory Path\Project Folder\Filename	String

Response:

Field	Type
Directory Path\Project Folder\Filename	String

Remarks: If the specified folder doesn't exist, the command fails. Same path conventions as map:open. Supported formats: .xwmf (SENTIO wafer map), .wm2 (text-based), .svg (scalable vector graphics).

`map:set_axis_orient`¶

Sentio Version: 2.8.1

Description: Sets the axis orientation.

Parameters:

Parameter	Type	Values
Orientation	String	`UR` (Y up, X right), `UL` (Y up, X left), `DR` (Y down, X right), `DL` (Y down, X left)

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: Not case sensitive.

`map:set_color_scheme`¶

Sentio Version: 2.8.1

Description: Sets the map color scheme.

Parameters:

Parameter	Type	Values
Color Scheme	Integer	`0` = "Color from Bin" (dies without a bin code marked orange if selected for test, gray otherwise); `1` = "Color from Value" (uses each die's assigned numeric value to determine cell color)

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: Prior to SENTIO 3.0 there were three color schemes; "Color from Presence" was merged into "Color from mark to test" in v3. In SENTIO 3.4, "Color From Value" was introduced and "Color from Bin" was merged with "Color from Path".

`map:set_diameter`¶

Sentio Version: 2.8.1, updated 3.7.0

Description: Sets the wafer diameter.

Parameters:

Parameter	Type	Notes
Diameter [mm]	Float	If the value contains a decimal point it is used verbatim as a float (accepted range 50–300). If an integer is submitted, the actual diameter used is the next matching SEMI-standard diameter; only these integer values are accepted: 50, 51, 75, 76, 100, 125, 150, 200, 300

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: Available range is 50–310 mm.

Update Logs: 3.7.0 — updated the parameter description and available range.

`map:set_flat_params`¶

Sentio Version: 2.8.1, updated 3.3.0

Description: Sets the parameters of the wafer flat.

Parameters:

Parameter	Type	Notes
Flat Angle [deg.]	Unsigned Integer	Only 0, 45, 90, 135, 180, 225, 270, 315 valid
Flat Length [µm]	Unsigned Integer	—

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: No longer supported — use map:set_orient_marker instead.

Update Logs: 3.3.0 — added 45, 135, 225, 315 degree options.

`map:set_grid_origin`¶

Sentio Version: 2.8.1

Description: Sets the origin of the grid within the base grid.

Parameters:

Parameter	Type	Values
Column	Integer	—
Row	Integer	—
Reference Point (opt.)	String	`Center` (default), `LowerLeft`, `UpperLeft`, `LowerRight`, `UpperRight`
Axis Orient (opt.)	String	`UpRight` (default), `DownRight`, `UpLeft`, `DownLeft`

Response:

Field	Type	Values
Setup	String	`OK`

Examples:

Command:   map:set_grid_origin 1,2
Response:  0,0,OK     (origin set one column right, two rows up from center die)

Command:   map:set_grid_origin -1,-2,UpperRight
Response:  0,0,OK     (origin set one column left, two rows down from the upper-right die)

Command:   map:set_grid_origin 2,1,UpperLeft,DownRight
Response:  0,0,OK     (origin set two columns right, one row down from the upper-left die)

Remarks: "Reference Point" is the die that Column/Row are measured from (center die or a corner die). "Axis Orient" defines the positive directions for Column/Row offsets — it does not change the wafer map's own axis orientation (use map:set_axis_orient for that). If "Reference Point" is omitted, "Axis Orient" must be omitted too; omitted parameters use their defaults.

`map:set_grid_params`¶

Sentio Version: 2.8.1

Description: Sets the layout of the wafer map grid.

Parameters:

Parameter	Type
Die Width [µm]	Float
Die Height [µm]	Float
Grid Offset X [µm]	Unsigned Integer
Grid Offset Y [µm]	Unsigned Integer
Edge Area Width [µm] (opt.)	Unsigned Integer

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: Only for round maps; for rectangular maps use map:set_index_size.

`map:set_home_die`¶

Sentio Version: 2.8.1

Description: Sets the grid cell used as the home die with respect to the grid origin.

Parameters:

Parameter	Type
Column Index	Integer
Row Index	Integer

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: Index values follow the axis orientation of the wafer coordinate system.

`map:set_index_size`¶

Sentio Version: 2.8.1

Description: Sets the index size of a wafer (size of the wafer mask).

Parameters:

Parameter	Type
Die Width [µm]	Float
Die Height [µm]	Float

Response:

Field	Type	Values
Setup	String	`OK`

`map:set_orient_marker`¶

Sentio Version: 2.8.1, updated 3.3.0

Description: Sets type and geometry of the wafer orientation marker.

Parameters:

Parameter	Type	Values	Notes
Marker Type	String	`Flat`, `Notch`
Marker Angle [deg.]	Float	—	Only 0, 45, 90, 135, 180, 225, 270, 315 valid
Marker Size [µm]	Float	—	Flat length / notch depth

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: Marker type not case sensitive. Maximum notch depth is 10000 µm.

Update Logs: 3.3.0 — added 45, 135, 225, 315 degree options.

`map:set_prop`¶

Sentio Version: 3.2.0, updated 3.5.0

Description: Generic function to set the value of a specific data item of the map module.

Parameters:

Property Name	Additional Parameters
`edge_area`	1. Edge Area Size
`die_reference`	1. Position X, 2. Position Y
`die_reference_is_set`	1. Boolean
`grid_offset`	1. Offset X, 2. Offset Y
`street_size`	1. Street Size X, 2. Street Size Y
`die_size`	1. Die Size X, 2. Die Size Y
`wafer_marker`	1. Marker Type
`wafer_marker_angle`	1. Marker Angle
`show_subsites`	1. Boolean
`col_row_swap`	1. Boolean

Response: Depends on the data property.

Example:

Command:   map:set_prop show_subsites, false
Response:  0,0,OK     (disables subsite rendering in the wafer map)

`map:set_routing`¶

Sentio Version: 2.8.1

Description: Sets the routing scheme for die stepping.

Parameters:

Parameter	Type	Values
Start Point	String	`UL` (Upper Left), `UR` (Upper Right), `LL` (Lower Left), `LR` (Lower Right)
Trace	String	`R` (Rows unidirectional), `C` (Columns unidirectional), `WR` (Winding Rows), `WC` (Winding Columns)

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: Parameters not case sensitive. "Unidirectional" steps each row/column in the same direction; "Winding" alternates direction each row/column.

`map:set_street_size`¶

Sentio Version: 2.8.1

Description: Sets the street size of the wafer (for rendering purposes only).

Parameters:

Parameter	Type
Street Size Width [µm]	Float
Street Size Height [µm]	Float

Response:

Field	Type	Values
Setup	String	`OK`

`map:step_die`¶

Sentio Version: 2.8.1

Description: Steps to a die at a defined position.

Parameters:

Parameter	Type	Notes
Column Index	Integer	Use row index if map has swapped columns/rows
Row Index	Integer	Use column index if map has swapped columns/rows
Subsite Index (opt.)	Integer	—

Response:

Field	Type
Column Index	Integer
Row Index	Integer
Subsite Index	Integer

Remarks: Row/column parameter order swaps when "swap rows and columns" is checked in the wafer map's grid setup.

`map:step_die_seq`¶

Sentio Version: 2.8.1

Description: Steps to a subsite of a die within the routing sequence.

Parameters:

Parameter	Type
Sequence Index	Integer
Subsite Index / Name (opt.)	Integer / String

Response:

Field	Type	Notes
Column Index	Integer	Is row index if map has swapped columns/rows
Row Index	Integer	Is column index if map has swapped columns/rows
Subsite Index	Integer	—

Remarks: Subsite may be submitted by index or ID. If omitted, subsite 0 is used. Fails if the selected subsite is not routable. On success, the current routing position is set to the selected die.

`map:step_first_die`¶

Sentio Version: 2.8.1

Description: Steps to the defined subsite of the first die of the wafer (per the selected routing algorithm) and sets the currently active subsite.

Parameters:

Parameter	Type
Subsite Index (opt.)	Integer

Response:

Field	Type	Notes
Column Index	Integer	Is row index if map has swapped columns/rows
Row Index	Integer	Is column index if map has swapped columns/rows
Subsite Index	Integer	—

Remarks: If the defined subsite is not routable, the chuck is never moved to contact and result SubsiteNotRoutable is returned — an explicit contact move must be issued after a subsequent map:step_next_die. If Subsite Index is omitted, the first routable subsite of the die is used, or subsite 0 if none is routable.

`map:step_next_die`¶

Sentio Version: 2.8.1

Description: Steps to the submitted subsite of the next die in the stepping route. Errors if the target subsite is not routable. If Subsite Index is omitted, the target subsite is the currently active subsite and the target die is the next die on the route where that subsite is routable. Only executable if routing is active and the currently active die is part of the route.

Parameters:

Parameter	Type
Subsite Index (opt.)	Integer

Response:

Field	Type	Notes
Column Index	Integer	Is row index if map has swapped columns/rows
Row Index	Integer	Is column index if map has swapped columns/rows
Subsite Index	Integer	—

`map:step_previous_die`¶

Sentio Version: 2.8.1

Description: Steps to the currently active subsite of the previous die in the stepping route whose currently active subsite is routable. Only executable if routing is active and the currently active die is part of the route.

Parameters: None

Response:

Field	Type	Notes
Column Index	Integer	Is row index if map has swapped columns/rows
Row Index	Integer	Is column index if map has swapped columns/rows

`map:subsite:add`¶

Sentio Version: 2.8.1

Description: Adds a single subsite to the subsite table.

Parameters:

Parameter	Type	Values	Notes
ID	String	—	User-defined identifier of the site
X Position [µm]	Float	—	Relative to the position of site 0
Y Position [µm]	Float	—	Relative to the position of site 0
Axis Orientation (opt.)	String	`UL`, `UR` (default), `DL`, `DR`, `Map`	`Map` = use the wafer map grid orientation

Response:

Field	Type	Notes
List Index	Integer	Index of the new subsite in the subsite list

Remarks: If Axis Orientation is omitted, UR (Up-Right) is assumed.

`map:subsite:bin_step_next`¶

Sentio Version: 2.8.1

Description: Sets a bin code on the current subsite and steps to the next subsite of the die; if the current subsite is the die's last, steps to the first subsite of the next die.

Parameters:

Parameter	Type
Bin Value	Integer

Response:

Field	Type
Column Index	Integer
Row Index	Integer
Subsite Index	Integer

Remarks: If the current subsite is the last one of the stepping route, the bin code is set but no stepping occurs. If the command fails for any other reason, no bin code is set.

`map:subsite:export`¶

Sentio Version: 3.6.4

Description: Exports the subsite table to a file.

Parameters:

Parameter	Type
File name	String

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: A full path saves to that location; a bare name saves to the current project directory. File extension required — allowed types: CSV, XLS, XLSX.

`map:subsite:get`¶

Sentio Version: 2.8.1

Description: Retrieves information of a subsite from the subsite table.

Parameters:

Parameter	Type
Subsite Index	Integer / String

Response:

Field	Type
Subsite ID	Integer / String
X Position [µm]	Float
Y Position [µm]	Float

Example:

Command:   map:subsite:get 0
Response:  0,0,site_1,0.0,0.0

Remarks: If the parameter is a subsite index, the response contains the subsite ID (and vice versa).

`map:subsite:get_num`¶

Sentio Version: 2.8.1

Description: Gets the count of a specified subsite group.

Parameters:

Parameter	Type	Values
Group	String	`P` — present on specified die; `S` — selected for routing on specified die; `GP` (default) — global subsite definitions; `GS` — globally selected for routing for each die; `WP` — total present on wafer; `WS` — total selected for routing on wafer
Die Index X (opt.)	Integer	—
Die Index Y (opt.)	Integer	—

Response:

Field	Type
Count	Integer

Remarks: For Group {P, S} a die must be specified (or the currently active die is used; fails if neither is available). For Group {GP, GS, WP, WS}, Die Index must not be submitted. Default Group is GP. Presence/selection is the AND of a global and a local (per-die) definition; GP/GS reflect the global definitions, P/S the effective (global AND local) values, and WP/WS sum P/S over all dies.

`map:subsite:get_state`¶

Sentio Version: 3.2.0

Description: Checks whether a given subsite is active. When column and row are provided, the local subsite state is returned; otherwise the global subsite state is returned. A subsite is only effectively enabled when enabled in both the global and the die's local subsite table.

Parameters:

Parameter	Type
Subsite Index / ID	Integer / String
Column (opt.)	Integer
Row (opt.)	Integer

Response:

Field	Type	Values
State	Integer	`0`=Inactive, `1`=Active

`map:subsite:import`¶

Sentio Version: 3.6.4

Description: Imports the subsite table from a file.

Parameters:

Parameter	Type
File name	String

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: A full path loads from that location; a bare name loads from the current project directory. File extension required — allowed types: CSV, XLS, XLSX.

`map:subsite:remove`¶

Sentio Version: 2.8.1

Description: Deletes a subsite from the subsite table.

Parameters:

Parameter	Type
Subsite Index / ID	Integer / String

Response:

Field	Type	Values
Setup	String	`OK`

`map:subsite:reset`¶

Sentio Version: 2.8.1

Description: Resets the subsite list. After a reset, only a single entry remains (id="main", position="0,0"); the position of all other subsites is later defined relative to this first site.

Parameters: None

Response:

Field	Type	Values
Setup	String	`OK`

`map:subsite:set_state`¶

Sentio Version: 3.2.0

Description: Activates or deactivates a subsite either globally or locally on a specified die. With column/row provided, the local subsite state is set; otherwise the global state is set. A subsite is only effectively enabled when enabled both locally and globally.

Parameters:

Parameter	Type	Values
Subsite Index / ID	Integer / String	—
State	Integer	`0`=Inactive, `1`=Active
Column (opt.)	Integer	—
Row (opt.)	Integer	—

Response:

Field	Type	Values
Setup	String	`OK`

`map:subsite:step`¶

Sentio Version: 2.8.1

Description: Steps to a subsite index on the current die.

Parameters:

Parameter	Type
Subsite Index / ID	Integer / String

Response:

Field	Type
Column Index	Integer
Row Index	Integer
Subsite Index	Integer

Remarks: Subsite may be identified by index or by ID; if the identifier is a valid index it is interpreted as such, otherwise as the subsite ID.

`map:subsite:step_next`¶

Sentio Version: 2.8.1

Description: Steps to the next subsite of the current die. If the current subsite is the die's last and the die is part of the route, steps to the first subsite of the next die.

Parameters: None

Response:

Field	Type
Column Index	Integer
Row Index	Integer
Subsite Index	Integer

`map:subsite:step_previous`¶

Sentio Version: 2.8.1

Description: Steps to the previous subsite of the current die. If the current subsite is the die's first and the die is part of the route, steps to the last subsite of the previous die.

Parameters: None

Response:

Field	Type
Column Index	Integer
Row Index	Integer
Subsite Index	Integer

`map:view:show_current_die`¶

Sentio Version: 2.8.1

Description: Positions the wafer map on screen so that the current subsite of the current die is centered.

Parameters: None

Response:

Field	Type	Values
Setup	String	`OK`

Remarks: Only possible if a die is active.

Map Commands¶

map:bins:clear_all¶

map:bins:get_bin¶

map:bins:get_bin_info¶

map:bins:get_num_bins¶

map:bins:load¶

map:bins:set_all¶

map:bins:set_bin¶

map:bins:set_bin_info¶

map:bins:resize¶

map:bin_step_next_die¶

map:compensation:set_xy¶

map:compensation:set_z¶

map:compensation:topography [asynchronous]¶

map:create¶

map:create_rect¶

map:die:add¶

map:die:get_current_index¶

map:die:get_current_subsite¶

map:die:remove¶

map:die:select¶

map:die:set_status¶

map:die:unselect¶

map:get_axis_orient¶

map:get_diameter¶

map:get_die_seq¶

map:get_flat_params¶

map:get_grid_origin¶

map:get_grid_params¶

map:get_home_die¶

map:get_index_size¶

map:get_num_cols¶

map:get_num_dies¶

map:get_num_rows¶

map:get_orient_marker¶

map:get_prop¶

map:get_routing¶

map:get_street_size¶

map:open¶

map:path:add_bins¶

map:path:create_from_bins¶

map:path:get_die¶

map:path:remove_bins¶

map:path:select_dies¶

map:poi:add¶

map:poi:get¶

map:poi:get_num¶

map:poi:remove¶

map:poi:reset¶

map:poi:step¶

map:poi:step_first¶

map:poi:step_next¶

map:save¶

map:set_axis_orient¶

map:set_color_scheme¶

map:set_diameter¶

map:set_flat_params¶

map:set_grid_origin¶

map:set_grid_params¶

map:set_home_die¶

map:set_index_size¶

map:set_orient_marker¶

map:set_prop¶

map:set_routing¶

map:set_street_size¶

map:step_die¶

map:step_die_seq¶

map:step_first_die¶

map:step_next_die¶

map:step_previous_die¶

map:subsite:add¶

map:subsite:bin_step_next¶

map:subsite:export¶

map:subsite:get¶

map:subsite:get_num¶

map:subsite:get_state¶

map:subsite:import¶

map:subsite:remove¶

map:subsite:reset¶

map:subsite:set_state¶

`map:bins:clear_all`¶

`map:bins:get_bin`¶

`map:bins:get_bin_info`¶

`map:bins:get_num_bins`¶

`map:bins:load`¶

`map:bins:set_all`¶

`map:bins:set_bin`¶

`map:bins:set_bin_info`¶

`map:bins:resize`¶

`map:bin_step_next_die`¶

`map:compensation:set_xy`¶

`map:compensation:set_z`¶

`map:compensation:topography` [asynchronous]¶

`map:create`¶

`map:create_rect`¶

`map:die:add`¶

`map:die:get_current_index`¶

`map:die:get_current_subsite`¶

`map:die:remove`¶

`map:die:select`¶

`map:die:set_status`¶

`map:die:unselect`¶

`map:get_axis_orient`¶

`map:get_diameter`¶

`map:get_die_seq`¶

`map:get_flat_params`¶

`map:get_grid_origin`¶

`map:get_grid_params`¶

`map:get_home_die`¶

`map:get_index_size`¶

`map:get_num_cols`¶

`map:get_num_dies`¶

`map:get_num_rows`¶

`map:get_orient_marker`¶

`map:get_prop`¶

`map:get_routing`¶

`map:get_street_size`¶

`map:open`¶

`map:path:add_bins`¶

`map:path:create_from_bins`¶

`map:path:get_die`¶

`map:path:remove_bins`¶

`map:path:select_dies`¶

`map:poi:add`¶

`map:poi:get`¶

`map:poi:get_num`¶

`map:poi:remove`¶

`map:poi:reset`¶

`map:poi:step`¶

`map:poi:step_first`¶

`map:poi:step_next`¶

`map:save`¶

`map:set_axis_orient`¶

`map:set_color_scheme`¶

`map:set_diameter`¶

`map:set_flat_params`¶

`map:set_grid_origin`¶

`map:set_grid_params`¶

`map:set_home_die`¶

`map:set_index_size`¶

`map:set_orient_marker`¶

`map:set_prop`¶

`map:set_routing`¶

`map:set_street_size`¶

`map:step_die`¶

`map:step_die_seq`¶

`map:step_first_die`¶

`map:step_next_die`¶

`map:step_previous_die`¶

`map:subsite:add`¶

`map:subsite:bin_step_next`¶

`map:subsite:export`¶

`map:subsite:get`¶

`map:subsite:get_num`¶

`map:subsite:get_state`¶

`map:subsite:import`¶

`map:subsite:remove`¶

`map:subsite:reset`¶

`map:subsite:set_state`¶

`map:subsite:step`¶