अगर आपका डिवाइस ट्री ब्लॉब (DTB) या ओवरले के लिए डिवाइस ट्री ब्लॉब (DTBO), किसी यूनीक पार्टीशन में है, जैसे कि dtb
और dtbo
पार्टीशन, तो टेबल के इस स्ट्रक्चर और हेडर फ़ॉर्मैट का इस्तेमाल करें:
पहली इमेज. डीटीबी और डीटीबीओ पार्टीशन लेआउट का उदाहरण.
डेटा स्ट्रक्चर
dt_table_header
, सिर्फ़ dtb
/dtbo
पार्टीशन के लिए है. image.gz
के आखिर में, इस फ़ॉर्मैट को जोड़ा नहीं जा सकता. अगर आपके पास एक डीटीबी या डीटीबीओ है, तो भी आपको इस फ़ॉर्मैट का इस्तेमाल करना होगा. साथ ही, dt_table_header
में dt_entry_count
की वैल्यू 1 होगी.
#define DT_TABLE_MAGIC 0xd7b7ab1e
struct dt_table_header {
uint32_t magic; // DT_TABLE_MAGIC
uint32_t total_size; // includes dt_table_header + all dt_table_entry
// and all dtb/dtbo
uint32_t header_size; // sizeof(dt_table_header)
uint32_t dt_entry_size; // sizeof(dt_table_entry)
uint32_t dt_entry_count; // number of dt_table_entry
uint32_t dt_entries_offset; // offset to the first dt_table_entry
// from head of dt_table_header
uint32_t page_size; // flash page size we assume
uint32_t version; // DTBO image version, the current version is 0.
// The version is incremented when the
// dt_table_header struct is updated.
};
struct dt_table_entry {
uint32_t dt_size;
uint32_t dt_offset; // offset from head of dt_table_header
uint32_t id; // optional, must be zero if unused
uint32_t rev; // optional, must be zero if unused
uint32_t custom[4]; // optional, must be zero if unused
};
सभी dt_table_entry
पढ़ने के लिए, dt_entry_size
,
dt_entry_count
, और dt_entries_offset
का इस्तेमाल करें. उदाहरण:
my_read(entries_buf, header_addr + header->dt_entries_offset, header->dt_entry_size * header->dt_entry_count);
dt_table_entry
में मौजूद id
, rev
, custom
, डिवाइस ट्री के हार्डवेयर आइडेंटिफ़ायर हैं. ये ज़रूरी नहीं हैं. बूटलोडर इनका इस्तेमाल, लोड करने के लिए DTB या DTBO की सही पहचान करने के लिए कर सकता है. अगर बूटलोडर को ज़्यादा जानकारी की ज़रूरत है, तो उसे DTB या DTBO में डालें, ताकि बूटलोडर DTB या DTBO को पार्स करके उसे पढ़ सके. इसके लिए, नीचे दिया गया सैंपल कोड देखें.
नमूना कोड
यहां दिया गया सैंपल कोड, बूटलोडर में हार्डवेयर आइडेंटिफ़िकेशन की जांच करता है.
check_dtbo()
फ़ंक्शन, हार्डवेयर आइडेंटिफ़िकेशन की जांच करता है. यह सबसे पहले स्ट्रक्चdt_table_entry
(id
,rev
वगैरह) में मौजूद डेटा की जांच करता है. अगर यह डेटा काफ़ी नहीं है, तो यहdtb
डेटा को मेमोरी में लोड करता है औरdtb
में वैल्यू की जांच करता है.my_hw_information
औरsoc_id
प्रॉपर्टी की वैल्यू, रूट नोड में पार्स की जाती हैं (my_dtbo_1.dts
में उदाहरण).[my_dtbo_1.dts] /dts-v1/; /plugin/; / { /* As DTS design, these properties only for loader, won't overlay */ compatible = "board_manufacturer,board_model"; /* These properties are examples */ board_id = <0x00010000>; board_rev = <0x00010001>; another_hw_information = "some_data"; soc_id = <0x68000000>; ... }; &device@0 { value = <0x1>; status = "okay"; }; [my_bootloader.c] int check_dtbo(const dt_table_entry *entry, uint32_t header_addr) { ... if (entry->id != ... || entry->rev != ...) { ... } ... void * fdt_buf = my_load_dtb(header_addr + entry->dt_offset, entry->dt_size); int root_node_off = fdt_path_offset(fdt_buf, "/"); ... const char *my_hw_information = (const char *)fdt_getprop(fdt_buf, root_node_off, "my_hw_information", NULL); if (my_hw_information != NULL && strcmp(my_hw_information, ...) != 0) { ... } const fdt32_t *soc_id = fdt_getprop(fdt_buf, root_node_off, "soc_id", NULL); if (soc_id != NULL && *soc_id != ...) { ... } ... }
mkdtimg
mkdtimg
, dtb
/dtbo
इमेज बनाने के लिए एक टूल है (AOSP में system/libufdt
पर सोर्स कोड). mkdtimg
में कई निर्देश काम करते हैं. इनमें create
, cfg_create
, और
dump
शामिल हैं.
बनाएं
dtb
/dtbo
इमेज बनाने के लिए, create
कमांड का इस्तेमाल करें:
mkdtimg create <image_filename> (<global-option>...) \
<ftb1_filename> (<entry1_option>...) \
<ftb2_filename> (<entry2_option>...) \
...
ftbX_filename
, इमेज में dt_table_entry
जनरेट करता है. entryX_option
, dt_table_entry
को असाइन की जाने वाली वैल्यू हैं. ये वैल्यू इनमें से कोई भी हो सकती हैं:
--id=<number|path> --rev=<number|path> --custom0=<number|path> --custom1=<number|path> --custom2=<number|path> --custom3=<number|path>
संख्या की वैल्यू, 32-बिट अंक (जैसे, 68000) या हेक्स नंबर (जैसे, 0x6800) हो सकती है. इसके अलावा, इस फ़ॉर्मैट का इस्तेमाल करके भी पाथ तय किया जा सकता है:
<full_node_path>:<property_name>
उदाहरण के लिए, /board/:id
. mkdtimg
, DTB या DTBO फ़ाइल में मौजूद पाथ से वैल्यू पढ़ता है और dt_table_entry
में किसी रिलेटिव प्रॉपर्टी को वैल्यू (32-बिट) असाइन करता है. इसके अलावा, सभी एंट्री के लिए डिफ़ॉल्ट विकल्प के तौर पर global_option
दिया जा सकता है. dt_table_header
में page_size
की डिफ़ॉल्ट वैल्यू 2048 होती है. कोई दूसरी वैल्यू असाइन करने के लिए, global_option --page_size=<number>
का इस्तेमाल करें.
उदाहरण:
[board1.dts]
/dts-v1/;
/plugin/;
/ {
compatible = "board_manufacturer,board_model";
board_id = <0x00010000>;
board_rev = <0x00010001>;
another_hw_information = "some_data";
...
};
&device@0 {
value = <0x1>;
status = "okay";
};
mkdtimg create dtbo.img --id=/:board_id --custom0=0xabc \
board1.dtbo \
board2.dtbo --id=0x6800 \
board3.dtbo --id=0x6801 --custom0=0x123
- पहले
dt_table_entry
(board1.dtbo
)id
0x00010000
है औरcustom[0]
0x00000abc
है. - दूसरा
id
0x00006800
है औरcustom[0]
0x00000abc
है. - तीसरा
id
0x00006801
है औरcustom[0]
0x00000123
है. - बाकी सभी, डिफ़ॉल्ट वैल्यू (
0
) का इस्तेमाल करते हैं.
cfg_create
cfg_create
कमांड, कॉन्फ़िगरेशन फ़ाइल के साथ इमेज बनाता है. यह इमेज, यहां दिए गए फ़ॉर्मैट में बनती है:
# global options <global_option> ... # entries <ftb1_filename> # comment <entry1_option> # comment ... <ftb2_filename> <entry2_option> ... ...
विकल्प global_option
और entryX_option
, एक या उससे ज़्यादा स्पेस वर्ण से शुरू होने चाहिए. ये विकल्प, --
प्रीफ़िक्स के बिना create
विकल्पों जैसे ही होते हैं. खाली लाइनों या #
से शुरू होने वाली लाइनों को अनदेखा कर दिया जाता है.
उदाहरण:
[dtboimg.cfg]
# global options
id=/:board_id
rev=/:board_rev
custom0=0xabc
board1.dtbo
board2.dtbo
id=0x6800 # override the value of id in global options
board2.dtbo
id=0x6801 # override the value of id in global options
custom0=0x123 # override the value of custom0 in global options
mkdtimg cfg_create dtbo.img dtboimg.cfg
mkdtimg
, .dtb
/.dtbo
फ़ाइलों के लिए अलाइनमेंट को मैनेज नहीं करता. इसके बजाय, उन्हें इमेज में जोड़ता है.
.dts
को .dtb
/.dtbo
में कंपाइल करने के लिए dtc
का इस्तेमाल करने पर, आपको -a
विकल्प जोड़ना होगा. उदाहरण के लिए, -a 4
विकल्प जोड़ने पर पैडिंग जुड़ जाती है, ताकि .dtb
/.dtbo
का साइज़ चार बाइट के हिसाब से अलाइन हो जाए.
कई DT टेबल एंट्री, एक .dtb
/.dtbo
शेयर कर सकती हैं. अगर अलग-अलग एंट्री के लिए एक ही फ़ाइल नाम का इस्तेमाल किया जाता है, तो यह इमेज में एक ही कॉन्टेंट को एक ही dt_offset
और dt_size
के साथ सेव करता है. यह सुविधा, एक जैसे डीटी वाले अलग-अलग हार्डवेयर का इस्तेमाल करते समय काम की होती है.
डंप
dtb
/dtbo
इमेज के लिए, इमेज में मौजूद जानकारी को प्रिंट करने के लिए dump
कमांड का इस्तेमाल करें. उदाहरण:
mkdtimg dump dtbo.img
dt_table_header:
magic = d7b7ab1e
total_size = 1300
header_size = 32
dt_entry_size = 32
dt_entry_count = 3
dt_entries_offset = 32
page_size = 2048
version = 0
dt_table_entry[0]:
dt_size = 380
dt_offset = 128
id = 00010000
rev = 00010001
custom[0] = 00000abc
custom[1] = 00000000
custom[2] = 00000000
custom[3] = 00000000
(FDT)size = 380
(FDT)compatible = board_manufacturer,board_model
...