mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-09-07 15:42:36 +00:00
54ab6fad20
The net_reply() can be used if the application wants to reply something to peer right after receiving the data. The function will reverse the source and destination addresses and ports, and set the uIP internal structures in such a way that the reply is possible. Using this function saves the application from allocating a separate net_buf for just sending simple message back. Change-Id: Ia960c83b77a8f300222159ee085fed99e2b007c2 Signed-off-by: Jukka Rissanen <jukka.rissanen@linux.intel.com>
132 lines
4.1 KiB
C
132 lines
4.1 KiB
C
/** @file
|
|
@brief Network core definitions
|
|
|
|
Definitions for networking support.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (c) 2015 Intel Corporation
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1) Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* 2) Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* 3) Neither the name of Intel Corporation nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software without
|
|
* specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#include <misc/printk.h>
|
|
#include <string.h>
|
|
|
|
#include <net/net_buf.h>
|
|
|
|
#ifndef __NET_CORE_H
|
|
#define __NET_CORE_H
|
|
|
|
/* Network subsystem logging helpers */
|
|
|
|
#define NET_DBG(fmt, ...) printk("net: %s: " fmt, __func__, ##__VA_ARGS__)
|
|
#define NET_ERR(fmt, ...) printk("net: %s: " fmt, __func__, ##__VA_ARGS__)
|
|
#define NET_INFO(fmt, ...) printk("net: " fmt, ##__VA_ARGS__)
|
|
#define NET_PRINT(fmt, ...) printk(fmt, ##__VA_ARGS__)
|
|
|
|
/**
|
|
* @brief Initialize network stack. This is will be automatically called
|
|
* by the OS.
|
|
*
|
|
* @details No harm will happen if application calls this multiple times.
|
|
*
|
|
* @return 0 if ok, < 0 in case of error.
|
|
*/
|
|
int net_init(void);
|
|
|
|
struct net_driver {
|
|
/** How much headroom is needed for net transport headers */
|
|
size_t head_reserve;
|
|
|
|
/** Open the net transport */
|
|
int (*open) (void);
|
|
|
|
/** Send data to net */
|
|
int (*send) (struct net_buf *buf);
|
|
};
|
|
|
|
/**
|
|
* @brief Register a new network driver to the network stack.
|
|
*
|
|
* @details Only one network device can be registered at a time.
|
|
*
|
|
* @param buf Network driver.
|
|
*
|
|
* @return 0 if ok, < 0 in case of error.
|
|
*/
|
|
int net_register_driver(struct net_driver *drv);
|
|
|
|
/**
|
|
* @brief Unregister a previously registered network driver.
|
|
*
|
|
* @param buf Network driver.
|
|
*
|
|
* @details Networking will be disabled if there is no driver
|
|
* available.
|
|
*
|
|
*/
|
|
void net_unregister_driver(struct net_driver *drv);
|
|
|
|
/**
|
|
* @brief Set the MAC/EUI-64 address of the device.
|
|
*
|
|
* @details Network device driver should call this function to
|
|
* tell the used MAC or EUI-64 address to the IP stack.
|
|
*
|
|
* @param mac MAC or EUI-64 address
|
|
* @param len If len == 6, then the first parameter is interpreted
|
|
* to be the MAC address and the function sets the U/L bits etc.
|
|
* If the len == 8, then the value is used as is to generate the
|
|
* link local IPv6 address.
|
|
*
|
|
* @return 0 if ok, < 0 in case of error.
|
|
*/
|
|
int net_set_mac(uint8_t *mac, uint8_t len);
|
|
|
|
/*!
|
|
* @brief Send a reply packet to the message originator.
|
|
*
|
|
* @details Application can call this function if it has received
|
|
* a network packet from peer. The application needs to write
|
|
* reply data into net_buf. The app can use uip_appdata(buf) and
|
|
* uip_appdatalen(buf) to set the application data and length.
|
|
*
|
|
* @param context Network context
|
|
* @param buf Network buffer containing the network data.
|
|
*
|
|
* @return 0 if ok, < 0 in case of error.
|
|
*/
|
|
int net_reply(struct net_context *context, struct net_buf *buf);
|
|
|
|
/* Called by driver when an IP packet has been received */
|
|
int net_recv(struct net_buf *buf);
|
|
|
|
void net_context_init(void);
|
|
|
|
#endif /* __NET_CORE_H */
|