View EM61-0014E-V2_2374768.PDF datasheet online --- IC-ON-LINE

Datasheet File OCR Text:

em61.ist f i l e procedure application notes elan microelect ronics corp. doc. # ap-EM61-0014E-V2 second edition nove mber 2 002
trademark acknow ledgments ibm is a reg i stered tradem ark a nd ps/2 is a tradem ark of ibm. microsoft, ms, ms-dos, and w i ndows are register ed tradem arks of m i crosoft corporation. easy sound is a registered tradem ar k of elan m i croelectronics corp. docum ent nu mber ap-em6 1 -00 14e-v 2 ? 2001-2 002 e l an micro e lect ronics c o rpor a t ion all rig hts res e rved printed i n t a i w an, roc, 11/2 002 th e con t en ts of in th is d o c u m en t is su bj ect t o ch ang e withou t no tice. elan mi croelect ronics ass u m e s no respon sib ility fo r errors t h at may ap p ear in th is m a n u a l. elan micro e lectron i cs m a k e s no co mmit m e n t to up dat e , o r t o k eep c u r r ent , t h e i n f o rm at i on c ont ai ne d i n t h i s m a nual . t h e soft ware desc ri bed i n t h i s m a nual i s furnis he d unde r a license or nondiscl os ure a g reem ent, and may be use d or copied only in accorda n ce wi th the term s of the a g reem ent. ela n m i cr oel ect ro ni cs p r od uct s are n o t i n t e nde d f o r use i n l i f e s u pp o r t a ppl i a nce s , de vi ces, or sy st em s. use of ela n m i cr oel ect ro ni cs p r od uct s i n suc h a p pl i cat i ons a r e n o t s u p p o rt ed a n d i s pr ohi bi t e d. no p a rt of the easy s o und ? an d of th is m a nu al m a y be repro d u ced or tran sm itt e d in a n y f o rm or b y an y m e a n s with o u t t h e e x pre ss writt e n permiss i on of el an microelectr onics. elan microelec tronics corpor ation headquarters: no. 12, innovation road 1 , science-based in dustrial park, hsinchu, t a iwan , r.o . c. tel : +886 3 5639977 fa x : +886 3 5639966 http:/ /www .em c . c om .tw hong kong office: rm. 1005b, 10 /f empire cen t re 68 mody roa d , t s imsha t sui kowloon , hong kong tel : +852 2838-8715 fa x : +852 2838-0497 ii em61.ist file a p plication notes
1.0 introduction this application notes is appli cable to em61000 series integrated developm ent environm ent (em61id e ) ve rsion 2.0. this tool supports all series of em61000 chips (em61001 ~ em61500). 2.0 overview an instrum e nt map (*.ist) file is au tom a tically generated when you create a new midi project with the em61ide progr am . the file, which bears the sam e filenam e s as that of your project; is lo cated under the project folder. you can always m odify these files to suite the requirem e nts of your pr oject. an example of a m odified instrum e nt map file (t utor.ist) is shown below. the f ile con s isted of th r ee m a jor sec tions, nam e ly : 1. [general] section 2. [instrum ent list] section 3. [t e m plate list] section see followin g pages for the detailed d e scrip tion s o f the con t ents of each section . [gen era l] titl e=e m61 0 00 i nst rum e nt f ile vers ion =2. 0 $wor kdi r=d : \wor k61 \c6 1 _000 1\0 927 \ twf [ins tru men t lis t] tone gr oup = 1 tone gr oup 0=t0 10 t02 4 t03 3 t 046 t072 t0 73 t 074 t09 1 perc uss ion grou p=3 perc uss ion grou p 0 =p0 3 5 perc uss ion grou p 1 =p0 4 0 perc uss ion grou p 2 =p0 5 0 [t01 0] name =mu sic box scal e=a 2-f # 4 g4 -f# 5 g 5 -b6 a2-f #4= t01 0 _0 % nor mal %100 g4-f #5= t01 0 _1 % nor mal %100 g5-b 6=t 010 _ 2 %n orm al % 100 [t02 4] name =ac ous t ic n ylo n g u itar scal e=c 2-f # 3 g3 -f# 4 g 4 -f#5 g5 -f# 7 c2-f #3= t02 4 _0 % nor mal %100 g3-f #4= t02 4 _1 % nor mal %100 g4-f #5= t02 4 _2 % nor mal %100 g5-f #7= t02 4 _3 % nor mal %100 em61.ist file a p plication notes 1
[t03 3] name =el ect r ic b ass fi n gere d scal e=a 2-f # 4 g4 -f# 5 g 5 -b6 a2-f #4= t03 3 _0 % nor mal %100 g4-f #5= t03 3 _1 % nor mal %100 g5-b 6=t 033 _ 2 %n orm al % 100 [t04 6] name =ha rp scal e=a 2-f # 4 g4 -f# 5 g 5 -b6 a2-f #4= t04 6 _0 % nor mal %100 dt 046 _ 0 %d etu ne % 60 g4-f #5= t04 6 _1 % nor mal %100 dt 046 _ 1 %d etu ne % 60 g5-b 6=t 046 _ 2 %n orm al % 100 dt0 46_ 2 %de tun e % 6 0 [t07 2] name =pi cco l o scal e=a 2-f # 4 g4 -f# 5 g 5 -b6 a2-f #4= t07 2 _0 % nor mal %100 dt 072 _ 0 %d etu ne % 85 g4-f #5= t07 2 _1 % nor mal %100 dt 072 _ 1 %d etu ne % 85 g5-b 6=t 072 _ 2 %n orm al % 100 dt0 72_ 2 %de tun e % 8 5 [t07 3] name =fl ute scal e=a 2-f # 4 g4 -f# 5 g 5 -b6 a2-f #4= t07 3 _0 % nor mal %100 g4-f #5= t07 3 _1 % nor mal %100 g5-b 6=t 073 _ 2 %n orm al % 100 [t07 4] name =re cor d er scal e=a 2-f # 4 g4 -f# 5 g 5 -b6 a2-f #4= t07 4 _0 % nor mal %100 g4-f #5= t07 4 _1 % nor mal %100 g5-b 6=t 074 _ 2 %n orm al % 100 [t09 1] name =ch ord voic e scal e=a 2-b 6 a2-b 6=t 091 _ 0 %n orm al % 100 [p03 5] name =ac ous t ic b ass dr u m temp lat e=p 0 35f [p04 0] name =el ect r ic s nar e temp lat e=p 0 40f [p05 0] name =hi gh t om temp lat e=p 0 50f 2 em61.ist file a p plication notes
[tem pla te l ist] t010 _0= % d e faul t 0 10_ 0 .twf %0 t010 _1= % d e faul t 0 10_ 1 .twf %0 t010 _2= % d e faul t 0 10_ 2 .twf %0 t024 _0= % u s er $ wor kdi r \024 _c3 .tw f %0 t024 _1= % u s er $ wor kdi r \024 _c4 .tw f %0 t024 _2= % u s er $ wor kdi r \024 _c5 .tw f %0 t024 _3= % u s er $ wor kdi r \024 _c6 .tw f %0 t033 _0= % d e faul t 0 33_ 0 .twf %0 t033 _1= % d e faul t 0 33_ 1 .twf %0 t033 _2= % d e faul t 0 33_ 2 .twf %0 t046 _0= % u s er $ wor kdi r \046 _c4 .tw f %0 dt04 6_0 =% u ser $wo rkd i r\04 6_c 4_d 1 0.tw f % 0 t046 _1= % u s er $ wor kdi r \046 _c5 .tw f %0 dt04 6_1 =% u ser $wo rkd i r\04 6_c 5_d 1 0.tw f % 0 t046 _2= % u s er $ wor kdi r \046 _c6 .tw f %0 dt04 6_2 =% u ser $wo rkd i r\04 6_c 6_d 1 0.tw f % 0 t072 _0= % u s er $ wor kdi r \072 _c4 .tw f %4 dt07 2_0 =% u ser $wo rkd i r\07 2_c 4_d 1 5.tw f % 4 t072 _1= % u s er $ wor kdi r \072 _c5 .tw f %4 dt07 2_1 =% u ser $wo rkd i r\07 2_c 5_d 1 3.tw f % 4 t072 _2= % u s er $ wor kdi r \072 _c6 .tw f %4 dt07 2_2 =% u ser $wo rkd i r\07 2_c 6_d 1 0.tw f % 4 t073 _0= % u s er $ wor kdi r \073 _c4 .tw f %4 t073 _1= % u s er $ wor kdi r \073 _c5 .tw f %4 t073 _2= % u s er $ wor kdi r \073 _c6 .tw f %4 t074 _0= % u s er $ wor kdi r \074 _c4 .tw f %4 t074 _1= % u s er $ wor kdi r \074 _c5 .tw f %4 t074 _2= % u s er $ wor kdi r \074 _c6 .tw f %4 t091 _0= % u s er $ wor kdi r \091 _g4 .tw f %0 p035 f=% de f ault p0 35. t wf % 0 p040 f=% de f ault p0 40. t wf % 0 p050 f=% de f ault p0 50. t wf % 0 em61.ist file a p plication notes 3
2.1 [general] section this sec tion of the ins t ru m e nt map file defines the ti tle and version information of the file and provides the path to your twf file. example: [gen era l] titl e=e m61 0 00 i nst rum e nt f ile vers ion =2. 0 $wor kdi r=d : \wor k61 \c6 1 _000 1\0 927 \ twf ; the first two lines show the title and version of the file. ; t h e ? $ work dir? (upper ca se) line is where you defi ne t h e direc t or y pa th o f yo ur twf fi le. 2.2 [instrument list] section instrum e nt list is where you prescrib e the instrum e nts for your tone and percussion groups of sound. architectures of its contents are explained below. 2.2.1 tone/percussion instrument group field contents f i e l d d e s c r i p t i o n t one group t one type instr u ment can b e divid ed i n to se veral gr oups, o r t one group = n , w h ere n is the tone grou p nu mber. t one group n = list the numb e r used in the nt h tone gro up. t he values foll o w in g the equ al sig n (= ) states the instrum ent t y pe (or midi patch nu mber), prefi x e d w i th ?t ? (ex: t 010, t 024. etc.). t he numb e rs are s epar ated b y a space. each instrum ent number re pres ents one t y p e of tone instrume nt and must be uniq u e from others. percussi on gro up percussi on t y p e instrume nt can be d i vi ded i n to severa l gro ups, or percussi on gro up = n, w h ere n is the percus s ion gr oup nu mber. percussi on gro up n = list the numb e r used in the nt h tone gro up. t he values foll o w in g the equ al sig n (= ) states the instru m ent numb e r (or midi patch number), prefi x e d w i th ? p ? (ex: p0 35, p 040, etc.). t he numb e rs are s epar ated b y a space. each instrum ent number re pres ents one t y p e of percuss ion i n strument an d mu st be uniq ue fr om others. example: note f o r formattin g conve n ie nce, s o me porti ons o f the example i n strument map file show n bel ow are d i spl a ye d i n tw o lines inst ead of the corr ect sing le l i n e format as sh ow n un der s e ctio n 2.0 ( overview ). w hen w r iting y our file, foll ow the for m atting u nder secti on 2. 0. 4 em61.ist file a p plication notes [ins tru men t lis t] tone gr oup = 1 tone gr oup 0=t0 10 t02 4 t03 3 t 046 t072 t073 t0 74 t 091 ; assign a required tone grou p for y o ur pro j ect and collect the needed tone ty pe instruments for such group i.e., group 0 = t010 (music box); t024 (acoustic ny lon guitar); etc., or as you have defined for th e project).
perc uss ion grou p=3 perc uss ion grou p 0 =p0 3 5 perc uss ion grou p 1 =p0 4 0 perc uss ion grou p 2 =p0 5 0 ; define the required percussion t y pe i n struments (in 3 gr oups) and assign each with the needed instrument; i.e., group 0 = 035 (acousti c bass dru m ); group 1 = 04 0 (el ectric snare); and group 2 = 0 5 0 (high tom ) , or as y ou have defined for th e project). note 1. t one gr oup s h oul d on ly conta i n t one typ e in stru me nts an d is prefixe d w i th ?t .? l i kew i se, percussi on gro up shou ld on ly contai n percus si on type instru me nts and is prefixed w i th ?p.? 2. all instru ment nu mb ers enu mer a ted in th e tone or percussion gro up shou ld have th eir respectiv e instrument na me and conte n ts separate l y listed i n t he [instrume nt list] section. any o m issi on w ill result to err one ous co mpil ation of em6 1 ide. 2.2.2 tone instrument pitch scale field contents fie l d d e sc r i p t i o n [t n] f i eld n a me w i t h tone instrum ent num b e r (pr e fixed w i t h ?t ?) as define d b y midi. name t he correspon din g instrumen t name for the abov e instrum ent numb e r. scale t h is field defin es the full pitch range ( gam ut) in used an d monitors the star t and e nd p o ints of each ran ge ( s epar ated b y a dash ?-?). t here can be mor e than on e segm ent in a full pitc h rang e. each segme n t is sep a rated from others b y a spa c e (ex : a2-f #4 g4-f #5 g5-b). t o tal number of segment in a pitch ran ge ca nnot e x ce ed 2 56. pitch_sc a le t he individ u a l segme n t of the above ful l pitc h rang e (gam ut). t he informati on foll o w in g the e qua l sign (= ) states the correspo n d in g prop erties of the particul a r segment (e x : a2-f #4= t 010_ 0 %normal %10 0 ). 2.2.2.1 pitch scale format pitch_scale = var(0) type weight [var(1) type weight] wher e : pitch_scale is the nam e of the indiv i du al seg m e nt fo r the full pitc h range (ga m ut) as de fined in the ? s cale? fi eld. example : a2-f#4; g4-f#5, g5-b var(0), var(1)? are the instruments (te m pl ate wavefor m ) variables for each pitch scale (s eg m e nt). these variables s e rves as inde xes that link to the cor r esponding t o ne instruments properties defined in the tem p late list section. example: t046_0 / dt04 6_0; t 046 _ 1 / dt046 _1, t0 46_2 / dt04 6_2 note f o r special eff e ct and qu ality , no more tha n 2 templ a te w a veforms sh oul d be assig n e d for simulta neo us p l ayin g per p i tch scale (ga m ut). em61.ist file a p plication notes 5
type is either ?%n o rmal? or ?%det une ? (alway s in upper case). it spe c i fies whether the wavefor m delta frequency co m p ensation is required or not. type = %normal: when the tone instrument is play ed, waveform delta frequency i s normal ( d elta value = 0, as set during conver s ion of wav file into twf file in t h e wav2twf tool. see figure below). hence, no frequency co m p ensation is required. type = %detune: frequency difference exist s and frequency co m p ensation is required when the tone instrument is play ed (delta value weight specifies the percentage of volum e (bas ed on the original sound) requir e d when specified tone inst rument is play ed. exam ples : %0 zero percentage or non e of the origi n al volum e is required, i. e., no sou nd ( m ute). %60 requires 60% of the or iginal vol um e when the specified tone instrum e nt is pla y ed. %100 requires 100% of th e original vol ume when the specified tone instrum e nt is pla y ed. 6 em61.ist file a p plication notes
example: [t01 0] name =mu sic box scal e=a 2-f # 4 g4 -f# 5 g 5 -b6 ; this particular instrum e nt num ber ( [t010] ) is the music box to ne t y pe instru ment per midi. ; a2 ~ b6 is the defined full scale range (gam ut). it consisted of three pitch sca les or seg men t s, na m e ly a2-f#4; g4-f#5; and g5 -b6 . note nu mb er of segments in a full scal e ran g e cann ot exce ed 25 6. each seg m e n t shoul d compos e of a start pitch and an en d pitch separ ated by a dash (-) a s pace se par ate s the seg m e n ts from others. a2-f #4= t01 0 _0 % nor mal %100 g4-f #5= t01 0 _1 % nor mal %100 g5-b 6=t 010 _ 2 %n orm al % 100 ; each of the 3 pitch scale (or se gm ent) is assigned with a sin g le t one i n st rum e nt var i ab l e ( t0 10_ 0, t01 0_1 , and t01 0_2 ) respe c tive l y . these varia b les are linke d to tone instrum e nt na m es stated in the [t em plate lis t ] section where the com p lete pr oper tie s of the instrum e nts are defi ne d. hence, a2-f#4 bec o m es a2 -f# 4 = t010_ 0 % normal % 1 00. where : a2-f #4 is the define d pitch scale (se g m e nt). t01 0_0 is t h e tone i n str u m e nt varia b le to be sourced from [t em plate lis t ] . %n o r m a l is t h e wa vef o r m delta f r eq ue nc y va l u e (0 = n o rm al or no frequenc y c o m p ensatio n require d ) spec if ied whe n c o nverti ng w a v file into twf file w i th w a v2t w f tool (see figure in page 6). %1 0 0 is the required percentage (100% ) of the original volum e to be executed when the specified tone instru m e nt is play ed. note % normal o r % detune must be in up per case. t he percent sign (%) has no functio n except to de no te enclos u re (o pen a nd cl ose pare n thesis). [t04 6] name =ha rp scal e=a 2-f # 4 g4 -f# 5 g 5 -b6 ; this particular instrum e nt nam e ( [t046] ) is the harp tone ty pe instrument according to midi. ; a2 ~ b6 is th e defined full scale range (gam ut). it consisted of three pitch sca les or seg men t s, na m e ly a2-f #4 ; g4 - f # 5 ; a n d g5 - b 6 . em61.ist file a p plication notes 7
note nu mb er of segments in a full scal e ran g e cann ot exce ed 25 6. each seg m e n t shoul d compos e of a start pitch and an en d pitch separ ated by a dash (-) a s pace se par ate s the seg m e n ts from others. a2-f #4= t04 6 _0 % nor mal %100 dt 046 _ 0 %de t une %60 g4-f #5= t04 6 _1 % nor mal %100 dt 046 _ 1 %de t une %60 g5-b 6=t 046 _ 2 %n orm al % 100 dt0 46_ 2 % det u ne % 60 ; each of the 3 pitch scale (or seg m e nt) is assigned with two tone instrum e nt variables ( t046_0 / dt046_0 , t0 46_1 / dt04 6_1 , and t0 4 6_2 / dt046_2 ) res p ectively . these variable s link to tone instrum e nt nam e s stat ed in the [te m plate list] section where the co m p l e te properties of the instruments are defined. hence, a2-f#4 becom es a2 -f# 4 = t046_ 0 % normal % 1 00 dt046 0 % d etune % 60 where : a2-f #4 is the define d pitch scale (s e g m e n t ) . t046_ 0 / dt 046 are the tone instrument variables to be sourced from [template list] section . %n o r m a l is t h e w a v e f o r m d e lta frequency value (0 = normal or no frequency co m p ensation required) specified when converting wav file into twf file with wav2twf tool (see figure in page 6). % d etune is t h e w a v e f o r m d e lta frequency which value is ?999 to 99 9, b u t not 0 (frequency com p ensation required when the tone instrument is play ed). this value is specified when conver- ting wav file into twf fi le with wav2twf tool (see figure in page 6). % 100 / % 6 0 are th e ou tpu t vo lu me set t i ng in p e rcen t a g e i.e., 10 0 % for ou tp ut with ou t delta_f chan ge a n d 6 0 % for ou tp ut w ith del t a_ f change.; note 1. f o r speci a l effect an d q ual ity, no mo r e than tw o tone instrument varia b le s ( tem p lat e w a veforms) sh oul d be ass i gn ed for simulta n eous p l ayi ng p e r pitch scal e (ga m ut). 2. %n or ma l or % d etune must be in upper case. t he percent sign (%) ha s no function except to de no te enclos u re (o pen a nd cl ose pare n thesis). [t09 1] name =ch ord voic e scal e=a 2-b 6 a2-b 6=t 091 _ 0 %n orm al % 100 ; this shows an exam ple of a scal e with a single pitch segment. 8 em61.ist file a p plication notes
2.2.3 percussion instrument field contents fie l d d e sc r i p t i o n [pn] f i eld nam e w i t h the percussi o n instrum ent n u mber (prefi xe d w i t h ?p?) as define d by mid i n a m e i n s t r u m e n t na m e t e m p l a t e t e mplate w a veform variable name example: [p03 5] name =ac ous t ic b ass dr u m temp lat e=p 0 35f ; the percussion instrum e nt ( [p035] ) is an acoustic bass dru m a ccording to midi channel 10. the template=p35f is link e d to percussion instrument name stat ed in the [template list] section where the com p let e properties of the instruments are defined. note 1. percussi on ins t rume nt does not hav e scal e rang e. it links to its properties i n th e [t emp l ate l i st] section through the ?te m pl at e ? l i n e . 2. only one ?te m plate ? l i ne is a l l o w ed per p e rcussio n instru ment. 2.3 [template list] section the tem p la te list section defines the path of your twf file and the corresponding num b er of your tone instrum e nt in the envelope file (*.env). these inform ation are linked by the inst rum e nt p a ram e ters lis t ed in the instrum e nt list section. 2.3.1 field contents fie l d d e sc r i p t i o n var (n) assign a temp l a te w a veform t o this varia b le name a nd sp e c if y its file path an d env el ope i n d e x . t he format is ? var(n) = location file_name envelope_index . em61.ist file a p plication notes 9
2.3.2 template waveform variable format var = location file_name envelope_index wher e : var is the nam e defined b y use r fo r tem p late waveform . its length should not exceed over 32 characters an d m u st be unique from others. location indicates the tem p late waveform location in the default directory or o t herwise. loca tio n = %de fau lt means template waveform i s in the default di rectory (\instl i b). l oca tio n = %us er means template waveform i s not in the default directory . yo u m u st specify the full directory path. file_name specifies the f ilena m e for t h e te m p late wavefor m . loca tio n = %de fau lt need to specify the filename onl y . l oca tio n = %us er m u st specify the absolute path nam e or use &workdir . envelope_index specify the t ype of envelope for tem p late waveform . the format is - %n , where n is any of t h e 32 types (0~32) envelope index available. note that this applies to tone i n struments onl y example: 10 em61.ist file a p plication notes [tem pla te l ist] t010 _0= % d e faul t 0 10_ 0 .twf %0 t072 _0= % u s er $ wor kdi r \072 _c4 .tw f %4 ; the tone instr u ment (m usic box) is t o be sourced from 010_0.t w f , which is located in the default folder \inslib . ; ? % 0 ? is the envelope in d e x num ber as defined in the envelop ( * .env) file. ; the tone instr u ment (picolo) is to be so urced from 072_c4. twf , which is located in the use r defined twf folder. its path d:\work61\c61 _ 0 001 \0927\twf i s defined in t h e [general] section described in section 2.1.1 above. ; ? % 4 ? is the envelope in d e x num ber as defined in the envelop ( * .env) file.
p035 f=% de f ault p0 35. t wf % 0 p040 f=% de f ault p0 40. t wf % 0 p050 f=% de f ault p0 50. t wf % 0 ; the percussion instrum e nts acoustic bass dru m (p035f), elec tric snare (p040f), and high tom (p050f), are t o be sourced from p035.twf, p040 .twf, and p05 0.twf , respectively . these file s are located in the defau lt folder \inslib . ; ? %0 ? has no function in the te m p late l i st as unlike to ne, p e rcussion typ e instruments does not need percussion in dex. ho wever, the value is needed to fill-in the program allocated sl ot. otherwise, error will occur. note 1. default, user, & $workdir must b e in upper cas e . 2. envel ope fil e in dex nu mbers a r e avai lab l e fro m 0 to 31 o n ly. 3. t he para m eter of each sectio n is detai le d in the *.env f ile of your project fo lder. 4. t he perc ent si gn (%) h a s no function ex c e pt to den ote e n clos ure (o pen and cl ose pare n thesis). em61.ist file a p plication notes 11

▲Up To Search▲

Price & Availability of EM61-0014E-V2

	To Download EM61-0014E-V2 Datasheet File
If you can't view the Datasheet, Please click here to try to view without PDF Reader .