Skip to content

Light Tag APIs

The Light Tag is a pick-by-light system from NIMMSTA. Each of the Light Tags store their location information on device and can be triggered using the location information. We call the process of defining the location information "Attach". If you reset the location, we call it "Detach".

The following documentation helps you find, illuminate, attach a location, and reset a Light Tag location as well as handling special cases such as end of life.

Essential Prerequisites

  • This integration works with native Kotlin / Java Android Projects. For Xamarin or .NET MAUI, please consider using a websocket integration.
  • Android SDK Requirements: The baseline SDK level required for Android devices is 29 (Android 10).
  • Access to NIMMSTA Maven Repository: It's crucial that you have the necessary credentials for the NIMMSTA Maven Repository. These credentials are key to accessing and integrating the Maven dependency. also, you need to have access to the LightTag SDK as well as core library SDK provided by NIMMSTA.
  • Latest Firmware Bundle: To ensure compatibility and the latest features, download and install the newest firmware bundle available at the NIMMSTA B2B Portal.
  • Gradle Compatibility: Your project should be using Gradle version 7.0 or above. This version ensures better performance and more features that are compatible with the NIMMSTA Maven dependency.
  • Kotlin Compatibility: Your project should be using Kotlin version 1.8 or above.

Gaining Access to the NIMMSTA Maven Repository

In order to download the necessary artifacts from the NIMMSTA Repository, specific access credentials are required. These credentials can typically be obtained through direct communication with your service partner or a representative at NIMMSTA. This step is crucial as it provides the authentication required to securely access and download the Maven artifacts needed for your project.

Starting with Kotlin Gradle Plugin

The first step in your setup should be the addition of the Kotlin Gradle Plugin. This plugin is essential for integrating Kotlin code and modules effectively in your project. It provides necessary tools and features to compile, test, and debug your Kotlin code within the project environment. Make sure to verify the compatibility of the Kotlin Gradle Plugin version with your current Gradle setup to ensure a smooth integration process.

    buildscript {

        /* ... */

        repositories {
            /* ... */
        }

        dependencies {
            /* ... */

            classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.22" // You can use the latest version
        }
    } 

    buildscript {

        /* ... */

        repositories {
            /* ... */
        }

        dependencies {
            /* ... */

            classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.22") // You can use the latest version
        }
    }

Configuring Repository Settings

The following step involves adding the Light Tag Maven Repository to your project's settings. This is a crucial step for ensuring that your project can access and utilize the NIMMSTA Maven dependency effectively.

Adding the Light Tag Maven Repository

  1. Repository Configuration: Integrate the Light Tag Maven Repository into your project's repository settings. This involves specifying the repository URL and ensuring that it's correctly configured within your project's build system.

  2. Authentication with Credentials: Utilize your NIMMSTA access credentials during this step. These credentials are essential for authenticating your access to the repository. They ensure secure and authorized communication between your project and the NIMMSTA Maven Repository, allowing for the download and integration of necessary dependencies.

repositories {
/* ... */
    google()
    mavenCentral()
    maven {
        url 'https://maven.nimmsta.com/repository/nimmsta-lighttag-release/'
        credentials {
            username = "yourusername"
            password = "yourpassword"
        }
        authentication {
            basic(BasicAuthentication)
        }
        metadataSources {
            mavenPom()
            artifact()
        }
    }
}
/* ... */

repositories {
/* ... */
    google()
    mavenCentral()
    maven {
        url = uri("https://maven.nimmsta.com/repository/nimmsta-lighttag-release/")
        credentials {
            username = "yourusername"
            password = "yourpassword"
        }
        metadataSources {
            mavenPom()
            artifact()
        }
    }
}
/* ... */

Integrating Android Maven Dependency

Once the repository configuration is complete, the next step involves incorporating the Maven artifact into your project's build system.

Inclusion of Maven Artifact

  • Artifact Implementation: Add the Light Tag Maven artifact to your project's build system. This step is crucial for the artifact to be recognized and used within your project's environment.

  • Kotlin Plugin Integration: Ensure that the Kotlin plugin is integrated into your build system. This is important regardless of whether your project is based on Kotlin or Java. The Kotlin plugin plays a key role in dependency management, helping the system to identify and select the appropriate artifacts for your project.

Warning

Important Note for Java Users: The Kotlin plugin is necessary even if your application is developed in Java. This plugin is crucial for managing dependencies effectively in your build system, ensuring compatibility and optimal functioning of the NIMMSTA Maven artifact.

Note

Update Notifications in IDE: If your Integrated Development Environment (IDE) suggests that a newer version of the 'shared-android' project is available, consider updating to the latest version. Staying up-to-date with these versions ensures that your project benefits from the latest features, improvements, and bug fixes. It's always recommended to use the most recent stable version available for better performance and enhanced security.

plugins {
    /* ... */
    id 'kotlin-android'
}

    dependencies {
        /* ... */
        api("com.nimmsta.lighttag:lighttag-android:1.0.+@aar") {
            transitive = true
            changing = true
        }
    }

plugins {
    /* ... */
    id("kotlin-android")
}

    dependencies {
        api("com.nimmsta.lighttag:lighttag-android:1.0.+@aar") {
            isTransitive = true
            isChanging = true
        }
    }