314 lines
9.0 KiB
C
314 lines
9.0 KiB
C
/*
|
|
ChibiOS - Copyright (C) 2006..2018 Giovanni Di Sirio
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @file hal_mac_lld.c
|
|
* @brief PLATFORM MAC subsystem low level driver source.
|
|
*
|
|
* @addtogroup MAC
|
|
* @{
|
|
*/
|
|
|
|
#include <string.h>
|
|
|
|
#include "hal.h"
|
|
|
|
#if (HAL_USE_MAC == TRUE) || defined(__DOXYGEN__)
|
|
|
|
#include "hal_mii.h"
|
|
|
|
/*===========================================================================*/
|
|
/* Driver local definitions. */
|
|
/*===========================================================================*/
|
|
|
|
/*===========================================================================*/
|
|
/* Driver exported variables. */
|
|
/*===========================================================================*/
|
|
|
|
/**
|
|
* @brief MAC1 driver identifier.
|
|
*/
|
|
#if (PLATFORM_MAC_USE_MAC1 == TRUE) || defined(__DOXYGEN__)
|
|
MACDriver ETHD1;
|
|
#endif
|
|
|
|
/*===========================================================================*/
|
|
/* Driver local variables and types. */
|
|
/*===========================================================================*/
|
|
|
|
/*===========================================================================*/
|
|
/* Driver local functions. */
|
|
/*===========================================================================*/
|
|
|
|
/*===========================================================================*/
|
|
/* Driver interrupt handlers. */
|
|
/*===========================================================================*/
|
|
|
|
/*===========================================================================*/
|
|
/* Driver exported functions. */
|
|
/*===========================================================================*/
|
|
|
|
/**
|
|
* @brief Low level MAC initialization.
|
|
*
|
|
* @notapi
|
|
*/
|
|
void mac_lld_init(void) {
|
|
|
|
#if PLATFORM_MAC_USE_MAC1 == TRUE
|
|
/* Driver initialization.*/
|
|
macObjectInit(&MACD1);
|
|
#endif
|
|
}
|
|
|
|
/**
|
|
* @brief Configures and activates the MAC peripheral.
|
|
*
|
|
* @param[in] macp pointer to the @p MACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
void mac_lld_start(MACDriver *macp) {
|
|
|
|
if (macp->state == MAC_STOP) {
|
|
/* Enables the peripheral.*/
|
|
#if PLATFORM_MAC_USE_MAC1 == TRUE
|
|
if (&MACD1 == macp) {
|
|
|
|
}
|
|
#endif
|
|
}
|
|
/* Configures the peripheral.*/
|
|
|
|
}
|
|
|
|
/**
|
|
* @brief Deactivates the MAC peripheral.
|
|
*
|
|
* @param[in] macp pointer to the @p MACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
void mac_lld_stop(MACDriver *macp) {
|
|
|
|
if (macp->state != MAC_STOP) {
|
|
/* Resets the peripheral.*/
|
|
|
|
/* Disables the peripheral.*/
|
|
#if PLATFORM_MAC_USE_MAC1 == TRUE
|
|
if (&MACD1 == macp) {
|
|
|
|
}
|
|
#endif
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Returns a transmission descriptor.
|
|
* @details One of the available transmission descriptors is locked and
|
|
* returned.
|
|
*
|
|
* @param[in] macp pointer to the @p MACDriver object
|
|
* @param[out] tdp pointer to a @p MACTransmitDescriptor structure
|
|
* @return The operation status.
|
|
* @retval MSG_OK the descriptor has been obtained.
|
|
* @retval MSG_TIMEOUT descriptor not available.
|
|
*
|
|
* @notapi
|
|
*/
|
|
msg_t mac_lld_get_transmit_descriptor(MACDriver *macp,
|
|
MACTransmitDescriptor *tdp) {
|
|
|
|
(void)macp;
|
|
(void)tdp;
|
|
|
|
return MSG_OK;
|
|
}
|
|
|
|
/**
|
|
* @brief Releases a transmit descriptor and starts the transmission of the
|
|
* enqueued data as a single frame.
|
|
*
|
|
* @param[in] tdp the pointer to the @p MACTransmitDescriptor structure
|
|
*
|
|
* @notapi
|
|
*/
|
|
void mac_lld_release_transmit_descriptor(MACTransmitDescriptor *tdp) {
|
|
|
|
(void)tdp;
|
|
|
|
}
|
|
|
|
/**
|
|
* @brief Returns a receive descriptor.
|
|
*
|
|
* @param[in] macp pointer to the @p MACDriver object
|
|
* @param[out] rdp pointer to a @p MACReceiveDescriptor structure
|
|
* @return The operation status.
|
|
* @retval MSG_OK the descriptor has been obtained.
|
|
* @retval MSG_TIMEOUT descriptor not available.
|
|
*
|
|
* @notapi
|
|
*/
|
|
msg_t mac_lld_get_receive_descriptor(MACDriver *macp,
|
|
MACReceiveDescriptor *rdp) {
|
|
|
|
(void)macp;
|
|
(void)rdp;
|
|
|
|
return MSG_OK;
|
|
}
|
|
|
|
/**
|
|
* @brief Releases a receive descriptor.
|
|
* @details The descriptor and its buffer are made available for more incoming
|
|
* frames.
|
|
*
|
|
* @param[in] rdp the pointer to the @p MACReceiveDescriptor structure
|
|
*
|
|
* @notapi
|
|
*/
|
|
void mac_lld_release_receive_descriptor(MACReceiveDescriptor *rdp) {
|
|
|
|
(void)rdp;
|
|
|
|
}
|
|
|
|
/**
|
|
* @brief Updates and returns the link status.
|
|
*
|
|
* @param[in] macp pointer to the @p MACDriver object
|
|
* @return The link status.
|
|
* @retval true if the link is active.
|
|
* @retval false if the link is down.
|
|
*
|
|
* @notapi
|
|
*/
|
|
bool mac_lld_poll_link_status(MACDriver *macp) {
|
|
|
|
(void)macp;
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @brief Writes to a transmit descriptor's stream.
|
|
*
|
|
* @param[in] tdp pointer to a @p MACTransmitDescriptor structure
|
|
* @param[in] buf pointer to the buffer containing the data to be
|
|
* written
|
|
* @param[in] size number of bytes to be written
|
|
* @return The number of bytes written into the descriptor's
|
|
* stream, this value can be less than the amount
|
|
* specified in the parameter @p size if the maximum
|
|
* frame size is reached.
|
|
*
|
|
* @notapi
|
|
*/
|
|
size_t mac_lld_write_transmit_descriptor(MACTransmitDescriptor *tdp,
|
|
uint8_t *buf,
|
|
size_t size) {
|
|
|
|
(void)tdp;
|
|
(void)buf;
|
|
|
|
return size;
|
|
}
|
|
|
|
/**
|
|
* @brief Reads from a receive descriptor's stream.
|
|
*
|
|
* @param[in] rdp pointer to a @p MACReceiveDescriptor structure
|
|
* @param[in] buf pointer to the buffer that will receive the read data
|
|
* @param[in] size number of bytes to be read
|
|
* @return The number of bytes read from the descriptor's
|
|
* stream, this value can be less than the amount
|
|
* specified in the parameter @p size if there are
|
|
* no more bytes to read.
|
|
*
|
|
* @notapi
|
|
*/
|
|
size_t mac_lld_read_receive_descriptor(MACReceiveDescriptor *rdp,
|
|
uint8_t *buf,
|
|
size_t size) {
|
|
|
|
(void)rdp;
|
|
(void)buf;
|
|
|
|
return size;
|
|
}
|
|
|
|
#if (MAC_USE_ZERO_COPY == TRUE) || defined(__DOXYGEN__)
|
|
/**
|
|
* @brief Returns a pointer to the next transmit buffer in the descriptor
|
|
* chain.
|
|
* @note The API guarantees that enough buffers can be requested to fill
|
|
* a whole frame.
|
|
*
|
|
* @param[in] tdp pointer to a @p MACTransmitDescriptor structure
|
|
* @param[in] size size of the requested buffer. Specify the frame size
|
|
* on the first call then scale the value down subtracting
|
|
* the amount of data already copied into the previous
|
|
* buffers.
|
|
* @param[out] sizep pointer to variable receiving the buffer size, it is
|
|
* zero when the last buffer has already been returned.
|
|
* Note that a returned size lower than the amount
|
|
* requested means that more buffers must be requested
|
|
* in order to fill the frame data entirely.
|
|
* @return Pointer to the returned buffer.
|
|
* @retval NULL if the buffer chain has been entirely scanned.
|
|
*
|
|
* @notapi
|
|
*/
|
|
uint8_t *mac_lld_get_next_transmit_buffer(MACTransmitDescriptor *tdp,
|
|
size_t size,
|
|
size_t *sizep) {
|
|
|
|
(void)tdp;
|
|
(void)size;
|
|
(void)sizep;
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* @brief Returns a pointer to the next receive buffer in the descriptor
|
|
* chain.
|
|
* @note The API guarantees that the descriptor chain contains a whole
|
|
* frame.
|
|
*
|
|
* @param[in] rdp pointer to a @p MACReceiveDescriptor structure
|
|
* @param[out] sizep pointer to variable receiving the buffer size, it is
|
|
* zero when the last buffer has already been returned.
|
|
* @return Pointer to the returned buffer.
|
|
* @retval NULL if the buffer chain has been entirely scanned.
|
|
*
|
|
* @notapi
|
|
*/
|
|
const uint8_t *mac_lld_get_next_receive_buffer(MACReceiveDescriptor *rdp,
|
|
size_t *sizep) {
|
|
|
|
(void)rdp;
|
|
(void)sizep;
|
|
|
|
return NULL;
|
|
}
|
|
#endif /* MAC_USE_ZERO_COPY == TRUE */
|
|
|
|
#endif /* HAL_USE_MAC == TRUE */
|
|
|
|
/** @} */
|