Skip to content

Commit

Permalink
(#92) add z-ranger poplink
Browse files Browse the repository at this point in the history
  • Loading branch information
@knmcguire
knmcguire committed Aug 10, 2021
1 parent 724e9b9 commit 126750a
Show file tree
Hide file tree
Showing 6 changed files with 25 additions and 12 deletions.
5 changes: 5 additions & 0 deletions src/_data/poplink.yml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

8 changes: 8 additions & 0 deletions src/_poplink/z-ranger-deck.md
View file
Original file line number Diff line number Diff line change
@@ -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/)
6 changes: 3 additions & 3 deletions src/buy/buyers-guide.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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)

---

Expand Down
10 changes: 5 additions & 5 deletions src/documentation/system/platform/cf2-expansiondecks.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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)| |
Expand Down Expand Up @@ -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) |
Expand Down Expand Up @@ -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 |
Expand All @@ -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 |
Expand Down Expand Up @@ -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 |
Expand Down
4 changes: 2 additions & 2 deletions src/documentation/tutorials/getting-started-with-z-ranger-deck.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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 %}

Expand Down
4 changes: 2 additions & 2 deletions src/products/z-ranger-deck-v2.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down

0 comments on commit 126750a

Please sign in to comment.