MAN_NFC_1105-267 Open NFC - Android Gingerbread 2.3.3 - SDK v0.1

Open NFC - Android Gingerbread

2.3.3 - SDK

Disclaimer

Copyright © 2011 Inside Secure

Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License at /licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.

Content of the NOTICE file:

Open NFC and the Open NFC logo are trademarks or registered trademarks of Inside Secure.

Other brand, product and company names mentioned herein may be trademarks, registered trademarks or trade names of their respective owners.

History

Summary of Contents

1Introduction (5)

2Delivery Description (6)

2.1Delivery contents (6)

2.2SDK add-on (6)

2.3Documentation of the Open NFC for Android API (6)

2.4Application examples (6)

3Installation (8)

3.1Installation (8)

3.2Checking the installation (8)

3.3Creation of the AVD (9)

3.4Launching of the AVD and starting of the Open NFC stack (11)

4Development of applications (18)

4.1Generalities (18)

4.2Examples (19)

4.2.1Reading Mode (20)

1 Introduction

This document is the developer’s manual for the NFC software stack “Open NFC v4.3 (Build 10378)”.

This document describes the installation of the Open NFC for Android SDK add-on and gives some hints about the development of Open NFC applications.

The revision of this delivery is Open NFC v4.3 (Build 10378)

This product was tested and SHALL be used under the following environment: ∙NFC Controller Hardware:

∙Firmware Loader:

∙Firmware: Error! Unknown document property name.

∙Android AOSP Gingerbread branch (Android 2.3.x series)

2 Delivery Description

2.1 Delivery contents

The delivery contains:

- An Android SDK add-on, to be installed within the Android SDK

- Complete documentation of the Open NFC for Android API

- Some application examples

2.2 SDK add-on

The Open NFC for Android SDK add-on provides a pre-configured development platform to allow Android application developers to start developing NFC application without need to regenerate a complete Android platform embedding the Open NFC stack.

This add-on relies on the standard Android emulator, the access to the NFC controller hardware being done through a TCP/IP connection.

The add-on includes a Linux kernel module, meaning the add-on cannot be run with the default kernel image provided with the Android SDK, which has been configured without loadable module support.

A suitable kernel image is provided with the add-on. This kernel image has been configured to be as much as possible similar to the android SDK original kernel image, the only difference being the enabling of the loadable module support. We also provide the corresponding kernel configuration file.

The add-on bas been built against the “SDK Platform 2.3.3, API 10, revision 1” package.

The SDK add-on can is located in the directory “./sdk_addon/opennfc_library”

The kernel image and its corresponding configuration file are located in the directory “./sdk_addon/kernel”

2.3 Documentation of the Open NFC for Android API

The complete documentation of the Open NFC for Android APIs is located in the directory “./documentation/SIS_NFC_1006-198 Open NFC for Android - Developer's Manual”.

2.4 Application examples

The application examples are located in the directory “./documentation/examples”.