omap_read_page_bch(9)

okay bestie, welcome to the Kernel API Manual page for omap_read_page_bch(9) 💅✨

---

💖 NAME 💖

omap_read_page_bch — the BCH ecc based page read function for entire page. she reads the whole page, no cap 📖✨

✨ SYNOPSIS ✨

here's the exact signature, bestie — don't retype it from memory:

int omap_read_page_bch (struct nand_chip *chip , uint8_t *buf , int
oob_required , int page );

🎀 ARGUMENTS 🎀

• chip — nand chip info structure. literally the chip's little info card 🪪
• buf — buffer to store read data. this is where the read data goes 🧺
• oob_required — caller requires OOB data read to chip->oob_poi. yep, OOB data heads to chip->oob_poi 🫶
• page — page number to read. which page are we reading? this one 🔖

🦋 DESCRIPTION 🦋

For the BCH ecc scheme, GPMC is used for syndrome calculation and the ELM module is used for error correction. bestie, it's a whole two-module situation ✨

A custom method evolved to support ELM error correction & multi sector reading. lowkey iconic 🌈

On reading, the page data area is read along with OOB data with the ecc engine enabled. so it's data + OOB together, with the ecc engine on 🎀

The ecc vector is updated after the read of OOB data. periodt 💅

For non error pages, the ecc vector is reported as zero. clean, cute, zero drama ⭐

🌈 SEE ALSO 🌈

The kernel file is ./drivers/mtd/nand/raw/omap2.c, and here's the whole friend group:

• omap_prefetch_enable(9)
• omap_nand_data_in_pref(9)
• omap_nand_data_out_pref(9)
• omap_nand_data_in_dma_pref(9)
• omap_nand_data_out_dma_pref(9)
• gen_true_ecc(9)
• omap_compare_ecc(9)
• omap_correct_data(9)
• omap_calculate_ecc(9)
• omap_enable_hwecc(9)
• omap_enable_hwecc_bch(9)
• _omap_calculate_ecc_bch(9)
• omap_calculate_ecc_bch_sw(9)
• omap_calculate_ecc_bch_multi(9)
• erased_sector_bitflips(9)
• omap_elm_correct_data(9)
• omap_write_page_bch(9)
• omap_write_subpage_bch(9)
• is_elm_present(9)

---

this omap_read_page_bch(9) manual page lives under ./drivers/mtd/nand/raw and is dated October 2026 — bye bestie, stay slaying 💖🎀