1 /*
2  * Copyright (C) 2014 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package com.android.nfc;
18 
19 /**
20  * Parameters for enabling NFC tag discovery and polling,
21  * and host card emulation.
22  */
23 public final class NfcDiscoveryParameters {
24 
25     public static class Builder {
26 
27         private NfcDiscoveryParameters mParameters;
28 
Builder()29         private Builder() {
30             mParameters = new NfcDiscoveryParameters();
31         }
32 
setTechMask(int techMask)33         public NfcDiscoveryParameters.Builder setTechMask(int techMask) {
34             mParameters.mTechMask = techMask;
35             return this;
36         }
37 
setEnableLowPowerDiscovery(boolean enable)38         public NfcDiscoveryParameters.Builder setEnableLowPowerDiscovery(boolean enable) {
39             mParameters.mEnableLowPowerDiscovery = enable;
40             return this;
41         }
42 
setEnableReaderMode(boolean enable)43         public NfcDiscoveryParameters.Builder setEnableReaderMode(boolean enable) {
44             mParameters.mEnableReaderMode = enable;
45 
46             if (enable) {
47                 mParameters.mEnableLowPowerDiscovery = false;
48             }
49 
50             return this;
51         }
52 
setEnableHostRouting(boolean enable)53         public NfcDiscoveryParameters.Builder setEnableHostRouting(boolean enable) {
54             mParameters.mEnableHostRouting = enable;
55             return this;
56         }
57 
setEnableP2p(boolean enable)58         public NfcDiscoveryParameters.Builder setEnableP2p(boolean enable) {
59             mParameters.mEnableP2p = enable;
60             return this;
61         }
62 
build()63         public NfcDiscoveryParameters build() {
64             if (mParameters.mEnableReaderMode &&
65                     (mParameters.mEnableLowPowerDiscovery || mParameters.mEnableP2p)) {
66                 throw new IllegalStateException("Can't enable LPTD/P2P and reader mode " +
67                         "simultaneously");
68             }
69             return mParameters;
70         }
71     }
72 
73     static final int NFC_POLL_DEFAULT = -1;
74 
75     // NOTE: when adding a new field, don't forget to update equals() and toString() below
76     private int mTechMask = 0;
77     private boolean mEnableLowPowerDiscovery = true;
78     private boolean mEnableReaderMode = false;
79     private boolean mEnableHostRouting = false;
80     private boolean mEnableP2p = false;
81 
NfcDiscoveryParameters()82     public NfcDiscoveryParameters() {}
83 
getTechMask()84     public int getTechMask() {
85         return mTechMask;
86     }
87 
shouldEnableLowPowerDiscovery()88     public boolean shouldEnableLowPowerDiscovery() {
89         return mEnableLowPowerDiscovery;
90     }
91 
shouldEnableReaderMode()92     public boolean shouldEnableReaderMode() {
93         return mEnableReaderMode;
94     }
95 
shouldEnableHostRouting()96     public boolean shouldEnableHostRouting() {
97         return mEnableHostRouting;
98     }
99 
shouldEnableDiscovery()100     public boolean shouldEnableDiscovery() {
101         return mTechMask != 0 || mEnableHostRouting;
102     }
103 
shouldEnableP2p()104     public boolean shouldEnableP2p() {
105         return mEnableP2p;
106     }
107 
108     @Override
equals(Object obj)109     public boolean equals(Object obj) {
110         if (obj == this) {
111             return true;
112         }
113 
114         if ((obj == null) || (obj.getClass() != this.getClass())) {
115             return false;
116         }
117         NfcDiscoveryParameters params = (NfcDiscoveryParameters) obj;
118         return mTechMask == params.mTechMask &&
119                 (mEnableLowPowerDiscovery == params.mEnableLowPowerDiscovery) &&
120                 (mEnableReaderMode == params.mEnableReaderMode) &&
121                 (mEnableHostRouting == params.mEnableHostRouting)
122                 && (mEnableP2p == params.mEnableP2p);
123     }
124 
125     @Override
toString()126     public String toString() {
127         StringBuilder sb = new StringBuilder();
128         if (mTechMask == NFC_POLL_DEFAULT) {
129             sb.append("mTechMask: default\n");
130         } else {
131             sb.append("mTechMask: " + Integer.toString(mTechMask) + "\n");
132         }
133         sb.append("mEnableLPD: " + Boolean.toString(mEnableLowPowerDiscovery) + "\n");
134         sb.append("mEnableReader: " + Boolean.toString(mEnableReaderMode) + "\n");
135         sb.append("mEnableHostRouting: " + Boolean.toString(mEnableHostRouting) + "\n");
136         sb.append("mEnableP2p: " + Boolean.toString(mEnableP2p));
137         return sb.toString();
138     }
139 
newBuilder()140     public static NfcDiscoveryParameters.Builder newBuilder() {
141         return new Builder();
142     }
143 
getDefaultInstance()144     public static NfcDiscoveryParameters getDefaultInstance() {
145         return new NfcDiscoveryParameters();
146     }
147 
getNfcOffParameters()148     public static NfcDiscoveryParameters getNfcOffParameters() {
149         return new NfcDiscoveryParameters();
150     }
151 }
152