You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mynewt.apache.org by ad...@apache.org on 2017/03/07 09:24:18 UTC

[1/5] incubator-mynewt-site git commit: Use virtualenv/pip for python setup

Repository: incubator-mynewt-site
Updated Branches:
  refs/heads/develop 8dcf97987 -> 47b782124


Use virtualenv/pip for python setup


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/d31f71cb
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/d31f71cb
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/d31f71cb

Branch: refs/heads/develop
Commit: d31f71cba64d8a373b8385a7eefe838b3bff28b3
Parents: 8dcf979
Author: Fabio Utzig <ut...@utzig.org>
Authored: Fri Mar 3 10:49:59 2017 -0300
Committer: Fabio Utzig <ut...@utzig.org>
Committed: Fri Mar 3 10:49:59 2017 -0300

----------------------------------------------------------------------
 .gitignore       |  1 +
 README.md        | 21 ++++++++++++++++-----
 requirements.txt |  4 ++++
 3 files changed, 21 insertions(+), 5 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/d31f71cb/.gitignore
----------------------------------------------------------------------
diff --git a/.gitignore b/.gitignore
index 68a916b..3422c7d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 site
 !.editorconfig
 .*
+venv/

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/d31f71cb/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 6351d8c..59f6906 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,20 @@
 The Apache MyNewt site is built using [MkDocs](http://www.mkdocs.org/).
 
 ## Setup
-### For all contributors:
-* Install [MkDocs](http://www.mkdocs.org/) on your system.
 
-### Additionally for committers:
-* `pip install GitPython`
-* `pip install sh`
+Clone the repo:
+
+    git clone https://github.com/apache/incubator-mynewt-site
+    cd incubator-mynewt-site
+
+Optional: it's a very good idea to use a `virtualenv`:
+
+    virtualenv venv
+    . venv/bin/activate
+
+Install the requirements:
+
+    pip install -r requirements.txt
 
 ## Submitting updates
 
@@ -21,6 +29,7 @@ The Apache MyNewt site is built using [MkDocs](http://www.mkdocs.org/).
 When a new release of MyNewt OS and its associated tools occurs, the documentation in the git `develop` branch of this repository should be in sync with the released version. The following steps will create a documentation branch for the release and make it available as the default documentation from the mynewt-site.
 
 ### Build
+
 1. Merge `develop` to `master`.
 1. Switch to the master branch.
     * `git checkout master`
@@ -32,10 +41,12 @@ When a new release of MyNewt OS and its associated tools occurs, the documentati
 1. Run: `./build.py`
 
 ### Test
+
 1. Run: `./serve.py`
 1. Visit [http://localhost:8000](http://localhost:8000)
 
 ### Deploy
+
 1. Run: `./deploy.sh`
 1. This will leave you on the `asf-site` branch.
 1. Commit & push the changes.

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/d31f71cb/requirements.txt
----------------------------------------------------------------------
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..d46f0b7
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,4 @@
+click
+GitPython
+mkdocs
+sh


[2/5] incubator-mynewt-site git commit: Updating filesystem and block driver docs

Posted by ad...@apache.org.
Updating filesystem and block driver docs

- Update FS documentation with multiple disk support
- Document the the FAT filesystem
- Document the MMC driver
- Document the AT45DB SPI flash driver


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/1cee1a2d
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/1cee1a2d
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/1cee1a2d

Branch: refs/heads/develop
Commit: 1cee1a2d53dff157ea1fdea4d039000fbf611d99
Parents: 8dcf979
Author: Fabio Utzig <ut...@utzig.org>
Authored: Wed Mar 1 16:33:14 2017 -0300
Committer: Fabio Utzig <ut...@utzig.org>
Committed: Mon Mar 6 11:19:17 2017 -0300

----------------------------------------------------------------------
 docs/os/modules/drivers/driver.md |  16 ++++-
 docs/os/modules/drivers/flash.md  | 121 +++++++++++++++++++++++++++++++++
 docs/os/modules/drivers/mmc.md    |  87 ++++++++++++++++++++++++
 docs/os/modules/fs/fatfs.md       |  44 ++++++++++++
 docs/os/modules/fs/fs/fs.md       |  46 ++++++++++++-
 mkdocs.yml                        |   9 +++
 6 files changed, 319 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/1cee1a2d/docs/os/modules/drivers/driver.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/drivers/driver.md b/docs/os/modules/drivers/driver.md
index 8c5b586..d090809 100644
--- a/docs/os/modules/drivers/driver.md
+++ b/docs/os/modules/drivers/driver.md
@@ -41,10 +41,22 @@ Device drivers in the Mynewt context includes libraries that interface with devi
 
 * Device drivers should be searchable. The plan is to have the newt tool offer a `newt pkg search` capability. This is work in progress. You are welcome to join the conversation on the dev@ mailing list!
 
-
-###Example
+### Example
 
 The Mynewt core repo includes an example of a driver using the HAL to provide extra functionality - the UART driver. It uses HAL GPIO and UART to provide multiple serial ports on the NRF52 (but allowed on other platforms too.)
 
 The gist of the driver design is that there is an API for the driver (for use by applications), and then sub-packages to that driver that implement that driver API using the HAL and BSP APIs.
 
+### Implemented drivers
+
+Drivers live under `hw/drivers`. The current list of supported drivers includes:
+
+| Driver | Description |
+|---------|-------------|
+| [adc](adc.md) | TODO: ADC driver. |
+| [flash](flash.md) | SPI/I2C flash drivers. |
+| [lwip](lwip.md) | TODO: LWIP. |
+| [mmc](mmc.md) | MMC/SD card driver. |
+| [nimble](/network/ble/ble_intro/) | NIMBLE. |
+| [sensors](sensors.md) | TODO: sensors. |
+| [uart](uart.md) | TODO: UART driver. |

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/1cee1a2d/docs/os/modules/drivers/flash.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/drivers/flash.md b/docs/os/modules/drivers/flash.md
new file mode 100644
index 0000000..fdd0e5d
--- /dev/null
+++ b/docs/os/modules/drivers/flash.md
@@ -0,0 +1,121 @@
+## <font color="#F2853F" style="font-size:24pt">flash</font>
+
+The flash driver subsystem is a work in progress which aims at supporting
+common external SPI/I2C flash/eeprom memory chips. This is equivalent
+to what Linux calls `MTD` for `Memory Technology Devices`.
+
+At the moment the only `flash` device that is already supported is the
+AT45DBxxx SPI flash family with the `at45db` driver.
+
+The flash driver aims for full compatibility with the `hal_flash` API,
+which means initialization and usage can be performed by any `fs` that
+supports the `hal_flash` interface.
+
+#### Initialization
+
+To be compatible with the standard `hal_flash` interface, the `at45db` driver
+embeds a `struct hal_flash` to its own `struct at45db_dev`. The whole `at45db_dev`
+struct is shown below.
+
+```c
+struct at45db_dev {
+    struct hal_flash hal;
+    struct hal_spi_settings *settings;
+    int spi_num;
+    void *spi_cfg;                  /** Low-level MCU SPI config */
+    int ss_pin;
+    uint32_t baudrate;
+    uint16_t page_size;             /** Page size to be used, valid: 512 and 528 */
+    uint8_t disable_auto_erase;     /** Reads and writes auto-erase by default */
+};
+```
+
+To ease with initialization a helper function `at45db_default_config` was added.
+It returns an already initialized `struct at45db_dev` leaving the user with just
+having to provide the SPI related config.
+
+To initialize the device, pass the `at45db_dev` struct to `at45db_init`.
+
+```c
+int at45db_init(const struct hal_flash *dev);
+```
+
+For low-level access to the device the following functions are provided:
+
+```c
+int at45db_read(const struct hal_flash *dev, uint32_t addr, void *buf,
+                uint32_t len);
+int at45db_write(const struct hal_flash *dev, uint32_t addr, const void *buf,
+                 uint32_t len);
+int at45db_erase_sector(const struct hal_flash *dev, uint32_t sector_address);
+int at45db_sector_info(const struct hal_flash *dev, int idx, uint32_t *address,
+                       uint32_t *sz);
+```
+
+Also, `nffs` is able to run on the device due to the fact that standard `hal_flash`
+interface compatibility is provided. Due to current limitations of `nffs`, it can
+only run on `at45db` if the internal flash of the MCU is not being used.
+
+#### Dependencies
+
+To include the `at45db` driver on a project, just include it as a dependency in your
+pkg.yml:
+
+```
+pkg.deps:
+    - hw/drivers/flash/at45db
+```
+
+#### Header file
+
+The `at45db` SPI flash follows the standard `hal_flash` interface but requires
+that a special struct 
+
+```c
+#include <at45db/at45db.h>
+```
+
+#### Example
+
+This following examples assume that the `at45db` is being used on a STM32F4 MCU.
+
+```c
+static const int SPI_SS_PIN   = MCU_GPIO_PORTA(4);
+static const int SPI_SCK_PIN  = MCU_GPIO_PORTA(5);
+static const int SPI_MISO_PIN = MCU_GPIO_PORTA(6);
+static const int SPI_MOSI_PIN = MCU_GPIO_PORTA(7);
+
+struct stm32f4_hal_spi_cfg spi_cfg = {
+    .ss_pin   = SPI_SS_PIN,
+    .sck_pin  = SPI_SCK_PIN,
+    .miso_pin = SPI_MISO_PIN,
+    .mosi_pin = SPI_MOSI_PIN,
+    .irq_prio = 2
+};
+
+struct at45db_dev *my_at45db_dev = NULL;
+
+my_at45db_dev = at45db_default_config();
+my_at45db_dev->spi_num = 0;
+my_at45db_dev->spi_cfg = &spi_cfg;
+my_at45db_dev->ss_pin = spi_cfg.ss_pin;
+
+rc = at45db_init((struct hal_flash *) my_at45db_dev);
+if (rc) {
+    /* XXX: error handling */
+}
+```
+
+The enable `nffs` to run on the `at45db`, the `flash_id` 0 needs to map to
+provide a mapping from 0 to this struct.
+
+```c
+const struct hal_flash *
+hal_bsp_flash_dev(uint8_t id)
+{
+    if (id != 0) {
+        return NULL;
+    }
+    return &my_at45db_dev;
+}
+```

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/1cee1a2d/docs/os/modules/drivers/mmc.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/drivers/mmc.md b/docs/os/modules/drivers/mmc.md
new file mode 100644
index 0000000..15c7c7f
--- /dev/null
+++ b/docs/os/modules/drivers/mmc.md
@@ -0,0 +1,87 @@
+## <font color="#F2853F" style="font-size:24pt">mmc</font>
+
+The MMC driver provides support for SPI based MMC/SDcard interfaces. It exports
+a `disk_ops` struct that can be used by any FS. Currently only `fatfs` can run
+over MMC.
+
+#### Initialization
+
+```c
+int mmc_init(int spi_num, void *spi_cfg, int ss_pin)
+```
+
+Initializes the mmc driver to be used by a FS.
+
+MMC uses the `hal_gpio` interface to access the SPI `ss_pin` and the `hal_spi`
+interface for the communication with the card. `spi_cfg` must be a hw dependent
+structure used by `hal_spi_init` to initialize the SPI subsystem.
+
+#### Dependencies
+
+To include the `mmc` driver on a project, just include it as a dependency in your
+pkg.yml:
+
+```
+pkg.deps:
+    - hw/drivers/mmc
+```
+
+#### Returned values
+
+MMC functions return one of the following status codes:
+
+| Return code          | Description                                           |
+|----------------------|-------------------------------------------------------|
+| MMC\_OK              | Success.                                              |
+| MMC\_CARD_ERROR      | General failure on the card.                          |
+| MMC\_READ_ERROR      | Error reading from the card.                          |
+| MMC\_WRITE_ERROR     | Error writing to the card.                            |
+| MMC\_TIMEOUT         | Timed out waiting for the execution of a command.     |
+| MMC\_PARAM_ERROR     | An invalid parameter was given to a function.         |
+| MMC\_CRC_ERROR       | CRC error reading card.                               |
+| MMC\_DEVICE_ERROR    | Tried to use an invalid device.                       |
+| MMC\_RESPONSE_ERROR  | A command received an invalid response.               |
+| MMC\_VOLTAGE_ERROR   | The interface doesn't support the requested voltage.  |
+| MMC\_INVALID_COMMAND | The interface haven't accepted some command.          |
+| MMC\_ERASE_ERROR     | Error erasing the current card.                       |
+| MMC\_ADDR_ERROR      | Tried to access an invalid address.                   |
+
+#### Header file
+
+```c
+#include "mmc/mmc.h"
+```
+
+#### <a name="Example"></a>Example
+
+This example runs on the STM32F4-Discovery and prints out a listing of
+the root directory on the currently installed card.
+
+```c
+// NOTE: error handling removed for clarity!
+
+struct stm32f4_hal_spi_cfg spi_cfg = {
+    .ss_pin   = SPI_SS_PIN,
+    .sck_pin  = SPI_SCK_PIN,
+    .miso_pin = SPI_MISO_PIN,
+    .mosi_pin = SPI_MOSI_PIN,
+    .irq_prio = 2
+};
+
+mmc_init(0, &spi_cfg, spi_cfg.ss_pin);
+disk_register("mmc0", "fatfs", &mmc_ops);
+
+fs_opendir("mmc0:/", &dir);
+
+while (1) {
+    rc = fs_readdir(dir, &dirent);
+    if (rc == FS_ENOENT) {
+        break;
+    }
+
+    fs_dirent_name(dirent, sizeof(out_name), out_name, &u8_len);
+    printf("%s\n", out_name);
+}
+
+fs_closedir(dir);
+```

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/1cee1a2d/docs/os/modules/fs/fatfs.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/fs/fatfs.md b/docs/os/modules/fs/fatfs.md
new file mode 100644
index 0000000..b409235
--- /dev/null
+++ b/docs/os/modules/fs/fatfs.md
@@ -0,0 +1,44 @@
+# The FAT File System
+
+Mynewt provides an implementation of the FAT filesystem which is currently
+supported on MMC/SD cards.
+
+### Description
+
+> File Allocation Table (FAT) is a computer file system architecture and a family
+> of industry-standard file systems utilizing it. The FAT file system is a legacy
+> file system which is simple and robust. It offers good performance even in
+> lightweight implementations, but cannot deliver the same performance, reliability
+> and scalability as some modern file systems.
+
+### Configuration
+
+`fatfs` configuration can be tweaked by editing `fs/fatfs/include/fatfs/ffconf.h`.
+The current configuraton was chosen to minimize memory use and some options address
+limitations existing in the OS:
+
+* Write support is enabled by default (can be disable to minimize memory use).
+* Long filename (up to 255) support is disabled.
+* When writing files, time/dates are not persisted due to current lack of a
+  standard `hal_rtc` interface.
+* No unicode support. Vanilla config uses standard US codepage 437.
+* Formatting of new volumes is disabled.
+* Default number of volumes is configured to 1.
+
+### API
+
+To include `fatfs` on a project just include is as a dependency in your
+project:
+
+```
+pkg.deps:
+    - fs/fatfs
+```
+
+It can now be used through the standard file system abstraction functions as
+described in [FS API](/os/modules/fs/fs/fs#API).
+
+#### Example
+
+An example of using `fatfs` on a MMC card is provided on the
+[MMC](/os/modules/drivers/mmc#Example) documentation.

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/1cee1a2d/docs/os/modules/fs/fs/fs.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/fs/fs/fs.md b/docs/os/modules/fs/fs/fs.md
index 188ad49..fc4b2de 100644
--- a/docs/os/modules/fs/fs/fs.md
+++ b/docs/os/modules/fs/fs/fs.md
@@ -47,10 +47,52 @@ pkg.deps:
 
 The `libs/imgmgr` package uses the `fs/fs` API for all file system operations.
 
+### Support for multiple filesystems
+
+When using a single filesystem/disk, it is valid to provide paths in the standard
+unix way, eg, `/<dir-name>/<file-name>`. When trying to run more than one filesystem
+or a single filesystem in multiple devices simultaneosly, an extra name has to be
+given to the disk that is being used. The abstraction for that was added as the
+`fs/disk` package which is a dependency of `fs/fs`. It adds the following extra
+user function:
+
+```c
+int disk_register(const char *disk_name, const char *fs_name, struct disk_ops *dops)
+```
+
+As an example os usage:
+
+```c
+disk_register("mmc0", "fatfs", &mmc_ops);
+disk_register("flash0", "nffs", NULL);
+```
+
+This registers the name `mmc0` to use `fatfs` as the filesystem and `mmc_ops` for
+the low-level disk driver and also registers `flash0` to use `nffs`. `nffs` is
+currently strongly bound to the `hal_flash` interface, ignoring any other possible
+`disk_ops` given.
+
+#### struct disk_ops
+
+To support a new low-level disk interface, the `struct disk_ops` interface must
+be implemented by the low-level driver. Currently only `read` and `write` are
+effectively used (by `fatfs`).
+
+```c
+struct disk_ops {
+    int (*read)(uint8_t, uint32_t, void *, uint32_t);
+    int (*write)(uint8_t, uint32_t, const void *, uint32_t);
+    int (*ioctl)(uint8_t, uint32_t, void *);
+    SLIST_ENTRY(disk_ops) sc_next;
+}
+```
+
 ###Thread Safety
+
 All `fs/fs` functions are thread safe.
 
-###Header Files 
+###Header Files
+
 All code which uses the `fs/fs` package needs to include the following header:
 
 ```c
@@ -66,7 +108,7 @@ struct fs_dir;
 struct fs_dirent;
 ```
 
-###API
+### <a name="API"></a>API
 
 Functions in `fs/fs` that indicate success or failure do so with the following set of return codes:
 

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/1cee1a2d/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index 87a7cfd..ea06968 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -275,6 +275,7 @@ pages:
                     - 'fs_write': 'os/modules/fs/fs/fs_write.md'
                     - 'fsutil_read_file': 'os/modules/fs/fs/fsutil_read_file.md'
                     - 'fsutil_write_file': 'os/modules/fs/fs/fsutil_write_file.md'
+            - 'FAT File System': 'os/modules/fs/fatfs.md'
             - 'Newtron Flash File System':
                 - toc:               'os/modules/fs/nffs/nffs.md'
                 - 'Data Structures':
@@ -306,6 +307,14 @@ pages:
             - 'Creating HAL': 'os/modules/hal/hal_creation.md'
         - Drivers:
             - toc: 'os/modules/drivers/driver.md'
+            - 'Supported Drivers':
+                  #- 'adc': 'os/modules/drivers/adc.md'
+                - 'flash': 'os/modules/drivers/flash.md'
+                  #  - 'lwip': 'os/modules/drivers/lwip.md'
+                - 'mmc': 'os/modules/drivers/mmc.md'
+                - 'nimble': 'network/ble/ble_intro.md'
+                  #- 'sensors': 'os/modules/drivers/sensors.md'
+                  #- 'uart': 'os/modules/drivers/uart.md'
         - Test Utilities:
             - toc: 'os/modules/testutil/testutil.md'
             - 'Functions/Macros':


[3/5] incubator-mynewt-site git commit: Corrected links and typos in various docs such as bootloader.md, hal_gpio.md, fatfs.md etc. This closes #160.

Posted by ad...@apache.org.
Corrected links and typos in various docs such as bootloader.md, hal_gpio.md, fatfs.md etc.
This closes #160.


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/0449fdad
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/0449fdad
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/0449fdad

Branch: refs/heads/develop
Commit: 0449fdad8195a9fed012733d600e7c572746262c
Parents: 1cee1a2
Author: aditihilbert <ad...@runtime.io>
Authored: Tue Mar 7 10:13:29 2017 +0100
Committer: aditihilbert <ad...@runtime.io>
Committed: Tue Mar 7 10:14:02 2017 +0100

----------------------------------------------------------------------
 docs/os/modules/bootloader/bootloader.md   |  8 --------
 docs/os/modules/fs/fatfs.md                |  4 ++--
 docs/os/modules/hal/hal_gpio/hal_gpio.md   |  2 +-
 docs/os/modules/shell/shell.md             | 20 ++++++++++----------
 docs/os/tutorials/project-target-slinky.md |  2 +-
 5 files changed, 14 insertions(+), 22 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0449fdad/docs/os/modules/bootloader/bootloader.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/bootloader/bootloader.md b/docs/os/modules/bootloader/bootloader.md
index 961b964..6c89ae6 100644
--- a/docs/os/modules/bootloader/bootloader.md
+++ b/docs/os/modules/bootloader/bootloader.md
@@ -54,14 +54,6 @@ struct image_header {
     uint8_t  ih_key_id;
     uint8_t  _pad1;
     uint16_t ih_hdr_s< bok@bok.net
-35d33
-< ericmanganaro@gmail.com
-42d39
-< tam@proxy.co
-55d51
-< nathan@natb1.com
-110d105
-< rvs@apache.orgize;
     uint16_t _pad2;
     uint32_t ih_img_size; /* Does not include header. */
     uint32_t ih_flags;

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0449fdad/docs/os/modules/fs/fatfs.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/fs/fatfs.md b/docs/os/modules/fs/fatfs.md
index b409235..4ec72ff 100644
--- a/docs/os/modules/fs/fatfs.md
+++ b/docs/os/modules/fs/fatfs.md
@@ -17,7 +17,7 @@ supported on MMC/SD cards.
 The current configuraton was chosen to minimize memory use and some options address
 limitations existing in the OS:
 
-* Write support is enabled by default (can be disable to minimize memory use).
+* Write support is enabled by default (can be disabled to minimize memory use).
 * Long filename (up to 255) support is disabled.
 * When writing files, time/dates are not persisted due to current lack of a
   standard `hal_rtc` interface.
@@ -27,7 +27,7 @@ limitations existing in the OS:
 
 ### API
 
-To include `fatfs` on a project just include is as a dependency in your
+To include `fatfs` on a project just include it as a dependency in your
 project:
 
 ```

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0449fdad/docs/os/modules/hal/hal_gpio/hal_gpio.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/hal/hal_gpio/hal_gpio.md b/docs/os/modules/hal/hal_gpio/hal_gpio.md
index 503f374..1191235 100644
--- a/docs/os/modules/hal/hal_gpio/hal_gpio.md
+++ b/docs/os/modules/hal/hal_gpio/hal_gpio.md
@@ -19,7 +19,7 @@ port pins) depends on the specific variant of the stm32F4xx.
 
 So if I want to turn on port B pin 3, that would be virtual pin  1*16 + 3 = 19.
 This translation is defined in the MCU implementation of
-[hal_gpio.c](https://github.com/apache/incubator-mynewt-larva/blob/master/hw/mcu/stm/stm32f4xx/src/hal_gpio.c)
+[hal_gpio.c](https://github.com/apache/incubator-mynewt-core/blob/master/hw/mcu/stm/stm32f4xx/src/hal_gpio.c)
 for the stmf32F4xx.  Each MCU will typically have a different translation method
 depending on its GPIO architecture.
 

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0449fdad/docs/os/modules/shell/shell.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/shell/shell.md b/docs/os/modules/shell/shell.md
index ff05c98..e302b7a 100644
--- a/docs/os/modules/shell/shell.md
+++ b/docs/os/modules/shell/shell.md
@@ -29,22 +29,22 @@ receives newtmgr request messages.
 Create a sim target to check out these commands available in shell.
 
 ```no-highlight
-user@~/dev/larva$ newt target create blinky_sim
+user@~/dev$ newt target create blinky_sim
 Creating target blinky_sim
 Target blinky_sim successfully created!
-user@~/dev/larva$ newt target set blinky_sim name=blinky_sim
+user@~/dev$ newt target set blinky_sim name=blinky_sim
 Target blinky_sim successfully set name to blinky_sim
-user@~/dev/larva$ newt target set blinky_sim arch=sim
+user@~/dev$ newt target set blinky_sim arch=sim
 Target blinky_sim successfully set arch to sim
-user@~/dev/larva$ newt target set blinky_sim project=blinky
+user@~/dev$ newt target set blinky_sim project=blinky
 Target blinky_sim successfully set project to blinky
-user@~/dev/larva$ newt target set blinky_sim bsp=hw/bsp/native
+user@~/dev$ newt target set blinky_sim bsp=hw/bsp/native
 Target blinky_sim successfully set bsp to hw/bsp/native
-user@~/dev/larva$ newt target set blinky_sim compiler_def=debug
+user@~/dev$ newt target set blinky_sim compiler_def=debug
 Target blinky_sim successfully set compiler_def to debug
-user@~/dev/larva$ newt target set blinky_sim compiler=sim
+user@~/dev$ newt target set blinky_sim compiler=sim
 Target blinky_sim successfully set compiler to sim
-user@~/dev/larva$ newt target show
+user@~/dev$ newt target show
 blinky_sim
 	arch: sim
 	bsp: hw/bsp/native
@@ -52,7 +52,7 @@ blinky_sim
 	compiler_def: debug
 	name: blinky_sim
 	project: blinky
-user@~/dev/larva$ newt target build blinky_sim
+user@~/dev$ newt target build blinky_sim
 Building target blinky_sim (project = blinky)
 Compiling case.c
 Compiling suite.c
@@ -63,7 +63,7 @@ Building project blinky
 Linking blinky.elf
 Successfully run!
 
-user@~/dev/larva$ ./project/blinky/bin/blinky_sim/blinky.elf
+user@~/dev$ ./project/blinky/bin/blinky_sim/blinky.elf
 uart0 at /dev/ttys005
 
 ```

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0449fdad/docs/os/tutorials/project-target-slinky.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/project-target-slinky.md b/docs/os/tutorials/project-target-slinky.md
index bea8049..fcdf759 100644
--- a/docs/os/tutorials/project-target-slinky.md
+++ b/docs/os/tutorials/project-target-slinky.md
@@ -155,7 +155,7 @@ You can now disconnect the debugging cable from the board. You should see the gr
 
 ```no-highlight
         $ pwd
-        /Users/<user>/dev/larva/project/slinky
+        /Users/<user>/dev/project/slinky
         $ newtmgr conn add olimex01 type=serial connstring=/dev/tty.usbserial-AJ03HAQQ
         Connection profile olimex01 successfully added
         $ newtmgr conn show


[5/5] incubator-mynewt-site git commit: minor change in link name in mkdocs.yml

Posted by ad...@apache.org.
minor change in link name in  mkdocs.yml


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/47b78212
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/47b78212
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/47b78212

Branch: refs/heads/develop
Commit: 47b78212459f795379c96d0bb5232595379d8e47
Parents: 441e6c8
Author: aditihilbert <ad...@runtime.io>
Authored: Tue Mar 7 10:24:01 2017 +0100
Committer: aditihilbert <ad...@runtime.io>
Committed: Tue Mar 7 10:24:01 2017 +0100

----------------------------------------------------------------------
 mkdocs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/47b78212/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index ea06968..670f07f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -312,7 +312,7 @@ pages:
                 - 'flash': 'os/modules/drivers/flash.md'
                   #  - 'lwip': 'os/modules/drivers/lwip.md'
                 - 'mmc': 'os/modules/drivers/mmc.md'
-                - 'nimble': 'network/ble/ble_intro.md'
+                - 'nimBLE': 'network/ble/ble_intro.md'
                   #- 'sensors': 'os/modules/drivers/sensors.md'
                   #- 'uart': 'os/modules/drivers/uart.md'
         - Test Utilities:


[4/5] incubator-mynewt-site git commit: Merge branch 'add-venv-config' of https://github.com/utzig/incubator-mynewt-site into develop This closes #161.

Posted by ad...@apache.org.
Merge branch 'add-venv-config' of https://github.com/utzig/incubator-mynewt-site into develop
This closes #161.


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/441e6c80
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/441e6c80
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/441e6c80

Branch: refs/heads/develop
Commit: 441e6c80a1aca86dd6a26241913c88f9fd618412
Parents: 0449fda d31f71c
Author: aditihilbert <ad...@runtime.io>
Authored: Tue Mar 7 10:14:45 2017 +0100
Committer: aditihilbert <ad...@runtime.io>
Committed: Tue Mar 7 10:14:45 2017 +0100

----------------------------------------------------------------------
 .gitignore       |  1 +
 README.md        | 21 ++++++++++++++++-----
 requirements.txt |  4 ++++
 3 files changed, 21 insertions(+), 5 deletions(-)
----------------------------------------------------------------------