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

Writing FCode 3.x Programs

Contenues dans

Driver Developer Site 1.0 AnswerBook

Trouver plus de documentation

Ressources d'assistance comprises

Télécharger cet ouvrage au format PDF

Index

Symbols


`"alternate-reg"`	92
`"assigned-addresses"`	92
`"big-endian-aperture"`	93
`"fast-back-to-back"`	97
`"has-fcode"`	97
:	12
;	13
`[']`	63

Numerics


0xfd	2
3.x tokenizer	50
`66Mhz-capable`	9
68	57

A


`a.out` header	5
accessing
.....packages	74
accessing a PCI device's configurationspace registers	45
active package	58
adding a PCI header to a PROM	45
`address`	90
`address-bits`	90
`#address-cells`	89
addressing
.....packages	76
.....SBus	161
ANS Forth
.....and FCode	11
`apply`	69
`assigned-addresses` property	9
`auto-boot?`	28
`available`	92

B


`begin-package`	34, 75, 77
`begin-select-dev`	40
binary executable programs	32
binary format
.....FCode	11
boot scenario, Solaris	51
boot software roles	51
booting FCode image	5
`buffer:`	62
`byte-load`	35

C


`cache-line-size`	9
`$call-method`	60, 64, ?? to 69
`call-package`	64
`$call-parent`,?? to69
`map-in $call-parent`	44
`character-set`	93
`class-code`	9
code examples
.....`$open-package`	65
.....`begin-package`	77
.....data
............instance-specific	74
............static	73
.....`find-package`	64
.....`open-dev`	76
.....`reg`	19
colon definition	12 to 13
command line editor	30
`compatible`	94
compile state	12
configuration space base address	51
configuration space command register	52
configuration variables
.....`auto-boot?`	28
.....`fcode-debug?`	28
CPU PROM-generated properties	8
current instance	58

D


data
.....initialized	62
.....instance-specific	62
.....package	61
.....packages	58
.....static	62
.....zero-filled	62
data definition
.....packages	73
deblocker support	81
`decode-unit`	63, 157
`defer`	62
defining
......Forth words	12
`depth`	94
`dev`	36, 58
device
......drivers, plug-in	70
......identification	2
......node	3
......tree	3
device addressing
......SBus	161
device methods
......`block-size`	122
......`decode-unit`	157
......`dma-alloc`	158
......`dma-free`	158, 237
......`dma-map-in`	159
......`dma-map-out`	159
......`dma-sync`	160
......`load`	122, 192
......`map-in`	161
......`map-out`	161
......`max-transfer`	123
......`probe-self`	160
......`read`	123, 193, 237
......`read-blocks`	123
......`seek`	123
......`write`	124, 193
......`write-blocks`	124
device node
......browsing	36
......creating with`begin-package`	34
......creating with`end-package`	34
device property generation	51
`device_type`	95
`device-end`	36
`device-id`	9
`devsel-speed`	9, 96
`dloading`FCode image	5
`dma-alloc`	158
`dma-free`	158, 237
`dma-map-in`	159


`dma-map-out`	159
`dma-sync`	160
driver
.....and boot PROM	1
.....function	1

E


end0	2
end1	2
`end-package`	35
`execute-device-method`	41, 69
executing
.....methods	63
execution token	63
.....obtaining	63
expansion FCode PROM access	53

F


`fakeboot`	5
`fast-back-to-back`	9
FCode
.....`/w`	391
.....and ANS Forth	11
.....binary format	11
.....characteristics	11
.....compile state	12
.....defining words	12
.....device identification	2
.....in PROM	1
.....interpret state	12
.....interpretation	2
.....interpreting	34
.....one-byte	20
.....programming style	14 to 16
.....property-specific FCodes	118
.....source format	11
.....stack	12
.....tokenizing	12
.....two-byte	20
.....valid program	2
.....`w!`	390
.....`w,`	390
.....`w@`	391
......words	11
FCode programs	32
......testing in source form	42
FCode PROM
......body	2
......end token	2
......header	2
......magic number	2
......organization	2
......size	2
FCode source	25 to 26
FCode types
......interface	21
......local	22
......primitives	20
`fcode-debug?`	24, 28
FCodes
......`-`	260
......`#`	257
......`#>`	237, 238, 257
......`#columns`	290
......`#line`	348
......`#lines`	348
......`#out`	363
......`#s`	374
......`$call-method`	58, 60, 64, ?? to 69, 284
......`$call-parent`,?? to69	285
......`$find`	325
......`$number`	361
......`$open-package`	60, `65`, 75, `362`
......`'`	258
......`(`	258
......`(cr`	293
......`(is-user-word)`	342
......`*`	259
......`+`	259
......`+!`	259
......`+loop`	349
......`,`	259
......`.`	260
......`.r`	367
......`.s`	374
......`/`	261
......`/c`	283


