Bitcoin Wiki - User contributions [en]

Avalon6

2016-07-31T09:18:40Z

Johnson-Fan: /* Modify dfu-util For Ubuntu 14.04 */

= Basic Information =
Hashrate: 3.5Ths ± 5%
Power Consumption: ≈ 1050 Watt (with assumption of 90% power conversion ratio)
Overclocking: Support automatically optimizes frequency, no need to overclock manually.
PSU ouput pin: 4 x 6PIN PCIe power connector.
Controller: Raspberry Pi (version B or B+) Raspberry Pi 2 is not supported yet.
AUC: Each AUC can connect up to 6 devices.
Dimensions: 340 mm x 136 mm x 150 mm
Operating Temperature: -10 °C to 38°C
Fan Specs: 12038, Current less then 2.4A
Protection Degree: IP20
Net weight: 4.8kg
Gross weight: 5kg

== Pictures ==
=== Control board ===
[[File: AvalonMiner6_CTRL.png | none | 640 px]]
* NC means not connect

=== Fan & Temp control algorithm ===
* RPi firmware 20160530
[[File:Avalon6 fan adj 601605-256e0f00.png | none | 640px]]
* RPi firmware 20160125
[[File:Avalon6 fan adj 601601-5d8a1270.png | none | 640px]]

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== IIC ==
[[File:IIC_Link_Avalon6.png]]

