122-32000 Parallax Inc, 122-32000 Datasheet - Page 187

• Manufacturer Part Number: 122-32000
• Description: MANUAL PROPELLER
• Manufacturer: Parallax Inc

Specifications of 122-32000

• Accessory Type: Manual
• Lead Free Status / RoHS Status: Lead free / RoHS Compliant
• For Use With/related Products: Propeller Education (PE) Kit
• Lead Free Status / Rohs Status: Lead free / RoHS Compliant

COGINIT
Start or restart a cog by ID to run the Spin code or Propeller Assembly code.
((PUB ┆ PRI))
((PUB ┆ PRI))
Explanation
COGINIT
cog whose ID is CogID, and 2) it does not return a value. Since
specific cog, as directed by the CogID parameter, it can be used to stop and restart an active
cog in one step. This includes the current cog; i.e.: a cog can use
itself to run, perhaps, completely different code.
Spin Code (Syntax 1)
To run a Spin method in a specific cog, the
name, its parameters, and a pointer to some stack space. For example:
COGINIT
COGINIT
coginit(1, Square(@X), @SqStack) 'Launch Square in Cog 1
•
•
•
•
•
•
CogID
next available cog being started (if possible).
SpinMethod
Optionally, it can be followed by a parameter list enclosed in parentheses.
ParameterList
SpinMethod. It must be included only if SpinMethod requires parameters.
StackPointer
the affected cog. The affected cog uses this space to store temporary data during
further calls and expression evaluations. If insufficient space is allocated, either the
application will fail to run or it will run with strange results.
AsmAddress
Parameter
affected cog’s read-only Cog Boot Parameter (
to pass a either a single 14-bit value or the address of a block of memory to be used
by the assembly routine. Parameter is required by
your routine simply set it to an innocuous value like zero (0).
works exactly like
(CogID, SpinMethod
(CogID, AsmAddress, Parameter )
is the ID (0 – 7) of the cog to start, or restart. A CogID above 7 results in the
is used to optionally pass a value to the new cog. This value ends up in the
is a pointer to memory, such as a long array, reserved for stack space for
is the address of a Propeller Assembly routine from a
is the
is an optional, comma-delimited list of one or more parameters for
PUB
COGNEW
〈
(ParameterList)
or
with two exceptions: 1) it launches code into a specific
PRI
4: Spin Language Reference –
Spin method that the affected cog should run.
COGINIT
〉
, StackPointer )
command needs the cog ID, the method
PAR
) register. Parameter can be used
COGINIT
Propeller Manual v1.0 · Page 187
COGINIT
, but if not needed for
COGINIT
DAT
to stop and restart
block.
operates on a