From 2134210f6e269f60c0a8034bcb57b276545617f2 Mon Sep 17 00:00:00 2001 From: Marti Bolivar Date: Sat, 11 Jun 2011 20:47:54 -0400 Subject: ide: Document further, reorganize. Move screenshot down into its own section. Add table of contents. Reorganize toolbar button descriptions as subsections of a new section dedicated to the purpose. Add a stub about getting to the examples. --- source/ide.rst | 116 +++++++++++++++++++++++++++++++++++---------------------- 1 file changed, 72 insertions(+), 44 deletions(-) diff --git a/source/ide.rst b/source/ide.rst index b3ef653..58dca1c 100644 --- a/source/ide.rst +++ b/source/ide.rst @@ -11,116 +11,135 @@ The :ref:`Maple Quickstart ` is another good source of information on the IDE; it is especially useful for setting up a computer for the first time. +.. contents:: Contents + :local: + +IDE Windows +----------- + +The following screenshot shows the appearance of a Maple IDE window: + .. figure:: /_static/img/ide-blinky.png :align: center :alt: Maple IDE +Note the toolbar buttons at the top; they're the icons with circles or +squares around them. You can program your board mostly through the +use of these buttons, which are described in the next section. + +Toolbar Buttons +--------------- + .. _ide-verify: Verify ------- +~~~~~~ .. image:: /_static/img/button-verify.png :align: left -Click Verify to compile the current sketch. +Click Verify to compile the current sketch. This will process your +program and produce an executable which can run on your board. .. _ide-stop: Stop ----- +~~~~ .. image:: /_static/img/button-stop.png :align: left -Click Stop to cancel a compilation. +Click Stop to cancel a compilation. Longer programs may take a while +to compile. Clicking Stop will let you go back to writing code +without having to wait for compilation to finish. .. _ide-new: New ---- +~~~ .. image:: /_static/img/button-new.png :align: left -Click New to begin a fresh sketch. +Click New to make a fresh sketch. .. _ide-open: Open ----- +~~~~ .. image:: /_static/img/button-open.png :align: left -Click Open to open a new sketch. By default, this will look in you -*sketchbook*, which is a directory on your system which contains all -of your sketches. The default directory of your sketchbook varies by -operating system; you can change it in the IDE preferences. +Click Open to open an existing sketch. Maple IDE will first look for +the sketch in your *sketchbook*, which is a folder on your computer +that contains your sketches. The sketchbook is stored in different +places depending on your operating system. You can change its +location in the IDE's preferences. .. _ide-save: Save ----- +~~~~ .. image:: /_static/img/button-save.png :align: left -Click Save to save the currently opened sketch. +Click Save to save the currently opened sketch. This will save all +open tabs, not just the one you're currently looking at. .. _ide-upload: Upload ------- +~~~~~~ .. image:: /_static/img/button-upload.png :align: left Click Upload to send the compiled sketch to your Maple to run. Before you click Upload, you must have a memory location and serial port -selected. The memory location, either Flash or RAM, determines -whether the compiled sketch binary will be stored on the Maple. You -can choose this using the Tools > Board menu. The serial port -corresponds to the Serial-over-USB connection the Maple has -established with your computer. This looks like "COM1", "COM2", -etc. on Windows, "/dev/tty.usbmodemXXX" on Mac (where "XXX" is some -sequence of letters and numbers), or "/dev/ttyACMXXX" on Linux (again, -where "XXX" is some sequence of letters and numbers). You can choose -a serial port using the Tools > Serial Port menu. - -If you click Upload without having made these choices; The IDE -*should* prompt you to do so. However, if you're trying to upload and -are unsuccessful, make sure you've made choices for both board and -serial port. - -For more help, the upload process is documented in more detail (with -screenshots) in the :ref:`quickstart `. +selected. + +The memory location, either Flash or RAM, determines whether the +compiled sketch binary will be stored on the Maple. You can choose +this using the Tools > Board menu. + +The serial port corresponds to the :ref:`SerialUSB ` +connection the Maple establishes with your computer. This looks like +"COM1", "COM2", etc. on Windows, "/dev/tty.usbmodemXXX" on Mac (where +"XXX" is some sequence of letters and numbers), or "/dev/ttyACMXXX" on +Linux (again, where "XXX" is some sequence of letters and numbers). +You can choose a serial port using the Tools > Serial Port menu. + +If you're trying to upload and are unsuccessful, make sure you've made +choices for both board and serial port. More help on uploading +(including screenshots) is available in the :ref:`quickstart +`. If all else fails, try putting your Maple in :ref:`perpetual bootloader mode ` before -uploading. - -In any case, you can always find us on the `forum`_ or `contact us -directly`_. +uploading. You can always find us on the `forum`_ or `contact us +directly`_ for help on any problems you're having. .. _ide-serial-monitor: Serial Monitor --------------- +~~~~~~~~~~~~~~ .. image:: /_static/img/button-serial-monitor.png :align: left -Click Serial Monitor to open up a communications channel between your -PC and the Maple's :ref:`Serial-over-USB ` -(``SerialUSB``) virtual serial port. +Click Serial Monitor to open up a communication channel between your +PC and the Maple's :ref:`SerialUSB ` virtual serial +port. If the serial monitor is open, any information sent to the computer -(e.g. using :ref:`SerialUSB.println() ` will -be displayed in the large text area. You can send data to the Maple -(to be read with e.g. :ref:`SerialUSB.read() `) -by typing into the small text box and either hitting the Enter key or -pressing the Send button. +(for example, using :ref:`SerialUSB.println() +`) will be displayed in the large text area. +You can send data to the Maple by typing into the small text box and +either hitting the Enter key or pressing the Send button. (The Maple +can read the data you send with :ref:`SerialUSB.read() +`). Here is an example serial monitor session with the InteractiveTest sketch (which you can load in the IDE by choosing menu item File > @@ -134,3 +153,12 @@ This is the result of typing "?" in the text box and clicking Send. If you click :ref:`Upload ` while the serial monitor is open, the IDE will close it for you before proceeding with the upload. + +.. _ide-examples: + +Example Code +------------ + +Maple IDE comes with a variety of sample code you can use to help you +get started writing your own programs. To load an example in a new +Maple IDE window, choose one from the submenus under File > Examples. -- cgit v1.2.3