.....`/l`	345
.....`/l*`	345
.....`/mod`	354
.....`/n`	358
.....`/w*`	391
.....`<`	262
.....`<#`	262
.....`<=`	262
.....`<>`	263
.....`<w@`	391
.....`=`	263
.....`>`	263
.....`>=`	263
.....`>>a`	268
.....`>body`	280
.....`>font`	328
.....`>r`	368
.....`?dup`	304
.....`@`	264
.....`0`	265
.....`0<`	265
.....`0<=`	265
.....`0<>`	265
.....`0=`	266
.....`0>`	266
.....`0>=`	266
.....`-1`	266
.....`1`	266
.....`2`	267
.....`2!`	267
.....`2*`	267
.....`2/`	267
.....`2@`	268
.....`2drop`	303
.....`2dup`	304
.....`2over`	363
.....`2rot`	372
.....`2swap`	380
.....`3`	268
.....`abort`	268
.....`abs`	269
.....`alarm`	269
.....`aligned`	271
.....`alloc-mem`	271
.....`and`	272
.....`b(")`	272
......`b(')`	272
......`b(+loop)`	279
......`b(:)`	272
......`b(;)`	273
......`b(<mark)`	279
......`b(>resolve)`	280
......`b(?do)`	276
......`b(case)`	275
......`b(constant)`	275
......`b(create)`	275
......`b(defer)`	275
......`b(do)`	276
......`b(endcase)`	277
......`b(endof)`	277
......`b(field)`	277
......`b(leave)`	278
......`b(lit)`	279
......`b(loop)`	279
......`b(of)`	280
......`b(to)`	281
......`b(value)`	281
......`b(variable)`	281
......`b?branch`	275
......`base`	273
......`bbranch`	274
......`behavior`	276
......`bell`	277
......`between`	277
......`bl`	277
......`blink-screen`	278
......`bljoin`	279
......`body>`	279
......`bounds`	280
......`bs`	280
......`bwjoin`	281, 282
......`byte-load`	282
......`c!`	282
......`c,`	282
......`c@`	283
......`ca+`	283
......`call-package`	64, 284
......`catch`	286
......`cell+`	288
......`cells`	288
......`char-height`	288
......`chars`	288


.....`char-width`	288
.....`child`	289
.....`close-package`	289
.....`column#`	290
.....`comp`	291
.....`compile,`	291
.....`count`	292
.....`cpeek`	292
.....`cpoke`	293
.....`cr`	293
.....`d-`	295
.....`d+`	294
.....`decode-int`	296
.....`decode-phys`	296
.....`decode-string`	296
.....`default-font`	297
.....`delete-characters`	299
.....`delete-lines`	299
.....`delete-property`	300
.....`depth`	300
.....`device-name`	300
.....`diagnostic-mode?`	301
.....`digit`	301
.....`draw-character`	302
.....`draw-logo`	303
.....`drop`	303
.....`dup`	304
.....`emit`	304
.....`encode+`	305
.....`encode-bytes`	306
.....`encode-int`	306
.....`encode-phys`	306
.....`encode-string`	307
.....`end0`	307
.....`end1`	307
.....`erase-screen`	308
.....`evaluate`	308
.....`execute`	309
.....`exit`	309
.....`expect`	310
.....`external-token`	311
.....`fb1-blink-screen`	311
.....`fb1-delete-lines`	312
.....`fb1-draw-character`	312
.....`fb1-draw-logo`	313
.....`fb1-erase-screen`	313
......`fb1-insert-characters`	313
......`fb1-insert-lines`	314
......`fb1-install`	314
......`fb1-invert-screen`	315
......`fb1-reset-screen`	316
......`fb1-slide-up`	316
......`fb1-toggle-cursor`	316
......`fb8-blink-screen`	317
......`fb8-delete-characters`	317
......`fb8-delete-lines`	318
......`fb8-draw-character`	318
......`fb8-draw-logo`	318
......`fb8-erase-screen`	319
......`fb8-insert-characters`	319
......`fb8-insert-lines`	319
......`fb8-install`	320
......`fb8-invert-screen`	321
......`fb8-reset-screen`	321
......`fb8-toggle-cursor`	321
......`fcode-revision`	322
......`ferror`	323
......`fill`	325
......`find-method`	63, ?? to 69, 326
......`find-package`	64, 326
......`finish-device`	36, 74, 327
......`fontbytes`	328
......`frame-buffer-adr`	329
......`free-mem`	330
......`free-virtual`	330
......`get-inherited-property`	330
......`get-msecs`	331
......`get-my-property`	331
......`get-package-property`	332
......`get-token`	332
......`here`	334
......`hold`	334
......`i`	335
......`ihandle>phandle`	336
......`insert-characters`	336
......`insert-lines`	336
......`instance`	62, 337
......`inverse?`	337
......`inverse-screen?`	338
......`invert`	338
......`invert-screen`	339
......`is-install`	339


