winc3400/wifi_drv/driver/source/nmdrv.c File Reference

This module contains WINC3400 M2M driver APIs implementation.

Copyright (c) 2017-2019 Microchip Technology Inc. and its subsidiaries.

#include "common/include/nm_common.h"
#include "driver/source/nmbus.h"
#include "bsp/include/nm_bsp.h"
#include "driver/source/nmdrv.h"
#include "driver/source/nmasic.h"
#include "driver/include/m2m_types.h"

Functions
sint8	nm_cpu_start (void)
	Start CPU from the WINC module. More...
sint8	nm_drv_deinit (void *arg)
sint8	nm_drv_init (void *arg, uint32 req_serial_number)
sint8	nm_drv_init_download_mode (uint32 req_serial_number)
sint8	nm_drv_init_hold (uint32 req_serial_number)
sint8	nm_drv_init_start (void *arg)
sint8	nm_get_firmware_full_info (tstrM2mRev *pstrRev)
	Get Firmware version info. More...
sint8	nm_get_hif_info (uint16 *pu16FwHifInfo, uint16 *pu16OtaHifInfo)
	Get Hif info of images in both partitions (Firmware and Ota). More...
sint8	nm_get_ota_firmware_info (tstrM2mRev *pstrRev)
	Get Firmware version info. More...
tenuNmState	nm_get_state (void)
	Get the current state of the WINC module. More...

Variables
static tenuNmState	genuNmState = NM_STATE_DEINIT

nm_cpu_start

(

void

)

Start CPU from the WINC module.

Returns

M2M_SUCCESS in case of success and Negative error code in case of failure

References cpu_start().

Referenced by enter_wifi_firmware_download().

sint8 nm_drv_deinit

(

void *

arg

)

References chip_deinit(), genuNmState, M2M_ERR, M2M_SUCCESS, nm_bus_iface_deinit(), nm_sdio_init(), nm_spi_deinit(), and NM_STATE_DEINIT.

sint8 nm_drv_init	(	void *	arg,
		uint32	req_serial_number
	)

References M2M_SUCCESS, nm_drv_init_hold(), and nm_drv_init_start().

sint8 nm_drv_init_download_mode

(

uint32

req_serial_number

)

References genuNmState, M2M_ERR, M2M_INFO, M2M_SUCCESS, nm_bus_iface_init(), nm_spi_init(), NM_STATE_INIT, nm_write_reg(), nmi_get_chipid(), and NULL.

sint8 nm_drv_init_hold

(

uint32

req_serial_number

)

References chip_idle(), chip_reset(), chip_wake(), genuNmState, M2M_ERR, M2M_INFO, M2M_SUCCESS, nm_bsp_sleep(), nm_bus_iface_deinit(), nm_bus_iface_init(), nm_spi_init(), NM_STATE_INIT, nmi_get_chipid(), and NULL.

sint8 nm_drv_init_start

(

void *

arg

)

References cpu_start(), enable_interrupts(), genuNmState, M2M_ERR, M2M_SUCCESS, M2M_WIFI_MODE_ATE_HIGH, M2M_WIFI_MODE_ATE_LOW, M2M_WIFI_MODE_CONFIG, M2M_WIFI_MODE_MAX, M2M_WIFI_MODE_NORMAL, nm_bus_iface_deinit(), nm_spi_deinit(), NM_STATE_START, NULL, wait_for_bootrom(), and wait_for_firmware_start().

sint8 nm_get_firmware_full_info

(

tstrM2mRev *

pstrRev

)

Get Firmware version info.

Parameters

[out]

M2mRev

pointer holds address of structure "tstrM2mRev" that contains the firmware version parameters

Version

1.0

Parameters

[out]	M2mRev	Pointer holds address of structure tstrM2mRev that contains the firmware version parameters
[out]	pstrRev	Pointer holds address of structure tstrM2mRev that contains the version parameters of image in the active partition.

Returns

M2M_SUCCESS in case of success and Negative error code in case of failure

