contiki

mirror of https://github.com/oliverschmidt/contiki.git synced 2024-12-23 01:29:33 +00:00

History

oliverschmidt 072830d4f2 Migrated project files from VC++ 2005 (Express Edition) to VC++ 2008 (Express Edition). Almost all changes were required because VC++ 2008 does a parallel build. Therefore all intermediate files need to have unique names. This wasn't the case by default because VC++ doesn't presume seperate projects to build into the same directory - as it is the case with all the .prg and .dsc files of Contiki.		2008-10-29 15:03:34 +00:00
..
cfs	Moved Win32 cfs directory functions from cfs-win32.c to cfs-win32-dir.c.	2008-07-06 10:24:38 +00:00
ctk	Fixed typos.	2007-12-15 20:12:28 +00:00
loader	Removed superfluous semicolon.	2008-02-08 12:14:52 +00:00
vcproj	Migrated project files from VC++ 2005 (Express Edition) to VC++ 2008 (Express Edition). Almost all changes were required because VC++ 2008 does a parallel build. Therefore all intermediate files need to have unique names. This wasn't the case by default because VC++ doesn't presume seperate projects to build into the same directory - as it is the case with all the .prg and .dsc files of Contiki.	2008-10-29 15:03:34 +00:00
clock.c	Added clock_seconds implementation to win32 port	2008-07-10 17:08:54 +00:00
conio.h
contiki-conf.h	Activate uIP forwarding support.	2008-05-22 19:49:48 +00:00
contiki-main.c	Removed finally unnecessary cast.	2008-02-10 22:36:36 +00:00
contiki.sln	Migrated solution file from VC++ 2005 (Express Edition) to VC++ 2008 (Express Edition).	2008-10-29 14:59:35 +00:00
Makefile	Adjusted to the new shell.	2008-02-09 18:56:26 +00:00
Makefile.win32	Leverage split of cfs-posix and cfs-posix-dir by reusing cfs-posix for win32 and replacing only cfs-posix-dir with cfs-win32-dir.	2008-07-06 08:29:37 +00:00
README	Added some info on the win32 platform.	2007-11-28 17:12:11 +00:00

README

The platform/win32/ directory contains a showcase of Contiki 1.x technologies
ported to the Contiki 2.x environment. As such it serves primarily two purposes:
- Allow for easy interactive experience of the Contiki applications with user
  interface, especially the Contiki web browser.
- Allow for easy regression tests of the code in core/ctk/ and most of the code
  in apps/.

The employed Contiki 1.x technologies include:
- The 'Contiki Tool Kit' (CTK) UI framework in general
- CTK running in a character based environment (here the Win32 Console API)
- CTK mouse support
- Dynamic loading and unloading of Contiki programs (.PRG) and Contiki program
  descriptions (.DSC) based on dynamically loadable libraries (here Win32 DLLs)

A typical Contiki 1.x implementation consists of a core binary (containing among
others the uIP and CTK libraries) and the program (and program description)
binaries which are both loaded by the core and reference the core libraries.
Therefore the Contiki 2.x project-based build system doesn't suit exactly. So
in order to be able to leverage the Contiki 2.x build system to its maximum
extend two makefiles are necessary:
- Makefile plays the role of a Contiki 2.x project Makefile
- Makefile.win32 is an ordinary (yet complex) Contiki 2.x Makefile.$(TARGET)

As an alternative to building with Cygwin, gcc and the Contiki 2.x build system
it is also possible to use Microsoft Visual Studio 2005 (including the Express
Edition) by loading platform/win32/contiki.sln.

As platform/win32/Makefile.win32 includes cpu/native/Makefile.native the WinPcap
library is used for network I/O. Please consult cpu/native/net/README-WPCAP for
further details.

Both a Cygwin Bash Shell and an ordinary Windows Command Prompt are fine for
runtime. But in order to experience the CTK mouse support it is necessary to
deactivate the 'QuickEdit Mode' of the window used. This option is found in its
Windows system menu under 'Properties'.

As the console is used for displaying the actual user interface the log output
is routed to the debug output. DebugView is a very lean program for displaying
the debug output in case no debugger is active and does so. It is available at
http://www.microsoft.com/technet/sysinternals/utilities/debugview.mspx.