# Tool Chain Setup on Windows

The following steps describe the µracoli toolchain installation for Windows.

The packages referenced below was installed in December 2008.

Note:
  Generally I did install all tools in a separate directory, e.g. "D:\\DevTools" instead of "C:\\Programm Files" and it worked.

## Tools for Beginners

- avrstudio

## Tools for Users

If you want to modify the examples and install it on your platform, you will need:

- avrstudio
- winavr

For using the packet capture tool, you need:

- Python
- PyWin32
- PySerial
- Wireshark
- FTDI driver for Windows (You need this driver, if you want to use the AVR Z-Link 2.4 GHz Packet Sniffer Kit or the STB Sensor Terminal Board.)

## Tools for Advanced Users

If you want to build the libraries and applications directly from the sources, you need:

This tools you have probably already installed:

- avrstudio, winavr
- winpywin32, winpyserial, winwshark, winftdi

This tools you will need:

- winpython
- winscons
- windox
- windot
- winxslt

If you want to run the packet capture tool you need additionaly:

- winpywin32
- winpyserial
- winwshark
- winftdi

For check out of the latest state of the repository:

- wincvs

## Tools for Developers

You need now nearly the complete tool chain (except ssh):

- avrstudio
- winavr
- winpython
- winscons
- windox
- windot
- winxslt
- winpywin32
- winpyserial
- winwshark
- winftdi
- wincvs
- winpy2exe

## Tools for Contributors opt{1}=<b><tt></tt></b>

You need now the complete tool chain:

- avrstudio
- winavr
- winpython
- winscons
- windox
- windot
- winxslt
- winpywin32
- winpyserial
- winwshark
- winftdi
- wincvs
- winssh
- winpy2exe

## Tools List

1. AVR Studio 4 (mandatory)
   - URL: http://www.atmel.com/dyn/products/tools_card.asp?tool_id=2725
   - Download: http://www.atmel.com/dyn/resources/prod_documents/AvrStudio416Setup.exe
   - Remarks: None
   - Why? ... it provides embedded programmer and debugger
2. WinAVR (mandatory)
   This package provides a complete set of all tools around AVR microcontroller, including compiler, linker, assembler, avrdude, ... and many other more.
   - URL: http://winavr.sourceforge.net/
   - Download: http://downloads.sourceforge.net/winavr/WinAVR-20081205-install.exe
   - Remarks: None
   - Why? ... it provides avr-binutils, avr-gcc
3. Python (mandatory)
   - URL: http://www.python.org
   - Download: http://www.python.org/ftp/python/2.5.2/python-2.5.2.msi
   - Remarks: None
   - Why? ... it provides a swiss army knife for everything
4. Scons (mandatory)
   - URL: http://www.scons.org/
   - Download: http://prdownloads.sourceforge.net/scons/scons-1.1.0.win32.exe
   - Remarks: None
   - Why? ... it provides a a comfortable modern build system
5. Doxygen (required for creating documentation)
   - URL: http://www.doxygen.org/
   - Download: http://ftp.stack.nl/pub/users/dimitri/doxygen-1.5.7.1-setup.exe
   - Remarks: None
6. Graphviz (required for creating documentation)
   - URL: http://www.graphviz.org/
   - Download: http://www.graphviz.org/pub/graphviz/stable/windows/graphviz-2.20.3.msi
   - Remarks: None
7. XMLTools, xsltproc (required for generating AvrStudio example aps files)
   - URL: http://www.xmlsoft.org/
   - Download:
     http://www.zlatkovic.com/pub/libxml/zlib-1.2.3.win32.zip
     http://www.zlatkovic.com/pub/libxml/libxslt-1.1.24.win32.zip
     http://www.zlatkovic.com/pub/libxml/libxml2-2.7.2+.win32.zip
   - Remarks:
     Unizip this packages and copy all files from [PACKAGE]/bin/ directory to your misc. tools directory, e.g. D:\DevTool\Misc
8. Pywin32 (required if packet capture tool is used)
   - URL: http://sourceforge.net/projects/pywin32/
   - Download: http://downloads.sourceforge.net/pywin32/pywin32-212.win32-py2.5.exe
   - Remarks: prerequisite for pyserial and used in ieee802154.py for named pipes.
9. Pyserial (required if packet capture tool is used)
   - URL: http://pyserial.wiki.sourceforge.net/pySerial
   - Download: http://downloads.sourceforge.net/pyserial/pyserial-2.4.win32.exe
   - Remarks: None
10. Wireshark (required if packet capture tool is used)
    - URL: http://www.wireshark.org
    - Download: http://www.wireshark.org/download.html (wireshark-setup-1.0.5.exe)
    - Remarks: None
11. Driver FTDI FR245 (required if DE sensor terminal board or Atmel sniffer kit is used)
    - URL: http://www.ftdichip.com
    - Download: TODO make the patched package available
    - Remarks: see
12. TortoiseCVS (recommended)
    Since µracoli is rapidly changing, a direct access to the µracoli source code repository helps to stay up to date with bug fixes and enhancements.
    - URL: http://www.tortoisecvs.org/
    - Download: http://prdownloads.sourceforge.net/tortoisecvs/TortoiseCVS-1.10.9.exe
    - Remarks:
      Unable to install 11.1.3 on WinXP, version 1.10.9 did work fine.
      For anonymous cvs use: simply add cvs url to tortoise config for developer cvs use:
      - install Putty (see below)
      - convert your ssh2 privte key to putty ppk format, use puttygen.exe / Load / Save private key.
      - start pageant /path/to/uracoli.ppk, e.g.
        "d:\\DevTools\\Misc\\PAGEANT.EXE \\path\\to\\uracoli.ppk"
13. Putty (required for µracoli developer access)
    If you have a µracoli developer account, you will need this package in order to do a SSH connection with the repository (not needed for anonymous checkout).
    - URL: http://www.putty.org/
    - Donwload: ftp://ftp.chiark.greenend.org.uk/users/sgtatham/putty-latest/x86/putty.zip
    - Remarks:
      Unpack the contents of the zip file in a general tool directory, which is in the path variable, e.g. D:\DevTool\Misc
14. py2exe (optional)
    - URL: http://www.py2exe.org
    - Download: http://sourceforge.net/project/showfiles.php?group_id=15583
    - Remarks: Version 0.6.9 was used.