From 3a3b759e4caedddea5c7cb837a4d7e1cd8c9f8f4 Mon Sep 17 00:00:00 2001 From: Irit Date: Tue, 2 Jun 2020 16:07:20 +0100 Subject: [PATCH 1/4] That images has been broken for ages --- docs/api/connectivity/types/6lowpan_nd_intro.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/api/connectivity/types/6lowpan_nd_intro.md b/docs/api/connectivity/types/6lowpan_nd_intro.md index 0337cbff7b..f3f07a467d 100644 --- a/docs/api/connectivity/types/6lowpan_nd_intro.md +++ b/docs/api/connectivity/types/6lowpan_nd_intro.md @@ -19,8 +19,6 @@ The Nanostack library, which provides a set of C API headers with more functiona Typically, the 6LoWPAN-ND network consists of one border router on multiple low-powered nodes. You can connect the nodes to a cloud service for feeding in the sensor or control data. -![Node connected to server](https://github.com/ARMmbed/mbed-os-5-docs/blob/development/docs/images/node_to_server_2.jpg?raw=true) - ### Different device types in a 6LoWPAN-ND network In a 6LoWPAN-ND network, devices can have different roles. The colors in the illustrations represent different device types and are used in the examples throughout this section. From 7a7fdc922d8bb3f46a7436ea4a86d4523cb772ba Mon Sep 17 00:00:00 2001 From: Irit Date: Wed, 3 Jun 2020 06:54:33 +0100 Subject: [PATCH 2/4] Adding AWS - but not to 6.0 yet because it 404s --- docs.json | 2 +- docs/introduction/tutorials_intro.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs.json b/docs.json index 81c2c1b269..0c4031c835 100644 --- a/docs.json +++ b/docs.json @@ -1175,7 +1175,7 @@ ] }, { - "title": "All tutorials", + "title": "Tutorials and examples", "description": "", "slug": "tutorials", "type": "markdown", diff --git a/docs/introduction/tutorials_intro.md b/docs/introduction/tutorials_intro.md index 590536a0c8..18fa6a9cd2 100644 --- a/docs/introduction/tutorials_intro.md +++ b/docs/introduction/tutorials_intro.md @@ -54,8 +54,8 @@ These tutorials show you how to install, export a project to and start a debuggi ## Connecting to the cloud -[Pelion Device Management](https://github.com/ARMmbed/mbed-os-example-pelion) - +- [Pelion Device Management](https://github.com/ARMmbed/mbed-os-example-pelion) +- [AWS](https://github.com/ARMmbed/mbed-os-example-aws) ## Migrating From babe2828e2d6358685cf8d207546c476391437bf Mon Sep 17 00:00:00 2001 From: Lingkai Dong Date: Wed, 3 Jun 2020 06:58:21 +0100 Subject: [PATCH 3/4] A serial driver should be installed on Windows 7 only (#1334) * A serial driver should be installed on Windows 7 only * Remove links to serial driver from feature-related pages * Apply suggestions from code review Co-authored-by: Irit Arkin Co-authored-by: Irit Arkin --- docs/api/connectivity/tutorials/intro-to-lora.md | 2 +- docs/api/drivers/uart/BufferedSerial.md | 2 -- docs/api/drivers/uart/UnbufferedSerial.md | 2 -- docs/debugging-testing/debug/DAP.md | 2 -- docs/introduction/tutorials_intro.md | 2 +- docs/program-setup/serial/serial_communication.md | 2 +- docs/program-setup/serial/serial_driver.md | 4 +++- 7 files changed, 6 insertions(+), 10 deletions(-) diff --git a/docs/api/connectivity/tutorials/intro-to-lora.md b/docs/api/connectivity/tutorials/intro-to-lora.md index 0e8528955a..f2f2a81457 100644 --- a/docs/api/connectivity/tutorials/intro-to-lora.md +++ b/docs/api/connectivity/tutorials/intro-to-lora.md @@ -304,7 +304,7 @@ Now you can verify whether the setup works by flashing this application to your ![](../../../images/lora10.png)Compile button 1. When compilation succeeds, the compiler sends a file to your computer. -1. Plug your development board into the computer (over micro-USB) to mount it as a USB mass storage device. In most cases, you do not need a driver, but you can find drivers [here](../program-setup/windows-serial-driver.html). +1. Plug your development board into the computer (over micro-USB) to mount it as a USB mass storage device. 1. Once the device mounts, drag the compiled file onto the board. This causes the device to boot. You can then see the device joining and then sending messages in the The Things Network console, under the **Data** tab: ![](../../../images/ttn19.png)We've got data! diff --git a/docs/api/drivers/uart/BufferedSerial.md b/docs/api/drivers/uart/BufferedSerial.md index de51f150c5..d8f99b52b7 100644 --- a/docs/api/drivers/uart/BufferedSerial.md +++ b/docs/api/drivers/uart/BufferedSerial.md @@ -52,8 +52,6 @@ You can view more information about the configurable settings and functions in t [![View code](https://www.mbed.com/embed/?type=library)](https://os.mbed.com/docs/mbed-os/development/mbed-os-api-doxy/classmbed_1_1_buffered_serial.html) -**Note**: On a Windows machine, you need to install a USB serial driver. Please see the [Windows serial configuration](../program-setup/serial-communication.html#windows-serial-driver) document for more information. - ## BufferedSerial examples This example toggles an LED and echoes input to a terminal: diff --git a/docs/api/drivers/uart/UnbufferedSerial.md b/docs/api/drivers/uart/UnbufferedSerial.md index 5074f416e1..e50f7d1651 100644 --- a/docs/api/drivers/uart/UnbufferedSerial.md +++ b/docs/api/drivers/uart/UnbufferedSerial.md @@ -14,8 +14,6 @@ You can view more information about the configurable settings and functions in t [![View code](https://www.mbed.com/embed/?type=library)](https://os.mbed.com/docs/mbed-os/development/mbed-os-api-doxy/classmbed_1_1_unbuffered_serial.html) -**Note**: On a Windows machine, you need to install a USB serial driver. See [Windows serial configuration](../program-setup/serial-communication.html#windows-serial-driver). - ## UnbufferedSerial Example [![View code](https://www.mbed.com/embed/?url=https://github.com/ARMmbed/mbed-os-snippet-UnbufferedSerial/tree/v6.0)](https://github.com/ARMmbed/mbed-os-snippet-UnbufferedSerial/blob/v6.0/main.cpp) diff --git a/docs/debugging-testing/debug/DAP.md b/docs/debugging-testing/debug/DAP.md index 1fbf7bdbd0..d91773940d 100644 --- a/docs/debugging-testing/debug/DAP.md +++ b/docs/debugging-testing/debug/DAP.md @@ -28,8 +28,6 @@ DAPLink debug probes appear on the host computer as a USB disk. Program files in The DAPLink debug probe also provides a USB serial port, which can be bridged through to a TTL UART on the target system. The USB serial port will appear on a Windows machine as a COM port, or on a Linux machine as a /dev/tty interface. -For more information on configuring your host computer to use this feature, please the [Windows serial driver information](../program-setup/windows-serial-driver.html). - ## Further reading - [DAPLink firmware updates and FAQ page](https://armmbed.github.io/DAPLink/). diff --git a/docs/introduction/tutorials_intro.md b/docs/introduction/tutorials_intro.md index 18fa6a9cd2..9c94837d0e 100644 --- a/docs/introduction/tutorials_intro.md +++ b/docs/introduction/tutorials_intro.md @@ -22,7 +22,7 @@ This page is an index of all tutorials and official examples. These tutorials teach you to communicate with your development board, an essential part of programming and debugging: -- [Windows serial driver tutorial](../program-setup/windows-serial-driver.html) +- [Windows serial driver tutorial](../program-setup/windows-serial-driver.html) (Windows 7 only) - [Board to PC communication over USB tutorial](../program-setup/serial-communication.html) ## Debugging diff --git a/docs/program-setup/serial/serial_communication.md b/docs/program-setup/serial/serial_communication.md index 357a284cfe..f15df03af8 100644 --- a/docs/program-setup/serial/serial_communication.md +++ b/docs/program-setup/serial/serial_communication.md @@ -2,7 +2,7 @@ The Arm Mbed microcontroller on your board can communicate with a host PC over the same USB cable that you use for programming. -If you're working on Windows earlier than Windows 10, you might need to [install a serial driver](../program-setup/windows-serial-driver.html). +If you're working on Windows 7, you might need to [install a serial driver](../program-setup/windows-serial-driver.html). This allows you to: diff --git a/docs/program-setup/serial/serial_driver.md b/docs/program-setup/serial/serial_driver.md index 3c5fd39b27..2b157a0231 100644 --- a/docs/program-setup/serial/serial_driver.md +++ b/docs/program-setup/serial/serial_driver.md @@ -1,8 +1,10 @@ # Windows serial driver +**Warning**: This page is for **Windows 7 only**. Do not install the serial driver on Windows 8 or newer; serial ports work out of the box with these versions. + You can connect your board to your computer over USB. This works out of the box on Linux and macOS. If you are using Windows, you may need to install a serial port driver: -1. Download the [Arm Mbed Windows serial port driver](http://os.mbed.com/media/downloads/drivers/mbedWinSerial_16466.exe). +1. Download the [Arm Mbed Windows serial port driver](http://os.mbed.com/media/downloads/drivers/mbedWinSerial_16466.exe) (**Windows 7 only**). 1. Plug in your Arm Mbed device over USB. It mounts as an Mbed drive. 1. Close all Explorer windows showing the Mbed drive. 1. Run the installer. This may take some time or display a few "unsigned driver" warnings. From 60406542454009f3c27a13095ee04005180ddd8e Mon Sep 17 00:00:00 2001 From: Irit Arkin Date: Wed, 3 Jun 2020 07:00:40 +0100 Subject: [PATCH 4/4] That doesn't work yet --- docs/introduction/tutorials_intro.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/introduction/tutorials_intro.md b/docs/introduction/tutorials_intro.md index 9c94837d0e..1dc33201db 100644 --- a/docs/introduction/tutorials_intro.md +++ b/docs/introduction/tutorials_intro.md @@ -55,7 +55,6 @@ These tutorials show you how to install, export a project to and start a debuggi ## Connecting to the cloud - [Pelion Device Management](https://github.com/ARMmbed/mbed-os-example-pelion) -- [AWS](https://github.com/ARMmbed/mbed-os-example-aws) ## Migrating