Skip to ContentSun and Oracle Channel Sun How to Buy Log In

Writing FCode 3.x Programs

Contained Within

Solaris 2.5.1 Driver Developer AnswerBook

Find More Documentation

Featured Support Resources

PDF로 이 문서 다운로드

Index

Symbols


:	6
;	7
`[']`	43

Numerics


0xfd	2

A


accessing
.....packages	54
active package	38
`"address"`	68
`"address-bits"`	68
`"#address-cells"`	67
addressing
.....packages	56
.....SBus	125
ANS Forth
.....and FCode	5
`apply`	49
`auto-boot?`	21
`"available"`	68

B


`begin-package`	26, 55, 57
`begin-select-dev`	33
binary executable programs	24
binary format
.....FCode	5
`buffer:`	42
`byte-load`	28

C


`$call-method`	40, 43, 46 to 48
`call-package`	43, 46
`$call-parent`	46 to 48
`"character-set"`	69
code examples
.....`$open-package`	45
.....`begin-package`	57
.....data
............instance-specific	54
............static	53
.....`find-package`	44
.....`open-dev`	56
.....`reg`	13
colon definition	6 to 7
command line editor	22
`"compatible"`	69


compile state	6
configuration variables
.....`auto-boot?`	21
.....`fcode-debug?`	21
current instance	38

D


data
.....initialized	42
.....instance-specific	42
.....package	41
.....packages	38
.....static	41
.....zero-filled	42
data definition
.....packages	53
deblocker support	61
`decode-unit`	43, 121
`defer`	42
defining
.....Forth words	6
`"depth"`	69
`dev`	29, 38
device
.....drivers, plug-in	50
.....identification	2
.....node	3
.....tree	3
device addressing
.....SBus	125
device methods
.....`block-size`	84
.....`decode-unit`	121
.....`dma-alloc`	122
.....`dma-free`	122
.....`dma-map-in`	122
.....`dma-map-out`	123
.....`dma-sync`	124
.....`load`	84, 156
.....`map-in`	125
.....`map-out`	125
.....`max-transfer`	85
.....`probe-self`	124
......`read`	85, 157, 201
......`read-blocks`	85
......`seek`	85
......`write`	85, 157
......`write-blocks`	85
device node
......browsing	29
......creating with`begin-package`	26
......creating with`end-package`	26
`"device_type"`	69
`device-end`	29
`"devsel-speed"`	70
`dma-alloc`	122
`dma-free`	122
`dma-map-in`	122
`dma-map-out`	123
`dma-sync`	124
driver
......and boot PROM	1
......function	1

E


end0	2
end1	2
`end-package`	28
`execute-device-method`	34, 46, 49
executing
......methods	43
execution token	43
......obtaining	43

F


FCode
......`/w`	352
......and ANS Forth	5
......binary format	5
......characteristics	5
......compile state	6
......defining words	6
......device identification	2
......in PROM	1
......interpret state	6


.....interpretation	2
.....interpreting	26
.....one-byte	14
.....programming style	8 to 10
.....property-specific FCodes	81
.....source format	5
.....stack	6
.....tokenizing	6
.....two-byte	14
.....valid program	2
.....`w!`	352
.....`w,`	352
.....`w@`	352
.....words	5
FCode programs	24
.....testing in source form	35
FCode PROM
.....body	2
.....end token	2
.....header	2
.....magic number	2
.....organization	2
.....size	2
FCode source	17 to 18
FCode types
.....interface	16
.....local	16
.....primitives	14
`fcode-debug?`	21
FCodes
.....`-`	216
.....`"model"`	79
.....`"reg"`	331
.....`#`	214
.....`#>`	201, 202, 214
.....`#columns`	248
.....`#line`	309
.....`#lines`	309
.....`#out`	324
.....`#s`	336
.....`$call-method`	38, 40, 43, 46 to 48, 241
.....`$call-parent`	46 to 48, 242
.....`$find`	283
.....`$number`	322
......`$open-package`	40, `44`, 55, `324`
......`'`	214
......`(`	215
......`(cr`	251
......`(is-user-word)`	303
......`*`	215
......`+`	216
......`+!`	216
......`+loop`	310
......`,`	216
......`.`	216
......`.r`	329
......`.s`	336
......`/`	218
......`/c`	240
......`/l`	305
......`/l*`	305
......`/mod`	315
......`/n`	319
......`/w*`	352
......`<`	218
......`<#`	219
......`<=`	219
......`<>`	219
......`<w@`	353
......`=`	219
......`>`	220
......`>=`	220
......`>>a`	225
......`>body`	237
......`>font`	287
......`>r`	329
......`?dup`	262
......`@`	220
......`0`	222
......`0<`	222
......`0<=`	222
......`0<>`	222
......`0=`	222
......`0>`	222
......`0>=`	223
......`-1`	223
......`1`	223
......`2`	223
......`2!`	224
......`2*`	224


