From 171c84a9d962a0141d8027dcfc39c5e90f95c5ed Mon Sep 17 00:00:00 2001 From: oliverschmidt Date: Wed, 28 Nov 2007 17:12:11 +0000 Subject: [PATCH] Added some info on the win32 platform. --- platform/win32/README | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 platform/win32/README diff --git a/platform/win32/README b/platform/win32/README new file mode 100644 index 000000000..b151db93b --- /dev/null +++ b/platform/win32/README @@ -0,0 +1,40 @@ +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.