== MM Error Codes ==
'''[https://canaan.io/downloads/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|- valign="top"
| 65536
| CODE_LOCK
| FATAL
| MM is not permit to run without decrypt
| Ask service for help
|- valign="top"
| 131072
| CODE_HOTBEFORE
| WARN
| Toohot is found on MM
| It's just a note on toohot
|- valign="top"
| 262144
| CODE_APIFIFOOVERFLOW
| WARN
| API fifo overflow flag
| It's just a note on api fifo
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [https://canaan.io/downloads/software/avalon6/openwrt/20160726/ 20160726] ===
* Support Raspberry Pi 3 Model B
* Sync with OpenWrt master branch (cac971da)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20160530/ 20160530] ===
* CGMiner:Add more options to optimize hashrate when toohot occus.
* CGMiner:Support AV4 miner detect through iic
* CGMiner:Double check data size when use avalon4_auc_xfer
* CGMiner:Update adjust_fan to avoid fan overshoot, Thanks to ckolivas
* CGMiner:Update default target temperature for AvalonMiner 6.(68℃ to 65℃)
* CGMiner:Support 6 machines maximum on a AUC

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20160125/ 20160125] ===
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option (mode 3), and change it to default.
* Update mm count when scan hash

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* Notice: Only for testing purpose

== MM Firmware ==
=== [https://canaan.io/downloads/software/avalon6/mm/2016-07-15/ 2016-07-15] ===
* Version: '''601607-2a78bc90'''
* Fix: 50% off hash rate bug

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2016-05-11/ 2016-05-11] ===
* Version: '''601605-256e0f00'''
* The minimum stratum pool difficulty should >= 32 for better performance
* Check api fifo overflow
* Add CODE_HOTBEFORE for hot notify
* Add a new package AVA4_P_SET_FREQ
* Support device hardware error
* Fix duplicate share
* Move stratum file to a lib
* Update temp check

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2016-01-25/ 2016-01-25] ===
* Version '''601601-5d8a1270'''
* Add mm package header verify
* Update pll couter for separate module
* Update iic address free mechanism
* Update fan rpm detect
* Fix duplicate address during detect
* Fix freq setting lost cause by mm was toot

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* Notice: Only for testing purpose

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
* Download & Compile
# git clone https://github.com/Canaan-Creative/cgminer
# cd cgminer
# git checkout origin/avalon4 -b avalon4
# ./autogen.sh --enable-avalon4
# make -j 4

* Run
# Run with AUC
#;sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
#;or
#;sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log
#;
# Run with AUC and IIC interface
#;sudo ./cgminer --avalon4-iic-detect --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
#;or
#;sudo ./cgminer --avalon4-iic-detect --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./logA

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

cd dfu-util

wget https://raw.githubusercontent.com/Johnson-Fan/Avalon-USB-converter/master/patches/001-add-milli_sleep.patch

patch -p0 < 001-add-milli_sleep.patch

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===
==== Modify The AUC2 Firmware Flash And RAM Address ====
1. We modify the Flash start address at 0x4000, because the bootloader's size is 0x4000. 
2. We modify the RAM start address at 0x10000200, because we remap the NVIC table at the RAM 0x10000000,
and the NVIC table size is 0x200 bytes. 
3. We modify the *.ld file. And my *.ld file is avalon-usb-converter.ld, you can find your *.ld file.
:{|class="wikitable" border="1"
|-
! <big>Before Modification</big>
! <big>After Modification</big>
|-
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x0, LENGTH = 0x8000 /* 32K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000000, LENGTH = 0x1000 /* 4K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x0 + 0x8000;
__top_RamLoc4 = 0x1000000 + 0x1000;
__top_RamUsb2 = 0x20004000 + 0x800;
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x4000, LENGTH = 0x4000 /* 16K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000200, LENGTH = 0xe00 /* 3.5K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x4000 + 0x4000;
__top_RamLoc4 = 0x10000200 + 0xe00;
__top_RamUsb2 = 0x20004000 + 0x800;
|}

==== Remap The NVIC Table ====
1. Add Under Function Code In Your Program.

/* copy the nvic table to ram */
static void copy_nvic_to_ram(void)
{
volatile uint32_t *dst, size;
volatile const uint32_t *src; 
src = (volatile uint32_t *)APP_START_ADDR;//APP_START_ADDR Is The Application Program's Start Address.
dst = (volatile uint32_t *)RAM_START_ADDR;//RAM_START_ADDR Is The RAM Start Address.
size = NVIC_TABLE_LEN >> 2;//NVIC_TABLE_LEN Is The NVIC Table's Size.
do {
*dst++ = *src++;
} while (--size); 
/* NVIC remap to RAM */
Chip_SYSCTL_Map(0x01); 
}

2. Config The Register To Remap NVIC Table To RAM
:[[File:LPC11u14 NVIC Table Remap1.png | none | 640px ]]
<big><big>More See UM10462 LPC11U3x/2x/1x User manual,At The Page 22.</big></big>

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
# Upgrade OpenWrt branch to master
# Commit cgminer package for OpenWrt packages

=== CGMiner ===

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]
3. AUC always appear and then disappear in CGMiner status ?
It maybe damaged. Take a new one instead.

Avalon nano

2016-06-17T00:14:49Z

Johnson-Fan: /* LPCXpresso */

It's a usb dongle, using only one A3233.

== Hardware version 1.0 ==
=== Features ===
* VID/PID: 0x1FC9/0x0083
* Icarus protocol support
* It use USB CDC, without need driver installation under Linux
* Smart [[#LED|LED]] indicator
* Overheating protection. (>= 65℃)
* Adjust the hashrate automatically by temperature (~1.0GH/s - ~3.6GH/s)

Note: You may need install driver for windows before usage. Please down it here <ref>http://www.lpcware.com/system/files/lpcopen_examples_windows_usb_drivers_v1_10_0.zip</ref>

=== Software ===
It can support CGMiner, BFGMiner and AvalonMiner(Based on BFGMiner) for now.
==== CGMiner Under Ubuntu 14.04 ====
* Download / Compile / Run
'''Download'''
Inside your home directory, download CGMiner
git clone https://github.com/Canaan-Creative/cgminer

'''Compile'''
cd cgminer
git checkout origin/avalon-usb -b avalon-usb
./autogen.sh --enable-icarus
make -j 4

'''Run'''
sudo ./cgminer --icarus-options 115200:1:1 --icarus-timing 0.22 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --icarus-options 115200:1:1 --icarus-timing 0.22 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2.1 --api-listen $@ 2>./log

* Patches
Patch for Canaan Creative's CGMiner: [http://downloads.canaan-creative.com/software/avalon_nano/patches/001-avalon3-nano.patch 001-avalon3-nano.patch]
For what: CGMiner patch.
From where: Based c5ec1171@https://github.com/Canaan-Creative/cgminer/tree/avalon2
Comments:
Support avalon3 nano in cgminer.
Support Icarus protocol.

==== BFGMiner ====
* Run
'''Run under Linux'''
./bfgminer \
-S ICA:/dev/ttyACMx \
-o stratum+tcp://stratum.ozco.in:80 -O mikeqin.avalon:1234 \
--set-device ICA:baud=115200 \
--set-device ICA:reopen=timeout \
--set-device ICA:work_division=1 \
--set-device ICA:fpga_count=1 \
--set-device ICA:probe_timeout=100 \
--set-device ICA:timing=0.22 \
--api-listen \
2>log

'''Run under Windows'''
bfgminer.exe ^
-S ICA:\\.\COMn ^
-o stratum+tcp://stratum.ozco.in:80 -O mikeqin.avalon:1234 ^
--set-device ICA:baud=115200 ^
--set-device ICA:reopen=timeout ^
--set-device ICA:work_division=1 ^
--set-device ICA:fpga_count=1 ^
--set-device ICA:probe_timeout=100 ^
--set-device ICA:timing=0.22 ^
--api-listen ^
2>log

Note: See the details about the timing in README. It works ~4GH/s(400 * 11.8) at 400MHz.
timing = (1 / (4 * 10 ** 9)) * 10 ** 9 (python format)

* MHS Cur calculation
MHS Cur = Diff1 Work * (Difficulty Accepted / (Difficulty Accepted + Difficulty Rejected + Difficulty Stale)) * 60/ Elapsed * 71582788 / 1000000
Note：
1.if Difficulty Accepted + Difficulty Rejected + Difficulty Stale = 0, then Difficulty Accepted / (Difficulty Accepted + Difficulty Rejected + Difficulty Stale) = 1.
2.Get all the infomation through ./bfgminer-rpc -o summary

* BFGMiner release from luck.dashjr
http://luke.dashjr.org/programs/bitcoin/files/bfgminer/

==== AvalonMiner ====
It is developed under Windows with Chinese UI only, You can import the solution and crack it by yourself. It is distributed under UNLICENSE.Source code can be download here: <ref>https://github.com/Canaan-Creative/Avalon-nano/tree/master/gui_1.0</ref>

===== Release =====
[http://downloads.canaan-creative.com/software/avalon_nano/software/20140911/ 20140911]
* Avalon3 nano windows miner(20140911)
* Beautifull GUI
* Auto detect Avalon nano

[http://downloads.canaan-creative.com/software/avalon_nano/software/20140803/ 20140803]
* Avalon3 nano windows miner(20140803) first version
* Support bfgminer only
* Support icarus protocal

===== Run or Debug with CLI =====
# Copy BfgMiner to a safe place.
# Uninstall Avalon GUI Miner
# Modify the icadbg.cmd(under BfgMiner folder) with your correct com port.
# Double click icadbg.cmd.
Note: BFGMiner location: (C:\Program Files (x86)\Avalon Nano\BfgMiner)

=== Hardware ===
==== Schematics ====
* [http://downloads.canaan-creative.com/software/avalon_nano/doc/sch/Avalon_usb_sch.pdf Avalon-usb schematics]

==== LPC11U14 Spec ====
{| class='wikitable'
|-
| Type || Infomation
|-
| Processor || NXP's Cortex-M0 LPC11U14 microcontroller
|-
| Flash || 32 kB
|-
| Data Memory || 6 kB
|-
| Clock Crystals || 12.000 MHz crystal for CPU
|}

==== Clock ====
{| class='wikitable'
|-
| Type || Value
|-
| LPC11U14 (External) || 48.000 MHz
|-
| A3233 XCLK (From LPC11U14) || 24.000 MHz
|}

==== LED ====
{| class='wikitable'
|-
| Color || Memo
|-
| Green || Idle status
|-
| Red/Blue || Working (Frequency high -> low,led red -> blue)
|-
| Red blinking || Overheating
|}

==== Programmer ====
* SmartPro 5000U-Plus

==== SWD Debuger ====
LPC11U14 only support swd debug.
The debugger can also be used to program the LPC11U14 chip.
===== LPCXpresso =====
* Installation and Activation
LPCXpresso download link <ref>https://www.lpcware.com/lpcxpresso/download</ref>
Free Edition is enough. Then activate it. <ref>http://www.lpcware.com/lpcxpresso/activate</ref>

* LPC-Link diagnostics
Diagnostics when connecting to LPC-Link

1. lpc-link info
crt_emu_lpc11_13_nxp -info-emu -wire=winusb

2. target info
crt_emu_lpc11_13_nxp -info-target -pLPC11U14/201 -wire=winusb -4

3. burn and run axf file
crt_emu_lpc11_13_nxp -pLPC11U14/201 -wire=winusb -flash-load-exec nxp_lpcxpresso_11u14_periph_blinky.axf

4. info scan
crt_emu_lpc11_13_nxp -info-scan -wire=winusb

5. semi_host debug
use newlib semihost

* How to debug issues with gdb (Works on OSX)
Compile the souce with debug, then run gdb with the following commands:
1.arm-none-eabi-gdb avalon_nano.axf
2.target extended-remote | crt_emu_cm_redlink -g -2 -vendor=NXP -pLPC11U14/201 -flash-driver=LPC11_12_13_32K_4K.cfx
3.load

* How to debug issues with gdb (Works on Ubuntu14.04)
Compile the souce with debug, then run gdb with the following commands:
1.arm-none-eabi-gdb avalon_nano.axf
2.target extended-remote | crt_emu_lpc11_13_nxp -g -mi -2 -pLPC11U14/201 -vendor=NXP -e0 -wire=winUSB -flash-driver=LPC11_12_13_32K_4K.cfx
3.load

Then you can use gdb as you want

===== ULINK 2 =====
* Configure ULINK2 for LPCXpresso
1.Change boot mode to CMSIS-DAP
Use the [http://www.keil.com/support/man/docs/ulink2/ulink2_boot_mode.htm Boot Mode Utility] to change the mode like this: UL2_Configure B1.

2.Set jumper to 3.3V position
See [http://www.keil.com/support/man/docs/ulink2/ulink2_hw_jumpers.htm Jumpers]

3.Connect Avalon nano to ULINK2
Check [http://support.code-red-tech.com/CodeRedWiki/HardwareDebugConnections SWD Connector Pinout], need connect SCLK,SWIO,GND only.

=== Firmware ===
==== Reflash ====
* Avalon3 nano firmware burner <ref>http://downloads.canaan-creative.com/software/avalon_nano/burner</ref>

==== Release ====
[http://downloads.canaan-creative.com/software/avalon_nano/firmware/20140523/ 20140523]
* Avalon3 nano firmware(20140523-dd84b993)
* Support nonce receive timeout check
* Support adjust freq for 100Mhz to 360Mhz,freq value after reset is 360Mhz

[http://downloads.canaan-creative.com/software/avalon_nano/firmware/20140519/ 20140519]
* Avalon3 nano firmware(20140519-8c38877c):first version
* Avalon3 nano test scripts found here:[https://github.com/BitSyncom/avalon-extras/tree/master/scripts a3233_avalon_usb_testbench.sh]
* Support adjust freq for 360Mhz to 400Mhz,value after reset is 400Mhz
* Include avalon3 nano module test(avalon_bsp_testben)
* bfgminer(0676fa314a9cc1491ad2e5f5c6a5e97f38fa67e3),how to run:http://wiki.0xf8.com/index.php/Bfgminer

[http://downloads.canaan-creative.com/software/avalon_nano/firmware/nexttesting/ NEXT-TESTING]
* NOTICE: Only for testing
* Adjust LED color according to the temperature

=== Review ===
* https://bitcointalk.org/index.php?topic=1022764.0

=== Issues ===
* OpenOCD is not support ULINK2 (See src/jtag/drivers/ulink.c)

== Hardware version 2.0 ==
=== Features ===
* VID/PID: 0x29F1/0x33F3
* [https://github.com/Canaan-Creative/MM/blob/avalon4/firmware/doc/protocol.md MM protocol] support
* It use HID CDC, without need driver installation.
* Smart [[#LED|LED]] indicator
* Overheating protection. (>= 65℃)
* Adjust the hashrate automatically by temperature (~1.0GH/s - ~3.6GH/s)
* Current：0.018A ~ 0.917A
* Voltage：4.97V ~ 5.179V

=== Software ===
It can support Avalon miner, CGMiner for now.
==== Avalon miner ====
The easiest way to mining.
# [https://chrome.google.com/webstore/detail/avalon-miner/odlgkocclgbbahkiajhldmlbmefpcjnc?hl=en-US Install from chrome web store]
# [http://downloads.canaan-creative.com/software/avalon_nano2/app/Avalon_miner_latest.crx Install from local crx]

==== CGMiner Under Ubuntu 14.04 ====
* Download / Compile / Run
'''Download'''
Inside your home directory, download CGMiner
git clone https://github.com/Canaan-Creative/cgminer

'''Compile'''
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon-miner
make -j 4

'''Run'''
sudo ./cgminer -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2.1 --api-listen $@ 2>./log

=== [https://en.bitcoin.it/wiki/Avalon_nano#Hardware Hardware] ===
=== Firmware ===
==== Release ====
[http://build.canaan-creative.com:8080/~mikeqin/avalonnano2/ Daily Building]

[http://downloads.canaan-creative.com/software/avalon_nano2/firmware/2015-08-25/ 2015-08-25]
* Avalon nano 2.0 firmware (3U1505-4481b7e0): first version

== References ==
<references />

== Links ==
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]
* Baremetal programming
** http://eleceng.dit.ie/frank/arm/BareMetalLPC1114/index.html
** http://eewiki.net/display/microcontroller/Getting+Started+with+NXP%27s+LPC11XX+Cortex-M0+ARM+Microcontrollers
** http://tech.munts.com/MCU/Frameworks/RaspberryPi/expansion/LPC1114/
* ULINK2
** [http://www.keil.com/support/docs/3632.htm ULINK: How to downgrade the firmware of ULINK2/ME]
** [http://www.keil.com/support/man/docs/ulink2/ulink2_fw_upgrade.htm Firmware Upgrade Utility]
** [http://www.keil.com/support/man/docs/ulink2/ulink2_trblsh_hwcheck.htm Hardware Checklist]
** [http://www.keil.com/support/man/docs/uv4/uv4_cl_programflash.htm Program Flash Example]
* LPC-Link
** [http://www.support.code-red-tech.com/CodeRedWiki/BootingLPCLink?highlight=%28dfu%5C-util%29 Booting LPC-Link]
** [http://www.support.code-red-tech.com/CodeRedWiki/LPCLinkDiagnostics?highlight=%28dfu%5C-util%29 Diagnostics when connecting to LPC-Link]
* [http://www.keil.com/support/man/docs/dapdebug/dapdebug_introduction.htm About CMSIS-DAP]
* [http://www.lpcware.com/content/nxpfile/an11321-porting-cmsis-dap-debugger-cortex-m0-platform Porting the CMSIS-DAP debugger to the Cortex-M0 platform]
* [http://microcontrollershop.com/product_info.php?products_id=4838 LPC11U14 ARM Cortex-M0 Board]
* [http://www.lpcware.com/content/blog/application-programming-iap-code-example In-Application Programming (IAP) Code Example]
* Software for flashing / upgrading firmware
** [http://www.lpcware.com/lpcxpresso/download LPCXpresso] (SWD method)
* [http://www.keil.com/support/man/docs/ulink2/ulink2_hw_connectors.htm Target Connectors]
* [https://www.lpcware.com/content/faq/lpcxpresso/regaining-debug-access Regaining debug access to target MCU]

Avalon6

2016-06-01T02:30:31Z

Johnson-Fan: /* MM Firmware 20160511 released*/

= Basic Information =
Hashrate: 3.5Ths ± 5%
Power Consumption: ≈ 1050 Watt (with assumption of 90% power conversion ratio)
Overclocking: Support automatically optimizes frequency, no need to overclock manually.
PSU ouput pin: 4 x 6PIN PCIe power connector.
Controller: Raspberry Pi (version B or B+) Raspberry Pi 2 is not supported yet.
AUC: Each AUC can connect up to 6 devices.
Dimensions: 340 mm x 136 mm x 150 mm
Operating Temperature: -10 °C to 38°C
Fan Specs: 12038, Current less then 2.4A
Protection Degree: IP20
Net weight: 4.8kg
Gross weight: 5kg

== Pictures ==
=== Control board ===
[[File: AvalonMiner6_CTRL.png | none | 640 px]]
* NC means not connect

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== IIC ==
[[File:IIC_Link_Avalon6.png]]

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|- valign="top"
| 65536
| CODE_LOCK
| FATAL
| MM is not permit to run without decrypt
| Ask service for help
|- valign="top"
| 131072
| CODE_HOTBEFORE
| WARN
| Toohot is found on MM
| It's just a note on toohot
|- valign="top"
| 262144
| CODE_APIFIFOOVERFLOW
| WARN
| API fifo overflow flag
| It's just a note on api fifo
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20160530/ 20160530] ===
* CGMiner:Add more options to optimize hashrate when toohot occus.
* CGMiner:Support AV4 miner detect through iic
* CGMiner:Double check data size when use avalon4_auc_xfer
* CGMiner:Update adjust_fan to avoid fan overshoot, Thanks to ckolivas
* CGMiner:Update default target temperature for AvalonMiner 6.(68℃ to 65℃)
* CGMiner:Support 6 machines maximum on a AUC

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20160125/ 20160125] ===
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option (mode 3), and change it to default.
* Update mm count when scan hash

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* Notice: Only for testing purpose

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2016-05-11/ 2016-05-11] ===
* Version: '''601605-256e0f00'''
* Check api fifo overflow
* Add CODE_HOTBEFORE for hot notify
* Add a new package AVA4_P_SET_FREQ
* Support device hardware error
* Fix duplicate share
* Move stratum file to a lib
* Update temp check

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2016-01-25/ 2016-01-25] ===
* Version '''601601-5d8a1270'''
* Add mm package header verify
* Update pll couter for separate module
* Update iic address free mechanism
* Update fan rpm detect
* Fix duplicate address during detect
* Fix freq setting lost cause by mm was toot

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* Notice: Only for testing purpose

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
* Download & Compile
# git clone https://github.com/Canaan-Creative/cgminer
# cd cgminer
# git checkout origin/avalon4 -b avalon4
# ./autogen.sh --enable-avalon4
# make -j 4

* Run
# Run with AUC
#;sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
#;or
#;sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log
#;
# Run with AUC and IIC interface
#;sudo ./cgminer --avalon4-iic-detect --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
#;or
#;sudo ./cgminer --avalon4-iic-detect --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./logA

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===
==== Modify The AUC2 Firmware Flash And RAM Address ====
1. We modify the Flash start address at 0x4000, because the bootloader's size is 0x4000. 
2. We modify the RAM start address at 0x10000200, because we remap the NVIC table at the RAM 0x10000000,
and the NVIC table size is 0x200 bytes. 
3. We modify the *.ld file. And my *.ld file is avalon-usb-converter.ld, you can find your *.ld file.
:{|class="wikitable" border="1"
|-
! <big>Before Modification</big>
! <big>After Modification</big>
|-
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x0, LENGTH = 0x8000 /* 32K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000000, LENGTH = 0x1000 /* 4K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x0 + 0x8000;
__top_RamLoc4 = 0x1000000 + 0x1000;
__top_RamUsb2 = 0x20004000 + 0x800;
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x4000, LENGTH = 0x4000 /* 16K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000200, LENGTH = 0xe00 /* 3.5K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x4000 + 0x4000;
__top_RamLoc4 = 0x10000200 + 0xe00;
__top_RamUsb2 = 0x20004000 + 0x800;
|}

==== Remap The NVIC Table ====
1. Add Under Function Code In Your Program.

/* copy the nvic table to ram */
static void copy_nvic_to_ram(void)
{
volatile uint32_t *dst, size;
volatile const uint32_t *src; 
src = (volatile uint32_t *)APP_START_ADDR;//APP_START_ADDR Is The Application Program's Start Address.
dst = (volatile uint32_t *)RAM_START_ADDR;//RAM_START_ADDR Is The RAM Start Address.
size = NVIC_TABLE_LEN >> 2;//NVIC_TABLE_LEN Is The NVIC Table's Size.
do {
*dst++ = *src++;
} while (--size); 
/* NVIC remap to RAM */
Chip_SYSCTL_Map(0x01); 
}

2. Config The Register To Remap NVIC Table To RAM
:[[File:LPC11u14 NVIC Table Remap1.png | none | 640px ]]
<big><big>More See UM10462 LPC11U3x/2x/1x User manual,At The Page 22.</big></big>

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
# Upgrade OpenWrt branch to master
# Commit cgminer package for OpenWrt packages

=== CGMiner ===

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]
3. AUC always appear and then disappear in CGMiner status ?
It maybe damaged. Take a new one instead.

Avalon6

2016-04-06T08:35:01Z

Johnson-Fan: /* Basic Information */

= Basic Information =
Hashrate: 3.5Ths ± 5%
Power Consumption: ≈ 1050 Watt (with assumption of 90% power conversion ratio)
Overclocking: Support automatically optimizes frequency, no need to overclock manually.
PSU ouput pin: 4 x 6PIN PCIe power connector.
Controller: Raspberry Pi (version B or B+) Raspberry Pi 2 is not supported yet.
AUC: Each AUC can connect up to 6 devices.
Dimensions: 340 mm x 136 mm x 150 mm
Operating Temperature: -10 °C to 38°C
Fan Specs: 12038, Current less then 2.4A
Protection Degree: IP20
Net weight: 4.8kg
Gross weight: 5kg

== Pictures ==
=== Control board ===
[[File: AvalonMiner6_CTRL.png | none | 640 px]]
* NC means not connect

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== IIC ==
[[File:IIC_Link_Avalon6.png]]

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20160125/ 20160125] ===
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option (mode 3), and change it to default.
* Update mm count when scan hash

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2016-01-25/ 2016-01-25] ===
* Version '''601601-5d8a1270'''
* Add mm package header verify
* Update pll couter for separate module
* Update iic address free mechanism
* Update fan rpm detect
* Fix duplicate address during detect
* Fix freq setting lost cause by mm was toot

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===
==== Modify The AUC2 Firmware Flash And RAM Address ====
1. We modify the Flash start address at 0x4000, because the bootloader's size is 0x4000. 
2. We modify the RAM start address at 0x10000200, because we remap the NVIC table at the RAM 0x10000000,
and the NVIC table size is 0x200 bytes. 
3. We modify the *.ld file. And my *.ld file is avalon-usb-converter.ld, you can find your *.ld file.
:{|class="wikitable" border="1"
|-
! <big>Before Modification</big>
! <big>After Modification</big>
|-
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x0, LENGTH = 0x8000 /* 32K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000000, LENGTH = 0x1000 /* 4K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x0 + 0x8000;
__top_RamLoc4 = 0x1000000 + 0x1000;
__top_RamUsb2 = 0x20004000 + 0x800;
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x4000, LENGTH = 0x4000 /* 16K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000200, LENGTH = 0xe00 /* 3.5K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x4000 + 0x4000;
__top_RamLoc4 = 0x10000200 + 0xe00;
__top_RamUsb2 = 0x20004000 + 0x800;
|}

==== Remap The NVIC Table ====
1. Add Under Function Code In Your Program.

/* copy the nvic table to ram */
static void copy_nvic_to_ram(void)
{
volatile uint32_t *dst, size;
volatile const uint32_t *src; 
src = (volatile uint32_t *)APP_START_ADDR;//APP_START_ADDR Is The Application Program's Start Address.
dst = (volatile uint32_t *)RAM_START_ADDR;//RAM_START_ADDR Is The RAM Start Address.
size = NVIC_TABLE_LEN >> 2;//NVIC_TABLE_LEN Is The NVIC Table's Size.
do {
*dst++ = *src++;
} while (--size); 
/* NVIC remap to RAM */
Chip_SYSCTL_Map(0x01); 
}

2. Config The Register To Remap NVIC Table To RAM
:[[File:LPC11u14 NVIC Table Remap1.png | none | 640px ]]
<big><big>More See UM10462 LPC11U3x/2x/1x User manual,At The Page 22.</big></big>

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
# Commit cgminer package for OpenWrt packages

=== CGMiner ===
# Support a new SmartSpeed way
# Update local hash rate calculate method
# Fix duplicate mm address
# Support 5 or 6 mm running stably

=== MM ===
# Fix duplicate mm address

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address
# AUC may be disappeared by unknown reason, then it can be detected again.

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

File:IIC Link Avalon6.png

2016-04-06T08:31:59Z

Johnson-Fan:

File:IIC Link Avalon4.png

2016-04-06T08:24:37Z

Johnson-Fan: Johnson-Fan uploaded a new version of File:IIC Link Avalon4.png

File:IIC Link Avalon4.png

2016-04-06T08:22:23Z

Johnson-Fan: Johnson-Fan uploaded a new version of File:IIC Link Avalon4.png

Avalon6

2016-01-08T10:11:04Z

Johnson-Fan: /* Add DFU In AUC2 Firmware */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===
==== Modify The AUC2 Firmware Flash And RAM Address ====
1. We modify the Flash start address at 0x4000, because the bootloader's size is 0x4000. 
2. We modify the RAM start address at 0x10000200, because we remap the NVIC table at the RAM 0x10000000,
and the NVIC table size is 0x200 bytes. 
3. We modify the *.ld file. And my *.ld file is avalon-usb-converter.ld, you can find your *.ld file.
:{|class="wikitable" border="1"
|-
! <big>Before Modification</big>
! <big>After Modification</big>
|-
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x0, LENGTH = 0x8000 /* 32K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000000, LENGTH = 0x1000 /* 4K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x0 + 0x8000;
__top_RamLoc4 = 0x1000000 + 0x1000;
__top_RamUsb2 = 0x20004000 + 0x800;
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x4000, LENGTH = 0x4000 /* 16K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000200, LENGTH = 0xe00 /* 3.5K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x4000 + 0x4000;
__top_RamLoc4 = 0x10000200 + 0xe00;
__top_RamUsb2 = 0x20004000 + 0x800;
|}

==== Remap The NVIC Table ====
1. Add Under Function Code In Your Program.

/* copy the nvic table to ram */
static void copy_nvic_to_ram(void)
{
volatile uint32_t *dst, size;
volatile const uint32_t *src; 
src = (volatile uint32_t *)APP_START_ADDR;//APP_START_ADDR Is The Application Program's Start Address.
dst = (volatile uint32_t *)RAM_START_ADDR;//RAM_START_ADDR Is The RAM Start Address.
size = NVIC_TABLE_LEN >> 2;//NVIC_TABLE_LEN Is The NVIC Table's Size.
do {
*dst++ = *src++;
} while (--size); 
/* NVIC remap to RAM */
Chip_SYSCTL_Map(0x01); 
}

2. Config The Register To Remap NVIC Table To RAM
:[[File:LPC11u14 NVIC Table Remap1.png]]
<big><big>More See UM10462 LPC11U3x/2x/1x User manual,At The Page 22.</big></big>

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

File:LPC11u14 NVIC Table Remap1.png

2016-01-08T10:06:36Z

Johnson-Fan:

File:LPC11u14 NVIC Table Remap.png

2016-01-08T10:00:01Z

Johnson-Fan: Johnson-Fan uploaded a new version of File:LPC11u14 NVIC Table Remap.png

LPC11u14_NVIC_Table_Remap Register

File:LPC11u14 NVIC Table Remap.png

2016-01-08T09:59:16Z

Johnson-Fan: Johnson-Fan uploaded a new version of File:LPC11u14 NVIC Table Remap.png

LPC11u14_NVIC_Table_Remap Register

File:LPC11u14 NVIC Table Remap.png

2016-01-08T09:57:56Z

Johnson-Fan: Johnson-Fan uploaded a new version of File:LPC11u14 NVIC Table Remap.png

LPC11u14_NVIC_Table_Remap Register

File:LPC11u14 NVIC Table Remap.png

2016-01-08T09:50:35Z

Johnson-Fan: Johnson-Fan uploaded a new version of File:LPC11u14 NVIC Table Remap.png

LPC11u14_NVIC_Table_Remap Register

File:LPC11u14 NVIC Table Remap.png

2016-01-08T09:48:29Z

Johnson-Fan: Johnson-Fan uploaded a new version of File:LPC11u14 NVIC Table Remap.png

LPC11u14_NVIC_Table_Remap Register

File:LPC11u14 NVIC Table Remap.png

2016-01-08T09:35:07Z

Johnson-Fan: LPC11u14_NVIC_Table_Remap Register

LPC11u14_NVIC_Table_Remap Register

Avalon6

2016-01-08T09:10:58Z

Johnson-Fan: /* Modify The AUC2 Firmware Start Address */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===
==== Modify The AUC2 Firmware Start Address ====
1. We modify the start address at 0x4000,because the bootloader's size is 0x4000.

2. We modify the *.ld file. And my *.ld file is avalon-usb-converter.ld, you can find your *.ld file.

:{|class="wikitable" border="1"
|-
! <big>Before Modification</big>
! <big>After Modification</big>
|-
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x0, LENGTH = 0x8000 /* 32K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000000, LENGTH = 0x1000 /* 4K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x0 + 0x8000;
__top_RamLoc4 = 0x1000000 + 0x1000;
__top_RamUsb2 = 0x20004000 + 0x800;
|MEMORY
{
/* Define each memory region */

MFlash32 (rx) : ORIGIN = 0x4000, LENGTH = 0x4000 /* 16K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000200, LENGTH = 0xe00 /* 3.5K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}
/* Define a symbol for the top of each memory region */

__top_MFlash32 = 0x4000 + 0x4000;
__top_RamLoc4 = 0x10000200 + 0xe00;
__top_RamUsb2 = 0x20004000 + 0x800;
|}

==== Modify The LPC11U14 RAM Start Address ====
==== Remap The NVIC Table ====

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T05:08:11Z

Johnson-Fan: /* Modify The AUC2 Firmware Start Address */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===
==== Modify The AUC2 Firmware Start Address ====
1. We modify the start address at 0x4000,because the bootloader's size is 0x4000.
2. We modify the *.ld file. And my *.ld file is avalon-usb-converter.ld, you can find your *.ld file.
Modify like:
{|
|-
！ Before modification
！ After modification
|-
|MEMORY
{
/* Define each memory region */
MFlash32 (rx) : ORIGIN = 0x4000, LENGTH = 0x4000 /* 16K bytes */
RamLoc4 (rwx) : ORIGIN = 0x10000200, LENGTH = 0xe00 /* 3.5K bytes */
RamUsb2 (rwx) : ORIGIN = 0x20004000, LENGTH = 0x800 /* 2K bytes */
}

/* Define a symbol for the top of each memory region */
__top_MFlash32 = 0x4000 + 0x4000;
__top_RamLoc4 = 0x10000200 + 0xe00;
__top_RamUsb2 = 0x20004000 + 0x800;
|
|-
|
|
|}

==== Modify The LPC11U14 RAM Start Address ====
==== Remap The NVIC Table ====

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:56:19Z

Johnson-Fan: /* Add DFU In AUC2 Firmware */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===
==== Modify The AUC2 Firmware Start Address ====
==== Modify The LPC11U14 RAM Start Address ====
==== Remap The NVIC Table ====

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:55:02Z

Johnson-Fan: /* Add DFU In AUC2 Firmware */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===
#Modify The AUC2 Firmware Start Address
#Modify The LPC11U14 RAM Start Address
#Remap The NVIC Table

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:50:37Z

Johnson-Fan: /* AUC2 */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

=== Add DFU In AUC2 Firmware ===

=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:42:37Z

Johnson-Fan: /* Issues */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
=== Issues ===
<big>1. About Bootloader USB Descriptor:</big>
Note the DFU Functional Descriptor' wTransferSize size, It must equal the USBD_DFU_INIT_PARAM_T's wTransferSize.
<big>2. About IAP Transmission Data Size </big>
The data size should be 256 or 512 or 1024 or 4096 Bytes.
<big>3. About IAP Transmission Data Address </big>
The data address should be a 256 byte boundary.
<big>3. Why sometimes updata failed ?</big>
Now, I didn't find the real reason. But, I think the reason is the time of communication is not correct.
<big>3. Why sometimes updata finished, but the program don't run normally ?</big>
I think that I didn't check the flash address and the data address are right. 
I will add the check in the program later.

=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:13:31Z

Johnson-Fan: /* AUC2 */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
=== Issues ===
=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:09:35Z

Johnson-Fan: /* How To Jump To Application Program */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:09:08Z

Johnson-Fan: /* How To Judge The Bootloader Program Is Updating Or Jump To Application Program */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== Judge Updating Program Or Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== How To Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:06:22Z

Johnson-Fan: /* Support USB-DFU Mode */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
We can use dfu-util under Ubuntu 14.04 or later updata new firmware for AUC2.

==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== How To Judge The Bootloader Program Is Updating Or Jump To Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== How To Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T04:04:10Z

Johnson-Fan: /* Links */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== How To Judge The Bootloader Program Is Updating Or Jump To Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== How To Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
=== References And Links ===
* [https://www.lpcware.com/lpcxpresso/download LPCXpress IDE Download]
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T03:59:55Z

Johnson-Fan: /* Links */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== How To Judge The Bootloader Program Is Updating Or Jump To Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== How To Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
=== Links ===
* [http://www.usb.org/developers/docs/devclass_docs/DFU_1.1.pdf See More About DFU Protocol]
* [https://github.com/Canaan-Creative/Avalon-USB-converter Source Code]
* [http://docs.lpcware.com/usbromlib/v1.0/ USBD ROM Stack]
* [http://www.nxp.com/documents/user_manual/UM10462.pdf LPC11U1X User Manual]
* [http://www.lpcware.com/content/nxpfile/lpcopen-software-development-platform-lpc11xx-packages-0 LPCOpen sourcecode]
* [http://docs.lpcware.com/lpcopen/v1.03/ LPCOpen docs]
* [http://www.lpcware.com/system/files/LPCXpressoLPC11U14revA_0.pdf LPC11U14 Rev A Schematic]
* [http://www.nxp.com/documents/errata_sheet/ES_LPC11U1X.pdf Errata sheet LPC11U1x]
* [http://support.code-red-tech.com/CodeRedWiki/UsingGDB?highlight=%28LPC\-Link%29 Using command line GDB]

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T03:49:54Z

Johnson-Fan: /* USB Bootloader */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== How To Judge The Bootloader Program Is Updating Or Jump To Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== How To Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
==== Links ====

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T03:48:37Z

Johnson-Fan: /* USB Bootloader */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== How To Judge The Bootloader Program Is Updating Or Jump To Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== How To Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====
#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.
#Links

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T03:45:30Z

Johnson-Fan: /* How To Jump To Application Program */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== How To Judge The Bootloader Program Is Updating Or Jump To Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== How To Jump To Application Program ====
When we don't want to updata application program, the bootloader program should run to application program.

In order to achieve this goal, we can add under code in your bootloader program.

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov sp, r0");

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your"
asm volatile("ldr r0, [r0]");
asm volatile("mov pc, r0");

==== Modify dfu-util For Ubuntu 14.04 ====

#[https://en.bitcoin.it/wiki/File:USB-DFU_Descriptor.png USB-DFU Product's USB Descriptor]
#[https://en.bitcoin.it/wiki/File:UpdataProcess.png DFU Updata Process Diagram]
#[[How To Judge The Bootloader Program Is Updating Or Jump To Application Program]]
#[[How To Jump To Application Program]]
#[[Modify dfu-util For Ubuntu 14.04]]
#Links

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T03:41:54Z

Johnson-Fan: /* How To Judge The Bootloader Program Is Updating Or Jump To Application Program */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== How To Judge The Bootloader Program Is Updating Or Jump To Application Program ====
I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag, if the updata falg is not equal 0xAABBCCDD, it will jump to application program.
Otherwise it will run to updata program.

==== How To Jump To Application Program ====
<big><big>When we don't want to updata application program,</big></big> 
<big><big>the bootloader program should run to application program.</big></big> 
<big><big>In order to achieve this goal, we can add under code in your bootloader program.</big></big> 

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your" 
asm volatile("ldr r0, [r0]"); 
asm volatile("mov sp, r0"); 

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your" 
asm volatile("ldr r0, [r0]"); 
asm volatile("mov pc, r0"); 

==== Modify dfu-util For Ubuntu 14.04 ====

#[https://en.bitcoin.it/wiki/File:USB-DFU_Descriptor.png USB-DFU Product's USB Descriptor]
#[https://en.bitcoin.it/wiki/File:UpdataProcess.png DFU Updata Process Diagram]
#[[How To Judge The Bootloader Program Is Updating Or Jump To Application Program]]
#[[How To Jump To Application Program]]
#[[Modify dfu-util For Ubuntu 14.04]]
#Links

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T03:39:15Z

Johnson-Fan: /* USB Bootloader */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

==== USB-DFU Product's USB Descriptor ====
[[File:USB-DFU Descriptor.png]]

==== DFU Updata Process Diagram ====
[[File:UpdataProcess.png]]

==== How To Judge The Bootloader Program Is Updating Or Jump To Application Program ====
<big><big>I used a updata flag which is a four bytes word and
is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag,
if the updata falg is not equal 0xAABBCCDD, 
it will jump to application program.
otherwise it will run to updata program.</big></big>

==== How To Jump To Application Program ====
<big><big>When we don't want to updata application program,</big></big> 
<big><big>the bootloader program should run to application program.</big></big> 
<big><big>In order to achieve this goal, we can add under code in your bootloader program.</big></big> 

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your" 
asm volatile("ldr r0, [r0]"); 
asm volatile("mov sp, r0"); 

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your" 
asm volatile("ldr r0, [r0]"); 
asm volatile("mov pc, r0"); 

==== Modify dfu-util For Ubuntu 14.04 ====

#[https://en.bitcoin.it/wiki/File:USB-DFU_Descriptor.png USB-DFU Product's USB Descriptor]
#[https://en.bitcoin.it/wiki/File:UpdataProcess.png DFU Updata Process Diagram]
#[[How To Judge The Bootloader Program Is Updating Or Jump To Application Program]]
#[[How To Jump To Application Program]]
#[[Modify dfu-util For Ubuntu 14.04]]
#Links

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T03:30:36Z

Johnson-Fan: /* Using USB-DFU Protocol */

= Basic Information =
Hashrate:
'''3.5T (+-5%)'''

Power consumption:
990W (measure on 12V port of the device)
1100W (on the wall, with assumption of 90% power conversion ratio)

Power per hash:
270J/THash (device only)
295J/THash (on the wall, with assumption of 90% power conversion
ratio)

Overclocking:
Support automatically optimize frequency, no need to overclock manually.

PSU output pin:
4x6PIN PCIe power connector. *All must be connected.*

PSU requirements:
Minimum 1100W output, recommend to use high-quality PSU for server
with more than 1200W output and high quality power cable.
Input voltage no lower than 11.7V and no higher than 12.2V (numbers
take from the controller)
Lower voltage leads to lower hashrate and higher voltage leads to
possible device burning down.
NOTICE: Poor quality cable may result in low voltage.

Fan:
Specs: 12038
Current: between 1.6A and 2.8A.
Minimum RPM: 3800.
*NOTICE* If the fan is broken or the fan's RPM cannot be measure,
the device will not start.

Controller:
Raspberry Pi (version B or B+)
Raspberry Pi 2 will be supported at the middle of December 2015
Each Rpi can control approximately ~12 devices.

AUC:
Each AUC can connect up to 6 devices.

Dimensions:
354x136x150mm

Net weight:
~4.8kg

Protection Degree:
IP20

== LED ==
=== Avalon6 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| White
| Power on
|- valign="top"
| Blue
| Working normally
|- valign="top"
| Yellow blinking
| Idle normally
|- valign="top"
| Green blinking
| Detect fan and mcu
|- valign="top"
| White blinking
| Turn on LED manually
|- valign="top"
| Red blinking
| Toohot/Loopback failed/PG failed/Coretest failed/Voltage error/Temperature sensor error/No fan
|}

=== AUC2 LED ===
{| class="wikitable sortable" border="1"
|+
|-
! LED Status
! MEMO
|- valign="top"
| Blue
| Initializing or Idle normally
|- valign="top"
| Green
| Working normally
|- valign="top"
| Red
| Communication failed
|}

== MM Error Codes ==
'''[http://downloads.canaan-creative.com/querystatus.html Query EC here]'''
{| class="wikitable sortable" border="1"
|-
! CODE
! NAME
! TYPE
! MEMO
! What to do
|- valign="top"
| 1
| CODE_IDLE
| WARN
| Idle
| Check if the network is ok or AUC is work normally
|- valign="top"
| 2
| CODE_TOOHOT
| FATAL
| Too hot
| Check if the fan is connect successfully
|- valign="top"
| 4
| CODE_LOOP0FAILED
| FATAL
| Channel 0 loopback failed
| Replace a new hash unit for channel 0 if PG0 is ok
|- valign="top"
| 8
| CODE_LOOP1FAILED
| FATAL
| Channel 1 loopback failed
| Replace a new hash unit for channel 1 if PG1 is ok
|- valign="top"
| 16
| CODE_INVALIDMCU
| FATAL
| MCU cann't be detected
| Replace a new CTRL board
|- valign="top"
| 32
| CODE_NOSTRATUM
| WARN
| No stratum
| Check if the network is ok or AUC is work normally
|- valign="top"
| 64
| CODE_RBOVERFLOW
| WARN
| Nonce ringbuffer overflow
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 128
| CODE_MMCRCFAILED
| WARN
| Ignore it please, If CGMiner is restart, It will be ok.
| Find iic rx crc mismatch
|- valign="top"
| 256
| CODE_MCUCRCFAILED
| WARN
| Find mcu rx irc mismatch
| Ignore it please, If CGMiner is restart, It will be ok.
|- valign="top"
| 512
| CODE_NOFAN
| FATAL
| Fan cann't be found
| Check the fan connection
|- valign="top"
| 1024
| CODE_PG0FAILED
| FATAL
| Channel 0 power good failed
| Check the PSU for channel 0
|- valign="top"
| 2048
| CODE_PG1FAILED
| FATAL
| Channel 1 power good failed
| Check the PSU for channel 1
|- valign="top"
| 4096
| CODE_CORETESTFAILED
| FATAL
| Find bad chip on channel 0 or channel 1
| Replace a new hash unit if hash rate is too low, or else you can ignore it.
|- valign="top"
| 8192
| CODE_ADC0_ERR
| FATAL
| Temperature sensor cann't be detected on channel 0
| Replace a new hash unit for channel 0
|- valign="top"
| 16384
| CODE_ADC1_ERR
| FATAL
| Temperature sensor cann't be detected on channel 1
| Replace a new hash unit for channel 1
|- valign="top"
| 32768
| CODE_VOL_ERR
| FATAL
| MM is not permit to run at the voltage for safety
| Change another PSU for the machine
|}
TYPE meaning:
'''WARN'''-It designates potentially harmful situations, but you can ignore it.
'''FATAL'''-It designates very severe error events that will presumably lead the Avalon6 to crash.

= Firmware =
== RPi Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151225/ 20151225] ===
* OpenWrt:Update to 15.05
* OpenWrt:Support Raspberry Pi 2 Model B
* LuCI:Sync with for-15.05 branch (ab31abd244979d1ff234a15a4a3cf69ac1b73688)
* CGMiner:Sync with ckolivas's master (5a456afbfa028162060afd66636b7cb266b35a53)
* CGMiner:Add more options for smartspeed (Only support MM version >= 601512-xxxxxxxx)

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151111/ 20151111] ===
*CGMiner:Fix divide by zero in Avalon4 driver
*CGMiner:Add stratum difficulty in pool api
*CGMiner:Update option for Avalon6
*CGMiner:Update Vol api display in Avalon4 driver for Avalon6
*CGMiner:Update fan adjust for Avalon6
*CGMiner:Update target temp settting for Avalon6
*LuCI:Update display information for Avalon6
*LuCI:Update device name for Avalon6
*LuCI:Update CGMiner configuration for Avalon6
*LuCI:Update CGMiner setting for Avalon theme

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151031/ 20151031] ===
* Fix nonce counter for multiple miners
* Display ASIC counts as TA in CGMiner status
* Update maximum difficulty for Avalon4 and Avalon6
* Update temperature check for Avalon6
* Add GHSmm for hash rate comparison
* Display PLL information for Avalon6
* Turn on nonce check as default for Avalon6
* Correct on voltage decode
* Enable adjust frequency automatically as default for Avalon6
* Decode voltage and temperature decode for Avalon6
* Support err code for Avalon6

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/20151001/ 20151001] ===
* First version of Avalon6 firmware

