Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit cef4cb20 authored by Matthew Xie's avatar Matthew Xie
Browse files

Add more comments to the file header to explain the state diagram 

The state diagram does not capture every messages. Here we explain
the missing parts to make the diagram clearer.

Change-Id: Ic5de5eb0556be4339d98023b0e7947d6e2cb30d1
parent 8b5c6efd

core/java/android/server/BluetoothAdapterStateMachine.java

+11 −0
Original line number Diff line number Diff line
@@ -62,6 +62,17 @@ import java.io.PrintWriter; 
 * m1 = TURN_HOT

 * m2 = Transition to HotOff when number of process wanting BT on is 0.

 *      POWER_STATE_CHANGED will make the transition.

 * Note:

 * The diagram above shows all the states and messages that trigger normal state changes.

 * The diagram above does not capture everything:

 *   The diagram does not capture following messages.

 *   - messages that do not trigger state changes

 *     For example, PER_PROCESS_TURN_ON received in BluetoothOn state

 *   - unhandled messages

 *     For example, USER_TURN_ON received in BluetoothOn state

 *   - timeout messages

 *   The diagram does not capture error conditions and state recoveries.

 *   - For example POWER_STATE_CHANGED received in BluetoothOn state

 */

final class BluetoothAdapterStateMachine extends StateMachine {

    private static final String TAG = "BluetoothAdapterStateMachine";