Ethernet host watchdog version 4

This is the software for the tuxgraphics.org
Tuxgraphics.org ethernet host watchdog. See http://tuxgraphics.org/electronics/

Copyright of most software and all diagrams: Guido Socher

License for everything: GPL V2
See http://www.gnu.org/licenses/gpl.html
---------------------------------------------------------------------------

 All parts needed to build this AVR ethernet solution can be ordered from 
 http://shop.tuxgraphics.org/                                          
 Note that the magnetics need to fit exactly the requirements of the enc28j60
 chip. You can not just take any transformer.

The relay that controls the reset button or the power of the monitored host
must be connected via pin PD7.

To use the voltage measurement functionality you need two 10K and two
270K 1% resistors. They are to be connected as voltage dividers to
ADC0 and ADC1 as shown in adc-voltage-divider.pdf.

Compiling the software

!! READ THIS FIRST !! --------------------- ! Edit the file main.c and change the 2 lines: ! static uint8_t mymac[6] = {0x54,0x55,0x58,0x10,0x00,0x29}; ! static uint8_t myip[4] = {10,0,0,29}; For the first device you build you will not need to change the mymac line. But you will probably need to change the IP address (myip). It must be a free address from the address range in your home network. Use an IP address in the same network as you DSL router. Example: you wlan router might have 192.168.1.1, your PC might have 192.168.1.2. This means you could e.g use 192.168.1.10 and leave some room for more PCs. Edit the beginning of the make file. And adjust those lines according to the CPU you use (atmega168 or atmega328p or atmega644): MCU=atmega168 DUDECPUTYPE=m168 or MCU=atmega328p DUDECPUTYPE=m328p or MCU=atmega644 DUDECPUTYPE=m644 or MCU=atmega644 DUDECPUTYPE=m644p Edit the avrdude command definition: # linux (plug in the avrusb500 and type dmesg to see which device it is): LOADCMD=avrdude -P /dev/ttyUSB0 # mac (plug in the programmer and use ls /dev/tty.usbserial* to get the name): LOADCMD=avrdude -P /dev/tty.usbserial-A9006MOb # windows (check which com-port you get when you plug in the avrusb500): LOADCMD=avrdude -P COM4 More information about Makefiles can be found at: http://tuxgraphics.org/electronics/200912/makefiles.shtml To compile the final software use the command: make Note: windows users may use and modify the supplied winmake.bat to setup the environment correctly. The above command will compile the following hex file: main.hex

Loading the software into the board

The makefile included as well a command to load the hex file using avrusb500 in combination with avrdude. You may use your own method to load the file. make load The "make load" command will run something like: avrdude -p m168 -c stk500v2 -e -U flash:w:main.hex Note: your programmer might interfere with the enc28j60! If you use an avrusb500 then you can normally leave the cable on. For all other programmers it is saver to remove the programmer cable and power down/up the ethernet board. This is because the SPI interface is used for loading of the software and communication to the enc28j60. To see a list of all possible build targets run the command: make help

Selecting the right clock source

Tuxgraphics hardware sold as of march 2007 is prepared to use the clock signal from the enc28j60. To use this you need to change the low fuse byte once from 0x62 to 0x60: avrdude -p m168 -c stk500v2 -u -v -U lfuse:w:0x60:m or avrdude -p m328p -c stk500v2 -u -v -U lfuse:w:0x60:m or avrdude -p m644 -c stk500v2 -u -v -U lfuse:w:0x60:m The above command can as well be executed by using the make file. In a Linux shell you can just type: make fuse Note: windows users may use and modify the supplied winsetfuse.bat script. After programming the fuse settings of an atmega168 should be: low fuse: 0x60 high fuse: 0xdf ext. fuse: 0x01 For the atmega328p the hfuse and efuse bytes look slightly different. The idea is however the same. Just change the lfuse from factory default to 0x60. The fuse settings of the atmega328p are after programming should be as below (default factory settings for atmega328p, the efuse has some not used bits and is dependent on the chip revision): lfuse reads as 0x60 hfuse reads as 0xD9 efuse reads as 0x07 Fuses of the atmega644/atmega644a after programming: Device signature = 0x1e9609 lfuse reads as 60 hfuse reads as 99 efuse reads as FF details of the lfuse bits: CKDIV8 = 0 CKOUT = 1 SUT1 = 1 SUT0 = 0 CKSEL3 = 0 CKSEL2 = 0 CKSEL1 = 0 CKSEL0 = 0 If you are unsure what the current fuse setting are on the atmega then you can read the fuse settings with a command like: avrdude -p m168 -c stk500v2 -v -q The below list of fuses shows for reference purpose the settings of a new and never programmed chip. The result should be this (default factory settings for atmega168): lfuse reads as 62 hfuse reads as DF efuse reads as 1 The result should be this (default factory settings for atmega328p): lfuse reads as 62 hfuse reads as D9 efuse reads as 7 The result should be this (default factory settings for atmega644/atmega644a): Device signature = 0x1e9609 lfuse reads as 62 hfuse reads as 99 efuse reads as FF

Calibrating the voltage measurement function

The microcontroller has a stable reference voltage of nominal 1.1V. This voltage is used as a reference for the ADC. It can vary from microcontroller to microcontroller therefore the voltages shown can vary. If you want to calibrate your board then look for line "#define ADCMUL_VAL 308" in main.c and read the comments above that line. By changing this value a litte bit you can calibrate the output.

Compilation on non-Unix systems

Please use the provided Makefile !!! It will also work under Windows. Take a look at the supplied winmake.bat and winload.bat file. The bat script might be needed to set the environment correctly. Take a look at the supplied winmake.bat and winload.bat file. The bat script might be needed to set the environment correctly in order to use the Makefile under windows. Edit the Makefile to make the needed adjustments at the top of the file. More information about Makefiles can be found at: http://tuxgraphics.org/electronics/200912/makefiles.shtml

Using the webserver based network watchdog

Point your web browser to http://10.0.0.29 (or what ever IP address you have given your hardware) [cfg] [voltages] [actions] [help] [refresh] host watchdog WD Status: OK [reset cnt:0, state: active] monitored IP: 192.168.0.1 GW IP: 0.0.0.0 ping interval: 10 sec send ping: yes -------------------------------------------------------------------------- 4.0,tuxgraphics The watchdog has its own documentation at: http://tuxgraphics.org/hwd4.html

Revision history

2008-12-10: version 2.13 -- First version of the reset pushbutton code. Based on eth_rem_dev_tcp-2.11 2008-12-30: version 2.14 -- Avoid interfrence between ping and web traffic 2008-12-31: version 2.15 -- adaptations for atmega328 chip 2009-02-28: version 2.16 -- Enc bug fixes and cosmetic code updates. 2009-03-11: version 2.17 -- updates to the README file 2010-03-21: version 3.0 -- major re-write. It is now possible to ping hosts inside and outside the local LAN version 3.0 was an internal version only. 2010-08-28: version 3.1 -- add atmega644 support 2011-02-01: version 4.0 -- SNMP support and voltage measurement option # vim:sw=8:ts=8:si:et