Skip to content

Commit

Permalink
minor updates to pm and dronecan
Browse files Browse the repository at this point in the history
  • Loading branch information
hamishwillee committed Jul 17, 2024
1 parent bac02b2 commit 67b2bf3
Show file tree
Hide file tree
Showing 3 changed files with 55 additions and 47 deletions.
54 changes: 29 additions & 25 deletions en/dronecan/raccoonlab_nodes.md
Original file line number Diff line number Diff line change
@@ -1,63 +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.
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 default for Mini and Micro nodes.

The Cyphal/DroneCAN CAN-PWM firmware, which is the default for Mini and Micro nodes,
converts a typical PX4 CAN setpoint to PWM for controlling ESCs or servos.
_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
## 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.
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/).
_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).
_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.
**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.
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](../../assets/hardware/can_nodes/raccoonlab_mini_node.png) | ![RaccoonLab Micro Node](../../assets/hardware/can_nodes/raccoonlab_micro_node.png) |
| 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 | 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)
[Cyphal store](https://cyphal.store/search?q=raccoonlab)
22 changes: 13 additions & 9 deletions en/dronecan/raccoonlab_power.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,30 +2,34 @@

## 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/).
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.
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, it (a separate DCDC) should also be connected to one of these connectors.
- 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.jpg](../../assets/hardware/power_module/raccoonlab_can/raccoonlab_pmu.jpg)
![raccoonlab pmu ](../../assets/hardware/power_module/raccoonlab_can/raccoonlab_pmu.jpg)

This board monitors the battery (voltage and current) and allows to control charging, source and load with DroneCAN interface.
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.
Expand All @@ -34,4 +38,4 @@ Please refer to the RaccoonLab docs [Power & Connectivity](https://docs.raccoonl

[RaccoonLab Store](https://raccoonlab.co/store)

[Cyphal store](https://cyphal.store/search?q=raccoonlab)
[Cyphal store](https://cyphal.store/search?q=raccoonlab)
26 changes: 13 additions & 13 deletions en/power_module/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,16 +18,16 @@ In in practice flight controllers may have different recommendations or preferen

This section provides information about a number of power modules and power distribution boards (see FC manufacturer docs for more options):

* Analog voltage and current power modules:
* [CUAV HV PM](../power_module/cuav_hv_pm.md)
* [Holybro PM02](../power_module/holybro_pm02.md)
* [Holybro PM07](../power_module/holybro_pm07_pixhawk4_power_module.md)
* [Holybro PM06 V2](../power_module/holybro_pm06_pixhawk4mini_power_module.md)
* [Sky-Drones SmartAP PDB](../power_module/sky-drones_smartap-pdb.md)
* Digital (I2C) voltage and current power modules (for Pixhawk FMUv6X and FMUv5X derived controllers):
* [Holybro PM02D](../power_module/holybro_pm02d.md)
* [Holybro PM03D](../power_module/holybro_pm03d.md)
* [DroneCAN](../dronecan/index.md) power modules
* [CUAV CAN PMU](../dronecan/cuav_can_pmu.md)
* [Pomegranate Systems Power Module](../dronecan/pomegranate_systems_pm.md)
* [RaccoonLab Power Connectors and PMU](../dronecan/raccoonlab_power.md))
- Analog voltage and current power modules:
- [CUAV HV PM](../power_module/cuav_hv_pm.md)
- [Holybro PM02](../power_module/holybro_pm02.md)
- [Holybro PM07](../power_module/holybro_pm07_pixhawk4_power_module.md)
- [Holybro PM06 V2](../power_module/holybro_pm06_pixhawk4mini_power_module.md)
- [Sky-Drones SmartAP PDB](../power_module/sky-drones_smartap-pdb.md)
- Digital (I2C) voltage and current power modules (for Pixhawk FMUv6X and FMUv5X derived controllers):
- [Holybro PM02D](../power_module/holybro_pm02d.md)
- [Holybro PM03D](../power_module/holybro_pm03d.md)
- [DroneCAN](../dronecan/index.md) power modules
- [CUAV CAN PMU](../dronecan/cuav_can_pmu.md)
- [Pomegranate Systems Power Module](../dronecan/pomegranate_systems_pm.md)
- [RaccoonLab Power Connectors and PMU](../dronecan/raccoonlab_power.md)

0 comments on commit 67b2bf3

Please sign in to comment.