.....`2/`	224
.....`2@`	224
.....`2drop`	262
.....`2dup`	262
.....`2over`	325
.....`2rot`	334
.....`2swap`	342
.....`3`	225
.....`abort`	225
.....`abs`	226
.....`alarm`	226
.....`aligned`	228
.....`alloc-mem`	228
.....`and`	229
.....`b(")`	229
.....`b(')`	229
.....`b(+loop)`	236
.....`b(:)`	229
.....`b(;)`	230
.....`b(<mark)`	236
.....`b(>resolve)`	237
.....`b(?do)`	233
.....`b(case)`	232
.....`b(constant)`	232
.....`b(create)`	232
.....`b(defer)`	232
.....`b(do)`	233
.....`b(endcase)`	234
.....`b(endof)`	234
.....`b(field)`	234
.....`b(leave)`	235
.....`b(lit)`	236
.....`b(loop)`	236
.....`b(of)`	237
.....`b(to)`	238
.....`b(value)`	238
.....`b(variable)`	238
.....`b?branch`	232
.....`base`	230
.....`bbranch`	231
.....`behavior`	233
.....`bell`	234
.....`between`	234
.....`bl`	234
.....`blink-screen`	235
.....`bljoin`	236
......`body>`	236
......`bounds`	237
......`bs`	237
......`bwjoin`	238, 239
......`byte-load`	239
......`c!`	239
......`c,`	239
......`c@`	240
......`ca+`	240
......`call-package`	43, 46, 241
......`catch`	244
......`cell+`	245
......`cells`	245
......`char-height`	245
......`chars`	246
......`char-width`	246
......`child`	246
......`close-package`	247
......`column#`	247
......`comp`	248
......`compile,`	249
......`count`	250
......`cpeek`	250
......`cpoke`	250
......`cr`	250
......`d-`	252
......`d+`	252
......`decode-int`	253
......`decode-phys`	254
......`decode-string`	254
......`default-font`	254
......`delete-characters`	257
......`delete-lines`	257
......`delete-property`	258
......`depth`	258
......`device-name`	258
......`diagnostic-mode?`	259
......`digit`	259
......`draw-character`	261
......`draw-logo`	261
......`drop`	262
......`dup`	262
......`emit`	263
......`encode+`	263
......`encode-bytes`	264
......`encode-int`	264


