W25QXXX_import.h 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117
  1. // Файл импорта внешних функций
  2. // v 1.0 от 07/10/20
  3. // Автор: Сычев А.
  4. // Драйвер управления W25Q16JV использует интерфейсные функции SSP и системного таймера
  5. // Для нормальной работы требуется, чтобы в системе присутствовали следующие функции:
  6. // * функция обмена по SSP/SPI (двустороннйий обмен)
  7. // * функции управления ChipSelect
  8. // * функции задержки на микросекунды и миллисекунды
  9. // * функция получения отметки времени (системный таймер) в миллисекундах
  10. // * функция отключения/включения питания чипа
  11. // * функции работы с памятью
  12. #ifndef W25QXXX_IMPORT_H
  13. #define W25QXXX_IMPORT_H
  14. #include "drivers/flash/w25q/config/W25Q16JV_conf.h"
  15. typedef struct
  16. {
  17. #if W25QXXX_POWER_MANAGEMENT
  18. void ( *SetPinPowerOn)();
  19. void ( *SetPinPowerOff)();
  20. #endif
  21. #if W25QXXX_RESET_MANAGEMENT
  22. void ( *ResetPinAssert)();
  23. void ( *ResetPinRelease)();
  24. #endif
  25. #if W25QXXX_HW_WR_PROTECT
  26. void ( *HwWrProtPinAssert)();
  27. void ( *HwWrProtPinRelease)();
  28. #endif
  29. }
  30. ExtMemPins_Handle_W25Q_t;
  31. #ifdef W25QXXX_HAL_H
  32. // переопределите макросы на ваши функции (имя внутреннего макроса менять не надо)
  33. #include "stm32l1xx_hal.h" // HAL_GetTick()
  34. #include "core/main.h" // HAL_Wait_us()
  35. #include "drivers/spi/spi.h" // SPIHandle
  36. #include <string.h>
  37. // Import SPI handle
  38. #define pSPIHandle (&SPIHandle)
  39. #if W25QXXX_POWER_MANAGEMENT || W25QXXX_RESET_MANAGEMENT || W25QXXX_HW_WR_PROTECT
  40. extern const ExtMemPins_Handle_W25Q_t ExtMemPinsHandle_W25Q;
  41. // Import External Memory Pins Handle
  42. #define pExtMemPinsHandle (&ExtMemPinsHandle_W25Q)
  43. #endif
  44. // внутренний макрос | ваша функция
  45. #define __imp_sys_delayus(_1us) HAL_Wait_us(_1us) // ожидание, в микросекундах
  46. #define __imp_sys_delayms(_1ms) HAL_Delay(_1ms) // ожидание, в миллисекундах
  47. #define __imp_sys_gettimer() HAL_GetTick() // возвращает количество тиков системы с момента старта системы
  48. #define __imp_ssp_cshi() pSPIHandle->SetNSS() // #CS в состояние 1 (HiLogicLevel)
  49. #define __imp_ssp_cslo() pSPIHandle->ClrNSS() // #CS в состояние 0 (LoLogicLevel)
  50. #define __imp_ssp_ro(r,c) pSPIHandle->Receive(r,c) // функция обмена по SSP / SPI
  51. #define __imp_ssp_wo(w,c) pSPIHandle->Transmit(w,c) // функция обмена по SSP / SPI
  52. // ------------------------------------------------------------------------------------
  53. // __imp_ssp_io - функция двунаправленного обмена - не требуется, если есть __imp_ssp_ro и __imp_ssp_wo
  54. //#define __imp_ssp_io(w,r,c) pSPIHandle->TransmitReceive(w,r,c) // функция обмена по SSP / SPI
  55. // ------------------------------------------------------------------------------------
  56. // __imp_ssp_io_rev - функция передачи данных по SPI в обратном порядке байт.
  57. // Создается для ускорения процесса обмена. Если такая функция отсутсвует в вашей системе,
  58. // не объявляйте макрос __imp_ssp_io_rev. При этом драйвер будет сам инвертировать порядок
  59. // байт в ущерб производительности.
  60. /*
  61. #define __imp_ssp_io_rev(w,r,c) ssp_ior(w,r,c) // функция обмена по SSP / SPI в обратном порядке байт
  62. */
  63. #if W25QXXX_POWER_MANAGEMENT
  64. // Опция W25QXXX_POWER_MANAGEMENT
  65. #define __imp_flash_poweron() pExtMemPinsHandle->SetPinPowerOn()
  66. #define __imp_flash_poweroff() pExtMemPinsHandle->SetPinPowerOff()
  67. #endif
  68. #if W25QXXX_RESET_MANAGEMENT
  69. // Опция W25QXXX_RESET_MANAGEMENT
  70. #define __imp_flash_reset_assert() pExtMemPinsHandle->ResetPinAssert()
  71. #define __imp_flash_reset_release() pExtMemPinsHandle->ResetPinRelease()
  72. #endif
  73. #if W25QXXX_HW_WR_PROTECT
  74. // Опция W25QXXX_HW_WR_PROTECT
  75. #define __imp_flash_hwwrprotect_assert() pExtMemPinsHandle->HwWrProtPinAssert()
  76. #define __imp_flash_hwwrprotect_release() pExtMemPinsHandle->HwWrProtPinRelease()
  77. #endif
  78. // ------------------------------------------------------------------------------------
  79. // __imp_flash_powercycle - перезапуск чипа по питанию.
  80. // нужна для отключения блокировки регистра статуса "Status Register Lock"
  81. // Эта функция требуется ТОЛЬКО ЕСЛИ:
  82. // * 1) запрещено управление питанием (W25QXXX_POWER_MANAGEMENT = 0); и
  83. // * 2) требуется поддержка разблокировки регистра статуса
  84. // Если все эти условия выполняются, требуется такую функцию объявить и импортировать.
  85. // В остальных случаях она не требуется.
  86. // #define __imp_flash_powercycle() sys_flash_W25QXXX_pwrcycle() // отключение питания чипа
  87. // // Note: при остутствии возможности отключить питание чипа используйте
  88. // // данный вызов как callback-событие для того, чтобы пользователь сделал это.
  89. // ------------------------------------------------------------------------------------
  90. #define __imp_sys_memset(p,b,c) memset(p,b,c) // порт функции memset()
  91. #define __imp_sys_memzero(p,c) memset(p,0,c) // порт функции memset()
  92. #define __imp_sys_memcmp(p1,p2,c) memcmp(p1,p2,c) // порт функции memcmp()
  93. #define __imp_sys_memcpy(d,s,c) memcpy(d,s,c) // порт функции memcpy()
  94. #define __imp_sys_memmove(d,s,c) memmove(d,s,c) // порт функции memmove()
  95. // ------------------------------------------------------------------------------------
  96. #define __imp_utl_mutex_lock() // блокировка доступа к устройству ч/з мютекс
  97. #define __imp_utl_mutex_unlock() // разблокировка доступа к устройству ч/з мютекс
  98. #endif
  99. #endif