PHPackages                             ocolin/tachyon-lite - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. ocolin/tachyon-lite

ActiveLibrary[HTTP & Networking](/categories/http)

ocolin/tachyon-lite
===================

HTTP client for Tachyon Networks devices running 8devices firmware, providing MAC table and status data without a dedicated API

v1.0.0(1mo ago)02↓100%MITPHPPHP ^8.4

Since May 1Pushed 1mo agoCompare

[ Source](https://github.com/ocolin/TachyonLite)[ Packagist](https://packagist.org/packages/ocolin/tachyon-lite)[ Docs](https://github.com/ocolin/tachyon-lite)[ RSS](/packages/ocolin-tachyon-lite/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (5)Versions (2)Used By (0)

TachyonLite
===========

[](#tachyonlite)

A PHP HTTP client for Tachyon Networks devices running 8devices firmware. Provides access to MAC table and device status data on models that lack a dedicated API, such as the TNS-100.

Tachyon Networks offers a dedicated API on their higher-end devices. TachyonLite is designed for models where that API is unavailable, providing equivalent read access to MAC table and status data through the device's web interface.

Compatible Devices
------------------

[](#compatible-devices)

This client communicates with the web interface of devices running 8devices firmware. It has been tested against the **Tachyon Networks TNS-100**. Other devices running 8devices firmware may also be compatible.

Requirements
------------

[](#requirements)

- PHP 8.4+
- Guzzle 7.10+
- ocolin/global-type 2.0+

Installation
------------

[](#installation)

```
composer require ocolin/tachyon-lite
```

Configuration
-------------

[](#configuration)

Configuration can be provided directly or via environment variables. Direct arguments take priority over environment variables.

### Via Constructor

[](#via-constructor)

```
use Ocolin\TachyonLite\Config;
use Ocolin\TachyonLite\TachyonLite;

$client = new TachyonLite( config: new Config(
    host:     '10.0.0.1',
    username: 'admin',
    password: 'secret',
));
```

### Via Environment Variables

[](#via-environment-variables)

```
TACHYON_LITE_HOST=10.0.0.1
TACHYON_LITE_USERNAME=admin
TACHYON_LITE_PASSWORD=secret
TACHYON_LITE_SSL=true
TACHYON_LITE_HTTP_PORT=80
TACHYON_LITE_HTTPS_PORT=443
```

When environment variables are set, no arguments are needed:

```
$client = new TachyonLite();
```

### Config Options

[](#config-options)

ParameterTypeDefaultENV VariableDescriptionhoststring—TACHYON\_LITE\_HOSTIP address or hostnameusernamestring—TACHYON\_LITE\_USERNAMELogin usernamepasswordstring—TACHYON\_LITE\_PASSWORDLogin passwordsslbooltrueTACHYON\_LITE\_SSLUse HTTPShttpPortint80TACHYON\_LITE\_HTTP\_PORTHTTP porthttpsPortint443TACHYON\_LITE\_HTTPS\_PORTHTTPS portoptionsarray\[\]—Additional Guzzle optionsUsage
-----

[](#usage)

### MAC Table

[](#mac-table)

Returns an array of `MacEntry` objects representing the device's MAC forwarding table.

```
$entries = $client->getMacTable();

foreach( $entries as $entry ) {
    echo $entry->mac       . PHP_EOL; // f4:1e:57:8f:58:6a
    echo $entry->interface . PHP_EOL; // eth5
    echo $entry->vlan      . PHP_EOL; // 1
    echo $entry->bridge    . PHP_EOL; // br-wan
    echo $entry->offload   . PHP_EOL; // true
}
```

#### MacEntry Properties

[](#macentry-properties)

PropertyTypeDescriptionmacstringMAC addressinterfacestringNetwork interface (e.g. eth1, eth5)vlanintVLAN ID, 0 if not presentbridgestringBridge name, empty if not presentoffloadboolWhether hardware offload is active### Device Status

[](#device-status)

Returns a `Status` object containing device information. All properties are raw decoded JSON objects.

```
$status = $client->getStatus();

echo $status->system->model;      // TNS-100
echo $status->system->fw_version; // 1.0.0
echo $status->network->hostname;  // my-device
```

By default all available types are returned. You can request specific types:

```
$status = $client->getStatus( types: ['system', 'network'] );
```

#### Available Status Types

[](#available-status-types)

TypeDescriptionsystemModel, serial number, firmware, CPU, memorynetworkHostname, DNS, DHCP, zone/IP informationinterfacesPer-interface details including port descriptionsethernetEthernet port statistics (hardware dependent)Exceptions
----------

[](#exceptions)

ExceptionDescriptionConfigExceptionRequired configuration missingAuthExceptionAuthentication failedTachyonLiteExceptionUnexpected response from deviceGuzzleExceptionHTTP transport errorLicense
-------

[](#license)

MIT

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance92

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

39d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e97ac0aa452b872ddc3f7f4c56c83852574a27bb74622f8c054d11ca20008fc9?d=identicon)[Ocolin](/maintainers/Ocolin)

---

Tags

routernetworkmac-tabletachyon8devices

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ocolin-tachyon-lite/health.svg)

```
[![Health](https://phpackages.com/badges/ocolin-tachyon-lite/health.svg)](https://phpackages.com/packages/ocolin-tachyon-lite)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

1.9k496.1k32](/packages/neuron-core-neuron-ai)[illuminate/http

The Illuminate Http package.

13137.2M6.4k](/packages/illuminate-http)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3751.2M45](/packages/tencentcloud-tencentcloud-sdk-php)[dreamfactory/df-core

DreamFactory(tm) Core Components

1652.0k38](/packages/dreamfactory-df-core)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

232.5k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)