.....`encode-phys`	265
.....`encode-string`	265
.....`end0`	265
.....`end1`	266
.....`erase-screen`	266
.....`evaluate`	267
.....`execute`	267
.....`exit`	268
.....`expect`	268
.....`external-token`	269
.....`fb1-blink-screen`	269
.....`fb1-delete-lines`	270
.....`fb1-draw-character`	271
.....`fb1-draw-logo`	271
.....`fb1-erase-screen`	271
.....`fb1-insert-characters`	272
.....`fb1-insert-lines`	272
.....`fb1-install`	272
.....`fb1-invert-screen`	274
.....`fb1-reset-screen`	274
.....`fb1-slide-up`	274
.....`fb1-toggle-cursor`	275
.....`fb8-blink-screen`	275
.....`fb8-delete-characters`	275
.....`fb8-delete-lines`	276
.....`fb8-draw-character`	276
.....`fb8-draw-logo`	276
.....`fb8-erase-screen`	277
.....`fb8-insert-characters`	277
.....`fb8-insert-lines`	277
.....`fb8-install`	278
.....`fb8-invert-screen`	279
.....`fb8-reset-screen`	279
.....`fb8-toggle-cursor`	280
.....`fcode-revision`	280
.....`ferror`	281
.....`fill`	283
.....`find-method`	43, 46 to 48, 284
.....`find-package`	44, 285
.....`finish-device`	28, 54, 285
.....`fontbytes`	287
.....`frame-buffer-adr`	287
.....`free-mem`	288
.....`free-virtual`	289
.....`get-inherited-property`	289
.....`get-msecs`	290
......`get-my-property`	290
......`get-package-property`	291
......`get-token`	291
......`here`	293
......`hold`	294
......`i`	294
......`ihandle>phandle`	295
......`insert-characters`	295
......`insert-lines`	296
......`instance`	42, 296
......`inverse?`	296
......`inverse-screen?`	297
......`invert`	297
......`invert-screen`	298
......`is-install`	298, 299
......`is-remove`	301
......`is-selftest`	302
......`j`	303
......`key`	303
......`key?`	304
......`l!`	304
......`l,`	304
......`l@`	305
......`la+`	305
......`la1+`	305
......`lbflip`	306
......`lbflips`	306
......`lbsplit`	306
......`lcc`	306
......`left-parse-string`	55, 308
......`line#`	308
......`lpeek`	311
......`lpoke`	311
......`lshift`	311
......`lwflip`	311
......`lwflips`	311
......`lwsplit`	312
......`mac-address`	312
......`map-low`	312
......`mask`	313
......`max`	313
......`memory-test-suite`	314
......`min`	314
......`mod`	314
......`model`	315
......`move`	316


.....`ms`	316
.....`my-address`	317
.....`my-args`	55, 317
.....`my-parent`	318
.....`my-self`	43, 318
.....`my-space`	318
.....`my-unit`	57, 319
.....`na+`	320
.....`named-token`	320
.....`negate`	321
.....`new-device`	39, 321
.....`new-token`	321
.....`next-property`	321
.....`nip`	321
.....`noop`	322
.....`off`	322
.....`on`	323
.....`open-package`	44, 55, `323`
.....`or`	324
.....`over`	325
.....`pack`	325
.....`parse-2int`	325
.....`peer`	326
.....`pick`	327
.....`property`	78, 327
.....`r>`	328
.....`r@`	329
.....`rb!`	330
.....`rb@`	331
.....`reset-screen`	332
.....`rl!`	332
.....`rl@`	333
.....`roll`	333
.....`-rot`	334
.....`rot`	333
.....`rshift`	334
.....`rw!`	334, 335
.....`rw@`	334
.....`sbus-intr>cpu`	336
.....`screen-height`	336
.....`screen-width`	337
.....`set-args`	55, 337
.....`set-font`	338
.....`set-token`	338
.....`sign`	338
.....`span`	339
......`start0`	339
......`start1`	340
......`start2`	340
......`start4`	340
......`state`	341
......`suspend-fcode`	341
......`swap`	342
......`throw`	342
......`toggle-cursor`	343
......`tuck`	345
......`type`	345
......`u#`	345
......`u#>`	345
......`u#s`	346
......`u.`	346
......`u.r`	349
......`u/mod`	348
......`u<`	346
......`u<=`	346
......`u>`	346
......`u>=`	347
......`u2/`	347
......`um*`	347
......`um/mod`	348
......`unloop`	348
......`upc`	349
......`user-abort`	350
......`version1`	351
......`w!`	352
......`wa+`	353
......`wa1+`	353
......`wbflip`	353
......`wbflips`	353
......`wbsplit`	354
......`window-left`	354
......`window-top`	355
......`within`	355
......`wljoin`	356
......`wpeek`	356
......`wpoke`	356
......`xor`	356, 358
`find-device`	38
`find-method`	43, 46 to 48, 284
`find-package`	44, 285
`finish-device`	28, 54, 285


