Installing CGminer on DD-WRT

http://ck.kolivas.org/apps/cgminer/
CGMiner documentation located in CGMINER_DOCS directory.

Note: Installing CGminer on a router is a non-trivial task!
      This assumes some linux and maybe some embedded systems knowlege.
      Some of the scripts may need tweaking to your specific system.


YOU WILL NEED:

A broadcom based DD-WRT compatable USB capable router such as Asus RT-N16 or Linksys E3000
USB storage >1Gb (Thumb drive / external HDD)


DD-WRT INSTALLATION:

Install DD-WRT according you your routers wiki at:

http://www.dd-wrt.com/site/support/router-database
*note: Do not use the build suggested in the database, read the wiki for the most stable version.
       It's very important to fully understand the steps, both the choice of the build, and how it's
       installed can be quite complicated. We don't want to see bricked routers.

Install optware according to the wiki:
http://www.dd-wrt.com/wiki/index.php/Optware%2C_the_Right_Way
OTRW2 will also work:
http://www.dd-wrt.com/phpBB2/viewtopic.php?t=156013

Also check out the other tutorials which may be useful to you (such as OpenVPN / samba server etc):
http://www.dd-wrt.com/wiki/index.php/Tutorials

CGMINER INSTALLATION:

Unpack the mipsel CGminer package.
(Suggest you copy the .tar.gz to the router and untar it there)

For all:
Copy cgminer scripts to     /opt/etc/init.d              (cgminer.sh, S99cgminer)
Copy cgminer executable to  /opt/bin                     (cgminer)
Copy cgminer.conf to        /opt/etc                     Edit according to your setup. See CGminer documentation.
Copy libusb-1.0 files to    /opt/lib                     Rename the originals (if any)

For BFL, Icarus and Mod Miner Quad:
Copy serial script to       /opt/etc/init.d              (S45serialmodules)
Copy ftdi_sio.ko to         /opt/lib/modules/2.6.24.111  Rename existing file

Enable the USB serial drivers, type:
> service serialmodules on
> service serialmodules start

The devices should now be recognised as a serial device. To check, type:
> ls -l /dev/usb/tts

This will list all the USB serial ports detected.

For Ztex and Mod Miner Quad:
Create the bitstreams dir and copy bitstream files to    /opt/bin/bitstreams

For all:
Log into the router via Telnet/SSH

Install the app 'screen', type:
>ipkg-opt install screen

Make sure all the scripts and cgminer are executable:
> chmod +x /opt/bin/cgminer
> chmod +x /opt/etc/init.d/cgminer.sh
etc...


LAUNCHING CGMINER:

Now start cgminer, type:
> service cgminer on
> service cgminer start

Your devices should now be mining.
To check look at the log file, type:
> ls -l /opt/var/log
to find latest logfile, then view it with:
> tail -f /opt/var/log/YYYYMMDD-HHMMSS.<PID>.log

This should show only a few items, such as startup information, long polls, stale shares and errors/warnings.

To monitor CGminer, you'll need to use the RPC API and a remote front-end such as Anubis.
https://github.com/pshep/ANUBIS

You can also see the current feed by connecting to 'screen', type:
> screen -r

This will update every few seconds, scrolling the totals, and each device status/hashrate/temp etc
Note: Do NOT press Ctrl-c or Ctrl-q to exit the screen, this will terminate CGminer.
      To exit screen and leave CGminer running, press 'Ctrl-A' then 'd'




*CGminer is compiled with optware's compiler with the following options:

--disable-opencl --disable-adl --without-curses --without-libudev --enable-bitforce --enable-icarus --enable-ztex --enable-modminer
CFLAGS="-O2 -march=mips32r2 -mtune=4kc -D_GNU_SOURCE"

Optware compiler available at:

http://www.nslu2-linux.org/wiki/FAQ/Optware-uClibcBuild
See section: 'And what if the program I need is not available in the existing packages?'


Created by p_shep
Donations: 1Fxpijq1NN52LzSzD2WtGbT3ZTWq366ejj