Atsign OpenWRT packages

This repo contains the source code to build packages for OpenWRT, a Linux operating system targeting embedded devices.

OpenWRT is very popular with device manufacturers, and we want to make it easy to run our stuff there.

Packages

csshnpd

This package contains our C NoPorts daemon

Installing csshnpd

Once an .ipk file has been created (e.g. csshnpd_0.2.0-1_x86_64.ipk) it should be copied to the target OpenWRT system and installed with opkg:

opkg install csshnpd_0.2.0-1_x86_64.ipk

NB that command line will vary according to version and platform architecture.

Configuring sshnpd

The config is held in /etc/config/sshnpd

Use your favourite editor to set atsign, manager and device to the atSigns and name you wish to use.

enabled needs to be changed to 1

Getting atSign keys in place

sshnpd expect to find keys in $HOME/.atsign/keys. For now keys need to be activated elsewhere and copied into an @atsign__key.atKeys file (where atsign is replaced with the atSign being used for the device).

Starting the daemon

Run:

/etc/init.d/sshnpd start

luci-app-csshnpd

This is a LuCI app that can be used to configure sshnpd without editing /etc/config/sshnpd at the command line

Installing luci-app-csshnpd

Once an .ipk file has been created (e.g. luci-app-csshnpd_24.294.58918.40ad298_all.ipk) it should be copied to the target OpenWRT system and installed with opkg:

opkg install luci-app-csshnpd_24.294.58918.40ad298_all.ipk

Using luci-app-csshnpd

Once installed there will be a NoPorts menu item under Network:

Clicking that brings up the sshnpd config form:

Fill out the atSigns and device name, then click the enable button.

To start the daemon for the first time go to System->Startup then press the Start button beside sshnpd.

Development Environment Setup

Please start by setting up an OpenWRT toolchain following the steps in their Developer guide

If you've got past "Hello World!" for OpenWRT then you're ready to use this.

Using this repo as a feed

First clone this repo from GitHub.

Then create a feeds.conf in the root of the OpenWRT build tree e.g.:

src-link atsign /home/chris/git/github.com/atsign-foundation/Atsign_OpenWRT_packages/packages

You'll need to change /home/chris/git/github.com/atsign-foundation/ to wherever you cloned this repo.

Old packages

python packages

We previously packaged the Python3 atSDK and sshnpd in:

• lang/python/python-atsdk
• lang/python/python-sshnpd

These have been removed to prevent conflicts with older build tool chains. The branch python3-packages holds those packages as they were.

Contributor

If you'd like to add, modify or improve what's here then please take a look at CONTRIBUTING.md for detailed guidance on how to make a pull request.

Maintainers

Created by @cpswan