entryPointCPP.hpp

/*
 * entryPointCPP.hpp
 *
 * C-callable entry points bridging CubeMX-generated main.c (plain C, subject
 * to regeneration whenever the .ioc changes) into the C++ W25QFlashSPI driver.
 *
 * extern "C" here prevents C++ name mangling on these declarations, so
 * main.c can call them directly by name. The driver object itself is
 * constructed inside initW25QFlash(), deliberately called from main() after
 * HAL_Init()/MX_GPIO_Init()/MX_SPI1_Init() have already run -- not as a
 * global static C++ object, which would construct too early (C++ global
 * constructors run in __libc_init_array() before main() even starts, before
 * any peripheral is configured).
 *
 *  Created on: Aug 30, 2026
 *      Author: johng
 */
 
#ifndef INC_ENTRYPOINTCPP_HPP_
#define INC_ENTRYPOINTCPP_HPP_
 
#include "main.h"
#include "stdbool.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
void initW25QFlash(void);
 
bool w25qIsReady(void);
 
bool w25qReadBuffer(uint32_t addr, uint8_t *buf, uint32_t len);
 
bool w25qWriteBuffer(uint32_t addr, const uint8_t *data, uint32_t len);
 
bool w25qEraseSector(uint32_t addr);
 
bool w25qReadJEDECID(uint32_t *id);
 
void w25qRunValidation(void);
 
#ifdef __cplusplus
}
#endif
 
#endif /* INC_ENTRYPOINTCPP_HPP_ */