Skip to content

Commit

Permalink
Update battery documentation updating BAT STATUS protocol and Display…
Browse files Browse the repository at this point in the history
… screen
  • Loading branch information
MSECode committed Sep 29, 2023
1 parent 47974e8 commit ccdf21b
Show file tree
Hide file tree
Showing 4 changed files with 39 additions and 5 deletions.
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 |
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:

```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
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.
The main screen is as described in the image below for both iCub3, ergoCub and R1:

<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):

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

0 comments on commit ccdf21b

Please sign in to comment.