aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/maple-ide-install.rst
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2011-06-11 19:25:29 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2011-06-11 20:05:33 -0400
commit0c2b3c667bf157dc2344e3dbc2aae0e11e37387b (patch)
tree3008ee192c80f17f640ebdeb870442e78415ce6b /docs/source/maple-ide-install.rst
parentd4b576fcadecf66b7b754af7d204bb6f3b4a9830 (diff)
downloadlibrambutan-0c2b3c667bf157dc2344e3dbc2aae0e11e37387b.tar.gz
librambutan-0c2b3c667bf157dc2344e3dbc2aae0e11e37387b.zip
Remove reST documentation, attendant updates.
The documentation covers topics not specifically relevant to libmaple, so it doesn't make sense for it to be part of the libmaple source distribution. Delete the docs/ tree, and prepare libmaple for use with the new leaflabs-docs repo, which will contain the docs from now on. * README: update to reflect this change * support/doxygen/Doxyfile: This is the old docs/Doxyfile * Makefile: Add a doxygen target * wirish/comm/HardwareSerial.h: fix reference to docs/. The comment informing maintainers that the HardwareSerial interface is documented by hand refers to the docs/ tree, which no longer exists. Update it to refer to the separate leaflabs-docs repository. * support/scripts/copy-to-ide: No longer build the documentation
Diffstat (limited to 'docs/source/maple-ide-install.rst')
-rw-r--r--docs/source/maple-ide-install.rst171
1 files changed, 0 insertions, 171 deletions
diff --git a/docs/source/maple-ide-install.rst b/docs/source/maple-ide-install.rst
deleted file mode 100644
index 67171dd..0000000
--- a/docs/source/maple-ide-install.rst
+++ /dev/null
@@ -1,171 +0,0 @@
-.. highlight:: c++
-
-.. _maple-ide-install:
-
-========================
- Maple IDE Installation
-========================
-
-If you still can't get the IDE installed after reading this page,
-check the :ref:`troubleshooting page <troubleshooting>` for help with
-some common problems. If all else fails, try our `forum`_, or `contact
-us directly`_\ !
-
-.. contents:: Contents
- :local:
-
-Download
---------
-
-.. FIXME [0.0.12] Update this for the release.
-
-This documentation was built from a development version of libmaple.
-See the formally released `LeafLabs documentation
-<http://leaflabs.com/docs/>`_ for more information about the current
-Maple IDE release.
-
-.. Choose the correct version for your operating system:
-
-.. .. list-table::
-.. :widths: 15 30
-.. :header-rows: 1
-
-.. * - Platform
-.. - Status
-.. - IDE Package
-.. * - `Windows XP <http://static.leaflabs.com/pub/leaflabs/maple-ide/maple-ide-0.0.10-windowsxp32.zip>`_
-.. - Tested on 32-bit Windows XP
-.. * - `Linux <http://static.leaflabs.com/pub/leaflabs/maple-ide/maple-ide-0.0.10-linux32.tgz>`_
-.. - Tested on Ubuntu 10.04 (32-bit)
-.. * - `Mac OS X <http://static.leaflabs.com/pub/leaflabs/maple-ide/maple-ide-0.0.10-macosx-10_6.dmg>`_
-.. - Tested on Snow Leopard (10.6)
-
-The package bundles together a compiler, an upload utility, a software
-library, and a simple GUI text editor. All this software is `free and
-open <http://www.fsf.org/>`_; we are grateful to the `Arduino
-<http://arduino.cc/>`_, `CodeSourcery
-<http://www.codesourcery.com/>`_, `GNU <http://www.gnu.org/>`_, and
-`OpenMoko <http://openmoko.com/>`_ developers, as well as many others,
-who allow us to reuse their software.
-
-**Looking for something older?** `Source archives and binaries
-<http://static.leaflabs.com/pub/leaflabs/maple-ide/>`_ are available
-for previously-released versions.
-
-Installation
-------------
-
-* :ref:`Windows <maple-ide-install-windows>`
-* :ref:`Linux <maple-ide-install-linux>`
-* :ref:`OS X <maple-ide-install-osx>`
-
-.. _maple-ide-install-windows:
-
-Windows
-^^^^^^^
-First, extract all the files in the ZIP file to a suitable location on
-your system (like your Desktop folder). Next, you have to install
-some drivers. Sorry!
-
-.. note:: Note that while these instructions work on Windows XP,
- changes in Windows 7 mean that you won't be able to install the IDE
- without disabling driver signing on your computer. We're working
- on resolving this situation. For now, `users on the forum have
- reported a workaround
- <http://forums.leaflabs.com/topic.php?id=73#post-788>`_.
-
-First, install DFU drivers (for uploading code to your Maple) using
-the following steps.
-
-1. Plug your Maple into the USB port.
-
-2. Hit the reset button on your Maple (it's the small button at the
- bottom left, labeled RESET). Notice that it blinks quickly 6 times,
- then blinks slowly a few more times.
-
-3. Hit reset again, and this time push and hold the other button
- during the 6 fast blinks (the button is on the top right; it is
- labeled BUT). You can release it once the slow blinks start.
-
-4. Your Maple is now in :ref:`perpetual bootloader mode
- <troubleshooting-perpetual-bootloader>`. This should give you a
- chance to install the DFU drivers.
-
-5. Windows should now prompt you for some drivers. In the top level
- directory of the Maple IDE, point Windows to
- :file:`drivers/mapleDrv/dfu/`.
-
-Next, install serial drivers (for communicating with your Maple using
-serial over USB).
-
-1. Reset your Maple and allow it to exit the bootloader (wait for the
- slow blinking to stop). The Maple will next start running whatever
- program was uploaded to it last. (New Maples will start running the
- test program we upload to them before shipping them to you).
-
-2. Once Maple is running some user code, Windows should prompt you for
- more drivers. Point windows to :file:`driver/mapleDrv/serial`.
-
-You can now run the Maple IDE by double-clicking on the
-:command:`maple-ide` program from within the extracted IDE directory.
-
-.. _maple-ide-install-linux:
-
-Linux
-^^^^^
-
-.. _maple-ide-install-java:
-.. note::
-
- The IDE is written in Java and requires a compatible runtime (JRE).
-
- If you don't have one, they're usually pretty easy to install. Sun
- Java 1.6 and OpenJDK 1.6 are known to work, and runtimes mostly
- compatible with Sun Java 1.5+ should probably get the job done.
-
- To install Java, try using your distribution's software packaging
- tool and search for "JRE" or "java". On Debian-based systems
- (including Ubuntu) you can try to install the OpenJDK 1.6 JRE
- with::
-
- $ sudo aptitude install openjdk-6-jre
-
-Extract the tarball to an appropriate location (like your home
-directory or desktop).
-
-Make sure you have a Java runtime (JRE) installed; if you can run
-:command:`java` from the shell, you should be fine.
-
-Next, run the script :file:`install-udev-rules.sh` in the extracted
-IDE directory. It will ask for root permissions (you will be prompted
-with something along the lines of ``[sudo] password for
-<username>:``). You now need to restart udev::
-
- $ sudo restart udev
-
-This will grant members of the group ``plugdev`` read/write access to
-Maple devices over USB. Make sure that you are in that group by
-running ``$ sudo adduser <your username> plugdev`` (which will ensure
-access to the Maple, but may report that you are already a member of
-that group). (For more information on why this is part of the install
-process, see the :ref:`Unix toolchain quickstart <toolchain-udev>`).
-
-To run the Maple IDE, run :command:`maple-ide` from the shell, or
-double-click on it if your window system supports it.
-
-Feel free to put the IDE directory wherever you want. As long as you
-leave its internal structure unchanged, things should be fine.
-
-.. _maple-ide-install-osx:
-
-OS X
-^^^^
-
-Double-click on the :file:`.dmg` file you downloaded to mount the disk
-image. From the mounted image, drag and drop the Maple IDE icon into
-your computer's Applications folder.
-
-To run the Maple IDE, double-click the :command:`Maple IDE`
-application you dragged into your computer's :file:`Applications`
-folder.
-