Skip to content

Latest commit

 

History

History
36 lines (20 loc) · 2.14 KB

README.md

File metadata and controls

36 lines (20 loc) · 2.14 KB
Raw

lwIP Arduino

This port allows to integrate lwIP with the Arduino platform. The motivation of this port, is to easily integrate a TCP/IP stack with any Mac-PHY chip in the Arduino platform.

Port Information

Port specific changes

  • Relative includes for source files. Arduino does not have an easy way to include directories in their build system. Done automatically with the python script relative-include.
  • Integrated Arduino SDK for implementation, to make it compatible with any Arduino board.
  • Changed extension of apps/http/fsdata.c to .c_ and changed as well the macro HTTPD_FSDATA_FILE. Arduino build system compiles .c and .cpp files by default. However, this file is intended to be only included by fs.c.

How to Use

Refer to the examples folder to an example of how you could integrate lwIP with a MAC-PHY chip. In addition read the official lwIP documentation. It requires that the user already has implemented the low-level access to the MAC-PHY chip to send/recieve ethernet frames and update the link status.

Debug

  • Debug options can be changed directly from the macros located in src/lwip_debug_opt.h.
  • Debug messages are sent via Serial object. Serial must be initialized (i.e. Serial.begin)

LwIP Options

Options are located in src/lwipopts.h

Notes

  • Currently the port is intended to work with bare metal systems. I.e., the OS Layer is not implemented. The reason is that Arduino does not have an OS abstraction layer and porting to a specific RTOs (ucos, VxWorks, FreeRTOS,etc) would make the library tightly coupled.
  • Not compatible with ESP32 core, as the ESP32 uses lwIP and will create a linkage conflict.
  • Will probably not fit in small MCUs, use something with much more SRAM and Flash such as the Arduino Due, RPI Pico.