From 65a4f591e96ad7ebd8df96f6b2db86d0e941e5e5 Mon Sep 17 00:00:00 2001 From: Lateefah Bello <2019cinnamon@gmail.com> Date: Sat, 19 Jun 2021 17:27:55 +0100 Subject: [PATCH] chapter 3(lesson 1) (#102) * Chapter two(lesson one) commit * Update README.md * Update pi-temp.md * Update virtual-device-temp.md * fixes * fixes * Update README.md * chapter two(lesson 2) * Update README.md * Chapter two (lesson three) * changed images * chapter two (lesson 4) * Update README.md * Update wio-terminal-connect-hub.md * Update wio-terminal-connect-hub.md * Update wio-terminal-connect-hub.md * Update wio-terminal-connect-hub.md * chapter 5 and 6 * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * fixed typos * chapter 3(lesson 1) * Revert "Merge branch 'main' of https://github.com/microsoft/IoT-For-Beginners into main" This reverts commit b2403c2cd8bd098a98fce8e9c3af0e21d532e78c, reversing changes made to 7afed015f4c56bc261d074bebd81f104b9e61bfd. * Revert "Revert "Merge branch 'main' of https://github.com/microsoft/IoT-For-Beginners into main"" This reverts commit b3eaedb38276986565fbac0808cd9e9c7f3bc464. * Update README.md * Update README.md * Update wio-terminal-gps-sensor.md * Update pi-gps-sensor.md * Update wio-terminal-gps-sensor.md * Update pi-gps-sensor.md * Update wio-terminal-gps-sensor.md Co-authored-by: Jim Bennett --- 3-transport/README.md | 8 ++++---- 3-transport/lessons/1-location-tracking/README.md | 10 +++++----- 3-transport/lessons/1-location-tracking/assignment.md | 2 +- .../lessons/1-location-tracking/pi-gps-sensor.md | 4 ++-- .../1-location-tracking/virtual-device-gps-sensor.md | 2 +- .../1-location-tracking/wio-terminal-gps-decode.md | 2 +- .../1-location-tracking/wio-terminal-gps-sensor.md | 6 +++--- 7 files changed, 17 insertions(+), 17 deletions(-) diff --git a/3-transport/README.md b/3-transport/README.md index 061f44d..f7058a2 100644 --- a/3-transport/README.md +++ b/3-transport/README.md @@ -1,10 +1,10 @@ # Transport from farm to factory - using IoT to track food deliveries -Many farmers grow food to sell - either they are commercial growers who sell everything they grow, or they are subsistence farmers who sell their excess produce to buy necessities. Somehow the food has to get from the farm to the consumer, and this usually relies on bulk transport from farms, to hubs or processing plants, then on to stores. For example, a tomato farmer will harvest tomatoes, pack them into boxes, load the boxes into a truck then deliver to a processing plant. The tomatoes will then be sorted, and from there delivered to the consumers in the form of retail, food processing, or restaurants. +Many farmers grow food to sell - either they are commercial farmers who sell everything they grow, or they are subsistence farmers who sell their excess produce to buy necessities. Somehow the food has to get from the farm to the consumer, and this usually relies on bulk transport from farms, to hubs or processing plants, then to stores. For example, a tomato farmer will harvest tomatoes, pack them into boxes, load the boxes into a truck then deliver to a processing plant. The tomatoes will then be sorted, and from there delivered to the consumers in the form of processed food, retail sales, or consumed at restaurants. -IoT can help with this supply chain by tracking the food in transit - ensuring drivers are going where they should, monitoring vehicle locations, and getting alerts when vehicles arrive so that food can be unloaded, ready for processing as soon as possible. +IoT can help with this supply chain by tracking the food in transit - ensuring drivers are going where they should, monitoring vehicle locations, and getting alerts when vehicles arrive so that food can be unloaded, and be ready for processing as soon as possible. -> 🎓 A *supply chain* is the sequence of activities to make and deliver something. For example, in tomato farming it covers seed, soil, fertilizer and water supply, growing tomatoes, delivering tomatoes to a central hub, transporting them to a supermarkets local hub, transporting to the individual supermarket, being put out on display, then sold to a consumer and taken home to eat. Each step is like the links in a chain. +> 🎓 A *supply chain* is the sequence of activities to make and deliver something. For example, in tomato farming it covers seed, soil, fertilizer and water supply, growing tomatoes, delivering tomatoes to a central hub, transporting them to a supermarket's local hub, transporting to the individual supermarket, being put out on display, then sold to a consumer and taken home to eat. Each step is like the links in a chain. > 🎓 The transportation part of the supply chain is know as *logistics*. @@ -15,7 +15,7 @@ In these 4 lessons, you'll learn how to apply the Internet of Things to improve ## Topics 1. [Location tracking](lessons/1-location-tracking/README.md) -1. [Store location data](./3-transport/lessons/2-store-location-data/README.md) +1. [Store location data](lessons/2-store-location-data/README.md) 1. [Visualize location data](lessons/3-visualize-location-data/README.md) 1. [Geofences](lessons/4-geofences/README.md) diff --git a/3-transport/lessons/1-location-tracking/README.md b/3-transport/lessons/1-location-tracking/README.md index 2bb82fb..9d35dfe 100644 --- a/3-transport/lessons/1-location-tracking/README.md +++ b/3-transport/lessons/1-location-tracking/README.md @@ -10,13 +10,13 @@ Add a sketchnote if possible/appropriate ## Introduction -The main process for getting food from a farmer to a consumer involves loading boxes of produce on to trucks, ships, airplanes, or other commercial transport vehicles, and delivering the food somewhere - either direct to a customer, or to a central hub or warehouse for processing. The whole end-to-end process from farm to consumer is part of a process called the *supply chain*. The video below from Arizona State University's W. P. Carey School of Business talks about the idea of the supply chain and how it is managed in more detail. +The main process for getting food from a farmer to a consumer involves loading boxes of produce on to trucks, ships, airplanes, or other commercial transport vehicles, and delivering the food somewhere - either directly to a customer, or to a central hub or warehouse for processing. The whole end-to-end process from farm to consumer is part of a process called the *supply chain*. The video below from Arizona State University's W. P. Carey School of Business talks about the idea of the supply chain and how it is managed in more detail. [![What is Supply Chain Management? A video from Arizona State University's W. P. Carey School of Business](https://img.youtube.com/vi/Mi1QBxVjZAw/0.jpg)](https://www.youtube.com/watch?v=Mi1QBxVjZAw) Adding IoT devices can drastically improve your supply chain, allowing you to manage where items are, plan transport and goods handling better, and respond quicker to problems. -When managing a fleet of vehicles such as trucks, it is helpful to know where each vehicle is at a given time. Vehicles can be fitted with GPS sensors that send their location to IoT systems, allowing the owners to pinpoint their location, see the route they have taken, and know when they will arrive at their destination. Most vehicles operate outside of WiFi coverage, so they use cellular networks to send this kind of data. Sometimes the GPS sensor is built into more complex IoT devices such as electronic log books. These devices track how long a truck has been driven for to ensure drivers are in compliance with local laws on working hours. +When managing a fleet of vehicles such as trucks, it is helpful to know where each vehicle is at a given time. Vehicles can be fitted with GPS sensors that send their location to IoT systems, allowing the owners to pinpoint their location, see the route they have taken, and know when they will arrive at their destination. Most vehicles operate outside of WiFi coverage, so they use cellular networks to send this kind of data. Sometimes the GPS sensor is built into more complex IoT devices such as electronic log books. These devices track how long a truck has been in transit to ensure drivers are in compliance with local laws on working hours. In this lesson you will learn how to track a vehicles location using a Global Positioning System (GPS) sensor. @@ -53,11 +53,11 @@ The core component of vehicle tracking is GPS - sensors that can pinpoint their ## Geospatial coordinates -Geospatial coordinates are used to define points on the Earth's surface, similar to how coordinates can be used to draw to a pixel on a computer screen or position stitches in cross stitch. For a single point, you have a pair of coordinates. For example, the Microsoft Campus in Redmond, Washington, USA is located at 47.6423109,-122.1390293. +Geospatial coordinates are used to define points on the Earth's surface, similar to how coordinates can be used to draw to a pixel on a computer screen or position stitches in cross stitch. For a single point, you have a pair of coordinates. For example, the Microsoft Campus in Redmond, Washington, USA is located at 47.6423109, -122.1390293. ### Latitude and longitude -The Earth is a sphere - a three-dimensional circle. Because of this, points are defined is by dividing it into 360 degrees, the same as the geometry of circles. Latitude measures the number of degrees north to south, longitude measures the number of degrees east to west. +The Earth is a sphere - a three-dimensional circle. Because of this, points are defined by dividing it into 360 degrees, the same as the geometry of circles. Latitude measures the number of degrees north to south, longitude measures the number of degrees east to west. > 💁 No-one really knows the original reason why circles are divided into 360 degrees. The [degree (angle) page on Wikipedia](https://wikipedia.org/wiki/Degree_(angle)) covers some of the possible reasons. @@ -178,7 +178,7 @@ Rather than use the raw NMEA data, it is better to decode it into a more useful ### Task - decode GPS sensor data -Work through the relevant guide to measure soil moisture using your IoT device: +Work through the relevant guide to decode GPS sensor data using your IoT device: * [Arduino - Wio Terminal](wio-terminal-gps-decode.md) * [Single-board computer - Raspberry Pi/Virtual IoT device](single-board-computer-gps-decode.md) diff --git a/3-transport/lessons/1-location-tracking/assignment.md b/3-transport/lessons/1-location-tracking/assignment.md index e524e32..76d106e 100644 --- a/3-transport/lessons/1-location-tracking/assignment.md +++ b/3-transport/lessons/1-location-tracking/assignment.md @@ -6,7 +6,7 @@ The NMEA sentences that come from your GPS sensor have other data in addition to For example - can you get the current date and time? If you are using a microcontroller, can you set the clock using GPS data in the same way you set is using NTP signals in the previous project? Can you get elevation (your height above sea level), or your current speed? -If you are using a virtual IoT device, then you can get some of this data by sending MENA sentences generated using tools [nmeagen.org](https://www.nmeagen.org). +If you are using a virtual IoT device, then you can get some of this data by sending NMEA sentences generated using tools [nmeagen.org](https://www.nmeagen.org). ## Rubric diff --git a/3-transport/lessons/1-location-tracking/pi-gps-sensor.md b/3-transport/lessons/1-location-tracking/pi-gps-sensor.md index 63d8793..8cf3073 100644 --- a/3-transport/lessons/1-location-tracking/pi-gps-sensor.md +++ b/3-transport/lessons/1-location-tracking/pi-gps-sensor.md @@ -24,7 +24,7 @@ Connect the GPS sensor. 1. With the Raspberry Pi powered off, connect the other end of the Grove cable to the UART socket marked **UART** on the Grove Base hat attached to the Pi. This socket is on the middle row, on the side nearest the SD Card slot, the other end from the USB ports and ethernet socket. -![The grove GPS sensor connected to the UART socket](../../../images/pi-gps-sensor.png) + ![The grove GPS sensor connected to the UART socket](../../../images/pi-gps-sensor.png) 1. Position the GPS sensor so that the attached antenna has visibility to the sky - ideally next to an open window or outside. It's easier to get a clearer signal with nothing in the way of the antenna. @@ -42,7 +42,7 @@ Program the device. 1. Launch VS Code, either directly on the Pi, or connect via the Remote SSH extension. - > ⚠️ You can refer to [the instructions for setting up and launch VS Code in lesson 1 if needed](../../../1-getting-started/lessons/1-introduction-to-iot/pi.md). + > ⚠️ You can refer to [the instructions for setting up and launching VS Code in lesson 1 if needed](../../../1-getting-started/lessons/1-introduction-to-iot/pi.md). 1. With newer versions of the Raspberry Pi that support Bluetooth, there is a conflict between the serial port used for Bluetooth, and the one used by the Grove UART port. To fix this, do the following: diff --git a/3-transport/lessons/1-location-tracking/virtual-device-gps-sensor.md b/3-transport/lessons/1-location-tracking/virtual-device-gps-sensor.md index d6c5803..e47a455 100644 --- a/3-transport/lessons/1-location-tracking/virtual-device-gps-sensor.md +++ b/3-transport/lessons/1-location-tracking/virtual-device-gps-sensor.md @@ -98,7 +98,7 @@ Program the GPS sensor app. 1. Run this code, ensuring you are using a different terminal to the one that the CounterFit app is running it, so that the CounterFit app remains running. -1. From the CounterFit app, change the value of the gps sensor. You can do this in one of thess ways: +1. From the CounterFit app, change the value of the gps sensor. You can do this in one of these ways: * Set the **Source** to `Lat/Lon`, and set an explicit latitude, longitude and number of satellites used to get the GPS fix. This value will be sent only once, so check the **Repeat** box to have the data repeat every second. diff --git a/3-transport/lessons/1-location-tracking/wio-terminal-gps-decode.md b/3-transport/lessons/1-location-tracking/wio-terminal-gps-decode.md index 8eb9622..b266236 100644 --- a/3-transport/lessons/1-location-tracking/wio-terminal-gps-decode.md +++ b/3-transport/lessons/1-location-tracking/wio-terminal-gps-decode.md @@ -31,7 +31,7 @@ Program the device to decode the GPS data. TinyGPSPlus gps; ``` -1. Change the contents of the `printGPSData` function to be the following: +1. Change the contents of the `printGPSData` function to the following: ```cpp if (gps.encode(Serial3.read())) diff --git a/3-transport/lessons/1-location-tracking/wio-terminal-gps-sensor.md b/3-transport/lessons/1-location-tracking/wio-terminal-gps-sensor.md index ea65a73..3a48b86 100644 --- a/3-transport/lessons/1-location-tracking/wio-terminal-gps-sensor.md +++ b/3-transport/lessons/1-location-tracking/wio-terminal-gps-sensor.md @@ -22,15 +22,15 @@ Connect the GPS sensor. 1. Insert one end of a Grove cable into the socket on the GPS sensor. It will only go in one way round. -1. With the Wio Terminal disconnected from your computer or other power supply, connect the other end of the Grove cable to the left-hand side Grove socket on the Wio Terminal as you look at the screen. This is the socket closest to from the power button. +1. With the Wio Terminal disconnected from your computer or other power supply, connect the other end of the Grove cable to the left-hand side Grove socket on the Wio Terminal as you look at the screen. This is the socket closest to the power button. -![The grove GPS sensor connected to the left hand socket](../../../images/wio-gps-sensor.png) + ![The grove GPS sensor connected to the left hand socket](../../../images/wio-gps-sensor.png) 1. Position the GPS sensor so that the attached antenna has visibility to the sky - ideally next to an open window or outside. It's easier to get a clearer signal with nothing in the way of the antenna. 1. You can now connect the Wio Terminal to your computer. -1. The GPS sensor has 2 LEDs - a blue LED that flashes when data is transmitted, and a green LED that flashes every second when receiving data from satellites. Ensure the blue LED is flashing when you power up the Pi. After a few minutes the green LED will flash - if not, you may need to reposition the antenna. +1. The GPS sensor has 2 LEDs - a blue LED that flashes when data is transmitted, and a green LED that flashes every second when receiving data from satellites. Ensure the blue LED is flashing when you power up the Wio Terminal. After a few minutes the green LED will flash - if not, you may need to reposition the antenna. ## Program the GPS sensor