IMPORTANT NOTICE

During the next period of time, the Thecus Wiki will migrate to a new site - the NAS Website. The migration is part of an improvement initiative, which includes giving the site a new look and making it more user friendly.

During the migration information may exist both at the old and new site, however slowly pages should start to be located mainly at the new site. Please see the NAS Website for details.

N2100 Module Development

From Thecus Wiki

Jump to: navigation, search

Contents

[edit]

General

Many people contact me on email asking how to make modules. Well, basically it's not too difficult, but it requires a little knowledge of Linux.

This page gives some outlines on how to develop new modules. It is not yet very comprehensive, so please update it where needed!

[edit]

Module Contents and Structure

First of all, download a few modules off this site, eg. the SSH module, which is quite simple, and the P2P-BT which is a little more advanced.

Uncompress the .mod file of the module (they are really tar.gz) using your favourite decompression tool. On Linux it's something like "tar -xvzf SSH.mod"

Investigate the following files to get an idea of the module structure:

  • /Configure/install.rdf
  • /Shell/install.sh
  • /Shell/uninstall.sh
  • /Shell/module.rc
  • /Shell/enable.sh
  • /WWW/index.htm

You can also take a look at this PDF document that describes how to create modules.

[edit]

Creating the Module

We need to compress the structure into a module. Assuming that the module has the name TESTMOD and is located in /tmp/TESTMOD, do like this (on Linux with GNU tar/gzip): 

cd /tmp
tar -cvzf TESTMOD.mod ./TESTMOD

Please pay close attention to the "./" in front of the module directory. This is extremly important as the module will not otherwise install correctly. (Basically I don't know why Thecus made it like this, it doesn't seem too bright. But hey, there might be some explanation I don't know about).

Furthermore it is highly recommended to put the module inside another archive. Assuming the module is verion 1.0.00 and targets the Thecus N2100 

tar -cvzf N2100-TESTMOD-1.0.00.tar.gz TESTMOD.mod

It is recommended also to include a README file as well as a CHANGELOG. For more info have a look at the Module Packaging page.

[edit]

Testing the module

Please test the module thoroughly. If you are having problems and your module database gets corrupted, have a look at the N2100 Fixing Module problems page.

[edit]

Publishing

Upload the module to your website. If you don't have a website you may contact the ThecusWiki Admins and they can place it on this site.

Afterwards publish the new module using the Module Template and afterwards place a link on the Module List.

[edit]

Getting binaries for your modules

The current version (2.1.01) of the Thecus N2100 firmware is compatible with the "woody" Debian distributions so you can find packages on http://archive.debian.org/debian-archive/pool/main Make sure you choose the ARM architecture.

Retrieved from "http://onbeat.dk/thecus/index.php/N2100_Module_Development"
Personal tools
product resources