Propeller Manual
Table Of Contents
- Preface
- Chapter 1 : Introducing the Propeller Chip
- Concept
- Package Types
- Pin Descriptions
- Specifications
- Hardware Connections
- Boot Up Procedure
- Run-Time Procedure
- Shutdown Procedure
- Block Diagram
- Shared Resources
- System Clock
- Cogs (processors)
- Hub
- I/O Pins
- System Counter
- CLK Register
- Locks
- Main Memory
- Main RAM
- Main ROM
- Character Definitions
- Log and Anti-Log Tables
- Sine Table
- Boot Loader and Spin Interpreter
- Chapter 2 : Spin Language Reference
- Structure of Propeller Objects/Spin
- Categorical Listing of Propeller Spin Language
- Spin Language Elements
- ABORT
- BYTE
- BYTEFILL
- BYTEMOVE
- CASE
- CHIPVER
- CLKFREQ
- _CLKFREQ
- CLKMODE
- _CLKMODE
- CLKSET
- CNT
- COGID
- COGINIT
- COGNEW
- COGSTOP
- CON
- CONSTANT
- Constants (pre-defined)
- CTRA, CTRB
- DAT
- DIRA, DIRB
- FILE
- FLOAT
- _FREE
- FRQA, FRQB
- IF
- IFNOT
- INA, INB
- LOCKCLR
- LOCKNEW
- LOCKRET
- LOCKSET
- LONG
- LONGFILL
- LONGMOVE
- LOOKDOWN, LOOKDOWNZ
- LOOKUP, LOOKUPZ
- NEXT
- OBJ
- Operators
- Expression Workspace
- Operator Attributes
- Unary / Binary
- Normal / Assignment
- Constant and/or Variable Expression
- Level of Precedence
- Intermediate Assignments
- Constant Assignment ‘=’
- Variable Assignment ‘:=’
- Add ‘+’, ‘+=’
- Positive ‘+’ (unary form of Add)
- Subtract ‘-’, ‘-=’
- Negate ‘-’ (unary form of Subtract)
- Decrement, pre- or post- ‘- -’
- Increment, pre- or post- ‘+ +’
- Multiply, Return Low ‘*’, ‘*=’
- Multiply, Return High ‘**’, ‘**=’
- Divide ‘/’, ‘/=’
- Modulus ‘//’, ‘//=’
- Limit Minimum ‘#>’, ‘#>=’
- Limit Maximum ‘<#’, ‘<#=’
- Square Root ‘^^’
- Absolute Value ‘||’
- Sign-Extend 7 or Post-Clear ‘~’
- Sign-Extend 15 or Post-Set ‘~~’
- Shift Arithmetic Right ‘~>’, ‘~>=’
- Random ‘?’
- Bitwise Decode ‘|<’
- Bitwise Encode ‘>|’
- Bitwise Shift Left ‘<<’, ‘<<=’
- Bitwise Shift Right ‘>>’, ‘>>=’
- Bitwise Rotate Left ‘<-’, ‘<-=’
- Bitwise Rotate Right ‘->’, ‘->=’
- Bitwise Reverse ‘><’, ‘><=’
- Bitwise AND ‘&’, ‘&=’
- Bitwise OR ‘|’, ‘|=’
- Bitwise XOR ‘^’, ‘^=’
- Bitwise NOT ‘!’
- Boolean AND ‘AND’, ‘AND=’
- Boolean OR ‘OR’, ‘OR=’
- Boolean NOT ‘NOT’
- Boolean Is Equal ‘==’, ‘===’
- Boolean Is Not Equal ‘<>’, ‘<>=’
- Boolean Is Less Than ‘<’, ‘<=’
- Boolean Is Greater Than ‘>’, ‘>=’
- Boolean Is Equal or Less ‘=<’, ‘=<=’
- Boolean Is Equal or Greater ‘=>’, ‘=>=’
- Symbol Address ‘@’
- Object Address Plus Symbol ‘@@’
- OUTA, OUTB
- PAR
- PHSA, PHSB
- PRI
- PUB
- QUIT
- REBOOT
- REPEAT
- RESULT
- RETURN
- ROUND
- SPR
- _STACK
- STRCOMP
- STRING
- STRSIZE
- Symbols
- TRUNC
- VAR
- VCFG
- VSCL
- WAITCNT
- WAITPEQ
- WAITPNE
- WAITVID
- WORD
- WORDFILL
- WORDMOVE
- _XINFREQ
- Chapter 3 : Assembly Language Reference
- The Structure of Propeller Assembly
- Categorical Listing of Propeller Assembly Language
- Assembly Language Elements
- ABS
- ABSNEG
- ADD
- ADDABS
- ADDS
- ADDSX
- ADDX
- AND
- ANDN
- CALL
- CLKSET
- CMP
- CMPS
- CMPSUB
- CMPSX
- CMPX
- CNT
- COGID
- COGINIT
- COGSTOP
- Conditions ( IF_x )
- CTRA, CTRB
- DIRA, DIRB
- DJNZ
- Effects ( WC, WZ, WR, NR )
- FIT
- FRQA, FRQB
- HUBOP
- IF_x (Conditions)
- INA, INB
- JMP
- JMPRET
- LOCKCLR
- LOCKNEW
- LOCKRET
- LOCKSET
- MAX
- MAXS
- MIN
- MINS
- MOV
- MOVD
- MOVI
- MOVS
- MUXC
- MUXNC
- MUXNZ
- MUXZ
- NEG
- NEGC
- NEGNC
- NEGNZ
- NEGZ
- NOP
- NR
- Operators
- OR
- ORG
- OUTA, OUTB
- PAR
- PHSA, PHSB
- RCL
- RCR
- RDBYTE
- RDLONG
- RDWORD
- Registers
- RES
- RET
- REV
- ROL
- ROR
- SAR
- SHL
- SHR
- SUB
- SUBABS
- SUBS
- SUBSX
- SUBX
- SUMC
- SUMNC
- SUMZ
- Symbols
- TEST
- TESTN
- TJNZ
- TJZ
- VCFG
- VSCL
- WAITCNT
- WAITPEQ
- WAITPNE
- WAITVID
- WC
- WR
- WRBYTE
- WRLONG
- WRWORD
- WZ
- XOR
- Appendix A: Reserved Word List
- Appendix B: Math Samples and Function Tables
- Index
Operators – Spin Language Reference
Table 2-9: Math and Logic Operators
Constant Expressions
1
Operator
Assignment
Usage
Integer Float
Is
Unary
Description, Page Number
=
always n/a
1
n/a
1
Constant assignment (CON blocks only), 148
:=
always n/a
1
n/a
1
Variable assignment (PUB/PRI blocks only), 149
+ +=
9 9
Add, 149
+
never
9 9 9
Positive (+X); unary form of Add, 150
- -=
9 9
Subtract, 150
-
if solo
9 9 9
Negate (-X); unary form of Subtract, 150
--
always
9
Pre-decrement (--X) or post-decrement (X--), 151
++
always
9
Pre-increment (++X) or post-increment (X++), 152
* *=
9 9
Multiply and return lower 32 bits (signed), 153
** **=
9
Multiply and return upper 32 bits (signed), 153
/ /=
9 9
Divide (signed), 154
// //=
9
Modulus (signed), 154
#> #>=
9 9
Limit minimum (signed), 155
<# <#=
9 9
Limit maximum (signed), 155
^^
if solo
9 9 9
Square root, 156
||
if solo
9 9 9
Absolute value, 156
~
always
9
Sign-extend from bit 7 (~X) or post-clear to 0 (X~); all bits low, 156
~~
always
9
Sign-extend from bit 15 (~~X) or post-set to -1 (X~~); all bits high, 157
~> ~>=
9
Shift arithmetic right, 158
?
always
9
Random number forward (?X) or reverse (X?), 159
|<
if solo
9
9
Bitwise: Decode value (0 - 31) into single-high-bit long, 160
>|
if solo
9
9
Bitwise: Encode long into value (0 - 32) as high-bit priority, 160
<< <<=
9
Bitwise: Shift left, 161
>> >>=
9
Bitwise: Shift right, 161
<- <-=
9
Bitwise: Rotate left, 162
-> ->=
9
Bitwise: Rotate right, 162
>< ><=
9
Bitwise: Reverse, 163
& &=
9
Bitwise: AND, 164
| |=
9
Bitwise: OR, 165
^ ^=
9
Bitwise: XOR, 165
!
if solo
9
9
Bitwise: NOT, 166
AND AND=
9 9
Boolean: AND (promotes non-0 to -1), 167
OR OR=
9 9
Boolean: OR (promotes non-0 to -1), 168
NOT
if solo
9 9 9
Boolean: NOT (promotes non-0 to -1), 168
== ===
9 9
Boolean: Is equal, 169
<> <>=
9 9
Boolean: Is not equal, 170
< <=
9 9
Boolean: Is less than (signed), 171
> >=
9 9
Boolean: Is greater than (signed), 171
=< =<=
9 9
Boolean: Is equal or less (signed), 171
=> =>=
9 9
Boolean: Is equal or greater (signed), 172
@
never
9
9
Symbol address, 173
@@
never
9
Object address plus symbol, 173
1
Assignment forms of operators are not allowed in constant expressions.
.
Page 144 · Propeller Manual v1.1