1235609Sgber$FreeBSD: releng/10.3/sys/boot/fdt/dts/bindings-localbus.txt 235609 2012-05-18 14:41:14Z gber $ 2235609Sgber 3235609SgberMarvell Device bus (localbus) configuration. 4235609Sgber============================================ 5235609Sgber 6235609Sgber1. Properties for localbus nodes 7235609Sgber 8235609Sgber1.1 ranges 9235609Sgber 10235609SgberProperty: ranges 11235609Sgber 12235609SgberValue type: <prop-encoded-array> encoded as arbitrary number of localbus 13235609Sgber nodes specifiers. 14235609Sgber 15235609SgberDescription: ranges property defines values used for mapping devices 16235609Sgber connected to localbus, in Marvell devices it is used also for 17235609Sgber setting decoding windows. 18235609Sgber 19235609Sgber a) child node address-cells: 20235609Sgber - first cell: number of bank (chip select) 21235609Sgber - second cell: (Marvell devices) Target ID for decoding 22235609Sgber windows setup 23235609Sgber 24235609Sgber b) parent node address cells: 25235609Sgber - address offset: used with parent's node base address to 26235609Sgber specify base address of mapped device 27235609Sgber 28235609Sgber c) child node size-cells: 29235609Sgber - size: defines amount of memory that should be reserved for 30235609Sgber device 31235609Sgber 32235609Sgber1.2 bank-count 33235609Sgber 34235609SgberProperty: bank-count 35235609Sgber 36235609SgberValue type: <u32> 37235609Sgber 38235609SgberDescription: The bank_count property defines maximum number of banks on 39235609Sgber localbus node. Bank is most often interpreted as device chip 40235609Sgber select, but may also describe another device (e.g. SPI flash). 41235609Sgber 42235609Sgber1.3 Example 43235609Sgber 44235609Sgber localbus@0 { 45235609Sgber #address-cells = <2>; 46235609Sgber #size-cells = <1>; 47235609Sgber compatible = "mrvl,lbc"; 48235609Sgber bank-count = <5>; 49235609Sgber 50235609Sgber /* This reflects CPU decode windows setup. */ 51235609Sgber ranges = <0x0 0x2f 0xb2200000 0x00100000 52235609Sgber 0x1 0x3e 0xb2100000 0x00100000 53235609Sgber 0x2 0x3d 0xb0000000 0x02000000 54235609Sgber 0x3 0x3b 0xb2000000 0x00100000>; 55235609Sgber }; 56235609Sgber 57235609Sgber2. Properties for localbus consumer nodes: 58235609Sgber 59235609Sgber2.1 reg 60235609Sgber 61235609SgberProperty: reg 62235609Sgber 63235609SgberValue type: <prop-encoded-array> 64235609Sgber 65235609SgberDescription: A standard property required for localbus child nodes. Defines 66235609Sgber the device memory region. 67235609Sgber 68235609Sgber a) first cell: number of bank (chip select) 69235609Sgber 70235609Sgber b) address offset: used with address offset from parent's ranges 71235609Sgber for corresponding bank to specify base address of 72235609Sgber the device 73235609Sgber 74235609Sgber c) size: defines size of the device memory region 75235609Sgber 76235609Sgber2.2 Example 77235609Sgber 78235609Sgber nor@0,0 { 79235609Sgber #address-cells = <1>; 80235609Sgber #size-cells = <1>; 81235609Sgber compatible = "cfi-flash"; 82235609Sgber reg = <0x0 0x0 0x00100000>; 83235609Sgber }; 84