`fload`	18, 286
Forth
.....compile state	6
.....interpret state	6
.....programs	26
.....stack	6
.....tokenizing	6
.....words	5

G


`get-inherited-property`	29
`get-my-property`	29

H


`"height"`	70

I


ihandle	44
.....avoiding confusion with phandle	45
initialized data	42
instance
.....arguments	54
.....creation	38
.....package	38, 38
.....parameters	54
`instance`	42
instance chain	39
instance-specific
.....data	42
.....methods	43
interpret	37
interpret state	6
interpreting FCode	2, 26 to 28

L


`left-parse-string`	55
`"linebytes"`	70
`"little-endian-aperture"`	71
loading/executing files
.....Forth over serial port A	26
`"local-mac-address"`	71
`ls`	29

M


`"mac-address"`	72
`map-in`	125
`map-out`	125
mapping
......packages	57
`"max-frame-size"`	73
`"max-latency"`	73
methods
......calling other package methods	46
......executing	43
......instance-specific	43
......package	38
`"model"`	73, 79
`my-args`	55
`my-self`	43
`my-unit`	57

N


`"name"`	74
name
......of property	63
`new-device`	39
node
......machine	76
......SBus	76
......SCSI	76
NVRAM parameters
......setting	21
`nvramrc`	57

O


`open-dev`	40
`$open-package`	40, `44`, 45, `45`, 55, `324`
`open-package`	44, 55, 323
organizationally unique identifier	13
OUI	13

P


package	37
.....deblocker	61
.....TFTP	60
package method
.....`reset`	51, 52
.....`selftest`	52
package methods
.....`reset`	51, 52
`/packages`	44, `45`, `58`
packages
.....accessing	54
.....active	38
.....addressing	56
.....and linking	37
.....data	38, 41
.....data definition	53
.....instance	38
.....instances	38
.....interface	38
.....mapping	57
.....methods	38, 51
.....plug-in	37
.....properties	38
phandle	44, 291
.....avoiding confusion with ihandle	45
plug-in device drivers	50
plug-in package	37
`"power-consumption"`	74
probe	37
`probe-self`	124
probing sequence	58
.....expansion bus	21
.....modifying with NVRAM script	22
programming style
.....FCode	8 to 10
PROM
.....contents	1
`·properties`	29
properties
.....`"#address-cells"`	67
.....`"#size-cells"`	67
.....`"address"`	68
......`"address-bits"`	68
......`"available"`	68
......`"character-set"`	69
......`"compatible"`	69
......`"depth"`	69
......`"device_type"`	69
......`"devsel-speed"`	70
......`"height"`	70
......`"linebytes"`	70
......`"little-endian-aperture"`	71
......`"local-mac-address"`	71
......`"mac-address"`	72
......`"max-frame-size"`	73
......`"max-latency"`	73
......`"model"`	73
......`"name"`	74, 320
......`"power-consumption"`	74
......`"ranges"`	74
......`"reg"`	77, 319
......`"status"`	78
......`"vendor-id"`	78
......`"width"`	78
......block or byte device	86
......display device	66, 108
......memory device	67
......modifying from User Interface	58
......network device	67, 157
......packages	38
......parent node	67
......serial device	202
property
......`"ranges"`	77
......`"reg"`	77
......creation	65, 78
......decoding	80
......encoding	79
......list	3
......modification	78
......name	3
......property name	63
......property value	63, 79
......property value array formats	64
......retrieval	79
......standard names	66
......value	3


`property`	78
`pwd`	29

R


