Multihoming initial release

Added Multihoming feature to LWIP (ability to use more than one network interfaces) for increasing networking reliability.
This involves:

    LWIP interface
    LWIP IP routing
    DNS storage
    Sockets (bind to interface name possibility)
    possibility to add non default network interface
    cellular middleware modifications if cellular connection is used

Author: tymoteuszblochmobica

TESTS/network/l3ip/cellular_driver_l3ip.cpp

@@ -0,0 +1,121 @@
+/*
+ * Copyright (c) 2018 ARM Limited
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * 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.
+ */
+
+
+#include "mbed_interface.h"
+#include "netsocket/nsapi_types.h"
+#include "cellular_driver_l3ip.h"
+
+Cellular_driver_L3IP::Cellular_driver_L3IP()
+{
+}
+
+
+bool Cellular_driver_L3IP::link_out(net_stack_mem_buf_t *buf)
+{
+
+    return true;
+}
+
+
+bool Cellular_driver_L3IP::power_up()
+{
+
+    return true;
+}
+
+uint32_t Cellular_driver_L3IP::get_mtu_size() const
+{
+    return 0;
+}
+
+uint32_t Cellular_driver_L3IP::get_align_preference() const
+{
+    return 0;
+}
+
+void Cellular_driver_L3IP::get_ifname(char *name, uint8_t size) const
+{
+
+}
+
+
+
+void Cellular_driver_L3IP::set_link_input_cb(l3ip_link_input_cb_t input_cb)
+{
+    l3ip_link_input_cb = input_cb;
+}
+
+void Cellular_driver_L3IP::set_link_state_cb(l3ip_link_state_change_cb_t state_cb)
+{
+    l3ip_link_state_cb = state_cb;
+}
+
+void Cellular_driver_L3IP::add_ipv4_multicast_group(const char *address)
+{
+
+}
+
+void Cellular_driver_L3IP::add_ipv6_multicast_group(const char *address)
+{
+
+}
+
+void Cellular_driver_L3IP::remove_ipv4_multicast_group(const char *address)
+{
+
+}
+
+void Cellular_driver_L3IP::remove_ipv6_multicast_group(const char *address)
+{
+
+}
+
+void Cellular_driver_L3IP::set_all_multicast(bool all)
+{
+
+}
+
+void Cellular_driver_L3IP::power_down()
+{
+
+}
+
+void Cellular_driver_L3IP::set_memory_manager(NetStackMemoryManager &mem_mngr)
+{
+    memory_manager = &mem_mngr;
+}
+
+
+Cellular_driver_L3IP &Cellular_driver_L3IP::get_instance()
+{
+    static Cellular_driver_L3IP l3ip_test_driver;
+    return l3ip_test_driver;
+}
+
+// Weak so a module can override
+MBED_WEAK L3IP &L3IP::get_default_instance()
+{
+    return Cellular_driver_L3IP::get_instance();
+}
+
+/**
+ * @}
+ */
+
+/* --------------------------------- End Of File ------------------------------ */
+

TESTS/network/l3ip/cellular_driver_l3ip.h