=== [http://downloads.canaan-creative.com/software/avalon6/openwrt/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing
* Fix duplicate address
* Update GHS counter to fix the gap between miner and mm
* Add a new smart speed option

== MM Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-12-28/ 2015-12-28] ===
* Version '''601512-57532250'''
* Fix:Don't touch fan by miner when mm is too hot
* Fix:Update idle process with toohot detect, stratum detect, and invalid mcu protect
* Fix:Fix coretest failed cause by incorrect pll setting
* Update:Update API_TIMEOUT_CONST
* Add:Support adjust freq by CGMiner when mm is working

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-24/ 2015-11-24] ===
* Version '''601511-f4f59c70'''
* Update Core test check rules
* Update Input voltage check rules (Input voltage should not >= 12.8V)
* Fix result when run test scripts

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-11-11/ 2015-11-11] ===
* Version '''601511-e3d244c0 '''
* Add voltage range detect
* Check maximum rpm when detect fan polar
* Check temp for bad ntc resistor
* Check voltage when MM is starting
* Monitor powergood when power on
* Update temperature check
* Update nonce process
* Update frequency table
* Fix conflict address
* Enable 25MHz clock for debug purpose
* Disable pll when if miner is invalid when process FREQ_WORK

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-10-31/ 2015-10-31] ===
* Version '''601510-afa837a0'''
* Update IIC and UART communication
* Support core test by AVA4_P_TEST
* Update ASIC_FREQMIN to 100MHz
* Detect ASIC counts by LOOPBACK
* Fix upgrade failed caused by i2c FIFO overflow
* Update timer function
* Use GPIO led as address indicator
* Always disable the invalid miner when PG or LOOPBACK failed
* Add PLL status in P_STATUS_M
* Add err code
* Support ADC capture
* Keep free run if MCU can't be detected
* Update led status
* Rewrite boot loader with c code