.....`is-remove`	341
.....`is-selftest`	342
.....`j`	343
.....`key`	343
.....`key?`	344
.....`l!`	344
.....`l,`	344
.....`l@`	344
.....`la+`	345
.....`la1+`	345
.....`lbflip`	345
.....`lbflips`	345
.....`lbsplit`	346
.....`lcc`	346
.....`left-parse-string`	75, 347
.....`line#`	348
.....`lpeek`	350
.....`lpoke`	350
.....`lshift`	350
.....`lwflip`	351
.....`lwflips`	351
.....`lwsplit`	351
.....`mac-address`	351
.....`map-low`	352
.....`mask`	352
.....`max`	353
.....`memory-test-suite`	353
.....`min`	353
.....`mod`	353
.....`model`	115, 354
.....`move`	355
.....`ms`	355
.....`my-address`	356
.....`my-args`	75, 356
.....`my-parent`	357
.....`my-self`	64, 357
.....`my-space`	357
.....`my-unit`	77, 358
.....`na+`	358
.....`named-token`	359
.....`negate`	359
.....`new-device`	59, 360
.....`new-token`	360
.....`next-property`	360
.....`nip`	360
.....`noop`	360
......`off`	361
......`on`	362
......`open-package`	64, 75, `362`
......`or`	363
......`over`	363
......`pack`	363
......`parse-2int`	364
......`peer`	364
......`pick`	365
......`property`	115, 365
......`r>`	367
......`r@`	367
......`rb!`	368
......`rb@`	369
......`reg`	369
......`reset-screen`	370
......`rl!`	371
......`rl@`	371
......`roll`	371
......`-rot`	372
......`rot`	372
......`rshift`	372
......`rw!`	372, 373
......`rw@`	373
......`sbus-intr>cpu`	374
......`screen-height`	375
......`screen-width`	375
......`set-args`	75, 375
......`set-font`	376
......`set-token`	376
......`sign`	377
......`span`	377
......`start0`	378
......`start1`	378
......`start2`	378
......`start4`	379
......`state`	379
......`suspend-fcode`	379
......`swap`	380
......`throw`	380
......`toggle-cursor`	381
......`tuck`	383
......`type`	383
......`u#`	383
......`u#>`	384
......`u#s`	384


.....`u.`	384
.....`u.r`	387
.....`u/mod`	386
.....`u<`	384
.....`u<=`	385
.....`u>`	385
.....`u>=`	385
.....`u2/`	385
.....`um*`	386
.....`um/mod`	386
.....`unloop`	386
.....`upc`	387
.....`user-abort`	388
.....`version1`	389
.....`w!`	391
.....`wa+`	391
.....`wa1+`	392
.....`wbflip`	392
.....`wbflips`	392
.....`wbsplit`	392
.....`window-left`	393
.....`window-top`	394
.....`within`	394
.....`wljoin`	394
.....`wpeek`	395
.....`wpoke`	395
.....`xor`	395, 397
`find-device`	58
`find-method`	63, ?? to 69, 326
`find-package`	64, 326
`finish-device`	36, 74, 327
`fload`	26, 327
Forth
.....compile state	12
.....interpret state	12
.....programs	33
.....stack	12
.....tokenizing	12
.....words	11

