nand_gpio_waitrdy(9)

💅 nand_gpio_waitrdy(9) 💅

okay so you're reading the nand_gpio_waitrdy(9) page in the Kernel API Manual, and it's giving "tiny helper, big NAND energy" ✨. Bestie, this one is short and sweet: it polls a ready/busy pin over GPIO. Let's get into it.

✨ NAME ✨

nand_gpio_waitrdy — Poll R/B GPIO pin until ready.

🌸 SYNOPSIS 🌸

int nand_gpio_waitrdy (struct nand_chip *chip , struct gpio_desc *gpiod
, unsigned long timeout_ms );

🎀 ARGUMENTS 🎀

• chip — NAND chip structure. The main character chip, basically 👑.
• gpiod — GPIO descriptor of R/B pin. That's the ready/busy pin bestie 🦋.
• timeout_ms — Timeout in ms. Yep, milliseconds — keep that unit in mind 💅.

🦋 DESCRIPTION 🦋

Poll the R/B GPIO pin until it becomes ready. Like, it sits there checking the pin's vibe until the chip says "I'm ready" ✨.

If that does not happen whitin the specified timeout, -ETIMEDOUT is returned. Yes, whitin — we're keeping the source spelling, bestie 😭. No cap, that's what it says.

This helper is intended to be used when the controller has access to the NAND R/B pin over GPIO. That's the whole scenario, iykyk 🫶.

Return vibe: 0 if the R/B pin indicates chip is ready, a negative error otherwise. So: ready = 0, not ready = negative error, periodt 💀.

👑 SEE ALSO 👑

Kernel file ./drivers/mtd/nand/raw/nand_base.c, then the whole NAND extended universe: nand_extract_bits(9), nand_select_target(9), nand_deselect_target(9), nand_release_device(9), nand_bbm_get_next_page(9), nand_block_bad(9), nand_region_is_secured(9), nand_get_device(9), nand_check_wp(9), nand_fill_oob(9), nand_do_write_oob(9), nand_default_block_markbad(9), nand_markbad_bbm(9), nand_block_markbad_lowlevel(9), nand_block_isreserved(9), nand_block_checkbad(9), nand_soft_waitrdy(9), panic_nand_wait(9), nand_reset_interface(9), nand_setup_interface(9), nand_choose_best_sdr_timings(9), nand_choose_best_nvddr_timings(9), nand_choose_best_timings(9), nand_choose_interface_config(9), nand_fill_column_cycles(9), nand_read_page_op(9), nand_read_param_page_op(9), nand_change_read_column_op(9), nand_read_oob_op(9), nand_prog_page_begin_op(9), nand_prog_page_end_op(9), nand_prog_page_op(9), nand_change_write_column_op(9), nand_readid_op(9), nand_status_op(9), nand_exit_status_op(9), nand_erase_op(9), nand_set_features_op(9), nand_get_features_op(9), nand_reset_op(9), nand_read_data_op(9), nand_write_data_op(9), struct nand_op_parser_ctx(9), nand_op_parser_must_split_instr(9), nand_op_parser_match_pat(9), nand_op_parser_exec_op(9), nand_subop_get_addr_start_off(9), nand_subop_get_num_addr_cyc(9), nand_subop_get_data_start_off(9), nand_subop_get_data_len(9), nand_reset(9), nand_get_features(9), nand_set_features(9), nand_read_page_raw_notsupp(9), nand_read_page_raw(9), nand_monolithic_read_page_raw(9), nand_read_page_raw_syndrome(9), nand_read_page_swecc(9), nand_read_subpage(9), nand_read_page_hwecc(9), nand_read_page_hwecc_oob_first(9), nand_read_page_syndrome(9), nand_transfer_oob(9), nand_setup_read_retry(9), nand_do_read_ops(9), nand_read_oob_std(9), nand_read_oob_syndrome(9), nand_write_oob_std(9), nand_write_oob_syndrome(9), nand_do_read_oob(9), nand_read_oob(9), nand_write_page_raw_notsupp(9), nand_write_page_raw(9), nand_monolithic_write_page_raw(9), nand_write_page_raw_syndrome(9), nand_write_page_swecc(9), nand_write_page_hwecc(9), nand_write_subpage_hwecc(9), nand_write_page_syndrome(9), nand_write_page(9), nand_do_write_ops(9), panic_nand_write(9), nand_write_oob(9), nand_erase(9), nand_erase_nand(9), nand_sync(9), nand_block_isbad(9), nand_block_markbad(9), nand_suspend(9), nand_resume(9), nand_shutdown(9), nand_lock(9), nand_unlock(9), rawnand_dt_parse_gpio_cs(9), nand_scan_ident(9), nand_check_ecc_caps(9), nand_match_ecc_req(9), nand_maximize_ecc(9), nand_ecc_choose_conf(9), nand_scan_tail(9), nand_scan_with_ids(9), nand_cleanup(9).

okay that's the whole page, bestie! source/version: ./drivers/mtd/nand/raw · date: October 2026 — mwah 💋✨