Differences

This shows you the differences between two versions of the page.

--- en:xgrid:readme [2012/03/31 03:34]
alex [2.1 Building XGrid in Linux]
+++ en:xgrid:readme [2012/06/15 19:51] (current)
alex [3.2 Building XGrid Manager in Windows]
@@ Line 7: / Line 7: @@
 ==== - Compatibility List ====
-XGrid should be compatible with all XMEGA processors.  Using the online firmware update feature requires that the application be no larger than half of the application flash, however, so please choose a large enough chip.  Also, XGrid tends to require a rather large amount of RAM for buffers, so it is only recommended for use with chips with 8K of SRAM.  An asterisk denotes the MCU has been tested and confirmed XGrid compatible.
+XGrid should be compatible with all XMEGA processors.  Using the online firmware update feature requires that the application be no larger than half of the application flash, however, so please choose a large enough chip.  Also, XGrid tends to require a rather large amount of RAM for buffers, so it is only recommended for use with chips with at least 8K of SRAM.  As XGrid uses the hardware USART modules for networking, a minimum of five is suggested for a square grid (four for networking and one for debug) and seven for a hexagonal grid (six for networking and one for debug).  For this reason, the D and B series are not recommended as these devices have fewer hardware USART modules.  An asterisk denotes that the MCU has been tested and confirmed XGrid compatible.
-Note that it may be possible to use XGrid on ATMEGA processors, though with only two USARTS, the networking abilities will be rather limited.
+Note that it may be possible to use XGrid on ATMEGA processors, though with only two USARTS, the networking abilities will be very limited.
   * XMEGA
-    * atxmega16a4
+    * atxmega16a4 (2k SRAM, 5 USARTs)
-    * atxmega32a4
+    * atxmega32a4 (4k SRAM, 5 USARTs)
-    * atxmega64a1
+    * atxmega64a1 (4k SRAM, 8 USARTs)
-    * atxmega64a3
+    * atxmega64a3 (4k SRAM, 7 USARTs)
-    * atxmega64a4
+    * atxmega64a4 (4k SRAM, 5 USARTs)
-    * atxmega128a1
+    * atxmega128a1 (8k SRAM, 8 USARTs)
-    * atxmega128a3 *
+    * atxmega128a3 (8k SRAM, 7 USARTs) *
-    * atxmega128a4
+    * atxmega128a4 (8k SRAM, 5 USARTs)
-    * atxmega192a1
+    * atxmega192a1 (16k SRAM, 8 USARTs)
-    * atxmega192a3
+    * atxmega192a3 (16k SRAM, 5 USARTs)
-    * atxmega256a1
+    * atxmega256a1 (16k SRAM, 8 USARTs)
-    * atxmega256a3b
+    * atxmega256a3b (16k SRAM, 7 USARTs)
-    * atxmega256a3
+    * atxmega256a3 (16k SRAM, 7 USARTs)
-    * atxmega16d4
+    * atxmega16d4 (2k SRAM, 2 USARTs)
-    * atxmega32d4
+    * atxmega32d4 (4k SRAM, 2 USARTs)
-    * atxmega64d3
+    * atxmega64d3 (4k SRAM, 3 USARTs)
-    * atxmega64d4
+    * atxmega64d4 (4k SRAM, 2 USARTs)
-    * atxmega128d3
+    * atxmega128d3 (8k SRAM, 3 USARTs)
-    * atxmega128d4
+    * atxmega128d4 (8k SRAM, 2 USARTs)
-    * atxmega192d3
+    * atxmega192d3 (16k SRAM, 3 USARTs)
-    * atxmega256d3
+    * atxmega256d3 (16k SRAM, 3 USARTs)
-    * atxmega16a4u
+    * atxmega16a4u (2k SRAM, 5 USARTs)
-    * atxmega32a4u
+    * atxmega32a4u (4k SRAM, 5 USARTs)
-    * atxmega64a3u
+    * atxmega64a3u (4k SRAM, 7 USARTs)
-    * atxmega64a4u
+    * atxmega64a4u (4k SRAM, 5 USARTs)
-    * atxmega128a3u
+    * atxmega128a3u (8k SRAM, 7 USARTs)
-    * atxmega128a4u
+    * atxmega128a4u (8k SRAM, 5 USARTs)
-    * atxmega192a3u
+    * atxmega192a3u (16k SRAM, 7 USARTs)
-    * atxmega256a3u
+    * atxmega256a3u (16k SRAM, 7 USARTs)
-    * atxmega256a3bu
+    * atxmega256a3bu (16k SRAM, 7 USARTs)
-    * atxmega64b1
+    * atxmega64b1 (4k SRAM, 2 USARTs)
-    * atxmega64b3
+    * atxmega64b3 (4k SRAM, 1 USART)
-    * atxmega128b1
+    * atxmega128b1 (8k SRAM, 2 USARTs)
-    * atxmega128b3
+    * atxmega128b3 (8k SRAM, 1 USART)
 ===== - Building XGrid =====
