10ce8cf2fSSuman AnnaGeneric hwlock bindings 20ce8cf2fSSuman Anna======================= 30ce8cf2fSSuman Anna 40ce8cf2fSSuman AnnaGeneric bindings that are common to all the hwlock platform specific driver 50ce8cf2fSSuman Annaimplementations. 60ce8cf2fSSuman Anna 70ce8cf2fSSuman AnnaPlease also look through the individual platform specific hwlock binding 80ce8cf2fSSuman Annadocumentations for identifying any additional properties specific to that 90ce8cf2fSSuman Annaplatform. 100ce8cf2fSSuman Anna 110ce8cf2fSSuman Annahwlock providers: 120ce8cf2fSSuman Anna================= 130ce8cf2fSSuman Anna 140ce8cf2fSSuman AnnaRequired properties: 150ce8cf2fSSuman Anna- #hwlock-cells: Specifies the number of cells needed to represent a 160ce8cf2fSSuman Anna specific lock. 170ce8cf2fSSuman Anna 180ce8cf2fSSuman Annahwlock users: 190ce8cf2fSSuman Anna============= 200ce8cf2fSSuman Anna 210ce8cf2fSSuman AnnaConsumers that require specific hwlock(s) should specify them using the 220ce8cf2fSSuman Annaproperty "hwlocks", and an optional "hwlock-names" property. 230ce8cf2fSSuman Anna 240ce8cf2fSSuman AnnaRequired properties: 250ce8cf2fSSuman Anna- hwlocks: List of phandle to a hwlock provider node and an 260ce8cf2fSSuman Anna associated hwlock args specifier as indicated by 270ce8cf2fSSuman Anna #hwlock-cells. The list can have just a single hwlock 280ce8cf2fSSuman Anna or multiple hwlocks, with each hwlock represented by 290ce8cf2fSSuman Anna a phandle and a corresponding args specifier. 300ce8cf2fSSuman Anna 310ce8cf2fSSuman AnnaOptional properties: 320ce8cf2fSSuman Anna- hwlock-names: List of hwlock name strings defined in the same order 330ce8cf2fSSuman Anna as the hwlocks, with one name per hwlock. Consumers can 340ce8cf2fSSuman Anna use the hwlock-names to match and get a specific hwlock. 350ce8cf2fSSuman Anna 360ce8cf2fSSuman Anna 370ce8cf2fSSuman Anna1. Example of a node using a single specific hwlock: 380ce8cf2fSSuman Anna 390ce8cf2fSSuman AnnaThe following example has a node requesting a hwlock in the bank defined by 400ce8cf2fSSuman Annathe node hwlock1. hwlock1 is a hwlock provider with an argument specifier 410ce8cf2fSSuman Annaof length 1. 420ce8cf2fSSuman Anna 430ce8cf2fSSuman Anna node { 440ce8cf2fSSuman Anna ... 450ce8cf2fSSuman Anna hwlocks = <&hwlock1 2>; 460ce8cf2fSSuman Anna ... 470ce8cf2fSSuman Anna }; 480ce8cf2fSSuman Anna 490ce8cf2fSSuman Anna2. Example of a node using multiple specific hwlocks: 500ce8cf2fSSuman Anna 510ce8cf2fSSuman AnnaThe following example has a node requesting two hwlocks, a hwlock within 520ce8cf2fSSuman Annathe hwlock device node 'hwlock1' with #hwlock-cells value of 1, and another 530ce8cf2fSSuman Annahwlock within the hwlock device node 'hwlock2' with #hwlock-cells value of 2. 540ce8cf2fSSuman Anna 550ce8cf2fSSuman Anna node { 560ce8cf2fSSuman Anna ... 570ce8cf2fSSuman Anna hwlocks = <&hwlock1 2>, <&hwlock2 0 3>; 580ce8cf2fSSuman Anna ... 590ce8cf2fSSuman Anna }; 60