pkulchenko / DHCPLite

DHCP Lite library for Arduino v0.14

This library implements DHCP and DNS server processing for Arduino.

The library has been tested on Arduino Uno/Duemilanove. It correctly
handles requests from clients running Windows Vista, Ubuntu 11.04,
and iOS v.2, v.4 and v.5. See LIMITATIONS and KNOWN BUGS.

Visit http://notebook.kulchenko.com/dhcplite for updates.

HISTORY

I have been looking for DHCP server library for Arduino and while
there are several libraries mentioned in Arduino forums (most notably
http://www.musically.me.uk/DHCP_Web_Server_12.pde,
http://www.aether-hemera.com/blog/default.asp?PostId=30, and
Nebster's DHCP server code from this forum thread
http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1239258729), 
some used UDP libraries I could not use and some I simply could not 
get to work.

I wrote this library in a way that should be easy to integrate with
other network libraries as it only takes a buffer (that is expected 
to have a DHCP message or DNS message) and compiles a response using 
the same buffer.

INSTALLATION

Copy the content of examples/ and libraries/ to your 
Arduino folders: arduino/examples/ and arduino/libraries/.

THIRD PARTY SOFTWARE

The library has no external dependencies.

The example is using RedFly library that comes with RedFly shield
(both are available at http://www.watterott.net/projects/redfly-shield).

LIMITATIONS

Only DHCP REQUEST and DHCP DISCOVER messages are being handled.
All DHCP INFORM messages get DHCP NAK in response.
Only 12 leases are tracked by default.

KNOWN BUGS

Windows Vista (and possibly other versions of Windows) seems to rely on 
DNS Suffix Search List rather than Connection-specific DNS suffix in 
generating fully qualified hostnames (http://support.microsoft.com/kb/275553).
This means that even though you can set your domain name to "mydomain.net"
and the DHCP server will report this using option 15, when you try to
resolve "arduino", it will send a request for "arduino.mshome.net",
rather than "arduino.mydomain.net" (which will fail to resolve).

If you know how to fix this, send me an email.

AUTHOR

Paul Kulchenko ([email protected])

LICENSE

See LICENSE file

HISTORY 

Mar 17 2012  v0.14  Updated the example to store WiFi configuration in
                    EEPROM and to provide a web interface to update it.
Mar 10 2012  v0.12  Updated to work with Arduino 1.0.
Nov 16 2011  v0.10  Fixed a bug with incorrect CRC being stored when IP 
                    address is assigned, which caused incorrect processing
                    of multiple DHCP REQUEST messages from the same IP.
                    This fixed the issue with iOS and MacOS clients.
                    Thanks to David Simmons @davidsimmons.com for assistance.
Nov 12 2011  v0.06  Added AJAX example with keep-alive to read real-time data 
                    over HTTP.
Nov 07 2011  v0.05  Added options for renewal and rebinding timers. 
                    Cleaned up code.
Oct 30 2011  v0.04  Added conversion to lowercase hostname and a check for 
                    simple hostname to DNS processing.
Oct 29 2011  v0.03  Added DNS processing.
Oct 29 2011  v0.02  Updated hash to a longer and more robust version.
Oct 28 2011  v0.01  First release.