@@ Line 65: / Line 65: @@
   - Edit makefile for device and programmer settings
   -- Build
+  ..<code>
+$ make
+</code>
   -- Program
-<code>
+  ..<code>
 $ make program
 </code>
@@ Line 82: / Line 85: @@
   - Install software
- * Install WinAVR from http://sourceforge.net/projects/winavr/files/WinAVR/20100110/
+    * Install WinAVR from http://sourceforge.net/projects/winavr/files/WinAVR/
   - Edit makefile for device and programmer settings
-  - Build
+  -- Build
- > make
+  ..<code>
-  - Program
+> make
- > make program
+</code>
+  -- Program
+  ..<code>
+> make program
+</code>
+===== - Building XGrid Manager =====
+==== - Building XGrid Manager in Linux ====
+=== - Requirements ===
+  * gtkmm >= 2.28.0
+=== - Procedure ===
+  - Install required packages
+  -- If no configure script present, run bootstrap
+  ..<code>
+$ ./bootstrap
+</code>
+  -- Run configure script
+  ..<code>
+$ ./configure
+</code>
+  -- Build
+  ..<code>
+$ make
+</code>
+  -- Install
+  ..<code>
+$ make install
+</code>
+==== - Building XGrid Manager in Windows ====
+=== - Requirements ===
+  * mingw
+  * msys
+  * gtkmm >= 2.22.0
+=== - Procedure ===
+  - Install MinGW, MSYS, and gtkmm
+    * Install MinGW and MSYS
+      * Download from [[http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/]]
+      * Install C compiler, C++ compiler, MSYS, and Developer Toolkit
+      * Add MinGW and MSYS directories to path
+        * (Windows 7) Right click on Computer -> Properties, click Advanced System Settings
+        * (Other) Right cick on Computer -> Properties
+        * (All) On Advanced tab, select Environment Variables
+        * Under user variables, select PATH and click Edit.  If PATH does not exist, click New, enter PATH for name, and omit leading semicolon in next step.
+        * Add ;C:\MinGW\bin;C:\MinGW\msys\1.0\bin to the end of value
+        * Click OK x3
+        * Open a command prompt, type bash and hit enter.  You should see: bash-3.1$
+    * Install gtkmm
+      * Download from http://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/
+      * Install
+      * Add ACLOCAL_FLAGS environment variable with the value:
+        * -I /c/gtkmm/share/aclocal
+  -- Start bash shell and cd into proper directory
+  ..<code>
+> bash
+$ cd /path/to/software
+</code>
+  -- If no configure script present, run bootstrap
+  ..<code>
+$ ./bootstrap
+</code>
+  -- Run configure script
+  ..<code>
+$ ./configure
+</code>
+  -- Build
+  ..<code>
+$ make
+</code>
+  -- Install
+  ..<code>
+$ make install
+</code>