summaryrefslogtreecommitdiffstats
path: root/docs/html/tools/adk
diff options
context:
space:
mode:
authorJoe Fernandez <joefernandez@google.com>2012-06-26 23:32:03 -0700
committerJoe Fernandez <joefernandez@google.com>2012-06-26 23:32:03 -0700
commitd9435b37371b3b799ed2e8a93f9fba86ca874833 (patch)
tree1b9338e9bac8d15ac45002152f3e786230228591 /docs/html/tools/adk
parent7547be054261ad8ef9176bf6fa74df80b417ba90 (diff)
downloadframeworks_base-d9435b37371b3b799ed2e8a93f9fba86ca874833.zip
frameworks_base-d9435b37371b3b799ed2e8a93f9fba86ca874833.tar.gz
frameworks_base-d9435b37371b3b799ed2e8a93f9fba86ca874833.tar.bz2
docs: ADK2 docs - update alternative build instructions
Change-Id: I395749198a0c1589b71d49638620708e2dc2f6ae
Diffstat (limited to 'docs/html/tools/adk')
-rw-r--r--docs/html/tools/adk/adk2.jd40
1 files changed, 29 insertions, 11 deletions
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 @@ ready to communicate with your Android device.</li>
<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>