commit d9435b37371b3b799ed2e8a93f9fba86ca874833
author Joe Fernandez <joefernandez@google.com> Tue Jun 26 23:32:03 2012 -0700
committer Joe Fernandez <joefernandez@google.com> Tue Jun 26 23:32:03 2012 -0700
tree 1b9338e9bac8d15ac45002152f3e786230228591
parent 7547be054261ad8ef9176bf6fa74df80b417ba90

docs: ADK2 docs - update alternative build instructions

Change-Id: I395749198a0c1589b71d49638620708e2dc2f6ae

docs/html/tools/adk/adk2.jd

diff --git a/docs/html/tools/adk/adk2.jd b/docs/html/tools/adk/adk2.jd
index d3fed30..6ee4a46 100644
--- a/docs/html/tools/adk/adk2.jd
+++ b/docs/html/tools/adk/adk2.jd
@@ -314,20 +314,38 @@
 
 <h3 id="alt-build">Using the ADK Alternative Build System</h3>
 
-<p>An alternative build and load system is also available for the ADK 2012. This system is command
-line based and intended for production environments where using an IDE environment to load software
-onto accessory hardware may be inconvenient or undesirable.</p>
+<p>An alternative, make file-based build and upload system is also available for the ADK 2012. This
+system is command line based and intended for production environments where using an IDE environment
+to load software onto accessory hardware may be inconvenient or undesirable.</p>
 
-<p>To use the command line based build system:</p>
+<p>To setup the environment:</p>
 <ol>
   <li><a href="#src-download">Download</a> the ADK 2012 source code files.</li>
-  <li>Download and install the <a href="http://www.gnu.org/software/make/">make</a> tool on your
-development system.</li>
-  <li>Update your system’s PATH to include {@code
-&lt;adk-source-download&gt;/external/toolchain/bin}.</li>
-  <li>Open a terminal window, navigate to {@code
-&lt;adk-source-download&gt;/external/toolchain/app} and execute the following command:
-  <pre>$> make</pre></li>
+  <li>In a terminal window, navigate to {@code
+&lt;adk-source-download&gt;/adk2012/board/MakefileBasedBuild}.</li>
+  <li>Execute the following command and follow the instructions:
+    <pre>$> ./setup</pre>
+  </li>
+</ol>
+
+<p>To build a program for your accessory:</p>
+<ol>
+  <li>Place your accessory code in the {@code MakefileBasedBuild/app} directory, including all
+required library files. See the {@code app/main.c} file for an example of the program format.</li>
+  <li>Execute the following command and follow the instructions:
+    <pre>$> ./build</pre>
+  </li>
+</ol>
+
+<p>To load the program on your accessory hardware:</p>
+<ol>
+  <li>Run the build process above and make sure your program compiled successfully.</li>
+  <li>Attach the accessory via USB cable to your development computer.</li>
+  <li>Check which port the accessory is attached to and modify the {@code UART} variable in the
+{@code flash} script to the correct port address. On linux machines, the port address is typically
+{@code /dev/ttyUSB0}.</li>
+  <li>Execute the following command to load the program on the accessory:
+  <pre>$> ./flash</pre></li>
 </ol>
 
 <h2 id="adk-conn">How the ADK Connects with Android Devices</h2>