Merge branch 'release/v0.2.0'

Author: ivankravets

HISTORY.rst

@@ -0,0 +1,16 @@
+Release History
+===============
+
+0.2.0 (2014-06-15)
+------------------
+
+* Resolved `issue #1 "Build referred libraries" <https://github.com/ivankravets/platformio/issues/1>`_
+* Renamed project's "libs" directory to "lib"
+* Added `arduino-internal-library <https://github.com/ivankravets/platformio/tree/develop/examples/arduino-internal-library>`_ example
+* Changed to beta status
+
+
+0.1.0 (2014-06-13)
+------------------
+
+* Birth! First alpha release

README.rst

@@ -35,7 +35,9 @@ instruments.
 
 **Platformio** is well suited for **embedded development**. It can:
 
-* Compile frameworks and libraries sources to static libraries
+* Automatically analyse dependency
+* Reliably detect build changes
+* Build framework or library source code to static library
 * Build *ELF* (executable and linkable firmware)
 * Convert *ELF* to *HEX* or *BIN* file
 * Extract *EEPROM* data
@@ -285,14 +287,14 @@ Initialize new platformio based project.
     # Example
     $ platformio init
     Project successfully initialized.
-    Please put your source code to `src` directory, external libraries to `libs`
+    Please put your source code to `src` directory, external libraries to `lib`
     and setup environments in `platformio.ini` file.
     Then process project with `platformio run` command.
 
 After this command ``platformio`` will create:
 
 * ``.pioenvs`` - a temporary working directory.
-* ``libs`` - a directory for project specific libraries. Platformio will
+* ``lib`` - a directory for project specific libraries. Platformio will
   compile their to static libraries and link to executable file
 * ``src`` - a source directory. Put code here.
 * ``platformio.ini`` - a configuration file for project

examples/arduino-internal-library/README.rst

@@ -0,0 +1,20 @@
+Arduino Example: Build code with internal library
+=================================================
+
+1. Download ``platformio``
+   `sources <https://github.com/ivankravets/platformio/archive/develop.zip>`_
+2. Extract ZIP archive
+3. Then run these commands:
+
+.. code-block:: bash
+
+    # Change directory to example
+    $ cd platformio-develop/examples/arduino-internal-library/
+
+    # Install Atmel AVR development platform with Arduino Framework
+    $ platformio install atmelavr
+
+    # Process example project
+    $ platformio run
+
+.. image:: console-result.png

examples/arduino-internal-library/console-result.png

@@ -0,0 +1,7 @@
+# Copyright (C) Ivan Kravets <[email protected]>
+# See LICENSE for details.
+
+[env:arduino_pro5v]
+platform = atmelavr
+framework = arduino
+board = pro16MHzatmega168

examples/arduino-internal-library/platformio.ini

@@ -0,0 +1,51 @@
+/**
+ * Copyright (C) Ivan Kravets <[email protected]>
+ * See LICENSE for details.
+ */
+
+/*
+ * EEPROM Read
+ *
+ * Reads the value of each byte of the EEPROM and prints it
+ * to the computer.
+ * This example code is in the public domain.
+ *
+ * https://github.com/arduino/Arduino/blob/master/libraries/EEPROM/examples/eeprom_read/eeprom_read.ino
+ */
+
+#include <Arduino.h>
+#include <EEPROM.h>
+
+// start reading from the first byte (address 0) of the EEPROM
+int address = 0;
+byte value;
+
+void setup()
+{
+  // initialize serial and wait for port to open:
+  Serial.begin(9600);
+  while (!Serial) {
+    ; // wait for serial port to connect. Needed for Leonardo only
+  }
+}
+
+void loop()
+{
+  // read a byte from the current address of the EEPROM
+  value = EEPROM.read(address);
+
+  Serial.print(address);
+  Serial.print("\t");
+  Serial.print(value, DEC);
+  Serial.println();
+
+  // advance to the next address of the EEPROM
+  address = address + 1;
+
+  // there are only 512 bytes of EEPROM, from 0 to 511, so if we're
+  // on address 512, wrap around to address 0
+  if (address == 512)
+    address = 0;
+
+  delay(500);
+}

examples/arduino-internal-library/src/main.cpp

@@ -1,7 +1,7 @@
 # Copyright (C) Ivan Kravets <[email protected]>
 # See LICENSE for details.
 
-VERSION = (0, 1, 0)
+VERSION = (0, 2, 0)
 __version__ = ".".join([str(s) for s in VERSION])
 
 __title__ = "platformio"

platformio/__init__.py

@@ -41,7 +41,11 @@
     PLATFORMFW_DIR=join("$PLATFORM_DIR", "frameworks", "$FRAMEWORK"),
     PLATFORMTOOLS_DIR=join("$PLATFORM_DIR", "tools"),
 
-    BUILD_DIR=join("$PROJECT_DIR", ".pioenvs", "$PIOENV")
+    BUILD_DIR=join("$PROJECT_DIR", ".pioenvs", "$PIOENV"),
+    LIBSOURCE_DIRS=[
+        join("$PROJECT_DIR", "lib"),
+        join("$PLATFORMFW_DIR", "libraries"),
+    ]
 )
 
 env = DefaultEnvironment()

platformio/builder/main.py

@@ -23,6 +23,7 @@
     "-DARDUINO=%d" % ARDUINO_VERSION,
     "-DARDUINO_%s" % BOARD_OPTIONS['build.board']
 ]
+
 # usb flags
 if "build.usb_product" in BOARD_OPTIONS:
     ARDUINO_FLAGS += [
@@ -32,12 +33,18 @@
             '"', "")
     ]
 
+# include board variant
+env.VariantDir(
+    join("$BUILD_DIR", "variant"),
+    join("$PLATFORMFW_DIR", "variants", BOARD_OPTIONS['build.variant'])
+)
+
 env.Append(
     ASFLAGS=ARDUINO_FLAGS,
     CCFLAGS=ARDUINO_FLAGS,
     CPPPATH=[
         join("$BUILD_DIR", "core"),
-        join("$PLATFORMFW_DIR", "variants", BOARD_OPTIONS['build.variant'])
+        join("$BUILD_DIR", "variant")
     ]
 )
 

platformio/builder/scripts/frameworks/arduino.py

@@ -24,12 +24,18 @@
     "-DENERGIA=%d" % ENERGIA_VERSION
 ]
 
+# include board variant
+env.VariantDir(
+    join("$BUILD_DIR", "variant"),
+    join("$PLATFORMFW_DIR", "variants", BOARD_OPTIONS['build.variant'])
+)
+
 env.Append(
     ASFLAGS=ENERGIA_FLAGS,
     CCFLAGS=ENERGIA_FLAGS,
     CPPPATH=[
         join("$BUILD_DIR", "core"),
-        join("$PLATFORMFW_DIR", "variants", BOARD_OPTIONS['build.variant'])
+        join("$BUILD_DIR", "variant")
     ]
 )