1 /* This is a bcm43xx microcode assembly example.
3 * In this example file, r0 and r1 are always input
4 * registers and r2 is output.
5 * For input we can always have constant values or (one) memory
6 * operand instead of the input registers shown here.
10 * Offset Registers: off0 - off5
13 * To access memory, two methods can be used. Examples follow.
16 * Indirect through Offset Register (pointer):
21 /* The target architecture. Supported versions are 5 and 15 */
24 /* Program entry point */
27 #define PSM_BRC spr848
29 #define ECOND_MAC_ON (0x20 | 4)
31 %assert ((((1))) == ((((2 - 1) & 0xFF))))
32 %assert ((1 == 2) || (1 == (0xFF & 1)))
34 %assert ((1 == (2 - 1)) && (2 == 2))
38 /* Inline assertion inside of a complex immediate.
39 * The %assert() expression will always return zero. */
40 mov (1 + (%assert(1 == ((1 + 2) - 2)))), r0
43 /* ADD instructions */
44 add r0,r1,r2 /* add */
45 add. r0,r1,r2 /* add, set carry */
46 addc r0,r1,r2 /* add with carry */
47 addc. r0,r1,r2 /* add with carry, set carry */
50 /* SUB instructions */
51 sub r0,r1,r2 /* sub */
52 sub. r0,r1,r2 /* sub, set carry */
53 subc r0,r1,r2 /* sub with carry */
54 subc. r0,r1,r2 /* sub with carry, set carry */
56 sra r0,r1,r2 /* arithmetic rightshift */
58 /* Logical instructions */
59 or r0,r1,r2 /* bitwise OR */
60 and r0,r1,r2 /* bitwise AND */
61 xor r0,r1,r2 /* bitwise XOR */
62 sr r0,r1,r2 /* rightshift */
63 sl r0,r1,r2 /* leftshift */
65 srx 7,8,r0,r1,r2 /* eXtended right shift (two input regs) */
67 rl r0,r1,r2 /* rotate left */
68 rr r0,r1,r2 /* rotate right */
69 nand r0,r1,r2 /* clear bits (notmask + and) */
71 orx 7,8,r0,r1,r2 /* eXtended OR */
73 /* Copy instruction. This is a virtual instruction
74 * translated to more lowlevel stuff like OR. */
75 mov r0,r2 /* copy data */
78 jmp label /* unconditional jump */
79 jand r0,r1,label /* jump if binary AND */
80 jnand r0,r1,label /* jump if not binary AND */
81 js r0,r1,label /* jump if all bits set */
82 jns r0,r1,label /* jump if not all bits set */
83 je r0,r1,label /* jump if equal */
84 jne r0,r1,label /* jump if not equal */
85 jls r0,r1,label /* jump if less (signed) */
86 jges r0,r1,label /* jump if greater or equal (signed) */
87 jgs r0,r1,label /* jump if greater (signed) */
88 jles r0,r1,label /* jump if less or equal (signed) */
89 jl r0,r1,label /* jump if less */
90 jge r0,r1,label /* jump if greater or equal */
91 jg r0,r1,label /* jump if greater */
92 jle r0,r1,label /* jump if less or equal */
94 jzx 7,8,r0,r1,label /* Jump if zero after shift and mask */
95 jnzx 7,8,r0,r1,label /* Jump if nonzero after shift and mask */
97 /* jump on external conditions */
98 jext ECOND_MAC_ON,label /* jump if external condition is TRUE */
99 jnext ECOND_MAC_ON,label /* jump if external condition is FALSE */
102 call lr0,label /* store PC in lr0, call func at label */
103 ret lr0,lr1 /* store PC in lr0, return to lr1
104 * Both link registers can be the same
105 * and don't interfere. */
107 /* TKIP sbox lookup */
108 tkiph r0,r2 /* Lookup high */
109 tkiphs r0,r2 /* Lookup high, byteswap */
110 tkipl r0,r2 /* Lookup low */
111 tkipls r0,r2 /* Lookup low, byteswap */
113 nap /* sleep until event */
115 /* raw instruction */
116 @160 r0,r1,r2 /* equivalent to or r0,r1,r2 */
117 @1C0 @C11, @C22, @BC3
120 /* Support for directional jumps.
121 * Directional jumps can be used to conveniently jump inside of
122 * functions without using function specific label prefixes. Note
123 * that this does not establish a sub-namespace, though. "loop"
124 * and "out" are still in the global namespace and can't be used
125 * anymore for absolute jumps (Assembler will warn about duplication).
146 /* The assembler has support for fancy assemble-time
147 * immediate constant expansion. This is called "complex immediates".
148 * Complex immediates are _always_ clamped by parentheses. There is no
149 * operator precedence. You must use parentheses to tell precedence.
161 mov (1 << (0x3 + 2)),r0
162 mov (1 + (2 + (3 + 4))),r0
163 mov (4 >> (((((~5 | 0x21)))) | (~((10) & 2)))),r0
166 /* Some regression testing for the assembler follows */
167 mov 2,off0 /* test memory stuff */
168 xor 0x124,r1,[0x0,off0] /* test memory stuff */
169 xor 0x124,r0,[0x0] /* test memory stuff */
170 mov -34,r0 /* negative dec numbers are supported */
171 or r0,r1,@BC2 /* We also support single raw operands */
172 mov 0xEEEE,r0 /* MOV supports up to 16bit */
173 jand 0x3800,r0,label /* This is emulated by jnzx */
174 jnand 0x3800,r0,label /* This is emulated by jzx */
175 or spr06c,0,spr06c /* Can have one spr input and one spr output */
176 or [0],0,[0] /* Can have one mem input and one mem output */
177 mov testlabel, r0 /* Can use label as immediate value */
178 mov r0,r1;mov r2, r3 /* ; does split instructions */
179 mov [(1+1)],[(2+2),off0] /* Can use complex immediates as memory offsets */
180 orx (0 + 1), (1 * 2), 0, 0, r0 /* Allow complex immediates as M or S */
183 /* The .initvals section generates an "Initial Values" file
184 * with the name "foobar" in this example, which is uploaded
185 * by the kernel driver on load. This is useful for writing ucode
186 * specific values to the chip without bloating the small ucode
187 * memory space with this initialization stuff.
188 * Values are written in order they appear here.
191 mmio16 0x1234, 0xABC /* Write 0x1234 to MMIO register 0xABC */
192 mmio32 0x12345678, 0xABC /* Write 0x12345678 to MMIO register 0xABC */
193 phy 0x1234, 0xABC /* Write 0x1234 to PHY register 0xABC */
194 radio 0x1234, 0xABC /* Write 0x1234 to RADIO register 0xABC */
195 shm16 0x1234, 0x0001, 0x0002 /* Write 0x1234 to SHM routing 0x0001, register 0x0002 */
196 shm32 0x12345678, 0x0001, 0x0002 /* Write 0x12345678 to SHM routing 0x0001, register 0x0002 */
199 // vim: syntax=b43 ts=8