diff --git a/platform/esb/doc/slipintro.txt b/platform/esb/doc/slipintro.txt index 9211d1a28..0c5504ec5 100644 --- a/platform/esb/doc/slipintro.txt +++ b/platform/esb/doc/slipintro.txt @@ -20,49 +20,52 @@ lets you communicate with them using standard network tools such as -# Click start button and choose 'My Computer'. Right-click 'My -Network Places' and choose 'Properties'. --# Click 'Create a new connection'. --# Select 'Set up an advanced connection'. --# Select 'Connect directly to another computer'. --# Select 'Guest'. --# Select a name for the slip connection (for example 'ESB'). +Network Places' and choose 'Properties'. + +-# Click 'Create a new connection'. + +-# Select 'Set up an advanced connection'. + +-# Select 'Connect directly to another computer'. + +-# Select 'Guest'. + +-# Select a name for the slip connection (for example 'ESB'). + -# Select the serial port to use when communicating with the sensor -node. --# Add the connection by clicking 'Finish'. --# A connection window will open. Choose 'Properties'. +node. + +-# Add the connection by clicking 'Finish'. + +-# A connection window will open. Choose 'Properties'. + + -# Click on 'Configure...' and deselect all selected -buttons. Choose the speed 57600 bps. +buttons. Choose the speed 57600 bps. + -# Close the modem configuration window, and go to the 'Options' tab in the ESB properties. Deselect all except 'Display -progress...'. +progress...'. + -# Go to the 'Networking' tab. Change to 'SLIP: Unix Connection' and deselect all except the first two items in the connection item -list. +list. + -# Select 'Internet Protocol (TCP/IP)' and click -'Properties'. Enter the IP address '172.16.0.1'. +'Properties'. Enter the IP address '172.16.0.1'. + -# Click 'Advanced' and deselect all checkboxes in the 'Advanced TCP/IP Settings'. Go to the 'WINS' tab and deselect 'Enable LMHOSTS lookup' if it is selected. Also select 'Disable NetBIOS over -TCP/IP'. - - +TCP/IP'. + + \section slipintro-setup Setup ESB for over the air programming --# Make sure you have the latest contiki, contiki-msp430, and -contiki-esb (older versions of contiki might not work with SLIP under -Windows) +-# Make sure you have the latest version of contiki (older versions of + contiki might not work with SLIP under Windows) -# Install the contiki kernel by running \code make core.u @@ -93,8 +96,8 @@ node id, the node will have the IP address 172.16.1.2. Each node should have its own unique node id. You need to compile a core and upload it onto the nodes. All nodes -must run the same core. Move to the directory '\c contiki-esb' and -run +must run the same core. Move to the directory +'contiki-2.x/platform/esb' and run \code make diff --git a/platform/esb/doc/winintro.txt b/platform/esb/doc/winintro.txt index de30a57e1..16cb750cf 100644 --- a/platform/esb/doc/winintro.txt +++ b/platform/esb/doc/winintro.txt @@ -26,8 +26,8 @@ be found at http://www.cygwin.com. Click on the icon "Install Cygwin Now" to the right to get the installation started. Choose "Install from Internet" and then specify where you want to -install cygwin (recommended installation path: \c -C:$\backslash$cygwin). Continue with the installation until you are +install cygwin (recommended installation path: +C:\\cygwin). Continue with the installation until you are asked to select packages. Most packages can be left as "Default" but there is one package that are not installed by default. Install the following package by clicking at "Default" until it changes to @@ -54,23 +54,15 @@ http://www.crimsoneditor.com/ The editor is useful both when editing C programs and when modifying scripts and configuration files. -\subsection winintro-installing-compiler MSP430 Compiler and tools} +\subsection winintro-installing-compiler MSP430 Compiler and tools -The MSP430 compiler (a version of gcc) is needed to compile the -programs to the MSP430 microprocessor that is used on the ESB -sensor nodes. We have made a webpage which describe how to get the compilers -and other tools for programming the ESB nodes, see: -http://www.sics.se/sensornets/esblab/ +A compiler is needed to compile the programs to the MSP430 +microprocessor that is used on the ESB sensor nodes. Download and +install the GCC toolchain for MSP430 (recommended installation path: +C:\\MSP430\\). -Download and install the GCC toolchain for MSP430 -(recommended installation path: C:$\backslash$MSP430$\backslash$): -\c mspgcc-20041112.exe. - -You will also need some tools for sending the compiled programs -over to the ESB nodes. Install the -IAR Embedded Workbench (Kickstart Version) package -(recommended installation path: C:$\backslash$MSP430$\backslash$IARSystems): -\c fet_r304.exe. +The GCC toolchain for MSP430 can be found at: +http://sourceforge.net/projects/mspgcc/ When the above software is installed you also need to set-up the PATH so that all of the necessary tools can be reached. In cygwin @@ -78,19 +70,17 @@ this is done by the following line (given that you have installed at recommended locations): -export PATH=\$PATH:/cygdrive/c/MSP430/IARSystems/ew23:\newline -/cygdrive/c/MSP430/IARSystems/ew23/430/bin:/cygdrive/c/MSP430/mspgcc/bin +export PATH=\$PATH:/cygdrive/c/MSP430/mspgcc/bin This line can also be added to the .profile startup file in your cygwin -home directory \newline -(C:$\backslash$cygwin$\backslash$home$\backslash$$\backslash$.profile\end). +home directory +(C:\\cygwin\\home\\\\\.profile). If your home directory is located elsewhere you can find it by starting cygwin and running \c cd followed by \c pwd. -\subsection winintro-installing-contiki The Contiki operating system, including examples and labs +\subsection winintro-installing-contiki The Contiki operating system, including examples When programming the ESB sensor nodes it is very useful to have an operating system that takes care of some of the low-level tasks and @@ -99,66 +89,47 @@ and networking. We will use the Contiki operating system developed by Adam Dunkels, SICS, which is very well suited when programming small embedded systems. -Download Contiki for ESB nodes from the same page as before (Contiki -ESB). +The Contiki OS can be found at: +http://www.sics.se/~adam/contiki/ -Unzip the Contiki OS at (for example) C:$\backslash$ -and you will get the following directories: +Unzip the Contiki OS at (for example) C:\\ +and you will get the following directories among others: -- esblab/contiki - the contiki operating system -- esblab/contiki-esb - the contiki operating system drivers, etc for the ESB -- esblab/contiki-esb/labs - the example and lab files +- contiki-2.x/core - the contiki operating system +- contiki-2.x/platform/esb - the contiki operating system drivers, etc for the ESB +- contiki-2.x/platform/esb/apps/ - example applications for the ESB \section winintro-testing Testing the tools Now everything necessary to start developing Contiki-based sensor net applications should be installed. Start cygwin and change to the -directory \c labs/intro. Then call make esbintro. +directory contiki-2.x/platform/esb/. Then call make +beeper.co. If you get an error about multiple cygwin dlls when compiling, you -need to delete \c cygwin1.dll from the MSP430 GCC toolchain (\c -C:$\backslash$MSP430$\backslash$bin$\backslash$cygwin1.dll). +need to delete cygwin1.dll from the MSP430 GCC toolchain +(C:\\MSP430\\bin\\cygwin1.dll). Connect a node and turn it on. Upload the test application by calling -\c make esbintro.u. +make beeper.u. \subsection winintro-testing-development Development tools -- make will compile and make a executable file ready for -sending to the ESB nodes. Depending on the SPEC it might even startup -the application that sends the executable to the node. During this -course you would typically write things like "make - esbintro.u" to get the file esbintro.c compiled, linked and -sent out to the ESB node - -- cw23 starts up the CSPY program that sends programs to the -ESB nodes and allow debugging (usually started by the \c make - +- make \ will compile and make a executable file ready +for sending to the ESB nodes. Depending on the \c SPEC it might even +startup the application that sends the executable to the +node. Typically you would write things like "make beeper.u" +to get the file beeper.c compiled, linked and sent out to the +ESB node \subsection winintro-testing-shell Some basic shell commands -- cd change to a specified directory (same as in DOS) -- pwd shows your current directory +- cd \ change to a specified directory (same as in DOS) +- pwd \ shows your current directory - ls list the directory -- mkdir creates a new directory -- cp copies a file - -\subsection winintro-testing-excercises - - * compile and start the \c esbintro application (remember to change - directory to contiki-esb before you run \c make) - * modify the C code and make the yellow led be on when the red is - off (and vice versa). The code is in the \c contiki-esb/labs/intro -folder. Hint: Add another line controlling the yellow led in the section: -\code - if (timer_expired(&timer)) { - timer_reset(&timer); - leds_red(on ? LEDS_ON : LEDS_OFF); - on = !on; - } -\endcode +- mkdir \ creates a new directory +- cp \ \ copies a file */ /** @} */ /** @} */ -