=== [http://downloads.canaan-creative.com/software/avalon6/mm/2015-09-30/ 2015-09-30] ===
* Version '''601509-a2613610'''
* First MM firmware for Avalon6.0 S
* Support 2 miners
* Detect asic counts when start
* Support target filter

=== [http://downloads.canaan-creative.com/software/avalon6/mm/nexttesting/ NEXT-TESTING] ===
* NOTICE: Only for testing

== MCU Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/mm/mcu/2015-10-31/ 2015-10-31] ===
* Version '''6C1508-afa837a0'''
* For adc and temperature capture use MM protocal

== AUC2 Firmware ==
=== [http://downloads.canaan-creative.com/software/avalon6/auc2/2015-12-08 20151208] ===
* AUC version: '''AUC-20151208'''
* First release

=== [http://downloads.canaan-creative.com/software/avalon6/auc2/NEXT-TESTING/ NEXT-TESTING] ===
* NOTICE: Only for testing

= Software Development =
== Controller firmware ==
=== [http://build.canaan-creative.com:8080/~buildbot/avalon6/ Daily building] ===
=== CGMiner Under Ubuntu 14.04 ===
#Inside your home directory, download Cgminer
git clone https://github.com/Canaan-Creative/cgminer
cd cgminer
git checkout origin/avalon4 -b avalon4
./autogen.sh --enable-avalon4
make -j 4
# Run
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass
or
sudo ./cgminer --avalon4-freq 200 --avalon4-voltage 7125 -o http://stratum.pool:3333 -u work -p pass --api-allow W:192.168.2,W:192.168.2.1 --api-listen $@ 2>./log

=== Frequency Statechart ===
[[File:A6 frequency state.png | none| 640px]]

== MM ==
=== [http://build.canaan-creative.com:8080/~buildbot/mm60/ Daily building] ===
=== Avalon6 TB2 ===
$ make -C firmware PLATFORM=MM60_TB2
=== Avalon6.0 S ===
$ make -C firmware

== AUC2 ==
=== [http://build.canaan-creative.com:8080/~buildbot/auc2/ Daily building] ===
=== USB Bootloader ===
==== Support USB-DFU Mode ====
==== Using USB-DFU Protocol ====
{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

#[https://en.bitcoin.it/wiki/File:USB-DFU_Descriptor.png USB-DFU Product's USB Descriptor]
#[https://en.bitcoin.it/wiki/File:UpdataProcess.png DFU Updata Process Diagram]
#[[How To Judge The Bootloader Program Is Updating Or Jump To Application Program]]
#[[How To Jump To Application Program]]
#[[Modify dfu-util For Ubuntu 14.04]]
#Links

== TODO ==
=== OpenWrt ===
# Support Raspberry Pi 2B
# Update with the master branch
# Support Avalon6 in LuCI (Advanced version)
# Keep more coding on LuCI (Avalon theme)

=== CGMiner ===
# Add auto speed option
# Merge the Avalon6 code to CK's master

=== MM ===

== Known Issues ==
# MM can be upgrade by mismatch firmware.
# local hashrate (GHS av) cann't match with the pool's hashrate
# Use 5 or more modules in one AUC will cause MM idle periodically.
# Duplicate MM address

= FAQ =
1. How to deal with the red blinking machine?
[[File:A6 EC PROC.png | none| 640px]]
2. How to boot the machine or hashboard unit safely?
[[File:A6 BOOT.png | none | 640px]]

Avalon6

2016-01-08T03:29:38Z

Johnson-Fan: /* USB Bootloader */

Using USB-DFU Protocol

2016-01-08T03:13:49Z

Johnson-Fan: Created page with "{| border=1 class="wikitable" style="width: 100%; height: 100px" |+<big><big>DFU Device Descriptor</big></big> !Offset!!Field!!Size!!Value!!Descripton |- | 0 || bLength || 1 |..."

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Device Descriptor</big></big>
!Offset!!Field!!Size!!Value!!Descripton
|-
| 0 || bLength || 1 || 12h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 01h || DEVICE descriptor type.
|-
| 2 || bcdUSB || 2 || 0100h || USB specification release number in binary coded decimal.
|-
| 4 || bDeviceClass || 1 || 00h || See interface.
|-
| 5 || bDeviceSubClass || 1 || 00h || See interface
|-
| 6 || bDeviceProtocol || 1 || 00h || See interface.
|-
| 7 || bMaxPacketSize0 || 1 || 8,16,32,64 || Maximum packet size for endpoint.
|-
| 8 || idVendor || 2 || ID || Vendor ID. Assigned by the USB-IF.
|-
| 10 || idProduct || 2 || ID || Product ID. Assigned by manufacturer.
|-
| 12 || bcdDevice || 2 || BCD || Device release number in binary coded decimal.
|-
| 14 || iManufacturer || 1 || index || index of string descriptor.
|-
| 15 || iProduct || 1 || index || index of string descriptor.
|-
| 16 || iSerialNumber || 1 || index || index of string descriptor.
|-
| 17 || bNumConfigurations || 1 || 01h || One configuration only for DFU.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 01h || Runtime protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Functional Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 21h || DFU FUNCTIONAL descriptor type.
|-
| 2 || bmAttributes || 1 || Bit mask || DFU attributes 

Bit 7……4: reserved 

Bit 3: device will perform a bus detach-attach sequence when it receives a DFU_DETACH request. The host must not issue a USB Reset. (bitWillDetach) 

0 = no 

1 = yes 

Bit 2: device is able to communicate via USB afeter Manifestation phase.(bitManifestationTolerant) 

0 = no, must see bus reset 

1 = yes 

Bit1: upload capable(bitCanUpload) 

0 = no 

1 = yes 

Bit0: download capable(bitCanDnload) 

0 = no 

1 = yes 
|-
| 3 || wDetachTimeOut || 2 || Number || Time,in milliseconds, that the device will wait after receipt of the DFU_DETACH request. if this time elapses without a USB reaset, then the device will terminate the Reconfiguration phase and revert back to normal operation . This repreents the maximum time that the device can wait(depending on its timers, etc.).The host may specify a shorter timeout in the DFU_DETACH request.
|-
| 5 || wTransferSize || 2 || Number || Maximum number of bytes that the device can accept per control-write transaction.
|-
| 7 || bcdDFUVersion || 2 || BCD || Numeric expression identifying the version of the DFU Specification release.
|}

{| border=1 class="wikitable" style="width: 100%; height: 100px"
|+<big><big>DFU Mode Interface Descriptor</big></big>
! Offset !! Field !! Size !! Value !! Descripton
|-
| 0 || bLength || 1 || 09h || Size of this descriptor,in bytes.
|-
| 1 || bDescriptorType || 1 || 04h || INTERFACE descriptor type.
|-
| 2 || bInterfaceNumber || 1 || Number || Number of this interface.
|-
| 3 || bAlternateSetting || 1 || 00h || Alternate setting. Must be zero.
|-
| 4 || bNumEndpoints || 1 || 00h || Only the control pipe is used.
|-
| 5 || bInterfaceClass || 1 || FEh || Application Specific Class Code.
|-
| 6 || bInterfaceSubClass || 1 || 01h || Device Firmware Upgrade Code.
|-
| 7 || bInterfaceProtocol || 1 || 02h || DFU mode protocol.
|-
| 8 || iInterface || 1 || index || Index of string descriptor for this interface.
|}

Avalon6

2016-01-08T03:08:24Z

Johnson-Fan: /* AUC2 */

Modify dfu-util For Ubuntu 14.04

2016-01-08T03:08:04Z

Johnson-Fan: Created page with " #Inside your home directory, download dfu-util git clone git://git.openezx.org/dfu-util.git open dfu-util/src/dfu_load.c add this instruction "[https://en.bitcoin.it/wi..."

#Inside your home directory, download dfu-util

git clone git://git.openezx.org/dfu-util.git

open dfu-util/src/dfu_load.c

add this instruction "[https://en.bitcoin.it/wiki/File:Milli_sleep%28200%29.png milli_sleep(200);]" under line 134

cd dfu-util

./autogen.sh

./configure

make

The resulting binary is dfu-util/src/dfu-util.

Avalon6

2016-01-08T02:07:12Z

Johnson-Fan: /* AUC2 */

Avalon6

2016-01-08T02:05:11Z

Johnson-Fan: /* LED */

Avalon6

2016-01-08T01:45:27Z

Johnson-Fan: /* AUC2 */

Avalon6

2016-01-07T13:47:34Z

Johnson-Fan: /* USB Bootloader */

Avalon6

2016-01-07T13:44:08Z

Johnson-Fan: /* USB Bootloader */

File:UpdataProcess.png

2016-01-07T13:43:05Z

Johnson-Fan: USB-DFU Bootloader Updata Process

USB-DFU Bootloader Updata Process

How To Judge The Bootloader Program Is Updating Or Jump To Application Program

2016-01-07T11:09:08Z

Johnson-Fan: Created page with "<big><big>I used a updata flag which is a four bytes word and is writed at fixd flash address (0x8000 - 4) The flag's value is 0xAABBCCDD When the bootloader program run, f..."

<big><big>I used a updata flag which is a four bytes word and
is writed at fixd flash address (0x8000 - 4)

The flag's value is 0xAABBCCDD

When the bootloader program run, first it judge the updata flag,
if the updata falg is not equal 0xAABBCCDD, 
it will jump to application program.
otherwise it will run to updata program.</big></big>

Avalon6

2016-01-07T10:55:33Z

Johnson-Fan: /* USB Bootloader */

Avalon6

2016-01-07T10:43:45Z

Johnson-Fan: /* USB Bootloader */

How To Jump To Application Program

2016-01-07T10:43:30Z

Johnson-Fan: Created page with "<big><big>When we don't want to updata application program,</big></big> <big><big>the bootloader program should run to application program.</big></big> <big><big>..."

<big><big>When we don't want to updata application program,</big></big> 
<big><big>the bootloader program should run to application program.</big></big> 
<big><big>In order to achieve this goal, we can add under code in your bootloader program.</big></big> 

asm volatile("ldr r0, =0x4000"); //"the 0x4000 is my application program's MSP point, you must change it adapt to your" 
asm volatile("ldr r0, [r0]"); 
asm volatile("mov sp, r0"); 

asm volatile("ldr r0, =0x4004"); //"the 0x4004 is my application program reset-function entry address, you must change it adapt to your" 
asm volatile("ldr r0, [r0]"); 
asm volatile("mov pc, r0");

Avalon6

2016-01-07T09:58:40Z

Johnson-Fan: /* USB Bootloader */

Avalon6

2016-01-07T09:56:36Z

Johnson-Fan: /* USB Bootloader */

File:Milli sleep(200).png

2016-01-07T09:50:39Z

Johnson-Fan: In dfu-util , Modify dfu_load.c,and add Milli_sleep(200)

In dfu-util , Modify dfu_load.c,and add Milli_sleep(200)