diff --git a/docs/objects.inv b/docs/objects.inv
index bbd31cc..dc228d9 100644
--- a/docs/objects.inv
+++ b/docs/objects.inv
@@ -2,7 +2,4 @@
# Project: InFiDEL
# Version:
# The remainder of this file is compressed using zlib.
-xڅA
-@ Esx
-n)*
- %v 3kx=ObTlQp^zO6&ESOz%dN`}m\ebfFtiA`1Pe*3Nxv`q"iYwC ֖\`M>WvqQV.M."]3
?ڡ 11,H=
\ No newline at end of file
+xڅ@ pW %D;Hgkz>V3e[v[ 1/=`H9CLJ )Ja9t ^nUuA1Q퐣9_3,fN\t}Sʫh~|q`KI:y O!ar> B }^Yb~:>P}#a
7m* v$j\T[<pK[
\ No newline at end of file
diff --git a/docs/search.html b/docs/search.html
index 0377358..280709e 100644
--- a/docs/search.html
+++ b/docs/search.html
@@ -79,6 +79,7 @@
diff --git a/docs/searchindex.js b/docs/searchindex.js
index e9abcc5..d04154f 100644
--- a/docs/searchindex.js
+++ b/docs/searchindex.js
@@ -1 +1 @@
-Search.setIndex({docnames:["assembly_and_setup","bom","index","license"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["assembly_and_setup.rst","bom.rst","index.rst","license.rst"],objects:{},objnames:{},objtypes:{},terms:{"2mm":1,"3x16mm":1,"3x18mm":1,"3x24mm":1,"4mm":1,"5mm":1,"6x2mm":1,"7mm":1,"80x15":[],"8mm":1,"case":3,"final":0,"public":3,"short":1,"while":2,ABS:1,AND:3,FOR:3,For:3,NOT:3,THE:3,The:[2,3],There:1,These:3,USE:3,Use:0,abandon:3,absenc:3,accessori:2,account:3,accuraci:3,acknowledg:3,action:3,actual:0,adapt:3,addit:3,adipis:[],advertis:3,affect:3,affirm:3,against:3,aliqua:[],aliquip:[],all:3,also:1,alt:[],amend:3,amet:[],analog:0,ani:3,anim:[],appli:3,applic:3,aris:3,asa:1,assembl:[1,2],assert:3,associ:3,attiny85:1,attornei:3,aut:[],author:3,authorship:3,auto:1,automat:3,avail:3,ballpoint:1,base:[2,3],basi:3,bear:1,below:3,benefit:3,bill:2,bit:[0,1],block:1,board:[0,1],border:[],build:3,calibr:2,calip:1,can:[1,2,3],cancel:3,cart:1,caus:3,cc0:3,certain:3,cheap:2,choos:1,cillum:[],claim:3,clear:3,click:[],client:3,code:3,column:0,com:2,commerci:3,commodo:[],common:[1,3],commun:3,compar:1,compens:[2,3],competit:3,compon:1,concept:2,concern:3,confer:3,connect:0,consectetur:[],consent:3,consequat:[],consider:3,contain:[],contempl:3,content:2,contrari:3,contravent:3,contribut:3,control:1,copi:3,copyright:3,corpor:3,correct:2,correspond:3,council:3,creat:3,creativ:3,creativecommon:[],creator:3,creep:1,culpa:[],cultur:3,cupidatat:[],current:[0,3],damag:3,data:3,databas:3,date:3,dct:[],decreas:1,deem:3,defect:3,defin:3,depict:3,deserunt:[],design:2,detriment:3,deviat:2,diamet:[0,1,2],din:1,direct:3,disclaim:3,discover:3,displai:3,disrupt:3,dissemin:3,distribut:3,document:3,doe:3,dolor:[],drill:[0,1],driver:0,drspangl:[],dui:[],durat:3,duti:3,each:[0,3],easili:1,effect:[1,3],effort:3,either:[1,3],eiusmod:[],elect:3,electron:2,elit:[],enabl:0,enim:[],enjoy:3,entri:0,equit:3,equival:3,error:3,ess:[],est:[],european:3,exact:0,exampl:0,excepteur:[],exclus:3,exercis:3,exercit:[],exist:3,expect:3,express:3,extens:3,extent:3,extract:3,fallback:3,fasten:2,fault:0,fdm:2,fear:3,filament:2,file:1,fill:[0,1],firm:3,firmwar:1,first:0,fit:3,flash:0,follow:3,form:3,free:3,freeli:3,from:[1,3],fugiat:[],fulli:3,further:3,futur:3,gain:3,gerber:1,get:1,github:[],grant:3,greater:3,greatest:3,grub:1,grubscrew:1,hall:1,hardwar:2,has:3,heir:3,held:3,her:3,herebi:3,hereund:3,his:3,host:0,href:[],http:2,hub:0,i2c:0,idea:2,ideal:3,idler:1,iii:3,imag:3,img:[],implement:3,impli:3,incididunt:[],includ:[1,3],incorpor:3,index:[],ineffect:3,infidel:1,inform:3,infring:3,ino:0,insert:[0,1],instruct:[],intend:[2,3],invalid:3,ipsum:[],irrevoc:3,irur:[],iso:1,its:3,jpg:[],judg:3,jurisdict:3,kind:3,kitspac:1,knowledg:3,known:3,labor:[],labori:[],laborum:[],larg:3,latent:3,later:3,law:3,legal:3,length:1,lever:1,liabil:3,licens:2,licensebutton:[],like:3,limit:3,linear:1,link:[],load:1,lookup:[0,1],lorem:[],m3x8:1,m6x5:1,m6x8:1,made:3,magna:[],magnet:1,mai:[1,3],main:2,make:3,march:3,mate:1,materi:2,maximum:3,mean:3,measur:[0,1],medium:3,member:3,merchant:3,minim:[],modifi:3,modul:[],mollit:[],moral:3,most:3,motiv:3,multipli:0,n35:1,nation:3,necessari:3,neighbor:3,net:[],nisi:[],non:3,none:[],nostrud:[],note:[0,1],now:[0,3],nulla:[],number:3,oblig:3,obtain:3,occaecat:[],offer:3,officia:[],one:1,onli:0,order:1,org:[],origin:3,other:[2,3],otherwis:3,out:0,output:0,over:1,overtli:3,own:0,owner:3,page:1,paragraph:3,pariatur:[],parliament:3,part:[2,3],parti:3,partial:3,particular:3,patent:3,pcb:1,pen:1,perform:3,perman:3,permiss:3,permit:3,person:3,pertain:3,petg:1,pin:[0,1],pla:1,png:[],popul:1,possibl:3,pre:1,precis:[1,2],prefer:1,present:3,preserv:3,price:1,print:2,printer:2,privaci:3,product:3,programm:1,proident:[],project:1,promot:3,proof:2,protect:3,provid:[0,2,3],ptfe:1,publicdomain:[],publicli:3,purl:[],purpos:3,qui:[],quiet:3,rdf:[],read:2,real:2,reason:3,redistribut:3,regard:3,rel:[],relat:3,relationship:3,reliabl:3,relinquish:3,remain:3,remaind:3,replac:[0,1],repositori:1,reprehenderit:[],represent:3,reproduc:3,reput:3,requir:[1,3],resciss:3,respect:3,respons:3,result:[1,3],retain:3,reus:3,revoc:3,right:3,roller:1,royalti:3,rygdlpe_t0c:[],sanlader:[],scientif:3,screw:1,search:[],second:0,sed:[],see:0,sensor:[1,2],servic:3,setup:2,shaft:[0,1],shall:3,she:3,should:[0,1,3],significantli:1,similar:[1,3],sint:[],sit:[],smt:1,soft:1,specif:1,spring:1,src:[],ss495a:1,statement:3,statutori:3,style:[],subject:3,sublicens:3,subsequ:3,successor:3,suitabl:1,sunt:[],supplier:1,surprisingli:2,surrend:3,tabl:[0,1],take:3,tempor:[],term:3,termin:3,territori:3,thereof:3,thi:[1,2,3],thoma:[],those:3,thread:1,through:3,throughout:3,tht:1,time:[1,2,3],titl:3,trademark:3,transfer:3,translat:3,treati:3,tube:1,two:1,ullamco:[],uncondit:3,uncondition:3,under:3,understand:3,unfair:3,univers:3,unknown:3,upon:3,usbtinyisp:1,use:[2,3],used:1,valu:0,variant:1,vcard:[],velit:[],veniam:[],verifi:1,version:3,via:[0,1],voluntarili:3,volupt:[],waiv:3,waiver:3,warranti:3,watch:[],well:3,whatsoev:3,whether:3,which:1,wish:3,without:3,work:3,world:3,worldwid:3,written:1,www:2,xmln:[],yet:2,youmagin:2,your:0,youtub:[],zero:[]},titles:["Assembly and setup","Bill of materials","Welcome to InFiDEL\u2019s documentation!","License"],titleterms:{accessori:1,assembl:0,bill:1,calibr:[0,1],diamet:[],document:2,electron:1,estim:[],fasten:1,filament:[],hardwar:1,indic:[],infidel:2,inlin:[],licens:3,lowcost:[],materi:1,other:1,part:1,print:1,setup:0,tabl:[],welcom:2}})
\ No newline at end of file
+Search.setIndex({docnames:["assembly_and_setup","bom","firmware","index","license"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["assembly_and_setup.rst","bom.rst","firmware.rst","index.rst","license.rst"],objects:{},objnames:{},objtypes:{},terms:{"2mm":1,"3x16mm":1,"3x18mm":1,"3x24mm":1,"4mm":1,"5mm":1,"6x2mm":1,"7mm":1,"80x15":[],"8mm":1,"case":4,"final":0,"public":4,"short":1,"while":3,ABS:1,AND:4,FOR:4,For:4,NOT:4,THE:4,The:[3,4],There:1,These:4,USE:4,Use:0,abandon:4,absenc:4,accessori:3,account:4,accuraci:4,acknowledg:4,action:4,actual:0,adapt:4,addit:4,adipis:[],advertis:4,affect:4,affirm:4,against:4,aliqua:[],aliquip:[],all:4,also:1,alt:[],amend:4,amet:[],analog:0,ani:4,anim:[],appli:4,applic:4,aris:4,asa:1,assembl:[1,3],assert:4,associ:4,attiny85:1,attornei:4,aut:[],author:4,authorship:4,auto:1,automat:4,avail:4,ballpoint:1,base:[3,4],basi:4,bear:1,below:4,benefit:4,bill:3,bit:[0,1],block:1,board:[0,1],border:[],build:4,calibr:3,calip:1,can:[1,3,4],cancel:4,cart:1,caus:4,cc0:4,certain:4,cheap:3,choos:1,cillum:[],claim:4,clear:4,click:[],client:4,code:4,column:0,com:3,commerci:4,commodo:[],common:[1,4],commun:4,compar:1,compens:[3,4],competit:4,compon:1,concept:3,concern:4,confer:4,connect:0,consectetur:[],consent:4,consequat:[],consider:4,contain:[],contempl:4,content:3,contrari:4,contravent:4,contribut:4,control:1,copi:4,copyright:4,corpor:4,correct:3,correspond:4,council:4,creat:4,creativ:4,creativecommon:[],creator:4,creep:1,culpa:[],cultur:4,cupidatat:[],current:[0,4],damag:4,data:4,databas:4,date:4,dct:[],decreas:1,deem:4,defect:4,defin:4,depict:4,deserunt:[],design:3,detriment:4,deviat:3,diamet:[0,1,3],din:1,direct:4,disclaim:4,discover:4,displai:4,disrupt:4,dissemin:4,distribut:4,document:4,doe:4,dolor:[],drill:[0,1],driver:0,drspangl:[],dui:[],durat:4,duti:4,each:[0,4],easili:1,effect:[1,4],effort:4,either:[1,4],eiusmod:[],elect:4,electron:3,elit:[],enabl:0,enim:[],enjoy:4,entri:0,equit:4,equival:4,error:4,ess:[],est:[],european:4,exact:0,exampl:0,excepteur:[],exclus:4,exercis:4,exercit:[],exist:4,expect:4,express:4,extens:4,extent:4,extract:4,fallback:4,fasten:3,fault:0,fdm:3,fear:4,filament:3,file:1,fill:[0,1,2],firm:4,firmwar:[1,3],first:0,fit:4,flash:0,follow:4,form:4,free:4,freeli:4,from:[1,4],fugiat:[],fulli:4,further:4,futur:4,gain:4,gerber:1,get:1,github:[],grant:4,greater:4,greatest:4,grub:1,grubscrew:1,hall:1,hardwar:3,has:4,heir:4,held:4,her:4,herebi:4,hereund:4,his:4,host:0,href:[],http:3,hub:0,i2c:0,idea:3,ideal:4,idler:1,iii:4,imag:4,img:[],implement:4,impli:4,incididunt:[],includ:[1,4],incorpor:4,index:[],ineffect:4,infidel:1,inform:4,infring:4,ino:0,insert:[0,1],instruct:[],intend:[3,4],invalid:4,ipsum:[],irrevoc:4,irur:[],iso:1,its:4,jpg:[],judg:4,jurisdict:4,kind:4,kitspac:1,knowledg:4,known:4,labor:[],labori:[],laborum:[],larg:4,latent:4,later:4,law:4,legal:4,length:1,lever:1,liabil:4,licens:3,licensebutton:[],like:4,limit:4,linear:1,link:[],load:1,lookup:[0,1],lorem:[],m3x8:1,m6x5:1,m6x8:1,made:4,magna:[],magnet:1,mai:[1,4],main:3,make:4,march:4,mate:1,materi:3,maximum:4,mean:4,measur:[0,1],medium:4,member:4,merchant:4,minim:[],modifi:4,modul:[],mollit:[],moral:4,most:4,motiv:4,multipli:0,n35:1,nation:4,necessari:4,neighbor:4,net:[],nisi:[],non:4,none:[],nostrud:[],note:[0,1],now:[0,4],nulla:[],number:4,oblig:4,obtain:4,occaecat:[],offer:4,officia:[],one:1,onli:0,order:1,org:[],origin:4,other:[3,4],otherwis:4,out:0,output:0,over:1,overtli:4,own:0,owner:4,page:1,paragraph:4,pariatur:[],parliament:4,part:[3,4],parti:4,partial:4,particular:4,patent:4,pcb:1,pen:1,perform:4,perman:4,permiss:4,permit:4,person:4,pertain:4,petg:1,pin:[0,1],pla:1,png:[],popul:1,possibl:4,pre:1,precis:[1,3],prefer:1,present:4,preserv:4,price:1,print:3,printer:3,privaci:4,product:4,programm:1,proident:[],project:1,promot:4,proof:3,protect:4,provid:[0,3,4],ptfe:1,publicdomain:[],publicli:4,purl:[],purpos:4,qui:[],quiet:4,rdf:[],read:3,real:3,reason:4,redistribut:4,regard:4,rel:[],relat:4,relationship:4,reliabl:4,relinquish:4,remain:4,remaind:4,replac:[0,1],repositori:1,reprehenderit:[],represent:4,reproduc:4,reput:4,requir:[1,4],resciss:4,respect:4,respons:4,result:[1,4],retain:4,reus:4,revoc:4,right:4,roller:1,royalti:4,rygdlpe_t0c:[],sanlader:[],scientif:4,screw:1,search:[],second:0,sed:[],see:0,sensor:[1,3],servic:4,setup:3,shaft:[0,1],shall:4,she:4,should:[0,1,4],significantli:1,similar:[1,4],sint:[],sit:[],smt:1,soft:1,specif:1,spring:1,src:[],ss495a:1,statement:4,statutori:4,style:[],subject:4,sublicens:4,subsequ:4,successor:4,suitabl:1,sunt:[],supplier:1,surprisingli:3,surrend:4,tabl:[0,1],take:4,tempor:[],term:4,termin:4,territori:4,thereof:4,thi:[1,3,4],thoma:[],those:4,thread:1,through:4,throughout:4,tht:1,time:[1,3,4],titl:4,todo:3,trademark:4,transfer:4,translat:4,treati:4,tube:1,two:1,ullamco:[],uncondit:4,uncondition:4,under:4,understand:4,unfair:4,univers:4,unknown:4,upon:4,usbtinyisp:1,use:[3,4],used:1,valu:0,variant:1,vcard:[],velit:[],veniam:[],verifi:1,version:4,via:[0,1],voluntarili:4,volupt:[],waiv:4,waiver:4,warranti:4,watch:[],well:4,whatsoev:4,whether:4,which:1,wish:4,without:4,work:4,world:4,worldwid:4,written:1,www:3,xmln:[],yet:3,youmagin:3,your:0,youtub:[],zero:[]},titles:["Assembly and setup","Bill of materials","Firmware","Welcome to InFiDEL\u2019s documentation!","License"],titleterms:{accessori:1,assembl:0,bill:1,calibr:[0,1],diamet:[],document:3,electron:1,estim:[],fasten:1,filament:[],firmwar:2,hardwar:1,indic:[],infidel:3,inlin:[],licens:4,lowcost:[],materi:1,other:1,part:1,print:1,setup:0,tabl:[],todo:2,welcom:3}})
\ No newline at end of file
From 684234ddc34d9cfbb1bb85b9d6850e734240e627 Mon Sep 17 00:00:00 2001
From: Darigov Research <30328618+darigovresearch@users.noreply.github.com>
Date: Sun, 20 Jun 2021 17:30:01 +0100
Subject: [PATCH 2/3] feat: Ports current content to firmware.rst
---
docs-src/source/firmware.rst | 185 ++++++++++++++++++-
docs/_images/host_to_sensor_arduino.PNG | Bin 0 -> 317914 bytes
docs/_sources/firmware.rst.txt | 185 ++++++++++++++++++-
docs/firmware.html | 224 +++++++++++++++++++++++-
docs/index.html | 10 +-
docs/searchindex.js | 2 +-
6 files changed, 594 insertions(+), 12 deletions(-)
create mode 100644 docs/_images/host_to_sensor_arduino.PNG
diff --git a/docs-src/source/firmware.rst b/docs-src/source/firmware.rst
index ba35e0e..2fc10ee 100644
--- a/docs-src/source/firmware.rst
+++ b/docs-src/source/firmware.rst
@@ -1,6 +1,185 @@
Firmware
=================================================================================
-TODO
-----------------
-To fill in
+Files
+-----
+
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| File | Note |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| calibration.ino | First test firmware by Thomas Sanladerer, it sends the ADC raw value over I2C, insert some drills of known diameters into the sensor and note the ADC value, then put the values into driver.ino and re compile |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| driver.ino | Code for the sensor, it uses a hardcoded table to convert the ADC to Diameter, and sends 2 bytes over I2C -- no analog out |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| host-example.ino | Reads the 2 bytes of diameter over I2C, and displays it over the UART, used to test the sensor |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Host_ee_prog.ino | Code for the Host Arduino, uses bidirectional communication with the sensor and has a simple UART Console to do the calibration and sensor testing |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Infidel_release_ee.ino | Firmware for the sensor, table in EEPROM, sets values over I2C |
++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+Setup and Programming
+----------------------
+
+Requirements
+^^^^^^^^^^^^
+- Arduino > V1.8.8
+- TinyWireS LIbary from https://github.com/nadavmatalon/TinyWireS
+- ATtiny85 Board for Arduino from https://github.com/damellis/attiny
+- ISP Programmer like Arduino over ISP --> https://www.arduino.cc/en/Tutorial/BuiltInExamples/ArduinoISP
+
+Load the code, wire the ISP program to the ISP port on the sensor and program it.
+
+Remember to set the processor to Attiny85.
+
+Tools --> Processor: Attiny85
+
+Tools --> Clock: Internal 1 MHz
+
+Tools --> Burn bootloader to set the fuses
+
+
+Sketch --> Upload with Programmer
+
+After programming, the LED should flash two times.
+
+Wiring to the Host Board
+------------------------
+
+|Image|
+
+Connect the the sensor to the host board, such as an Arduino Uno or Mega.
+
+Program the Host with Host_ee_prog.ino and start the console with 19200 baudrate.
+
+Console
+-------
+
+On start, the following is shown:
+::
+ Infidel Sensor Programmer
+ Scanning...
+ I2C device found at address 43
+
+ Version: 3.12
+ Table [ADC] [DIA in um]:
+ 00: 0000 / 3000
+ 01: 0619 / 2090
+ 02: 0702 / 1700
+ 03: 0817 / 1400
+ 04: 1000 / 1000
+ 05: 1023 / 0000
+ Table [DAC min Uout in uV] [DAC max Uout in uV]:
+ 09: 1344 / 2017
+ Command Input 0 - val / 1 - RAW val / 2 - Version / 3 - Table / 4 - Set Tabel Val / 5 - Ongoing raw read / 6 - sample Mean ADC Val
+ Command Input 7 - DAC 0 PWW / 8 - DAC 255 PWM
+
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| Commands | Note | Output |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 0 | Read the Diameter value | Diameter [mm]: 2.242 |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 1 | Read the Diameter + raw ADC Value | Diameter [mm] / [ADC]: 2.242 / RAW: 515 |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 2 | Read the Version | Version: 1.11 |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 3 | Read the Diameter Table | Table [idx] [ADC] [DIA in um] |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 4 | Set the Value in the Table | Input values for Table [IDX],[ADC],[DIA um] like (1,619,2090) |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 5 | Ongoing reading the ADC raw Value, stop when the command 5 is sent one more time | |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 6 | Read Meanvalue from Sensor (100 Samples), Display Min / Max / Mean / cnt, used it for Calibration | ADC Mean: 704 / Min: 688 / Max: 713 / Cnt: 100 |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 7 | Set DAC to PWM 0 --> for check Output Voltage at LOW | |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| 8 | Set DAC to PWM 255 --> for check Output Voltage at HIGH | |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+| h | Show the command list | |
++----------+---------------------------------------------------------------------------------------------------+---------------------------------------------------------------+
+
+Calibration
+-----------
+
+Start with the bigger shaft of known diameter (e.g., 2 mm), insert it into the sensor and read the raw ADC value with command "6".
+Command "6" determines the mean value over 100 measurements and removes the outliers
+::
+ ADC Mean: 704 / Min: 688 / Max: 713 / Cnt: 100
+
+Note the ADC value and use the command "4".
+The console should show:
+::
+ Input values for Table [IDX],[ADC],[DIA um] like (1,619,2090)
+ Input:
+
+Input this string: `1,503,2000`
+Means, Table Index 1 (Command "3"), ADC Val 503, Diameter 3
+
+Repeat this for the next two Ddiameter (1,7mm, 1,4 mm) and write the values to the sensor.
+
+At the end check the settings with Command "3".
+::
+ Table [ADC] [DIA in um]:
+ 00: 0001 / 2999
+ 01: 0617 / 2092
+ 02: 0722 / 1711
+ 03: 0816 / 1401
+ 04: 0999 / 1001
+ 05: 1022 / 0001
+
+The values are stored in the EEPROM and will load from the EEPROM at the next power up.
+
+If you program the sensor with a new firmware over the ISP the EEPROM will be erased and the sensor will start with default settings.
+
+Calibration with Button (Standalone)
+------------------------------------
+
+Press the Button at Powerup for 3 sec, if the Calibrationmode start the LED flashes 10 times
+The sensor sends an analog signal to Pin 5 [OUT].
+
+* Step 1, Led Flash 1 Times
+ * Insert Drill with 1,4mm
+ * Wait a short Time, 1-2 sec
+ * Press the Button for 1 sec
+ * The Led light for 2 sec, the Sensor is getting 100 Samples from the ADC
+ * If the messure is Ok the Led flash fast
+ * Remove the drill an press the Button
+* Step 2 Led flashes 2 Times (1,7mm Drill)
+ * Insert the Drill 1,7mm and repeat Step 1
+* Step 3, Led flash 3 times (2mm Drill)
+ * Insert the Drill with 2mm and repeat Step 1
+
+The Calibration is done
+
+Analog Output
+-------------
+
+The sensor sends an analog signal to Pin 5 [OUT].
+
+The range goes from 1.42 VDC to 2.14 VDC .
+The voltage is the analog for the diameter: 1.73V is equal to 1.73mm diameter.
+
+Calibrate the Analog Output
+---------------------------
+
+Connect a Multimeter to GND and OUT.
+The Analog Output depend on the VCC Voltage, so make the Calibration when the Sensor is connected to the Printerboard
+and not to the unstable USB Port.
+
+* Set with the command "7" the PWM to LOW, meassure the Voltage on Analog OUT and note it (like 1,344 V)
+* Set with the command "8" the PWM to HIGH, meassure the Voltage on Analog OUT and note it (like 2,017 V)
+
+Set with the command "4" the table Value for Index 9 (Calibration Values for DAC)
+IDX 9 then LOW Voltage and the HIGH Voltage --> like: 9,1344,2017
+
+Check the table with command "3".
+The Values are stored in the EEPROM for the next Start
+
+Fault Pin
+---------
+
+The fault pin is high when the diameter is bigger than 3mm and smaller than 1.5mm.
+This indicates that the sensor is outside of the normal working range.
+
+.. |Image| image:: ../../firmware/host_to_sensor_arduino.PNG
+ :alt: Wire Diagram
diff --git a/docs/_images/host_to_sensor_arduino.PNG b/docs/_images/host_to_sensor_arduino.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..620bb7a30668409ac86b1d70bdb0b9c60e7ea377
GIT binary patch
literal 317914
zcmeFYby$^M@HVQn0us_7wGl*VL_!**anl`2N|$s=NC<4YOQpM|OS+Nn?(W#sc{axT
zz45!wU+4P1bFTBp>npDHtTl7btXcQWEc|6&i=y8rx_{@+9dvOqVYxeZ5Jd0XflEX|
z0{*2@9{CFR-(4FyQNcU;y(H_v4+w?=(gJtx6a}MRzC{FnzGo?>YIEn#gC^L2ciSv7
z_3qrcNfQ?qP;k)NN
zhR4AE3;B>5Z$N0R-sO{$hGf^Dwh_}3vhv1c^!=mF5(ADX%D(j
xeC}-KuCUMG6QG
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 |