`"ranges"`	74, 77
`rb!`	330
`rb@`	331
`"reg"`	77, 319, 331
`reset`	51, 52
restricting system use	17
reverse polish notation	5
`rl!`	332
`rl@`	333
`rw!`	334, 335
`rw@`	334

S


SBus
.....node	76
SBus addressing	125
SCSI
.....node	76
`see`	29, 32
`select-dev`	31 to 33, 40
`selftest`	52
`set-args`	55
`show-devs`	29
size
.....FCode PROM	2
`"#size-cells"`	67
source format
.....FCode	5
stack	6
.....operation	7
stack comment	7
stack comments	10
standard methods
.....`decode-unit`	43
standard support packages	58
`state`	341
static data	41
`"status"`	78

T


TFTP
......support	60
tokenizer	25
......description	18
......directives	15
......macros	15
tokenizer directives
......`.(`	217
......`\`	221
......`]tokenizer`	344
......`alias`	227
......`decimal`	253
......`emit-byte`	263
......`external`	269
......`false`	269
......`fload`	18, 286
......`headerless`	292
......`headers`	293
......`hex`	293
......`offset16`	323
......`tokenizer[`	344
tokenizer macros
......`"`	212
......`(.)`	215
......`(u.)`	347
......`."`	217
......`.d`	253
......`.h`	292
......`/c*`	240
......`/n*`	319
......`:`	218
......`;`	218
......`<<`	219
......`>>`	220
......`?`	220
......`?do`	260
......`?leave`	307
......`[']`	43, 221
......`1-`	223
......`1+`	223


.....`2-`	224
.....`2+`	224
.....`3drop`	262
.....`3dup`	262
.....`accept`	226
.....`again`	226
.....`allot`	228
.....`ascii`	229
.....`begin`	233
.....`blank`	235
.....`buffer:`	42, 238
.....`ca1+`	240
.....`carret`	242
.....`case`	243
.....`constant`	249
.....`control`	249
.....`create`	251
.....`d#`	252
.....`decimal`	253
.....`decode-bytes`	253
.....`defer`	42, 255
.....`do`	260
.....`else`	263
.....`endcase`	266
.....`endof`	266
.....`erase`	266
.....`eval`	267
.....`fcode-version1`	280
.....`fcode-version2`	281
.....`field`	282
.....`h#`	291
.....`if`	294
.....`leave`	306
.....`linefeed`	309
.....`loop`	310
.....`na1+`	320
.....`not`	322
.....`of`	322
.....`repeat`	332
.....`s"`	335
.....`s.`	335
.....`space`	339
.....`spaces`	339
.....`struct`	341
.....`then`	342
.....`to`	342
......`true`	344
......`until`	348
......`value`	42, 350
......`variable`	42, 350
......`while`	354
tokenizing	6

U


unit-address	319
`unselect-dev`	33
`unselect-device`	28
User Interface
......`*/`	216
......`*/mod`	315
......`[`	221
......`[compile]`	249
......`]`	222
......`apply`	49
......`begin-package`	55
......browsing device nodes	29
............`·properties`	29
............`dev`	29
............`device-end`	29
............`get-inherited-property`	29
............`get-my-property`	29
............`ls`	29
............`pwd`	29
............`see`	29
............`show-devs`	29
............`words`	29
......`byte-load`	28
......command line editor	22
......`dev`	38
......`end-package`	28
......`execute-device-method`	46, 49
......`find-device`	38
......interpreting FCode	26 to 28
......modifying properties	58
......`nvramrc`	57
......`open-dev`	40
......`s"`	335
......testing a device driver	30 to 35
............`begin-select-dev`	33


............`execute-device-method`	34
............`patch`	33
............`see`	32
............`select-dev`	31
............`unselect-dev`	33
.....`unselect-device`	28

V


value
.....of property	63, 79
.....property	3
`value`	42
`variable`	42
`"vendor-id"`	78

W


`"width"`	78
words
.....FCode	5
.....Forth	5
`words`	29