References tstrM2mRev::BuildDate, tstrM2mRev::BuildTime, M2M_ERR, M2M_ERR_FAIL, M2M_ERR_FW_VER_MISMATCH, M2M_GET_HIF_BLOCK, M2M_GET_HIF_MAJOR, M2M_GET_HIF_MINOR, M2M_HIF_BLOCK_VALUE, M2M_INFO, M2M_MAKE_VERSION, m2m_memset(), M2M_RELEASE_VERSION_MAJOR_NO, M2M_RELEASE_VERSION_MINOR_NO, M2M_RELEASE_VERSION_PATCH_NO, M2M_SUCCESS, nm_get_hif_info(), nm_read_block(), nm_read_reg_with_ret(), NULL, rNMI_GP_REG_0, rNMI_GP_REG_2, tstrM2mRev::u16FirmwareHifInfo, tstrGpRegs::u32Firmware_Ota_rev, tstrM2mRev::u8DriverMajor, tstrM2mRev::u8DriverMinor, tstrM2mRev::u8DriverPatch, tstrM2mRev::u8FirmwareMajor, tstrM2mRev::u8FirmwareMinor, and tstrM2mRev::u8FirmwarePatch.

nm_get_hif_info	(	uint16 *	pu16FwHifInfo,
		uint16 *	pu16OtaHifInfo
	)

Get Hif info of images in both partitions (Firmware and Ota).

Parameters

[out]	pu16FwHifInfo	Pointer holding Hif info of image in the active partition.
[out]	pu16OtaHifInfo	Pointer holding Hif info of image in the inactive partition.

Returns

M2M_SUCCESS in case of success and Negative error code in case of failure

References M2M_SUCCESS, nm_read_reg_with_ret(), NMI_REV_REG, and NULL.

Referenced by hif_enable_access(), m2m_wifi_check_ota_rb(), nm_get_firmware_full_info(), and nm_get_ota_firmware_info().

sint8 nm_get_ota_firmware_info

(

tstrM2mRev *

pstrRev

)

Get Firmware version info.

Parameters

[out]

M2mRev

pointer holds address of structure "tstrM2mRev" that contains the firmware version parameters

Version

1.0

Parameters

[out]	M2mRev	Pointer holds address of structure tstrM2mRev that contains the firmware version parameters
[out]	pstrRev	Pointer holds address of structure tstrM2mRev that contains the version parameters of image in the inactive partition.

Returns

M2M_SUCCESS in case of success and Negative error code in case of failure

References tstrM2mRev::BuildDate, tstrM2mRev::BuildTime, M2M_ERR, M2M_ERR_FAIL, M2M_ERR_FW_VER_MISMATCH, M2M_ERR_INVALID, M2M_ERR_INVALID_ARG, M2M_GET_HIF_BLOCK, M2M_GET_HIF_MAJOR, M2M_GET_HIF_MINOR, M2M_HIF_BLOCK_VALUE, M2M_INFO, M2M_MAKE_VERSION, m2m_memset(), M2M_RELEASE_VERSION_MAJOR_NO, M2M_RELEASE_VERSION_MINOR_NO, M2M_RELEASE_VERSION_PATCH_NO, M2M_SUCCESS, nm_get_hif_info(), nm_read_block(), nm_read_reg_with_ret(), NULL, rNMI_GP_REG_0, rNMI_GP_REG_2, tstrM2mRev::u16FirmwareHifInfo, tstrGpRegs::u32Firmware_Ota_rev, tstrM2mRev::u8DriverMajor, tstrM2mRev::u8DriverMinor, tstrM2mRev::u8DriverPatch, tstrM2mRev::u8FirmwareMajor, tstrM2mRev::u8FirmwareMinor, and tstrM2mRev::u8FirmwarePatch.

nm_get_state

(

void

)

Get the current state of the WINC module.

Returns

The current state of the WINC module

References genuNmState.

Referenced by find_flash_section(), m2m_flash_erase_sector(), m2m_flash_read(), m2m_flash_switch_firmware(), m2m_flash_write(), and m2m_wifi_get_state().

tenuNmState genuNmState = NM_STATE_DEINIT

static

Referenced by nm_drv_deinit(), nm_drv_init_download_mode(), nm_drv_init_hold(), nm_drv_init_start(), and nm_get_state().