thodg/cgminer/ASIC-README

• Show log

  Commit

• Hash : 4c9f2b74
  Author :
  Date : 2013-04-28T19:24:57
  

  Add an ASIC README file and udev rules file for insertion of BFL devices on linux.

Download

• ASIC-README

• SUPPORTED DEVICES
  
  Currently supported devices include the Avalon and the Butterfly Labs SC range
  of devices. The BFL devices should come up as one of the following:
  
  BAJ: BFL ASIC Jalapeño
  BAL: BFL ASIC Little Single
  BAS: BFL ASIC Single
  BAM: BFL ASIC Minirig
  
  
  GETTING STARTED WITH BUTTERFLY LABS ASICS
  
  Unlike other software, cgminer uses direct USB communication instead of the
  ancient serial USB communication to be much faster, more reliable and use a
  lot less CPU. For this reason, setting up for mining with cgminer on these
  devices requires different drivers.
  
  
  WINDOWS:
  
  On windows, the direct USB support requires the installation of a WinUSB
  driver (NOT the ftdi_sio driver), and attach it to the Butterfly labs device.
  The easiest way to do this is to use the zadig utility which will install the
  drivers for you and then once you plug in your device you can choose the
  "list all devices" from the "option" menu and you should be able to see the
  device as something like: "BitFORCE SHA256 SC". Choose the install or replace
  driver option and select WinUSB. You can either google for zadig or download
  it from the cgminer directoy in the DOWNLOADS link above.
  
  
  LINUX:
  
  On linux, the direct USB support requires no drivers at all. However due to
  permissions issues, you may not be able to mine directly on the devices as a
  regular user without giving the user access to the device or by mining as
  root (administrator). In order to give your regular user access, you can make
  him a member of the plugdev group with the following commands:
  
   sudo usermod -G plugdev -a `whoami`
  
  If your distribution does not have the plugdev group you can create it with:
  
   sudo groupadd plugdev
  
  In order for the BFL devices to instantly be owned by the plugdev group and
  accessible by anyone from the plugdev group you can either copy the file
  "01-cgminer.rules" from the cgminer archive into the /etc/udev/rules.d
  directory with the following command:
  
   sudo cp 01-cgminer.rules /etc/udev/rules.d/
  
  Or you can manually create a file/add to a rules.d file with following rules
  (most users won't want to do this manually):
  ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6014", SUBSYSTEMS=="usb", ACTION=="add", MODE="0666", GROUP="plugdev"
  ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0003", SUBSYSTEMS=="usb", ACTION=="add", MODE="0666", GROUP="plugdev"
  
  After this you can either manually restart udev and re-login, or more easily
  just reboot.
  
  
  AVALON DEVICES
  
  Currently all known Avalon devices come with their own operating system and
  a preinstalled version of cgminer as part of the flash firmware, based on the
  most current cgminer version so no configuration should be necessary. It is
  possible to plug a USB cable from a PC into the Avalon device and use the
  --avalon-options copying the command as used by the internal router used by the
  Avalon. However since the Avalon code still currently uses the old serial usb
  interface and is being rewritten to use direct USB, it is prudent to not be
  dependent on this command long term, assuming it will go away.
  
  ---
  
  This code is provided entirely free of charge by the programmer in his spare
  time so donations would be greatly appreciated. Please consider donating to the
  address below.
  
  Con Kolivas <kernel@kolivas.org>
  15qSxP1SQcUX3o4nhkfdbgyoWEFMomJ4rZ
  

Download