1# log_phase_fault
2
3## Description
4
5Logs a redundant phase fault error for a voltage regulator. This action should
6be executed if a fault is detected during
7[phase_fault_detection](phase_fault_detection.md) for the regulator.
8
9A regulator may contain one or more redundant phases:
10
11- An "N+2" regulator has two redundant phases
12- An "N+1" regulator has one redundant phase
13
14A phase fault occurs when a phase stops functioning properly. The redundancy
15level of the regulator is reduced.
16
17The phase fault type indicates the level of redundancy remaining **after** the
18fault has occurred:
19
20| Type | Description                                                                                      |
21| :--- | :----------------------------------------------------------------------------------------------- |
22| n+1  | An "N+2" regulator has lost one redundant phase. The regulator is now at redundancy level "N+1". |
23| n    | Regulator has lost all redundant phases. The regulator is now at redundancy level N.             |
24
25If additional data about the fault was previously captured using
26[i2c_capture_bytes](i2c_capture_bytes.md), that data will be stored in the error
27log.
28
29## Properties
30
31| Name | Required | Type   | Description                                                 |
32| :--- | :------: | :----- | :---------------------------------------------------------- |
33| type |   yes    | string | Phase fault type. Specify one of the following: "n+1", "n". |
34
35## Return Value
36
37true
38
39## Example
40
41```json
42{
43  "log_phase_fault": {
44    "type": "n+1"
45  }
46}
47```
48