-
Notifications
You must be signed in to change notification settings - Fork 1.7k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Raccoonlab devices #3295
Merged
Merged
Raccoonlab devices #3295
Changes from all commits
Commits
Show all changes
11 commits
Select commit
Hold shift + click to select a range
9236812
Add descriptions for supported RaccoonLab devices:
frontw 9aec96c
Add RaccoonLab nodes, autopilot and power modules pages to SUMMARY.md
frontw 093696d
Shrink images
hamishwillee 37901ac
FC subedit
hamishwillee 8f83b05
Gnss subedit
hamishwillee df9f8c2
rtk/mag subedit (table tidy)
hamishwillee 7bf0260
Only add redirects if you need the link or to redirect
hamishwillee dadc83b
Rangefinder subedit
hamishwillee 9aceed4
minor updates to pm and dronecan
hamishwillee b337d56
RTK fix - linkchecker fail on anchor so revert otherwise good changes
hamishwillee a3eb0ed
FC is pixhawk standard
hamishwillee File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+63.1 KB
assets/hardware/power_module/raccoonlab_can/raccoonlab_power_connector_example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,67 @@ | ||
# RaccoonLab Mini/Micro Nodes | ||
|
||
Mini/Micro are general purpose CAN nodes. The functionality of these devices depends on the firmware they are running. | ||
The default and most popular usage is as a PWM-CAN adapter to control ESCs and servos using CAN (Cyphal or DroneCAN) communication: | ||
|
||
- Micro is the smallest node with 2 groups of pins (PWM/5V/GND) to control 2 servos or ESCs. | ||
- Mini v2: Features 2 x PWM/5V/GND for controlling servos or ESCs and 2 x PWM/FB/GND for controlling and receiving feedback from ESCs via UART. | ||
|
||
## Cyphal/DroneCAN CAN-PWM Adapter Firmware | ||
|
||
_Cyphal/DroneCAN CAN-PWM_ firmwares are the default for Mini and Micro nodes. | ||
These convert a typical PX4 CAN setpoint to PWM for controlling ESCs or servos. | ||
|
||
Please refer to the corresponding RaccoonLab docs pages for details: [Cyphal/CAN-PWM](https://docs.raccoonlab.co/guide/can_pwm/cyphal.html), [DroneCAN-PWM](https://docs.raccoonlab.co/guide/can_pwm/dronecan.html). | ||
|
||
![Mini v2 Node with Servo and ESC](../../assets/hardware/can_nodes/raccoonlab_mini_v2_with_servo.png) | ||
|
||
## Cyphal & DroneCAN Rangefinder Firmware | ||
|
||
The _Cyphal & DroneCAN Rangefinder_ firmware is a single firmware that can work in either Cyphal or DroneCAN mode. | ||
It supports LW20/I2C, Garmin Lite v3/I2C and TL-Luna/UART lidars. | ||
For details, please check the [Rangefinder](https://docs.raccoonlab.co/guide/can_pwm/rangefinder.html) page. | ||
|
||
![Mini v2 Node with servo and ESC](../../assets/hardware/can_nodes/raccoonlab_mini_v2_lw20_i2c.png) | ||
|
||
## DroneCAN Fuel Sensor Firmware | ||
|
||
_DroneCAN fuel tank_ firmware is based on the [AS5600 sensor board](https://docs.raccoonlab.co/guide/as5600/). | ||
Please refer to [DroneCAN Fuel Tank](https://docs.raccoonlab.co/guide/can_pwm/fuel_tank.html) for details. | ||
|
||
## DroneCAN Servo Gripper Firmware | ||
|
||
_DroneCAN servo gripper_ is part of a [Mini Node Template Application](https://github.com/RaccoonlabDev/mini_v2_node). | ||
Please refer to [DroneCAN Servo Gripper](https://docs.raccoonlab.co/guide/can_pwm/servo_gripper.html) for details. | ||
|
||
## Custom Firmware | ||
|
||
**Custom firmware** can be developed by anyone. | ||
If you require custom features, you can use the [Mini Node Template Application](https://github.com/RaccoonlabDev/mini_v2_node). | ||
You can configure the external pins to work in UART, I2C or ADC mode. | ||
From the box, it supports basic Cyphal/DroneCAN features. | ||
It has publishers and subscribers as an example. | ||
|
||
## Which node to choose? | ||
|
||
The differences between [Mini v2](https://docs.raccoonlab.co/guide/can_pwm/can_pwm_mini_v2.html) and [Micro](https://docs.raccoonlab.co/guide/can_pwm/can_pwm_micro.html) are summarized in the table below. | ||
For more details, please refer to the corresponding pages. | ||
|
||
| | | Mini v2 | Micro | | ||
| --- | --------------- | ----------------------------------------- | ------------------------------------ | | ||
| | Image | ![RaccoonLab Mini v2 Node][Mini v2 Node] | ![RaccoonLab Micro Node][Micro Node] | | ||
| 1 | Input voltage | 5.5V – 30V | 4.5V – 5.5V | | ||
| 2 | DC-DC | Yes | No | | ||
| 3 | Groups of pins | - PWM+5V+GND x2 </br> - PWM+FB+GND x2 | - PWM+5V+GND x2 | | ||
| 4 | CAN connectors | - UCANPHY Micro x2 </br> - 6-pin Molex x2 | - UCANPHY Micro x2 | | ||
| 5 | SWD interface | + | + | | ||
| 6 | Size, LxWxH, mm | 42x35x12 | 20x10x5 | | ||
| 7 | Mass, g | 5 | 3 | | ||
|
||
[Mini v2 Node]: ../../assets/hardware/can_nodes/raccoonlab_mini_node.png | ||
[Micro Node]: ../../assets/hardware/can_nodes/raccoonlab_micro_node.png | ||
|
||
## Where to Buy | ||
|
||
[RaccoonLab Store](https://raccoonlab.co/store) | ||
|
||
[Cyphal store](https://cyphal.store/search?q=raccoonlab) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,41 @@ | ||
# RaccoonLab Power Connectors and Management Units | ||
|
||
## CAN Power Connectors | ||
|
||
CAN power connectors are designed for light unmanned aerial (UAV) and other vehicles for providing power over CAN using [CAN power cables](https://docs.raccoonlab.co/guide/pmu/wires/). | ||
|
||
There are two types of devices: | ||
|
||
1. `CAN-MUX` devices provide power from XT30 connector to CAN. | ||
There are 2 variation of this type of the device with different number of connectors. | ||
2. `Power connector node` is designed to pass current (up to 60A) to power load and CAN, measure voltage and current on load. | ||
It behaves as Cyphal/DroneCAN node. | ||
|
||
Please refer to the RaccoonLab docs [CAN Power Connectors](https://docs.raccoonlab.co/guide/pmu/power/) page. | ||
|
||
**Connection example diagram** | ||
|
||
Here are the examples: | ||
|
||
- The first shows how to use both external high voltage power and 5V CAN power for different nodes with MUX. | ||
The [NODE](raccoonlab_nodes.md) (the large one in the left diagram) is connected to a high-voltage power source (here 30 V). | ||
In this case, the [uNODE](raccoonlab_nodes.md) (smaller one on the left schematic) is powered directly from the autopilot. | ||
- The second example shows how to connect multiple [uNODEs](raccoonlab_nodes.md) that are powered by the autopilot (5V). | ||
If these nodes are powered from a separate DCDC, that DCDC should also be connected to one of these connectors. | ||
|
||
![RaccoonLab CAN Power Connector Example Diagram](../../assets/hardware/power_module/raccoonlab_can/raccoonlab_power_connector_example.png) | ||
|
||
## Power Management Unit | ||
|
||
![raccoonlab pmu ](../../assets/hardware/power_module/raccoonlab_can/raccoonlab_pmu.jpg) | ||
|
||
This board monitors the battery (voltage and current) and allows control over charging, source and load using he DroneCAN interface. | ||
It might be useful for applications where you need to control the power of the drone including the board computer and charging process. | ||
|
||
Please refer to the RaccoonLab docs [Power & Connectivity](https://docs.raccoonlab.co/guide/pmu/) page. | ||
|
||
## Where to Buy | ||
|
||
[RaccoonLab Store](https://raccoonlab.co/store) | ||
|
||
[Cyphal store](https://cyphal.store/search?q=raccoonlab) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,162 @@ | ||
# RaccoonLab FMUv6X Autopilot | ||
|
||
:::warning | ||
PX4 does not manufacture this (or any) autopilot. | ||
Contact the [manufacturer](https://raccoonlab.co) for hardware support or compliance issues. | ||
::: | ||
|
||
The [RaccoonLab FMUv6X](https://docs.raccoonlab.co/guide/autopilot/RCLv6X.html) flight controller is based on the following Pixhawk® standards: [Pixhawk Autopilot FMUv6X Standard](https://github.com/pixhawk/Pixhawk-Standards/blob/master/DS-012%20Pixhawk%20Autopilot%20v6X%20Standard.pdf), [Autopilot Bus Standard](https://github.com/pixhawk/Pixhawk-Standards/blob/master/DS-010%20Pixhawk%20Autopilot%20Bus%20Standard.pdf), and [Connector Standard](https://github.com/pixhawk/Pixhawk-Standards/blob/master/DS-009%20Pixhawk%20Connector%20Standard.pdf). | ||
|
||
Equipped with a high-performance H7 Processor, modular design, triple redundancy, temperature-controlled IMU board, and isolated sensor domains, it delivers exceptional performance, reliability, and flexibility. | ||
At RaccoonLab, we focus on DroneCAN and Cyphal-based onboard control system buses. | ||
Our autopilot is part of a larger DroneCAN and Cyphal ecosystem, making it an ideal choice for next-generation intelligent vehicles. | ||
|
||
![RaccoonLab FMUv6X](../../assets/flight_controller/raccoonlab/fmuv6x.png) | ||
|
||
RaccoonLab offers versatile HATs for both Raspberry Pi and NVIDIA Jetson Xavier NX, enhancing connectivity and functionality. | ||
The [Jetson Xavier NX HAT](https://docs.raccoonlab.co/guide/nx_hat/) is designed to integrate the CAN bus with the Jetson Xavier NX, enabling access to Cyphal and DroneCAN protocols. | ||
The [Raspberry Pi CM4 HAT](https://docs.raccoonlab.co/guide/rpi_hat/) provides robust features, including CAN bus connectivity, an LTE modem, internal voltage measurement, SWD debugging for other MCUs, and UART communication with PX4 over MAVLINK. | ||
These HATs expand the capabilities of devices, making them ideal for advanced robotics and UAV applications. | ||
|
||
:::tip | ||
This autopilot is [supported](../flight_controller/autopilot_pixhawk_standard.md) by the PX4 maintenance and test teams. | ||
::: | ||
|
||
## Key Design Points | ||
|
||
- High performance STM32H753 Processor | ||
- Modular flight controller: separated IMU, FMU, and Base system connected by a 100-pin & a 50-pin Pixhawk Autopilot Bus connector. | ||
- Redundancy: 3x IMU sensors & 2x Barometer sensors on separate buses | ||
- Triple redundancy domains: Completely isolated sensor domains with separate buses and separate power control | ||
- Newly designed vibration isolation system to filter out high frequency vibration and reduce noise to ensure accurate readings | ||
- Ethernet interface for high-speed mission computer integration | ||
|
||
## Processors & Sensors | ||
|
||
- FMU Processor: STM32H753 | ||
- 32 Bit Arm Cortex-M7, 480MHz, 2MB flash memory, 1MB RAM | ||
- IO Processor: STM32F100 | ||
- 32 Bit Arm Cortex-M3, 24MHz, 8KB SRAM | ||
- On-board sensors | ||
- Accel/Gyro: ICM-20649 or BMI088 | ||
- Accel/Gyro: ICM-42688-P | ||
- Accel/Gyro: ICM-42670-P | ||
- Mag: BMM150 | ||
- Barometer: 2x BMP388 | ||
|
||
## Electrical data | ||
|
||
- Voltage Ratings: | ||
- Max input voltage: 36V | ||
- USB Power Input: 4.75\~5.25V | ||
- Servo Rail Input: 0\~36V | ||
- Current Ratings: | ||
- `TELEM1` output current limiter: 1.5A | ||
- All other port combined output current limiter: 1.5A | ||
|
||
## Mechanical data | ||
|
||
- Dimensions | ||
- Flight Controller Module: 38.8 x 31.8 x 14.6mm | ||
- Standard Baseboard: 52.4 x 103.4 x 16.7mm | ||
- Mini Baseboard: 43.4 x 72.8 x 14.2 mm | ||
- Weight | ||
- Flight Controller Module: 23g | ||
- Standard Baseboard: 51g | ||
- Mini Baseboard: 26.5g | ||
|
||
3D model can be downloaded on [GrabCAD](https://grabcad.com/library/raccoonlab-autopilot-1). | ||
|
||
![RaccoonLab FMUv6X drawings](../../assets/flight_controller/raccoonlab/fmuv6x-drw.png) | ||
|
||
## Interfaces | ||
|
||
- 16- PWM servo outputs | ||
- R/C input for Spektrum / DSM | ||
- Dedicated R/C input for PPM and S.Bus input | ||
- Dedicated analog / PWM RSSI input and S.Bus output | ||
- 4 general purpose serial ports | ||
- 3 with full flow control | ||
- 1 with separate 1.5A current limit (`TELEM1`) | ||
- 1 with I2C and additional GPIO line for external NFC reader | ||
- 2 GPS ports | ||
- 1 full GPS plus Safety Switch Port | ||
- 1 basic GPS port | ||
- 1 I2C port | ||
- 1 Ethernet port | ||
- Transformerless Applications | ||
- 100Mbps | ||
- 1 SPI bus | ||
- 2 chip select lines | ||
- 2 data-ready lines | ||
- 1 SPI SYNC line | ||
- 1 SPI reset line | ||
- 2 CAN Buses for CAN peripheral | ||
- CAN Bus has individual silent controls or ESC RX-MUX control | ||
- 2 Power input ports with SMBus | ||
- 1 AD & IO port | ||
- 2 additional analog input | ||
- 1 PWM/Capture input | ||
- 2 Dedicated debug and GPIO lines | ||
|
||
## Serial Port Mapping | ||
|
||
| UART | Device | Port | | ||
| ------ | ---------- | ------------- | | ||
| USART1 | /dev/ttyS0 | GPS | | ||
| USART2 | /dev/ttyS1 | TELEM3 | | ||
| USART3 | /dev/ttyS2 | Debug Console | | ||
| UART4 | /dev/ttyS3 | UART4 & I2C | | ||
| UART5 | /dev/ttyS4 | TELEM2 | | ||
| USART6 | /dev/ttyS5 | PX4IO/RC | | ||
| UART7 | /dev/ttyS6 | TELEM1 | | ||
| UART8 | /dev/ttyS7 | GPS2 | | ||
|
||
## Voltage Ratings | ||
|
||
_RaccoonLab FMUv6X_ can be triple-redundant on the power supply if three power sources are supplied. | ||
The three power rails are: **POWER1**, **POWER2** and **USB**. | ||
The **POWER1** & **POWER2** ports on the RaccoonLab FMUv6X uses the 6 circuit [2.00mm Pitch CLIK-Mate Wire-to-Board PCB Receptacle](https://www.molex.com/molex/products/part-detail/pcb_receptacles/5024430670). | ||
|
||
**Normal Operation Maximum Ratings** | ||
|
||
Under these conditions all power sources will be used in this order to power the system: | ||
|
||
1. **POWER1** and **POWER2** inputs (4.9V to 5.5V) | ||
2. **USB** input (4.75V to 5.25V) | ||
|
||
:::tip | ||
The manufacturer [RaccoonLab Docs](https://docs.raccoonlab.co/guide/autopilot/RCLv6X.html) are the canonical reference for the RaccoonLab FMUv6X Autopilot. | ||
They should be used by preference as they contain the most complete and up to date information. | ||
::: | ||
|
||
## Where to Buy | ||
|
||
[RaccoonLab Store](https://raccoonlab.co/store) | ||
|
||
[Cyphal store](https://cyphal.store) | ||
|
||
## Building Firmware | ||
|
||
:::tip | ||
Most users will not need to build this firmware! | ||
It is pre-built and automatically installed by _QGroundControl_ when appropriate hardware is connected. | ||
::: | ||
|
||
To [build PX4](../dev_setup/building_px4.md) for this target: | ||
|
||
```sh | ||
make px4_fmu-v6x_default | ||
``` | ||
|
||
## Supported Platforms / Airframes | ||
|
||
Any multicopter / airplane / rover or boat that can be controlled with normal RC servos or Futaba S-Bus servos. | ||
The complete set of supported configurations can be seen in the [Airframes Reference](../airframes/airframe_reference.md). | ||
|
||
## Further info | ||
|
||
- [Pixhawk Autopilot FMUv6X Standard](https://github.com/pixhawk/Pixhawk-Standards/blob/master/DS-012%20Pixhawk%20Autopilot%20v6X%20Standard.pdf) | ||
- [Pixhawk Autopilot Bus Standard](https://github.com/pixhawk/Pixhawk-Standards/blob/master/DS-010%20Pixhawk%20Autopilot%20Bus%20Standard.pdf) | ||
- [Pixhawk Connector Standard](https://github.com/pixhawk/Pixhawk-Standards/blob/master/DS-009%20Pixhawk%20Connector%20Standard.pdf) | ||
- [RaccoonLab docs](http://docs.raccoonlab.co) |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Very cool. I guess one concern is that CAN ESC are very precise and don't need calibration in the same way as PWM ones do. I presume you still need to do this "somewhere" so that should be noted in the docs - your docs :-)