G


`get-inherited-property`	36
`get-my-property`	36

H


`height`	97

I


`ihandle`	64
......avoiding confusion with`phandle`	66
initialized data	62
instance
......arguments	74
......creation	58
......package	58, 58
......parameters	74
`instance`	62
instance chain	59
instance-specific
......data	62
......methods	63
interpret	57
interpret state	12
interpreting FCode	2, 34 to 36

L


`left-parse-string`	75
`linebytes`	98
loading/executing files
......Forth over serial port A	33
`local-mac-address`	100
`ls`	36

M


`mac-address`	100
`map?`	44
`map-in`	48, 161
`map-out`	161
mapping
......packages	77
`max-frame-size`	101
`max-latency`	9
methods


.....calling other package methods	66
.....executing	63
.....instance-specific	63
.....package	58
`min-grant`	9
`model`	102, 115
`my-args`	75
`my-self`	64
`my-unit`	77

N


`name`	102
`new-device`	59
node
.....machine	107
.....SBus	107
.....SCSI	107
NVRAM parameters
.....setting	28
NVRAM variable`fcode-debug?`	24
`nvramrc`	77

O


`open-dev`	60
`$open-package`	60, 65, 66, 75, `362`
`open-package`	64, 75, 362
organizationally unique identifier	19
OUI	19

P


package	57
.....deblocker	81
.....TFTP	80
package method
.....`reset`	71, 72
.....`selftest`	72
package methods
.....`reset`	71, 72
`/packages`	64, 65, 78
packages
.....accessing	74
......active	58
......addressing	76
......and linking	57
......data	58, 61
......data definition	73
......instance	58
......instances	58
......interface	58
......mapping	77
......methods	58, 71
......plug-in	57
......properties	58
packaging PCI FCode	23
PCI
......data structure	5
......device configuration registeraccess	8
......FCode PROM header format	5
PCI expansion PROM
......data structure	6
......header	5
......header format	6
`pcia`	46
`pcia-probe-list`	49
`pcib`	46, 49
`pcib-probe-list`	49
`pcimsg?`	24
`phandle`	332
......avoiding confusion with`ihandle`	66
`phandle`s	64
`phys.hi`	7, 48
`phys.hi`cell	51
`phys.lo`	7, 48
`phys.mid`	7, 48
physical addresses, finding and using	47
plug-in
......device drivers	70
......package	57
......PCI device physical address	49
probe	57
`probemsg?`	24
`probe-self`	160


probing sequence	78
.....expansion bus	29
.....modifying with NVRAM script	29
programming style
.....FCode	14 to 16
PROM
.....contents	1
`·properties`	36
properties
.....`"alternate-reg"`	92
.....`"assigned-addresses"`	92
.....`"big-endian-aperture"`	93
.....`"fast-back-to-back"`	97
.....`"has-fcode"`	97
.....`#address-cells`	89
.....`#size-cells`	89
.....`address`	90
.....`address-bits`	90
.....`available`	92
.....block or byte device	125
.....`character-set`	93
.....`compatible`	94
.....`depth`	94
.....`device_type`	95
.....`devsel-speed`	96
.....display device	86, 146
.....`height`	97
.....`linebytes`	98
.....list	3
.....`local-mac-address`	100
.....`mac-address`	100
.....`max-frame-size`	101
.....memory device	87
.....`model`	102
.....modifying from User Interface	78
.....`name`	3, 102, 359
.....network device	87, 193
.....packages	58
.....parent node	87
.....`ranges`	105
.....`reg`	110, 358
.....serial device	238
.....`vendor-id`	115
.....`width`	115
property
......creation	85, 115
......decoding	117
......encoding	116
......modification	115
......name	83
......property value	115
......`ranges`	107
......`reg`	107
......retrieval	116
......standard names	86
......value	3, 83
......value array formats	84
`property`	115
`pwd`	36

R


