From 126750a3449fa55825bd8dabfa0343ab38734a39 Mon Sep 17 00:00:00 2001 From: knmcguire Date: Tue, 10 Aug 2021 14:10:05 +0200 Subject: [PATCH] (#92) add z-ranger poplink --- src/_data/poplink.yml | 5 +++++ src/_poplink/z-ranger-deck.md | 8 ++++++++ src/buy/buyers-guide.md | 6 +++--- .../system/platform/cf2-expansiondecks.md | 10 +++++----- .../tutorials/getting-started-with-z-ranger-deck.md | 4 ++-- src/products/z-ranger-deck-v2.md | 4 ++-- 6 files changed, 25 insertions(+), 12 deletions(-) create mode 100644 src/_poplink/z-ranger-deck.md diff --git a/src/_data/poplink.yml b/src/_data/poplink.yml index c750c261..cb1606f6 100644 --- a/src/_data/poplink.yml +++ b/src/_data/poplink.yml @@ -20,3 +20,8 @@ poplinks: title: Multi-ranger deck default-link: /products/multi-ranger-deck/ content: multi-ranger-deck.md + z-ranger-deck: + title: Z-ranger deck V2 + default-link: /products/z-ranger-deck-v2/ + content: z-ranger-deck.md + diff --git a/src/_poplink/z-ranger-deck.md b/src/_poplink/z-ranger-deck.md new file mode 100644 index 00000000..57de4dbf --- /dev/null +++ b/src/_poplink/z-ranger-deck.md @@ -0,0 +1,8 @@ + +[Buy in store](https://store.bitcraze.io/products/z-ranger-deck-v2) + +[Product Page](/products/z-ranger-deck-v2/) + +[Other deck compatibility](/documentation/system/platform/cf2-expansiondecks/#deck---deck) + +[Tutorial](/documentation/tutorials/getting-started-with-z-ranger-deck/) \ No newline at end of file diff --git a/src/buy/buyers-guide.md b/src/buy/buyers-guide.md index 8448f116..505f5a63 100644 --- a/src/buy/buyers-guide.md +++ b/src/buy/buyers-guide.md @@ -202,10 +202,10 @@ Note: SD card is not included {% row_image_text_links I want assistance when flying the Crazyflie %} {% row_text %} Flying a quadcopter like the Crazyflie manually requires some skill and -practising. By adding the Z-ranger deck or {% poplink flow-deck %} the Crazyflie gets more +practising. By adding the {% poplink z-ranger-deck %} or {% poplink flow-deck %} the Crazyflie gets more information about its motion and can assist the pilot. -The Z-ranger deck measures the distance to the ground and can be used +The {% poplink z-ranger-deck %} measures the distance to the ground and can be used to automatically stay at a constant height, while the pilot can focus on the position. @@ -221,7 +221,7 @@ gamepad, not with a mobile device. **What to buy:** * [Getting started bundle](https://store.bitcraze.io/products/getting-started-bundle) -* [Z-ranger deck](https://store.bitcraze.io/products/z-ranger-deck) +* [Z-ranger deck](https://store.bitcraze.io/products/z-ranger-deck-v2) --- diff --git a/src/documentation/system/platform/cf2-expansiondecks.md b/src/documentation/system/platform/cf2-expansiondecks.md index fe055186..d7289f9b 100644 --- a/src/documentation/system/platform/cf2-expansiondecks.md +++ b/src/documentation/system/platform/cf2-expansiondecks.md @@ -18,7 +18,7 @@ Here is a list of expansion decks that are available for the Crazyflie 2.X: | {% id_link product-breakout-deck%}|The breakout expansion deck|[datasheet](/documentation/hardware/breakout_deck/breakout_deck-datasheet.pdf), [schematics](/documentation/hardware/breakout_deck/breakout-revc.pdf) | | | {% id_link product-bigquad-deck%}|EARLY ACCESS Expansion deck to build a bigger quad| [datasheet](/documentation/hardware/big_quad_deck/big_quad_deck-datasheet.pdf), [schematics](/documentation/hardware/big_quad_deck/bigquad-rev-c.pdf) | {% id_link bq-deck-build %}| | {% id_link product-sd-card-deck%}|Expansion deck to read, write files to SD-card| [datasheet](/documentation/hardware/sd_card_deck/sd_card_deck-datasheet.pdf), [schematics](/documentation/hardware/sd_card_deck/sdcard_revb.pdf) | [Data Logging](/documentation/repository/crazyflie-firmware/master/userguides/decks/micro-sd-card-deck/) | -| {% id_link product-z-ranger-deck-v2 %}|Expansion deck for precise height control.| [datasheet](/documentation/hardware/z_ranger_deck_2/z_ranger_deck_2-datasheet.pdf), [schematics](/documentation/hardware/z_ranger_deck_2/z-ranger_v2_reva.pdf) | | +| {% poplink z-ranger-deck %}|Expansion deck for precise height control.| [datasheet](/documentation/hardware/z_ranger_deck_2/z_ranger_deck_2-datasheet.pdf), [schematics](/documentation/hardware/z_ranger_deck_2/z-ranger_v2_reva.pdf) | | | {% id_link product-lighthouse-deck %}|Expansion deck that supports the SteamVR Lighthouse positioning| [datasheet](/documentation/hardware/lighthouse_deck/lighthouse_deck-datasheet.pdf), [schematics](/documentation/hardware/lighthouse_deck/lighthouse_deck-datasheet.pdf) | {% id_link lh-deck-other-hardware %} | | {% id_link product-motion-capture-marker-deck %}|Expansion deck where motion capture markers can easily be mounted|[datasheet](/documentation/hardware/passive_marker_deck/passive_marker_deck-datasheet.pdf), [schematics](/documentation/hardware/passive_marker_deck/passive-marker-deck-revc.pdf) | | | {% id_link product-active-marker-deck %}|Expansion deck with active IR LED for motion capture markers | [datasheet](/documentation/hardware/active_marker_deck/active_marker_deck-datasheet.pdf), [schematics](/documentation/hardware/active_marker_deck/active-marker-deck_revd.pdf)| | @@ -110,7 +110,7 @@ Deck info | 0xBC | 0x0B | bcOA | Obstacle Avoidance | N/A | ~0.3mA | Above | N/A | | 0xBC | 0x0C | bcMultiranger | {% poplink multi-ranger-deck%} | 2.3g | ~90mA (depending on mode) | Above | [link](https://store.bitcraze.io/products/multi-ranger-deck) | | 0xBC | 0x0D | bcMocap | Mocap marker deck | 1.6g | 0mA | Above | [link](https://store.bitcraze.io/products/motion-capture-marker-deck) | -| 0xBC | 0x0E | bcZRanger2 | Z-Ranger v2 | 1.3g | ~15mA | Under | [link](https://store.bitcraze.io/products/z-ranger-deck-v2) | +| 0xBC | 0x0E | bcZRanger2 | {% poplink z-ranger-deck %} | 1.3g | ~15mA | Under | [link](https://store.bitcraze.io/products/z-ranger-deck-v2) | | 0xBC | 0x0F | bcFlow2 | {% poplink flow-deck %} | 1.6g | ~40mA | Under | [link](https://store.bitcraze.io/products/flow-deck-v2) | | 0xBC | 0x10 | bcLighthouse4 | Lighthouse-4 | 2.7g | ~40mA | Above | [link](https://store.bitcraze.io/products/lighthouse-positioning-deck) | | 0xBC | 0x11 | bcActiveM | Active marker deck | 3.3g | ~40mA | Above | [link](https://store.bitcraze.io/products/active-marker-deck) | @@ -140,7 +140,7 @@ two decks where the connections collide. | **bcBigQuad** | *(X)* | *(X)* | *(X)* | *(X)* | | **X** | **X** | *(X)* | **X** | **X** | *(X)* | *(X)* | *(X)* | | | N/A | | **bcBuzzer** | | | | | | | | | PWM | PWM | | | | | | N/A | | **bcESP** | | | | | | | | *(X)* | X | X | | | | | | N/A | -| **bcZRanger, bcZRanger2** | | | X | X | | *(X)* | | | | | | | | | | VCC | +| **{% poplink z-ranger-deck %}, Z-ranger deck V1** | | | X | X | | *(X)* | | | | | | | | | | VCC | | **{% poplink flow-deck %}, Flow deck V1** | | | X | X | | *(X)* | X | | | | X | X | X | | | VCC | | **bcOA** | | | X | X | | | | | | | | | | | | VCC | | **{% poplink multi-ranger-deck%}** | | | X | X | | | | | | | | | | | | VCOM | @@ -166,7 +166,7 @@ This table shows which deck that works on which platform. | **Big quad** | yes | yes | | **Buzzer** | yes | | | **bcESP** | yes | yes | -| **Z-Ranger, Z-Ranger V2** | yes | yes | +| **{% poplink z-ranger-deck %}, Z-ranger deck V1** | yes | yes | | **{% poplink flow-deck %}, Flow deck V1** | yes | yes | | **{% poplink multi-ranger-deck%}** | yes | yes | | **Mocap marker deck** | yes | yes | @@ -195,7 +195,7 @@ compatible. | **Big quad** | | yes | yes | yes | - | | | yes | | yes | yes | *2 | yes | yes | | **Buzzer** | yes | yes | yes | yes | | - | | yes | yes | yes | yes | yes | yes | yes | | **bcESP** | yes | yes | yes | yes | | | - | yes | yes | yes | yes | yes | yes | yes | - | **Z-Ranger, Z-Ranger V2** | | | yes | yes | yes | yes | yes | - | | yes | yes | yes | yes | yes | + | **{% poplink z-ranger-deck %}, Z-ranger V1** | | | yes | yes | yes | yes | yes | - | | yes | yes | yes | yes | yes | | **{% poplink flow-deck %}, Flow deck V1** | | | yes *1 | yes | | yes | yes | | - | yes | yes | yes | yes | yes | | **{% poplink multi-ranger-deck%}** | yes | yes | yes | yes | yes | yes | yes | yes | yes | - | yes | yes | yes | yes | | **Mocap marker deck** | yes | yes | yes | yes | yes | yes | yes | yes | yes | yes | - | yes | | yes | diff --git a/src/documentation/tutorials/getting-started-with-z-ranger-deck.md b/src/documentation/tutorials/getting-started-with-z-ranger-deck.md index 0b40d80d..2ea4cd24 100644 --- a/src/documentation/tutorials/getting-started-with-z-ranger-deck.md +++ b/src/documentation/tutorials/getting-started-with-z-ranger-deck.md @@ -7,10 +7,10 @@ redirects: --- {% si_intro The Z-ranger deck %} -The Z-ranger deck contains a VL53L0x Time-of-Flight (ToF) laser-ranging sensor and has a 1-wire memory which enables the Crazyflie to automatically detect the Z-ranger deck. +The {% poplink z-ranger-deck %} contains a VL53L0x Time-of-Flight (ToF) laser-ranging sensor and has a 1-wire memory which enables the Crazyflie to automatically detect the Z-ranger deck. The sensor can measure the distance up to 2 meters from the Crazyflie to the ground. The deck can be only be installed on the bottom of the Crazyflie. For more information about how to mount an expansion deck please see the {% id_link getting-started-expansion-decks %} tutorial. -To be able to use the Z-ranger deck you need to update the Crazyflie to the latest firmware. For more information on how to update the firmware, see the [update firmware in the Crazyflie]({% id_url getting-started-crazyflie-2; update-fw %}) section in our {% id_link getting-started-crazyflie-2 %} tutorial. +To be able to use the {% poplink z-ranger-deck %} you need to update the Crazyflie to the latest firmware. For more information on how to update the firmware, see the [update firmware in the Crazyflie]({% id_url getting-started-crazyflie-2; update-fw %}) section in our {% id_link getting-started-crazyflie-2 %} tutorial. {% endsi_intro %} diff --git a/src/products/z-ranger-deck-v2.md b/src/products/z-ranger-deck-v2.md index f44b2bd9..22d635e0 100644 --- a/src/products/z-ranger-deck-v2.md +++ b/src/products/z-ranger-deck-v2.md @@ -18,10 +18,10 @@ Laser ranging; Adds the possibility to fly with precise height control. %} -The Z-ranger deck uses a laser sensor to measure the distance to the ground. +The {% poplink z-ranger-deck %} uses a laser sensor to measure the distance to the ground. The deck enables the Crazyflie to automatically maintain a constant distance to the objects under it when flying in automatic mode. Over a floor it will stay on the -same height, but will follow the flow of a stair case up or down when going on +same height, but will follow the shape of a stair case up or down when going on adventures. The maximum range for the ranger is 4 meters.