Skip to content
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

Update battery documentation #319

Merged
merged 7 commits into from
Oct 2, 2023
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 27 additions & 5 deletions docs/battery_boards/bat_board/bat_protocol.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,16 +65,38 @@ where:

- DCDC_status_B:

Position | BIT[1] | BIT[0] |
|:---|:---:|:---:|
Value | PB1_restart | PB2_restart |
Description | Restart phase of the push button 1 | Restart phase of the push button 2 |
Possible status | Start-up phase(1)/stable operation(0) | Start-up phase/stable operation |
Position | BIT[3] | BIT[2] | BIT[1] | BIT[0] |
|:---|:---:|:---:|:---:|:---:|
Value | HSM_SW_F | HSM_HW_F | PB1_restart | PB2_restart |
Description | OC Fault on the HSM triggered by overcoming the MAX current defined in FW | OC Fault on the HSM triggered by FLT Pin on the HSM micro | Restart phase of the push button 1 | Restart phase of the push button 2 |
MSECode marked this conversation as resolved.
Show resolved Hide resolved
Possible status | FAULT_OFF(0)/FAULT_ON(1) | FAULT_OFF(0)/FAULT_ON(1) | Start-up phase(1)/stable operation(0) | Start-up phase/stable operation |

- Final status shown at the port is equal to:

`(DCDC_status_B << 8 ) | DCDC_status_A`

Therefore the end user will see a decimal number on the Display of the BAT, that can be translated in BITs and analyzed as defined by the tables above and summmed up here:
MSECode marked this conversation as resolved.
Show resolved Hide resolved

```console

**BIT_POS**: 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0

**VALUE**: NAN NAN NAN NAN HSM_SW_F HSM_HW_F PB1 PB2 V12board V12board_F V12motor V12motor_F HSM HSM_PG HSM_F HSM_broken

E.g.

If we get 172 as decimal value, then we will have in bits:

0000 0000 1010 1100

meaning that we have on the bits related to:

- HSM_PG
- HSM
- V12motor
- V12board

```

### Data displayed on the yarp port

Expand Down
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 docs/robot_power/assets/display-screen-131.png
pattacini marked this conversation as resolved.
Show resolved Hide resolved
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 12 additions & 0 deletions docs/robot_power/robot_power_button.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,3 +21,15 @@ On iCub3 and on R1 there is also a display that shows the voltage and current pr
|:---:|:---:|
| <img src="../assets/fig-icub3-4.png" height="200"> | <img src="../assets/fig-r1-1.png" height="200"> |


## Display Interface

Lately has been released a new version of the Display UX/UI.
MSECode marked this conversation as resolved.
Show resolved Hide resolved
The main screen is as described in the image below for both iCub3, ergoCub and R1:
MSECode marked this conversation as resolved.
Show resolved Hide resolved

<img src="../assets/display-screen-131.png" width="500" height="500">


Then, if a fault occurs the Display will switch to another screen descring the occurred fault by a string, which summarizes the error type, and the last values of voltage and currents accured at the moment of the fault as shown below (on the right hand side we have errors related to BOARDS/MOTORS line, instead on the left hand side errors related to CPU line):
MSECode marked this conversation as resolved.
Show resolved Hide resolved

<img src="../assets/display-fault-screen-131.png" width="500" height="500">