@@ -0,0 +1,135 @@
+/*
+ * Copyright (c) 2018 ARM Limited
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * 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.
+ */
+
+#ifndef CELLULAR_DRIVER_L3IP_H_
+#define CELLULAR_DRIVER_L3IP_H_
+
+#include "L3IP.h"
+
+
+class Cellular_driver_L3IP : public L3IP {
+public:
+    Cellular_driver_L3IP();
+
+    static Cellular_driver_L3IP &get_instance();
+
+    /**
+     * Return maximum transmission unit
+     *
+     * @return     MTU in bytes
+     */
+    virtual uint32_t get_mtu_size() const;
+
+    /**
+     * Gets memory buffer alignment preference
+     *
+     * Gets preferred memory buffer alignment of the cellular device.
+     * @return         Memory alignment requirement in bytes
+     */
+    virtual uint32_t get_align_preference() const;
+
+    /**
+     * Return interface name
+     *
+     * @param name Pointer to where the name should be written
+     * @param size Maximum number of characters to copy
+     */
+    virtual void get_ifname(char *name, uint8_t size) const;
+
+    /**
+     * Sends the packet over the link
+     *
+     * That cannot be called from an interrupt context.
+     *
+     * @param buf  Packet to be sent
+     * @return     True if the packet was sent, false otherwise
+     */
+    virtual bool link_out(net_stack_mem_buf_t *buf);
+
+    /**
+     * Initializes the hardware
+     *
+     * @return True on success, False in case of an error.
+     */
+    virtual bool power_up();
+
+    /**
+     * Deinitializes the hardware
+     *
+     */
+    virtual void power_down();
+
+    /**
+     * Sets a callback that needs to be called for packets received for that interface
+     *
+     * @param input_cb Function to be register as a callback
+     */
+    virtual void set_link_input_cb(l3ip_link_input_cb_t input_cb);
+
+    /**
+     * Sets a callback that needs to be called on link status changes for given interface
+     *
+     * @param state_cb Function to be register as a callback
+     */
+    virtual void set_link_state_cb(l3ip_link_state_change_cb_t state_cb);
+
+    /** Add device to an IP4 multicast group
+     *
+     * @param address an IP4 multicast group address
+     */
+    virtual void add_ipv4_multicast_group(const char *address);
+
+    /** Add device to an IP6 multicast group
+    *
+    * @param address  an IP6 multicast group address
+    */
+    virtual void add_ipv6_multicast_group(const char *address);
+
+    /** Remove device from an IPV4 multicast group
+     *
+     * @param address  An IPV4 multicast group address
+     */
+    virtual void remove_ipv4_multicast_group(const char *address);
+
+    /** Remove device from an IPV6 multicast group
+    *
+    * @param address  An IPV6 multicast group address
+    */
+    virtual void remove_ipv6_multicast_group(const char *address);
+
+    /** Request reception of all multicast packets
+     *
+     * @param all True to receive all multicasts
+     *            False to receive only multicasts addressed to specified groups
+     */
+    virtual void set_all_multicast(bool all);
+
+    /** Sets memory manager that is used to handle memory buffers
+     *
+     * @param mem_mngr Pointer to memory manager
+     */
+    virtual void set_memory_manager(NetStackMemoryManager &mem_mngr);
+
+private:
+
+    l3ip_link_input_cb_t l3ip_link_input_cb; /**< Callback for incoming data */
+    l3ip_link_state_change_cb_t l3ip_link_state_cb; /**< Link state change callback */
+    NetStackMemoryManager *memory_manager; /**< Memory manager */
+
+};
+
+#endif /* CELLULAR_DRIVER_L3IP_H_ */

TESTS/network/l3ip/main.cpp

@@ -0,0 +1,84 @@
+/*
+ * Copyright (c) 2018, ARM Limited, All Rights Reserved
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * 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.
+ */
+
+
+#include "mbed.h"
+#include "greentea-client/test_env.h"
+#include "unity/unity.h"
+#include "utest.h"
+#include "utest/utest_stack_trace.h"
+#include "L3IPInterface.h"
+
+using namespace utest::v1;
+
+namespace {
+NetworkInterface *l3interface;
+}
+
+void L3IP_START()
+{
+    printf("MBED: L3IP_START\n");
+}
+
+void L3IP_STOP()
+{
+    printf("MBED: L3IP_STOP\n");
+}
+
+
+static void _ifup()
+{
+    printf("MBED: ifdown\n");
+}
+
+static void _ifdown()
+{
+    printf("MBED: ifdown\n");
+}
+
+#if MBED_CONF_NSAPI_SOCKET_STATS_ENABLE
+int fetch_stats()
+{
+    return SocketStats::mbed_stats_socket_get_each(&udp_stats[0], MBED_CONF_NSAPI_SOCKET_STATS_MAX_COUNT);
+}
+#endif
+
+// Test setup
+utest::v1::status_t greentea_setup(const size_t number_of_cases)
+{
+    GREENTEA_SETUP(480, "default_auto");
+    _ifup();
+    return greentea_test_setup_handler(number_of_cases);
+}
+
+void greentea_teardown(const size_t passed, const size_t failed, const failure_t failure)
+{
+    _ifdown();
+    return greentea_test_teardown_handler(passed, failed, failure);
+}
+
+Case cases[] = {
+    Case("L3IP_START", L3IP_START),
+    Case("L3IP_STOP", L3IP_STOP),
+};
+
+Specification specification(greentea_setup, cases, greentea_teardown, greentea_continue_handlers);
+
+int main()
+{
+    return !Harness::run(specification);
+}