|
|
| Line 1: |
Line 1: |
| == Introduction ==
| | {{Migrating|https://smartpossdk.gitbook.io/cloudpossdk/faq/usb-serial-port/accessory-agent-service-d22-q3}} |
| The D22 device can establish a USB connection with the Q3, where D22 operates in master mode and Q3 in slave mode. The AccessoryConnectionAgent APK facilitates communication between applications across these two devices using Intents sent through the USB connection.
| |
| == User Manual ==
| |
| * For detailed instructions on how to use the Accessory Connection Agent service, refer to the [http://ftp.wizarpos.com/advanceSDK/AccessoryConnectAgentusermanual.pdf Accessory Connection Agent service user manual]
| |
| == Demonstration and Development: ==
| |
| # '''Demo for APK Development:'''
| |
| #* Explore the demo for insights into developing APKs for this setup, [http://ftp.wizarpos.com/advanceSDK/AccessoryAgentDemo.zip Access AccessoryAgentDemo]
| |
| # '''Testing APK:'''
| |
| #* After installation and running this APK, it will send an intent via the USB connection to initiate the merchant self-test application on the other device, [http://ftp.wizarpos.com/advanceSDK/AccessoryConnectionAgentDemo.apk Download AccessoryConnectionAgentDemo APK]
| |
| '''Sender snippet code:'''
| |
| <syntaxhighlight lang="java">
| |
| @Override
| |
| protected void onCreate(Bundle savedInstanceState) {
| |
| super.onCreate(savedInstanceState);
| |
| setContentView(R.layout.activity_main);
| |
| initView();
| |
| bindServer();
| |
| }
| |
| | |
| private void initView() {
| |
| bindServerStatus = findViewById(R.id.bindServerStatus);
| |
| startActivity = findViewById(R.id.startActivity);
| |
| String json ="{\n" +
| |
| " \"action\": \"android.intent.action.MAIN\",\n" +
| |
| " \"className\": \"com.wizarpos.accessoryreceiveintentdemo.MainActivity\",\n" +
| |
| " \"flags\": 268435456,\n" +
| |
| " \"packageName\": \"com.wizarpos.accessoryreceiveintentdemo\",\n" +
| |
| " \"putExtra\": {\n" +
| |
| " \"extraData\": \"10\"\n" +
| |
| " }\n" +
| |
| "}";
| |
| startActivity.setOnClickListener(v -> {
| |
| if(remoteServe != null){
| |
| try {
| |
| remoteServe.remoteIntent(json);
| |
| } catch (RemoteException e) {
| |
| throw new RuntimeException(e);
| |
| }
| |
| }else {
| |
| Toast.makeText(this, "The AIDL service is disconnected", Toast.LENGTH_SHORT).show();
| |
| }
| |
| | |
| });
| |
| }
| |
| | |
| private void bindServer() {
| |
| Intent intent = new Intent();
| |
| ComponentName componentName =new ComponentName(INTENT_PACKAGE, INTENT_ACTION);
| |
| intent.setComponent(componentName);
| |
| bindService(intent, mServiceConnection, BIND_AUTO_CREATE);
| |
| }
| |
| ServiceConnection mServiceConnection = new ServiceConnection() {
| |
| | |
| @Override
| |
| public void onServiceConnected(ComponentName name, IBinder service) {
| |
| remoteServe = IRemoteAccessoryApi.Stub.asInterface(service);
| |
| bindServerStatus.setText("The AIDL service is Connected");
| |
| }
| |
| | |
| @Override
| |
| public void onServiceDisconnected(ComponentName name) {
| |
| remoteServe = null;
| |
| bindServerStatus.setText("The AIDL service is disconnected");
| |
| }
| |
| };
| |
| | |
| @Override
| |
| protected void onDestroy() {
| |
| super.onDestroy();
| |
| unbindService(mServiceConnection);
| |
| }
| |
| </syntaxhighlight>
| |
| | |
| '''Receiver(com.wizarpos.accessoryreceiveintentdemo) snippet code:'''
| |
| <syntaxhighlight lang="java">
| |
| @Override
| |
| protected void onCreate(Bundle savedInstanceState) {
| |
| super.onCreate(savedInstanceState);
| |
| setContentView(R.layout.activity_main);
| |
| //Receive intent data
| |
| String extraData = getIntent().getStringExtra("extraData");
| |
| }
| |
| | |
| @Override
| |
| protected void onNewIntent(Intent intent) {
| |
| super.onNewIntent(intent);
| |
| //Receive intent data
| |
| String extraData = intent.getStringExtra("extraData");
| |
| }
| |
| </syntaxhighlight>
| |
| == AccessoryConnectionAgent Service APK ==
| |
| '''Installation Requirements:'''
| |
| * The AccessoryConnectAgent is typically included in the firmware (FW) of D22 and Q3. For older firmware versions, developers may need to install the agent manually. [http://ftp.wizarpos.com/advanceSDK/AccessoryAgentHostService-master-release-v1.0.22-r20230825095655-q1_platform.apk Download Connection Agent APK]
| |
| == Initiating USB Connection Mode in Development: ==
| |
| * '''Enabling AccessoryConnectionAgent:'''
| |
| ** By default, the AccessoryConnectionAgent is disabled. Developers can use the provided APK to enable it.
| |
| ** For production firmware, the agent is initialized before factory release.
| |
| ** [http://ftp.wizarpos.com/advanceSDK/InitConnectionMode.apk Download Initialize APK]
| |
| * '''Mode Selection:'''
| |
| ** In Q3, the default mode is set to slave, while other devices default to master mode.
| |
| * '''Usbchannel Switch:'''
| |
| ** Enable or disable the Accessory Connection Agent service as needed for your development and testing purposes.
| |
| This guide provides essential information for developers and users to set up and use the Accessory Agent Service between D22 and Q3 devices, ensuring efficient and effective communication and testing.
| |
