sl500_api

SL500 Card Reader API

The sl500_api package provides a Go-based interface for interacting with the SL500 card reader, allowing applications to communicate with the reader via serial connections. This package includes functions for initializing, configuring, and controlling the SL500, as well as reading and writing data on compatible RFID cards.

Features

• Initialize and manage serial connections with SL500.
• Control the reader's antenna, LED, and buzzer.
• RFID card operations, including reading, writing, and authentication.
• Compatibility with MIFARE and ISO15693 tags.

Installation

To include sl500_api in your project, use:

go get github.com/your_username/sl500_api

Usage

Initializing a Connection

To start, create a new connection to the SL500 card reader using the NewConnection function. Specify the serial port path, baud rate, logging option, and timeout.

package main

import (
    "fmt"
    "time"
    "github.com/ft-t/sl500-api"
)

func main() {
    // Initialize SL500 with the appropriate serial port path, baud rate, logging, and timeout
    reader, err := sl500_api.NewConnection("/dev/ttyUSB0", sl500_api.Baud.Baud9600, true, 3*time.Second)
    if err != nil {
        fmt.Println("Error initializing SL500:", err)
        return
    }
    defer reader.Close()
}

Basic Commands

Below are some primary commands for controlling the SL500:

• Open and Close Connection

  err := reader.Open()      // Opens the serial connection
  err = reader.Close()      // Closes the connection
  

• Antenna Control

  reader.RfAntennaSta(sl500_api.AntennaOn)    // Turn antenna on
  reader.RfAntennaSta(sl500_api.AntennaOff)   // Turn antenna off
  

• RFID Card Commands

  reader.RfRequest(sl500_api.RequestAll)     // Scan for all cards
  reader.RfAnticoll()                        // Anti-collision function
  

• MIFARE Operations

  blockNumber := byte(4)
  data, _ := reader.RfM1Read(blockNumber)    // Read data from block
  fmt.Printf("Data: %x\n", data)
  
  writeData := []byte{0x01, 0x02, 0x03, 0x04}
  reader.RfM1Write(blockNumber, writeData)   // Write data to block
  

Advanced Commands

Setting Device Type

reader.RfInitType(sl500_api.Type_A)

Enabling Beep and LED Light

reader.RfBeep(100)                        // Beep for 100 milliseconds
reader.RfLight(sl500_api.ColorGreen)      // Set LED to green

Error Handling

Each function returns an error object; check this for successful execution. Example:

if err := reader.RfAntennaSta(sl500_api.AntennaOn); err != nil {
    fmt.Println("Antenna error:", err)
}

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Feel free to submit a pull request or open an issue for feedback or feature requests.