nano biscotte v3-gb

Upload: leonardo-donnini

Post on 28-Feb-2018

222 views

Category:

Documents


0 download

TRANSCRIPT

  • 7/25/2019 Nano Biscotte v3-GB

    1/25

    Nano Biscotte (a.k.a. NB) v3.0Entry Range Illuminated Saber Sound Board - Users manual

    Erv - Plecter Labs v 1! "ecember #!1$erv%&lecterlabscom

    'tt&())***&lecterlabscom

    +Si,e does matter Small is beauti-ul and comes in nice &ac.ages++/'is t'ing actually -its into a 1inc' blade 0+

    We spent a lot of time writing this manual to ensure all the importantinformation is provided for proper use of that board. If ou are new tosaber building! to the use of "lecter #abs boards! or simpl to electronics ingeneral! we highl recommend ou print a cop of that document and keepit with ou during the whole process of installing NB in our hilt.

    odiication2 co&ies or distribution o t'at document is strictly &ro'ibited Plecter Labs ) Erv Plecter #!!$-#!1$

  • 7/25/2019 Nano Biscotte v3-GB

    2/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1

    /able o contents

    TABLE OF CONTENTS ------------------------------------------------------------------------------------------------------ 1

    INTRODUCTION--------------------------------------------------------------------------------------------------------------- 2

    SOUND SECTION-------------------------------------------------------------------------------------------------------------- 2

    NANO BISCOTTE FEATURES & MAXIMUM RATINGS-----------------------------------------------------------4

    TOOLS AND PARTS REQUIRED TO INSTALL/OPERATE THE MODULE ---------------------------------- 4

    SD CARD CONTENTS, SOUND BANKS AND SLOTS---------------------------------------------------------------- 5

    BOARD OVERVIEW ---------------------------------------------------------------------------------------------------------- 6

    USERS NOTES----------------------------------------------------------------------------------------------------------------------6

    WIRING AND OPERATING THE MODULE --------------------------------------------------------------------------- 7

    GENERAL POWER SWITCH & RECHARGE PORT----------------------------------------------------------------- 7

    GENERAL WIRING ----------------------------------------------------------------------------------------------------------- 9USUAL WIRING USING A 18650LI-ION CELL -----------------------------------------------------------------------------------9USERS NOTES----------------------------------------------------------------------------------------------------------------------9ALTERNATE WIRING USING 4XAANI-MHBATTERIES OR ALKALINES--------------------------------------------------- 10

    HIGH POWER LED RESISTOR CALCULATIONS------------------------------------------------------------------11

    STUNT UPGRADE ----------------------------------------------------------------------------------------------------------------- 11RESISTOR CALCULATION-------------------------------------------------------------------------------------------------------- 11WATTAGE CALCULATION ------------------------------------------------------------------------------------------------------- 11RESISTOR BARGAIN -------------------------------------------------------------------------------------------------------------- 12

    POWER INDICATOR --------------------------------------------------------------------------------------------------------12

    POWER INDICATOR WIRING ---------------------------------------------------------------------------------------------------- 12POWER INDICATOR RESISTOR -------------------------------------------------------------------------------------------------- 13POWER INDICATOR WIRING (OFF DURING DEEP SLEEP) -------------------------------------------------------------------- 13

    ADVANCED WIRING USING FLASH ON CLASH AND TRI-REBEL ------------------------------------------14

    BOARD SD CARD CONFIGURATION --------------------------------------------------------------------------------15

    CONFIGURATION FILE ----------------------------------------------------------------------------------------------------------- 15PARAMETERS AND FINE TUNING THE SABER --------------------------------------------------------------------------------- 15

    Motion & Gesture detection parameters :-----------------------------------------------------------------------------16Gesture flows & priorities : ---------------------------------------------------------------------------------------------16Sound / Interaction Parameters-----------------------------------------------------------------------------------------18

    High-power LED parameters :------------------------------------------------------------------------------------------19Clashes & Swings Selection Modes ------------------------------------------------------------------------------------19

    INSTALLING A SOUND FONT ON THE SD CARD------------------------------------------------------------------20

    DRIVE (AND FDRIVE) ADJUSTMENTS--------------------------------------------------------------------------------21

    DEEP SLEEP MODE ---------------------------------------------------------------------------------------------------------21

    TROUBLESHOOTING & FAQ --------------------------------------------------------------------------------------------22

  • 7/25/2019 Nano Biscotte v3-GB

    3/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    #

    Introduction/'e 6ano Biscotte is anot'er little brot'er o our 7rystal 8ocus Board It .ee&s t'esame s&irit *'ile using some more modest &arts2 ma.ing it a &erect entry range

    sound 4 board It *as designed as t'e &erect matc' to u&grade stunt sabers at lo*cost Its small si,e allo*s also to install it in t'e smallest 'ilts /'e 6ano Biscotte isactually so small t'at it its inside a 1+ blade 0

    Warning $ %ou&ve 'ust acuired an electronic board containing partssensitive to *+. ,inal wiring - assembl is under responsibilit of the userwith the appropriate tools and *+ protection.

    If ou&re not familiar with *+! please visit $

    http$en.wikipedia.orgwikilectrostatic/discharge

    "lecter #abs can not be held responsible for improper use or assembl ofthe Nano Biscotte board.

    Warning $ igh1power #+s (such as the #u2eon brand #+! which ismentioned in this document) are e2tremel bright. he are considered4class 5 lasers46 %ou should neither look directl at the beam nor point

    someone with it when the blade is not attached to the hilt! 'ust like apowerfull lamp or flashlight. "lecter #abs could not be held responsible foran bad use of high1power #+s.

    o avoid in'uries and retina damage due to the high brightness of high1power #+s! simple 7emitter plugs8 can be built using a piece of bladetubing finished with some decorative greeblies.

    Sound section/'e Plecter Labs sound board is uni9ue It 'as been develo&ed in t'e &ur&ose oim&roving t'e 9uality o "I: sabers sound 8; in a signiicant *ay 8or too many years2sound modules *ere obtained rom sacriiced toys and remained lo* 9uality asterRe&lica 8; sabers bro.e t'e line *it' better sounds and good dynamics e 'ave monitored several attem&ts or building an embedded sound module &layingcustom ? c'angeable sounds2 oten based on c'i&corders Using bul.y &arts2 t'ose

    *ere oten unreliable and 'ard to it in a 'ilt6ot to add t'ose c'i&corders *ere designed ordigital ans*ering mac'ines2 and t'ereoreeature a bad restitution 9uality @voice sam&lerate A

  • 7/25/2019 Nano Biscotte v3-GB

    4/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    D

    to u&load or do*nload sound contents or coniguration o t'e saber t'roug' a sim&leand standard *ay/o avoid any &lugging &roblem *it' a small connector and an easy-to-loose cable2 *eo&ted or a 'ig'-end las' memory card in t'e S" ormat @no* microS"CInserted in a USB card reader li.e t'e one *e sell2 t'e card is seen as a USB storage

    .ey and it ta.es a e* seconds only to transer iles to or rom t'e card2 on ac or P72*it'out t'e need o any custom &iece o sot*are Installing a 6ano Biscotte soundont on t'e card ta.es about 1$ second @1! seconds including t'e ormatting o t'ecardC

  • 7/25/2019 Nano Biscotte v3-GB

    5/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    6ano Biscotte 8eatures ? a4imum Ratings

    - "imensions ( #A$ 4 1A$ 4 $ mm- Po*er su&&ly ( D to $$v ) #3 @*it' t'e *ire2 not

    biggerC- 3n e4ternal &o*er resistor to limit t'e LE" current- rec'argeable batteries- rec'arge &ort li.e canon #1mm soc.et @o&tionalC- 3 &o*er e4tender @PE4C to o&erate las' on clas' @o&tionalC- a&&ro&riate Battery c'arger-

    a USB S" card reader acce&ting micro S" card or a regular S" card reader *it'a micro to regular S" card ada&ter

    - a com&uter- a digital audio editor sot*are 'andling >3J iles i you *is' to create your

    o*n sound onts

  • 7/25/2019 Nano Biscotte v3-GB

    6/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    $

    S" card contents2 Sound Ban.s and SlotsSounds are stored in t'e >3J ormat @1F bits2 ##!$! sam&les &er secondC "es&itet'e act t'at t'e module uses a 1! bit sound out&ut2 *e .e&t t'e 1F bit ormat o t'esound ont2 t'ereore ensuring immediate com&atibility *it' 78 sound onts

    W:; sound files must compl with the format above or the will be skippedduring the boot! leading to sound gaps or board failure.

    6ano Biscotte 'as t*o sound ban.s2 *it' all t'e iles @including coniguration ilesCstored in t'e root directory o t'e S" card /'e sound content o a ban. is called aSound 8ont

    3 sound ban. 'as #! sound slots s&lit as belo*(

    a boot sound @boot.wavC a &o*er on sound @poweron.wavC

    a &o*er o sound @poweroff.wavC

    continuous 'umming @hum.wavC

    A clas' sounds @clash1.wavto clash8.wavC

    A s*ing sounds @swing1.wavto swing8.wavC

    >'en t'e &o*er su&&ly voltage is a&&lied to t'e board2 our board MbootsN and &lays alittle logo sound to notiy t'e user2 =ust li.e a digital camera /'is little logo ma.es

    sure t'e 6ano Biscotte started &ro&erly and it gives a s&ecial identity to t'e saber andto t'e loaded sound ont /'is sound can be o course customi,ed I t'e boot sound

    boot.wavis not on t'e S" card2 a little bee& is &layed instead I you dont *ant any

    sound *'en &o*ering t'e module2 create a >3J sound ile *it' 1!! ms o silence

    /'e sounds mustbe all t'ere on t'e S" card and be named &ro&erly @lo*er caseC to

    'ave t'e module o&erating &ro&erly Same t'ing or t'e coniguration iles @.txt)

    >e advice t'e user to .ee& all its sound and coniguration iles in s&eciic olders ont'e 'ard dis. on t'e com&uter so t'at c'anging t'e sabers contents remains [email protected] boardC Use some e4&licit naming o t'e olders so t'at you can easilyremember *'at t'e sound ont and coniguration iles are doing2 or instance

    [very_sensitive_dark_lord_saber]

    /'e 6ano Biscotte is 1!!O com&atible *it' bot' 7rystal 8ocus and Petit 7routonsound onts E4tra sound iles rom t'ose boards are sim&ly ignored during t'e boardbooting o&eration

  • 7/25/2019 Nano Biscotte v3-GB

    7/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    F

    Board 5vervie*

  • 7/25/2019 Nano Biscotte v3-GB

    8/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    H

    >iring and 5&erating t'e odule/'e board must be &o*ered *it' an a&&ro&riate battery &ac. >e 'ig'ly recommendt'e use o good 9uality li1ion batter&ac.s made o a single 1$!! or 1AF$! celland including protection "=Bs /'e 3> brand ma.es su&erior 9uality batteries

    *'ile t'e Ultraire)/rustire remains a cost eective solution/'e 6ano Biscotte 'as been 'ig'ly o&timi,ed so t'at bot' a *ired battery &ac. andremovable cells could be used *it' t'e board /'e minimal current used in dee& slee&mode allo*s t'e saber to stay unused on t'e s'el or H mont's *it' a ully c'arged1AF$! 5 course2 t'e use o t'e rec'arge &ort and t'e .ill .ey is &ossible too 0

    6i-< battery &ac.s are sim&ly not recommended since t'ey 'ave a bigger energystorage)volume ratio and cost o li-ion cells isnt an issue anymore 'en &o*er is a&&lied to t'e board2 it *ill &lay t'eboot.wavsound /o start t'e

    sound board2 sim&ly &ress t'e activation s*itc' /'epoweron.wav sound *ill be

    &layed and t'e 'ig'-&o*er LE" *ill ram& u& in brig'tness in sync'roni,ation *it' t'esound 8rom t'ere t'e sound board *ill &lay t'e hum.wavsound in loo&2 interru&ted

    by motion 4 sounds /o sto& t'e sound board2 &ress t'e activation s*itc' again@eventually or a certain time2 i t'e &o*er o delay 3-P5P eature is usedC /'epoweroff.wavsound *ill be t'en &layed

    3ter a conigurable duration @reer to t'e coniguration section o t'is manualC t'eboard *ill move into dee& slee& mode Pressing t'en t'e activation s*itc' *ill ma.e

    t'e saber booting again *it' t'eboot.wavsound to get it out o t'e slee& mode3not'er &ress on t'e activation s*itc' *ill ignite t'e blade

    eneral Po*er S*itc' ? Rec'arge Port"es&ite t'e 6B board 'as a very lo* idle current use @G !1 m3C *'en it enters dee&slee& mode2 t'e user mig't &reer a battery solution or *'ic' 'e doesnt 'ave toremove t'e cell

    3 &in #1 mm M7anonN soc.et is a &o&ular c'oice

    /*o o t'ose &ins are connected *'en not'ing isinserted in t'e soc.et 7ontact is disru&ted *'en a&lug is inserted

    3long t'e years2 t'e M.ill .eyN tec'ni9ue 'as beendevelo&ed( a a.e &lastic &lug is decorated to loo.li.e an actual &art o t'e 'ilt >'en inserted2 it cutst'e &o*er su&&ly to t'e board in t'e rec'arge &ort5 course2 t'e &ort rec'arges t'e internal battery&ac. *'en an actual c'arger &lug is inserted

  • 7/25/2019 Nano Biscotte v3-GB

    9/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    A

    /'e ill ey must be made out o a non-conductive material @PJ72 6ylon etcC /'e let&icture above s'o*s a .ill .ey made out o a sacriiced male &lug @metalC but its&rovided only as a reerence &icture and &lastic s'ould be used as a rule o t'e t'umb

    'en not'ing is inserted in t'e &ort2 t'e negative o t'e battery &ac. is internallyconnected to t'e s*itc'ed negative tab2 'ence &o*ering t'e board >'en a ill ey isinserted in t'e &ort2 t'e negative o t'e board is no longer connected to t'e negativeo t'e battery &ac.( t'e board is ully &o*ered do*n >'en a c'arger &lug is insertedin t'e rec'arge &ort2 t'e c'arging voltage is reac'ing bot' leads o t'e battery &ac.*'ile t'e negative o t'e board is still unconnected rom t'e circuit2 &reventingdamages to t'e electronics and ensuring only t'e battery &ac. is connected to t'ec'arger or &ro&er c'arge

    In t'e &revious &icture t'e green-blac. dra*n s*itc'ed doesnt need to be *ired &ersay2 it only illustrates t'e rec'arge soc.et internal s*itc'

  • 7/25/2019 Nano Biscotte v3-GB

    10/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    Q

    eneral *iring?@A0 li1ion cell/'e board doesnt need many connections to be o&erated 3side rom t'e rec'arge&ort ) &o*er su&&ly detailed above @o&tionalC2 only a s*itc'2 t'e 'ig' &o*er LE"

    negative and t'e s&ea.er are re9uired to be soldered to get all t'e eatures t'e 6anoBiscotte board &ro&oses

    /'e 6ano Biscotte *iring is com&atible *it' #$ mm 'eaders meant to acce&t a*iring 'arness or individual &airs o emale 'eaders or t'e &o*er su&&ly2 t'eactivation s*itc' and t'e s&ea.er2 *'ic' allo*s t'e *iring to be versatile and scalable

    /'e board doesnt use a current regulator to drive t'e 'ig'-&o*er LE"2 t'ereorecurrent limitation must occur outside o t'e board2 li.e on regular stunt *iring2 using a&o*er resistor /'e &ositive o t'e LE" goes to t'e &o*er resistor and to t'e &ositiveo t'e battery2 t'e LE" negative goes to t'e L- &ad o t'e board

  • 7/25/2019 Nano Biscotte v3-GB

    11/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1!

    :lternate wiring using 2:: Ni1C batteries or alkalines3l.aline batteries arent recommended as t'eir eiciency is not as good as li-ion ort'e same volume but t'ey remain an alternative solution or &o*ering t'e saber 8our6i-< batteries ully c'arged *ill generate about $Fv *'ic' could e4ceed t'ema4imum ratings o t'e board2 and our al.aline batteries reac' FJ 3 sim&le 'ac. can

    overcome t'is issue using a diode 3ny diode rom t'e 16!!4 *ill *or. 6ote t'at*'en using 4332 t'e in&ut voltage is 'ig'er2 'ence t'e &o*er resistor *attage *illincrease2 as *ell as t'e dissi&ated 'eat

    >it' 4 al.aline batteries2 I recommend to use />5 diodes to ensure t'e boardsvoltage is really belo* its ma4 ratings

  • 7/25/2019 Nano Biscotte v3-GB

    12/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    11

  • 7/25/2019 Nano Biscotte v3-GB

    13/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1#

    Desistor bargain3s seen in t'e e4am&le above2 a !$F o'm resistor mig't not be easy to ind 3lso2 t'euser s'ould not ocus on t'e absolute &recision o t'e resistor value i 'e is still *it'int'e LE" s&eciications and ratings Instead o loo.ing or an e4&ensive source o a rareresistor2 t'e user can crat 'is o*n using # @or moreC resistors

    >it'out going too muc' into boring details2 t'eres a sim&le rule o t'e t'umb sayingt'at *iring # identical resistors in &arallel divides t'e resistor value by # and multi&liest'e *attage by #

    In our &revious e4am&le2 a #>2 !$ o'm @is'C resistor could be obtained *it' # 4 1 >21 o'm resistor

    Use eit'er ceramic or t'ic. carbon ilmresistors only as your 'ig'-&o*er LE"resistor @65 metal ilmC >'en combiningt'em in &arallel2 ceramic resistors can be

    directly *ired directly In t'e case ocarbon ilm resistor2 I recommendindividually *ra&&ing t'em in 'eat-s'rin.ing tube to avoid s'orts i t'eir &aintc'i&s @*'ic' sometimes 'a&&ens i t'eyare touc'ing eac' ot'ersC

    I t'e resistor calculation ends u& &roviding eit'er a very small resistor value or anegative value @0C2 you mig't s.i& t'e use o a resistor and ad=ust t'e LE" driveinstead Reer to t'e +rive (andfdrive) adjustmentssection or more details

    Po*er indicator

    "ower Indicator Wiring

    /'e 6ano Biscotte 'as a DDJ &ad t'at can &o*er a small accent LE" *'en its&o*ered /'is eature is recommended only i t'e saber is e9ui&&ed *it' a main&o*er s*itc' @more li.ely a rec'arge &ort *it' a .ill.eyC ot'er*ise t'e LE" *illde&lete t'e battery muc' 9uic.er t'an e4&ected des&ite t'e dee& slee& mode o t'esound board

    # 4 1> 1T !$ T #>

    R1

    R#

  • 7/25/2019 Nano Biscotte v3-GB

    14/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1D

    "ower Indicator Desistor

    /'e calculation is airly identical to t'e &o*er resistor o t'e main LE"

    R = (Vsupply Vled) / LedCurrent

    In our case2 Jsu&&ly is t'e voltage t'e board &rovides to &o*er t'e accent LE"s2 ieDDJ /'e Jled is t'e or*ard voltage o t'e accent LE"2 usually reerred as J in t'edatas'eet /'e led current 'as to be decided by t'e user2 de&ending on t'e brig'tnessand t'e ma4imum rating o t'e used LE" $ to1$ m3 are airly common or mostaccent LE"s

    3s an e4am&le2 lets consider a 1F volt LE" @redC at 1! m3

    R @DD 1FC ) !!1 1H! o'm @1$! o'm in t'e classic E1# resistor serieC

    Be sure not to drive too muc' current in t'e LE" @#! m3 ma4C I you *is' a goodbrig'tness *it' a lo* current2 use a 'ig' eiciency LE" @generally coming in atrans&arent McrystalN coatingC

    "ower Indicator Wiring (off during deep sleep)

    /'e same .ind o &o*er-on indicator can be *ired in suc' a *ay t'at t'e accent LE"

    *ill go o during dee&-slee& /'e &ositive to t'e LE" @via a resistorC is t'is timegrabbed on t'e "S @"ee& Slee&C &ad as illustrated belo* /'e s&ot out&uts a DDJvoltage li.e t'e regular &o*er indicator o t'e &revious &aragra&'2 but only *'en t'eboard isnt aslee&

  • 7/25/2019 Nano Biscotte v3-GB

    15/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1

    3dvanced *iring using 8las' on 7las' and /ri-rebel/'e e4am&le belo* s'o*s t'e *iring o a tri-rebel styled LE" *it' # identical dice*ired in &arallel and t'e e4tra t'ird die used or t'e 8las' on 7las'2 using t'e on-board Po*er E4tender @PE4C on t'e t' &ad

  • 7/25/2019 Nano Biscotte v3-GB

    16/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1$

    Board S" 7ard 7oniguration

    =onfiguration ,ile

    /'e 6ano Biscotte board comes *it' a single config.txtconiguration ile *'ic' is

    a sim&le te4t ile t'at can be edited *it' *indo*s note&adIt is com&osed o ## &arameters t'at must allbe &resent in t'e ile 5t'er*ise2 t'emodule *ill use deault &arameters

    /'e te4t ile acce&ts comments on a stand alone line @not mi4ed *it' a &arameterlineC /'e comment symbol is t'e 7 language double slas' V)) as t'e very irstc'aracters o t'e line 7omments can be used or leaving notes in t'e conigurationile or or disabling a coniguration line 6ote t'at =ust li.e our ot'er saber boards @782P7C2 synta4 also acce&ts t'e scri&t style comment WW 5ur convention is to use t'edouble slas' @))C comment at t'e to& o t'e coniguration ile to name it WWcomments are used or &arameter lines disabling 8or e4am&le (

    // My Nano Biscotte 1138 config file

    ## i=65 - no this is way too highi=55

    3ll &arameters o t'e 6ano Biscotte are integers /o modiy t'e ile2 insert t'e S"card in t'e USB card reader2 and t'en bro*se t'e contents *it' *indo*s ile e4&lorer@on E:or instanceC "ouble-clic. on ile config.txt( t'e note&ad o&ens :ou can

    directly save t'e ile on t'e S" card 5nce t'e coniguration is inali,ed and saved2sim&ly remove t'e card rom t'e reader ater 'aving it Me=ectedN @rig't clic. on t'e

    reader device in *indo*s e4&lorer2 conte4tual menu2 e=ectC /'is ste& isnt mandatoryanymore and can be s.i&&ed *it' modern o&erating systems li.e >indo*s ;P orSeven

    Put t'e card bac. in t'e saber and test you ne* setu&0

    /'e coniguration ile C5 btes I t'e si,e is bigger2 t'e ile*ill be s.i&&ed *it'out urt'er analysis and deault &arameters *ill be used /'e basicconiguration ile o 6ano Biscotte is about 1Q! bytes2 *it' a e* comment lines or aneasier reading a.e sure not to add too many comments in t'e ile I you are notsure o t'e ile si,e2 c'ec. it in >indo*s ile E4&lorer2 *it' a rig't clic. on t'e ile2t'en M&ro&ertiesN in t'e conte4tual menu

    Cake sure ou have no space characters at the beginning of the line! orbetween the EF& sign and the value of a parameter.

    "arameters and fine tuning the saber/'e coniguration ile includes a set o &arameters dedicated to t'e sound section ot'e controller and t'e gestural ) motion detection @bot' being lin.edC 3 second set o&arameters 'andles t'e be'avior o t'e 'ig'-&o*er LE" Some &arameters inluence

    bot' categories2 since visual and sound eects are in tig't relations'i& intrinsically 3ll&arameters are lo*ercase

  • 7/25/2019 Nano Biscotte v3-GB

    17/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1F

    =ertain parameters involve time duration dela. We tried to normaliGethose parameters to a single unit$ a multiple of 5ms.

  • 7/25/2019 Nano Biscotte v3-GB

    18/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1H

    3 s*ing sound can never interru&t a clas' sound if the clash flow limiter is stillengaged2 and *'et'er or not t'e s*ing rate limiter is engaged

    I t'e clas' lo* limiter 'as e4&ired2 and even i t'e clas' sound is still &laying2 as*ing sound can interru&t it

  • 7/25/2019 Nano Biscotte v3-GB

    19/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1A

    Sound / Interaction Parameters

    vol [0-4]( digital volume setu& ! mutes t'e sound out&ut2 is t'e

    ma4imum volume

    shmrd [10-500]( duration o t'e s'immering eect o t'e 'ig'-&o*er LE"during a clas' a.e sure t'is duration is not too muc' longer t'an t'eassociated sound to .ee& a nice result

    shmrp [5-25]( &eriodicity o t'e lig't bursts during t'e clas' eect 3 slo*

    &eriod *ill &roduce tig't bursts

    shmrr [0-25]( random value a&&lied to t'e &eriodicity o t'e lig't burst

    during a clas' eect 3llo*s 'aving bursts t'at are not regularly s&aced in time*'ic' increases t'e realism 8or instance2 a &eriod shmrpo #! and a random

    value shmrro 1! *ill &roduce a &eriod bet*een t*o bursts varying bet*een

    #! and D! @ie ! and F! msC

    focd [10-500]( duration o t'e 8las' on 7las' eect a.e sure t'is

    duration is not too muc' longer t'an t'e associated sound to .ee& a niceresult

    focp [5-25]( &eriodicity o t'e lig't bursts during t'e 8las' on 7las' eect

    3 slo* &eriod *ill &roduce tig't bursts

    focr [0-25]( random value a&&lied to t'e &eriodicity o t'e lig't burst during

    a clas' eect 3llo*s 'aving bursts t'at are not regularly s&aced in time *'ic'increases t'e realism 8or instance2 a &eriod focpo #! and a random value

    focro 1! *ill &roduce a &eriod bet*een t*o bursts varying bet*een #! and

    D! @ie ! and F! msC

    offd [0-10000]( Part o t'e 3nti &o*er o &rotection @3-P5PKC using t'e

    &o*er o delay /o avoid accidentally &o*ering o t'e saber2 es&ecially *'enusing a momentary button or activation2 *e added anot'er &o*er o&rotection t'at isnt using an au4iliary s*itc' @*'ic' doesnt e4ist on t'e 6BboardC /'is &arameter deines 'o* long t'e user must &ress on t'e activations*itc' to turn t'e saber o "eault is #!! *'ic' e9uates to !! ms

    qon [0-3000]( M9uic.-onN 3llo*s 'aving t'e blade ignited in a s&eciic

    amount o time rat'er t'an matc'ing t'e duration o t'e &o*er on sound hisparameter is specified in milliseconds (ms)2 and s'ould not e4ceed t'eduration o any &o*er on sounds

    qoff [0-3000]( same t'ing as above2 but or t'e blade retraction :lso in

    ms

    resume [0-1]( 'um resume "eines i sound comes bac. to *'ere t'e 'um

    'as been interru&ted or not Interesting or certain 'ums 6ot sam&le accuratebut resumes t'e 'um in a ball&ar. o 11ms rom *'ere its been interru&ted bya 4 sound @s*ing ) clas'C

    deep [0-18446744073709551615]( deines t'e time ater *'ic' t'e soundboard *ill move into dee& slee& mode or saving &o*er @G!1 m3C "arameter

  • 7/25/2019 Nano Biscotte v3-GB

    20/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    1Q

    e2pressed in multiples of 50 ms "eault is 1$!!! *'ic' e9uates D!!seconds or $ minutes DF!2!!! e9uates # 'ours ! disables t'e eature /'ema4 value leads to 112AF12DD#2D$1 years @11A /era-yearC /'is &arameter is agood e4am&le t'at enlarging a &arameter range to a stu&id &oint =ust becauseyou can doesnt ma.e t'e eature better

    High-power LED parameters :

    drive [0-1023]( deines t'e ma4imum drive o t'e 'ig'-&o*er LE" Leave it

    to t'e ma4imum unless you understand 'o* to use it See t'e "rive3d=ustment section or more details

    fdrive[0-1023]( deines t'e ma4imum drive o t'e 'ig'-&o*er die use ort'e 8las' on 7las' @8o7C eect

    flks [0-20]( s&eed o t'e energy variation ) lic.ering eect o t'e blade 3

    'ig' value &roduces a damaged saber eect *'ile a small value generatessubtile energy c'anges /'e value ! disables t'e eect @static bladeC

    flkd [0-100]( de&t' @in OC o t'e energy luctuation eect2 ie t'e t'e

    range over *'ic' t'e LE" brig'tness *ill be aected during t'e eect 3 lo*value does not modiy t'e energy very muc' *'ile a 'ig' value X digs Y bigste&s o lig't intensity /o be used *it' t'e &arameter flks

    Clashes & Swings Selection Modes

    /'e 6ano Biscotte 'as a single random met'od or selecting t'e clas' and s*ingsounds Its t'e same as mode 3 on a 78 board( t'is a im&roved random modereered as Random; mode or MBubble SortN random /'e idea is to avoid triggeringt*ice t'e same sound in a se9uence /'is ne* algorit'm *ill ma.e sure a se9uence @As*ings ) A clas'esC does not 'ave any du&licate2 but you mig't still get a doublebet*een # consecutive se9uences o A sounds2 in rare cases

  • 7/25/2019 Nano Biscotte v3-GB

    21/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    #!

    Installing a Sound 8ont on t'e S" card

    :lthough editing the configuration files (te2t files) can be done directl ontoour micro*+ card! changing the *H

  • 7/25/2019 Nano Biscotte v3-GB

    22/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    #1

    "rive @and driveC ad=ustments/'ere are al*ays s&ecial cases and e4ce&tions 5ne is to end *it' a resistor valuecalculation t'at gives an e4tremely small value @G!$ o'mC

    :ou can al*ays *ire several resistor in &arallel to reac' t'e rig't value but t'e 6ano

    Biscotte is designed to ta.e care o t'at t'an.s to t'e drive &arameter in t'econiguration ile

    /'e drive&arameter deines t'e ma4 drive t'at is a&&lied to t'e 'ig'-&o*er LE" Bydeault @1!#DC it a&&lies t'e battery voltage

    Lets ta.e a green LE" t'at 'as a or*ard voltage o D$J %13 It is really close tot'e battery voltage /'e resistor calculation remains t'e same

    R = (Vcell Vled) / LedCurrent

    R @DH - D$C ) 1 !1$ o'm

    5n t'e one 'and2 suc' a small resistor is un&ractical to source and tolerance *ill notlead to an accurate current limitation 5n t'e ot'er 'and2 not using a resistor *illoverdrive t'e LE" *'ic' mig't ry /'e board driver can act as a linear2 conigurableresistor2 using t'e drive&arameter >'en getting suc' a small resistor value @belo*!$ o'm2 36" Jled G JcellC2 t'e drive can be calculated as ollo*s(

    drive = 1023 * (Vled / Vcell)

    in our case2 drive 1!#D @D$ ) DHC Q$

    /'e drive&arameters can be also ine tuned using an am&-meter in t'e 'ig'-&o*er

    LE" circuit( ad=ust t'e drive until you reac' t'e e4act average current re9uired oryour LE" 6ever set t'e drive under A!O o t'e ma4imum value

    "ee& slee& mode/'e sound board 'as t'e ability to go in a &o*er saving mode called dee& slee&mode 5nce it 'as entered t'at mode2 t'e ne4t &ress on t'e activator s*itc' *ill not&o*er u& t'e blade but *ill ma.e t'e board reboot irst to get out o t'e dee& slee&mode 3not'er &ress on t'e activator s*itc' *ill ignite t'e saber normally

    /'e dee& slee& mode delay @deep&arameter in t'e coniguration ileC is conigurableas eac' use mig't *ant a s&eciic &o*er saving sc'eme 8or young .ids sabers2 t'edeep setting mig't be very lo* suc' as $ minutes to ensure t'e saber *ill move9uic.ly in &o*er saving mode ater being abandoned 7onversely2 a sound u&gradedstunt saber used or stage c'oreogra&'y cannot ta.e t'e ris. to be in dee& slee&mode =ust beore a &erormance2 so t'e setting mig't be increased to 1 day

    >'en t'e blade is o2 t'e sound board is in idle mode and it uses H$m3 @beoreentering dee& slee& modeC /'is idle current is lo* enoug' to still allo*s a 'ugeruntime even i t'e saber remains in t'at state or a *'ile [ t'e saber *ill still be*or.ing ater staying 1 *ee. to 1! days in idle mode *'en using a ully c'arged

    1AF$! li-ion cell

  • 7/25/2019 Nano Biscotte v3-GB

    23/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    ##

    /roubles'ooting ? 83\

    ( Ive u&dated t'e sounds on t'e S" card and no* t'e module does not *or.anymore It generates some bee&s *'en it starts

    :( :ou must ormat t'e S" card @in 83/1F ) 83/D#C beore u&dating t'e sounds2*'ile its not necessary to do so or t'e coniguration iles t'at can be edited in &laceon t'e S" card /o sim&liy t'e u&date &rocess2 &ut t'e ne* sounds on t'e S"2over*rite t'e old ones /'en select t'e *'ole contents o t'e S" card2 and co&y it ina tem&orary directory)older on t'e 'ard dis. 8ormat t'en t'e card2 and ne4t co&yt'e iles bac. to t'e S" card in one run

    ( *'ats t'e meaning o t'e bee&s *'en t'e module starts

    :( it means t'at a ile is missing or 'asnt been ound It can be t'e boot sound2 ort'e coniguration iles /'ree bee&s generally mean t'at many im&ortant iles 'avent

    been ound @boot.wav2 config.txtC

    ( can I rename t'e sounds on t'e S" card to s*a& t'em ]

    :( 65 7'ange t'e sound organi,ation on t'e

  • 7/25/2019 Nano Biscotte v3-GB

    24/25

    Plecter Labs is in no *ay ailiated2 associated2 licensed or endorsed by "isney or Lucasilm Ltd2 Industrial Lig'tand agic or any o t'eir associates3ll brands and trademar.s listed are t'e e4clusive &ro&erty o t'eir res&ective5*ners

    #D

    Plecter Labs *ould li.e to t'an. its ailiates or t'eir useul in&ut on t'e 6ano BiscotteBoard s&ecs2 ne* eatures ideas2 constructive criticism as *ell as &roo reading o t'eusers manual

    I also *ould li.e to dee&ly t'an. t'e 78)P7)6B users2 customers and t'e illuminated

    saber 'obby community or t'e trust2 su&&ort and in&ut in my *or. t'roug'out t'eyears2 &us'ing t'e design o our avorite &ro&s to*ard &er&etual im&rovement

    M7ustom Electronics -or Pro&s t'at >5RB0N

  • 7/25/2019 Nano Biscotte v3-GB

    25/25

    6on e4'austive list o trademar.s o*ned by Plecter Labs

    Blaster ove K>a.e on oveKPo*er on oveKPo*er on 8orceK8o7K ) 8las' 5n 7las'K

    Jocal enuKute on t'e goK

    3nti Po*er 5n)5 Protection - 3P5PKRI7E - Real time Internal 7oniguration EditorK7rystal PulseK7rystal 8ocusK and 7rystal 8ocus Saber 7oreKPetit 7routonK6ano BiscotteK

    Po*er 5n 3ngular SelectionKS" conigK8orce 7las'K8orce S*ingKButtered /oastKSSB/KSecret Society o t'e Buttered /oastKPo*er E4tenderKPo*er ;tenderKSaber 3udio PlayerK @S3PKC a.a iSaber

    3ccuBoltK8le4iBlendK

    /'e use o Plecter Labs trademar.ed terms is &ro'ibited or use in advertisement orsales o a &roduct not made by Plecter Labs or or a &roduct not containing a PlecterLabs electronic device