https://github.com/cslrfid/cs710s-android

https://github.com/cslrfid/cs710s-android

Last synced: 17 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/cslrfid/cs710s-android
• Owner: cslrfid
• License: mit
• Created: 2026-05-22T06:08:35.000Z (26 days ago)
• Default Branch: main
• Last Pushed: 2026-05-24T22:21:56.000Z (23 days ago)
• Last Synced: 2026-05-25T00:24:35.537Z (23 days ago)
• Language: Java
• Size: 323 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# CS710S-Android — JitPack Library Distribution

[![Platform](https://img.shields.io/badge/platform-Android-3DDC84?logo=android&logoColor=white)](https://www.android.com/)

[![Language](https://img.shields.io/badge/language-Java-007396?logo=openjdk&logoColor=white)](https://www.java.com/)

[![License](https://img.shields.io/github/license/cslrfid/cs710s-android)](LICENSE)

[![Release](https://img.shields.io/github/v/tag/cslrfid/cs710s-android?label=release&sort=semver)](https://github.com/cslrfid/cs710s-android/tags)

[![JitPack](https://jitpack.io/v/cslrfid/cs710s-android.svg)](https://jitpack.io/#cslrfid/cs710s-android)

This repository publishes three Android libraries for the CS710S/CS108 RFID readers via [JitPack](https://jitpack.io), plus a quick-start demo app you can build locally.

[Product information](https://www.convergence.com.hk/cs710s/)

## Published libraries

| Library | JitPack coordinate | Purpose |

|---|---|---|

| `csl-rfid-android-sdk` | `com.github.cslrfid.cs710s-android:csl-rfid-android-sdk:{TAG}` | Callback-based wrapper SDK — recommended entry point |

| `cslibrary4a` | `com.github.cslrfid.cs710s-android:cslibrary4a:{TAG}` | Core BLE/USB protocol and reader-chip drivers |

| `epctagcoder` | `com.github.cslrfid.cs710s-android:epctagcoder:{TAG}` | EPC tag encode/decode utility |

Dependency chain: `csl-rfid-android-sdk` → `cslibrary4a` → `epctagcoder`. Depending on any one library pulls in its transitive deps automatically.

## Consuming the libraries

**`settings.gradle`** (Gradle 7+):

```groovy

dependencyResolutionManagement {

    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)

    repositories {

        google()

        mavenCentral()

        maven { url 'https://jitpack.io' }

    }

}

```

**`app/build.gradle`**:

```groovy

dependencies {

    // Recommended: wrapper SDK — transitively brings in cslibrary4a and epctagcoder

    implementation 'com.github.cslrfid.cs710s-android:csl-rfid-android-sdk:1.0.0'

    // Or, core SDK only (no wrapper) — still brings in epctagcoder

    // implementation 'com.github.cslrfid.cs710s-android:cslibrary4a:1.0.0'

}

```

## Demo app — `cs710aquickstart`

![CS710S QuickStart screens](images/cs710s-android.png)

A minimal Android demo (MVVM, ViewModel-based) that exercises BLE scan, connect, inventory, Geiger search, battery monitoring, and hardware-trigger support against the wrapper SDK.

```bash

./gradlew :cs710aquickstart:assembleDebug          # Debug APK

./gradlew :cs710aquickstart:installDebug           # Install to a connected device

```

See `cs710aquickstart/README.md` for the full walkthrough.

## Prerequisites for local development

- Android Studio

- Android SDK API Level 36 (compileSdk/targetSdk), minSdk 26

- JDK 17

- macOS / Linux / Windows