`ranges`	105, 107
`rb!`	368
`rb@`	369
`reg`	107, 110, 358, 369
`reg` property physical address format	7, 8
`reset`	71, 72
restricting system use	25
reverse polish notation	12
`revision-id`	9
`rl!`	371
`rl@`	371
`rw!`	372, 373
`rw@`	373

S


SBus
......addressing	161
......node	107
SBus addressing	161
SCSI
......node	107
`see`	36, 39
`select-dev`	38 to 40, 60
`selftest`	72


set`fcode-verbose? fromNVRAMRC`	24
`set-args`	75
`show-devs`	36
size
.....FCode PROM	2
`size.hi`	7
`size.lo`	7
`#size-cells`	89
source format
.....FCode	11
stack	12
.....comments	13, 16
.....operation	13
standard methods
.....`decode-unit`	63
standard support packages	78
`state`	379
static data	62
`subsystem-id`	9
`subsystem-vendor-id`	9
Sun Ultra-1 UPA/PCI-related nodes	46
system cache line size	45
system flags and FCode debugging	24

T


TFTP
.....support	80
tokenizer	33
.....description	25
.....directives	21
.....macros	20
tokenizer directives
.....`.(`	260
.....`\`	264
.....`]tokenizer`	382
.....`alias`	270
.....`decimal`	295
.....`emit-byte`	305
.....`external`	310
.....`false`	311
.....`fload`	26, 327
......`headerless`	333
......`headers`	333
......`hex`	334
......`offset16`	361
......`tokenizer[`	382
tokenizer macros
......`"`	256
......`(.)`	258
......`(u.)`	385
......`."`	260
......`.d`	295
......`.h`	333
......`/c*`	283
......`/n*`	358
......`:`	261
......`;`	261
......`<<`	262
......`>>`	263
......`?`	263
......`?do`	302
......`?leave`	347
......`[']`	63, 264
......`1-`	266
......`1+`	266
......`2-`	267
......`2+`	267
......`3drop`	304
......`3dup`	304
......`accept`	269
......`again`	269
......`allot`	271
......`ascii`	272
......`begin`	276
......`blank`	278
......`buffer:`	62, 281
......`ca1+`	283
......`carret`	285
......`case`	285
......`constant`	291
......`control`	292
......`create`	293
......`d#`	294
......`decimal`	295
......`decode-bytes`	295
......`defer`	62, 297


.....`do`	302
.....`else`	304
.....`endcase`	307
.....`endof`	308
.....`erase`	308
.....`eval`	308
.....`fcode-version1`	322
.....`fcode-version2`	323
.....`field`	324
.....`h#`	332
.....`if`	335
.....`leave`	346
.....`linefeed`	348
.....`loop`	349
.....`na1+`	359
.....`not`	360
.....`of`	361
.....`repeat`	370
.....`s"`	373
.....`s.`	374
.....`space`	377
.....`spaces`	377
.....`struct`	379
.....`then`	380
.....`to`	381
.....`true`	383
.....`until`	387
.....`value`	62, 388
.....`variable`	62, 389
.....`while`	393
tokenizing	12

U


`udf-supported`	9
`unit-address`	358
`unselect-dev`	40
`unselect-device`	36
User Interface
.....`*/`	259
.....`*/mod`	354
.....`[`	264
.....`[compile]`	291
.....`]`	265
.....`apply`	69
......`begin-package`	75
......browsing device nodes	36
............`·properties`	36
............`dev`	36
............`device-end`	36
............`get-inherited-property`	36
............`get-my-property`	36
............`ls`	36
............`pwd`	36
............`see`	36
............`show-devs`	36
............`words`	36
......`byte-load`	35
......command line editor	30
......`dev`	58
......`end-package`	35
......`execute-device-method`	69
......`find-device`	58
......interpreting FCode	34 to 36
......modifying properties	78
......`nvramrc`	77
......`open-dev`	60
......`s"`	373
......testing a device driver	38 to 42
............`begin-select-dev`	40
............`execute-device-method`	41
............`patch`	40
............`see`	39
............`select-dev`	38
............`unselect-dev`	40
......`unselect-device`	36

V


value
......of property	115
......property	3
`value`	62
`variable`	62
variable`fcode-debug?`	24
`vendor-id`	8, 115
Vital Product Data	7, 53

W


`width`	115
words
.....FCode	11
.....Forth	11
`words`	36

X


`xxx clip-num`	50