Difference between revisions of "MC-Basic"

From SoftMC-Wiki
Jump to: navigation, search
(Refer to)
 
(73 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This manual covers all the commands and properties associated with the software components of the  MC. The application of these commands is covered in the  MC Users Manual. The syntax and related properties and variables are shown for each command. Example are also shown to illustrate the use of the command. It is recommended that you review this manual and refer to it when you are using these functions.
 
  
Various versions of the firmware adds many new features, and in many instances, significantly changes the syntax or behavior of functions (commands, properties). Therefore, the attribute Availability is included in the format to denote the applicability of each function (command, property) to the specified version of the firmware.
 
  
== Contents ==
+
== Introduction ==
* [[:Category:Axystems:MC-Basic:Commands|MC-Basic commands reference]] - Category, which lists all MC-Basic commands
+
This wiki covers all the commands and properties associated with the software components of the softMC.
* [[Axystems:MC-Basic:Language basics|Language basics]]
 
* [[Axystems:MC-Basic:Operators|Operators]]
 
* [[Axystems:MC-Basic:Predefined constants|Predefined constants]]
 
* [[Axystems:MC-Basic:Error codes|Error codes]]
 
  
== Format ==
+
The syntax and related properties and variables are shown for each command. Example are also shown to illustrate the use of the command.
Each command or property description is clearly separated from adjacent command and property topics so that you can easily find the item that you are looking for.  
 
Each description contains sufficient information required to use the command or property correctly. All commands and properties contain the following items:
 
  
 +
== Command Reference Format ==
 +
Each entry contains the information needed for correctly use of the command or property. All commands and properties contain the following items:
 +
* Description
 
* Short Form
 
* Short Form
 
* Syntax
 
* Syntax
 
* Availability
 
* Availability
* Description
 
 
* Type
 
* Type
 
* Range
 
* Range
Line 24: Line 18:
 
* Scope
 
* Scope
 
* Limitations
 
* Limitations
* Example
+
* Examples
 
* See Also
 
* See Also
  
Where applicable, a Short Form of the longer command can be used to simplify typing the command or property name. In such instances, the Short Form is denoted. The Short Form of a command or property name may be used interchangeably with the long version.
+
=== Short Form ===
 +
Where applicable, a short form of the longer command can be used to simplify typing the command or property name. In such instances, the short form is denoted. The short form of a command or property name may be used interchangeably with the long version.
 +
 
 +
=== Syntax ===
 +
In describing the syntax of an instruction, different notations are used.
 +
 
 +
'''< >'''<br/>Field to be filled by user. For example, ABS ( <expression> ) indicates that <expression> is the user’s data.
 +
 
 +
'''{ }'''<br/>Optional data. Many instructions have optional fields, which are used to override default values. For example, the VelocityCruise property is optional within a Move command. However, there is an exception to this rule, in that { } are used for vector notation. When the optional data may be repeated, an asterisk (*) is used to indicate this.
  
When parameter values imply dimensional units of measurement, these units are specified in the description of the command or property where they apply.
+
'''|'''<br/>Or. Indicates that either one of the values may be used.
  
=== Notation ===
+
=== Availability ===  
In describing the syntax of an instruction, different forms of notation are used.
+
Various versions of the firmware add new features, and often significantly change the syntax or behavior of commands and  properties. The attribute Availability included in the descriptions denotes the applicability of each function (command, property)to the specified version of the firmware.
  
<table border="1">
+
=== Units ===
<tr>
+
When parameter values imply dimensional units of measurement, these units are specified in the description of the command or property where they apply.
<td width="50">< ></td>
 
<td>
 
Field to be filled by user. For example, ABS ( <expression> ) indicates that <expression> is the user’s data.
 
</td>
 
</tr>
 
<tr>
 
<td>{ }</td>
 
<td>
 
Optional data. Many instructions have optional fields, which are used to override default values. For example, the VelocityCruise property is optional within a Move command. However, there is an exception to this rule, in that { } are used for vector notation. When the optional data may be repeated, an asterisk (*) is used to indicate this.
 
</td>
 
</tr>
 
<tr>
 
<td>|</td>
 
<td>
 
OR. Indicates that one or another value may be used.
 
</td>
 
</tr>
 
</table>
 
  
=== Scope of Operation ===
+
=== Scope ===
Instructions can be executed from any of three contexts: the configuration file (CONFIG.PRG), the terminal, and from within a task.  
+
Instructions can be executed from any of three contexts: the '''configuration''' file (CONFIG.PRG), the '''terminal''', and '''within a task'''.  
 
Not all instructions can be executed from all three contexts; their scope of operation is limited. For each instruction, the scope of operation is defined.
 
Not all instructions can be executed from all three contexts; their scope of operation is limited. For each instruction, the scope of operation is defined.
  
=== Limitations of Operation ===
+
=== Limitations ===
 
Even when an instruction can be executed in a given context, there may still be limitations on its use.  
 
Even when an instruction can be executed in a given context, there may still be limitations on its use.  
 
For example, a MOVE command can be executed from within a task, but there is a limitation in that the motion element being moved must first be attached to the task by the ATTACH command.
 
For example, a MOVE command can be executed from within a task, but there is a limitation in that the motion element being moved must first be attached to the task by the ATTACH command.
  
== See also ==
+
 
Other related manuals:
+
== Refer to ==
* MC Users Manual
+
* [[:Category:MC-Basic:Commands|MC-Basic Commands Reference]] - a list of all MC-Basic commands
* MC Installation Manual
+
* [[MC-Basic Language Fundamentals|Language Fundamentals]]
* MC Basic Moves Development Studio
+
* [[MC-Basic Constants|Constants]]
* MC/SC API Reference Manual
+
* [[MC-Basic Arrays|Arrays]]
 +
* [[MC-Basic Operators|Operators]]
 +
* [[MC-Basic Programs|Programs]]
 +
* [[MC-Basic Libraries|Libraries]]
 +
* [[MC-Basic C-Interface|C-Interface]]
 +
* [[MC-Basic Generic Elements|Generic Elements]]
 +
* [[Error Codes|Error Codes]]
 +
 
 +
* [[softMC Firmware|softMC Firmware]] - <font color="red"> old main page</font>
 +
 
 +
== FAQs ==
 +
[[FAQ MC-Basic|'''FAQs''' - MC-Basic]] - Ask the developers a question
  
  
[[Category:Axystems:MC-Basic]]
+
[[Category:MC-Basic]]
 +
[[Category:Control:Offline]]

Latest revision as of 08:37, 21 October 2014


Introduction

This wiki covers all the commands and properties associated with the software components of the softMC.

The syntax and related properties and variables are shown for each command. Example are also shown to illustrate the use of the command.

Command Reference Format

Each entry contains the information needed for correctly use of the command or property. All commands and properties contain the following items:

  • Description
  • Short Form
  • Syntax
  • Availability
  • Type
  • Range
  • Units
  • Default
  • Scope
  • Limitations
  • Examples
  • See Also

Short Form

Where applicable, a short form of the longer command can be used to simplify typing the command or property name. In such instances, the short form is denoted. The short form of a command or property name may be used interchangeably with the long version.

Syntax

In describing the syntax of an instruction, different notations are used.

< >
Field to be filled by user. For example, ABS ( <expression> ) indicates that <expression> is the user’s data.

{ }
Optional data. Many instructions have optional fields, which are used to override default values. For example, the VelocityCruise property is optional within a Move command. However, there is an exception to this rule, in that { } are used for vector notation. When the optional data may be repeated, an asterisk (*) is used to indicate this.

|
Or. Indicates that either one of the values may be used.

Availability

Various versions of the firmware add new features, and often significantly change the syntax or behavior of commands and properties. The attribute Availability included in the descriptions denotes the applicability of each function (command, property)to the specified version of the firmware.

Units

When parameter values imply dimensional units of measurement, these units are specified in the description of the command or property where they apply.

Scope

Instructions can be executed from any of three contexts: the configuration file (CONFIG.PRG), the terminal, and within a task. Not all instructions can be executed from all three contexts; their scope of operation is limited. For each instruction, the scope of operation is defined.

Limitations

Even when an instruction can be executed in a given context, there may still be limitations on its use. For example, a MOVE command can be executed from within a task, but there is a limitation in that the motion element being moved must first be attached to the task by the ATTACH command.


Refer to

FAQs

FAQs - MC-Basic - Ask the developers a question