Manuale d’uso / di manutenzione del prodotto PM5358 S/UNI 4x622 del fabbricante PMC-Sierra
Vai alla pagina of 136
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. Document ID: PMC- 2010419, Issue 1 PM5358 S/UNI-4 X 622 D RIVER M ANUAL P ROPRIET A R Y A ND C ONFI DENTIAL P RELIM.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 2 Document ID: PMC- 2010419, Issue 1 A BOUT THIS M A NUA L A ND S/UNI-4 X 622 This m anual describes the S/UNI- 4x622 (PM5358 ) device driv er . It descr ibes the driv er ’ s function s, data st ructures, an d archite cture.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 3 Document ID: PMC- 2010419, Issue 1 Legal Issues None of the inf ormatio n contained in thi s docum ent constitu tes an expre ss or im plied warran ty by PMC-Sie rra, In c.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 4 Document ID: PMC- 2010419, Issue 1 T ABL E O F C ONTENTS About this Manual and S/UNI- 4x622 ........................................................................
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 5 Document ID: PMC- 2010419, Issue 1 3.2 S tructures Passed b y the Ap plication ......................................................................... 26 Module Initi ali zation V ec t or: MIV .
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 6 Document ID: PMC- 2010419, Issue 1 Writing the K1K2 Byte: suni4x6 22LO HW r iteK1K2 .................................................. 65 Reading the K1K2 B yte: suni4x62 2LOHRead K1K2 .
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 7 Document ID: PMC- 2010419, Issue 1 Clearing RPOH Interru pt Enable Mask: s uni4x622C lrMaskRPO H ......................... 86 Getting P YLD Interr upt Enabl e Mask : suni4x622Ge tMask PYLD .
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 8 Document ID: PMC- 2010419, Issue 1 5.2 System- S pecific Interrupt Serv icing .......................................................................... 109 Installing th e ISR Hand ler: sysSun i4x622I SRHandlerInstall .
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 9 Document ID: PMC- 2010419, Issue 1 Payload Events (PYLD) ......................................................................................... 128 Line Interf ace Events (INTF_LINE) .
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 10 Document ID: PMC- 2010419, Issue 1 L IST OF F IGURE S Figure 1: Driv er External Interf aces.......................................................................
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 1 1 Document ID: PMC- 2010419, Issue 1 L IST OF T ABL ES Table 1: S/UNI-4x622 Module I nitiali zation Vec tor: sSUNI4x62 2_MIV ............................. 27 Table 2: S/UNI-4x 622 Device Initia li zati on Vec tor: sSUNI4x 6 22_ DIV .
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 12 Document ID: PMC- 2010419, Issue 1 Table 22: S/UNI-4x 622 Globa l Line Int erfac e Configura tion: sSUNI4x622_CFG _INTF_LINE _GLOBAL ..............................
PM5358 S/UNI-4x 622 Driver Manual Introduction Proprietary and Confi dential to PM C-Sierra, Inc. 13 Document ID: PMC- 2010419, Issue 1 1 I NTRODUCTI ON The follow ing section s of th e S/UNI- 4x622 Device Driver Des ign Specif ication descr ibe the S/UNI-4x622 dev ice driver .
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 14 Document ID: PMC- 2010419, Issue 1 2 S OFTW ARE A RCHI TECTURE This sec tion descr ibes the so ftware arch itecture of the S/UNI -4x622 device d river .
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 15 Document ID: PMC- 2010419, Issue 1 • I nitialize the device(s) • Perform diagnostic t.
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 16 Document ID: PMC- 2010419, Issue 1 • Alarm, status and count s • Section Ov erhead .
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 17 Document ID: PMC- 2010419, Issue 1 • Maximu m numb er of devices • The DDB( s) The Device Da ta-Block (DDB) is conta ined in the MDB, and init ialized by the driv er module f or each S/UN I-4x622 dev ice that is reg istered.
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 18 Document ID: PMC- 2010419, Issue 1 Section Ov erhead The Sectio n Overhead sec tion pr ovides func tions to con trol and m onitor the section ov erhead processing .
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 19 Document ID: PMC- 2010419, Issue 1 2.3 Sof t w are St ates Figure 3 sh ows the softw are state diagram for the S/UNI- 4x622 driver . State transiti ons occur on the success ful execut ion of the co rresponding transition functions shown.
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 20 Document ID: PMC- 2010419, Issue 1 Module St ates The follow i ng is a description o f the S /UNI-4x622 m odule states. See sectio n 4.1 for a de tailed descrip tion of the API function s that ar e used to change the m odule state.
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 21 Document ID: PMC- 2010419, Issue 1 2.4 Processing Flo w s This sec tion descr ibes the m ain processing flows of the S/ UNI-4x622 driv er component s.
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 22 Document ID: PMC- 2010419, Issue 1 Figure 5: Device Mana gement Flow Diagra m De-acti vates t he device and rem oves it from norm al operati on.
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 23 Document ID: PMC- 2010419, Issue 1 The driv er provides sy stem -independent fun ctions, suni4x622ISR and suni4x622DPR . Y ou must fil l in the co rrespon ding system -specific fu nctions, sysSuni4x622ISRHandler and sysSuni4x622DPRTask .
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 24 Document ID: PMC- 2010419, Issue 1 Calling suni4x622D PR The sysSuni4x622DPRTask funct ion is a sy stem speci fic funct ion that runs a s a separa te task within th e R T OS.
PM5358 S/UNI-4x 622 Driver Manual Sof tware Architecture Proprietary and Confi dential to PM C-Sierra, Inc. 25 Document ID: PMC- 2010419, Issue 1 Figure 7: Poll ing Service M odel In polling mode, the application is res ponsible fo r calling suni4x622Poll often enough to service any pending error or alarm condi tions.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 26 Document ID: PMC- 2010419, Issue 1 3 D AT A S T RUCTURES This sec tion descr ibes th e elements of the driv er that config ure or cont rol its be havior , and should therefore b e of in terest t o the appli cation prog ramm er .
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 27 Document ID: PMC- 2010419, Issue 1 T able 1: S/UNI-4 x622 Modu le Initia lization V ector: sSU.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 28 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description cbackPYLD sSUNI4x62.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 29 Document ID: PMC- 2010419, Issue 1 T able 4: S/UNI-4 x622 ISR Mask: sSUNI4x622_MASK_ISR_CHAN F.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 30 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description psbf UINT2 APS byte.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 31 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description psl UINT2 Pat h si .
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 32 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Descrip tion rxfpfovr UINT2 Rx .
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 33 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description lof UINT2 Los of fr.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 34 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description init ialize d state.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 35 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description init ialize d state.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 36 Document ID: PMC- 2010419, Issue 1 Device-wid e Global Configura tion T able 10: S/UNI-4x622 I.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 37 Document ID: PMC- 2010419, Issue 1 Per -Chann el Sec tion Over head (S OH ) Con figuration T a.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 38 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description allones UINT1 Contr.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 39 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description lcdprdi UINT1 Contr.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 40 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description ptimeprdi UINT1 Con.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 41 Document ID: PMC- 2010419, Issue 1 Field Name Field Ty pe Fiel d Description rxfpminpl UINT1 R.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 42 Document ID: PMC- 2010419, Issue 1 Per -Channel RALRM Confi guration T able 19: S/UNI-4x622 C .
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 43 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description cfgRALRM sSUNI4x622.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 44 Document ID: PMC- 2010419, Issue 1 Device-W ide Line Int erface Con figuration T able 22: S/UN.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 45 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description sdsap UINT4 SD Accu.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 46 Document ID: PMC- 2010419, Issue 1 Line Overhead (LOH) S tatus T able 27: S/UNI-4x622 L ine Ov.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 47 Document ID: PMC- 2010419, Issue 1 Field Name Field Type Field Description prdi UINT1 Path RDI.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 48 Document ID: PMC- 2010419, Issue 1 Field Name Field Ty pe Field Description tfclka UINT1 TFCL .
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 49 Document ID: PMC- 2010419, Issue 1 Line Overhead (LOH) Counter T able 33: S/UNI-4x622 L ine Ov.
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 50 Document ID: PMC- 2010419, Issue 1 Field Name Fi eld Ty pe Field Description rxfprminlf UINT2 .
PM5358 S/UNI-4x 622 Driver Manual Dat a Structur es Proprietary and Confi dential to PM C-Sierra, Inc. 51 Document ID: PMC- 2010419, Issue 1 T able 37: S/UNI-4x622 Def erred-Pro cessing V ector: sSUNI4x622_DPV Field Name Field Ty pe Fiel d Description event SUNI4x622_DPR_EVENT Event being reported cause UINT2 Reason for the Event 3.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 52 Document ID: PMC- 2010419, Issue 1 4 A PPLIC A TION P ROGRA MMING I NTER F A .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 53 Document ID: PMC- 2010419, Issue 1 Inputs None Outpu ts None Retur ns Success.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 54 Document ID: PMC- 2010419, Issue 1 Side Effects C hanges the MO DULE state to SUNI4x622_MOD_IDLE 4.2 Profil e Management This sec tion des cribes th e functions that add, g et and c lear an in itial ization p rofile.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 55 Document ID: PMC- 2010419, Issue 1 V alid S tates SUNI4x622_MOD_IDLE, SUNI4x6.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 56 Document ID: PMC- 2010419, Issue 1 perrDevice : ( poi nte r to) errDevice (in.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 57 Document ID: PMC- 2010419, Issue 1 SUNI4x622_ERR_INVALID_DIV V alid S tates S.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 58 Document ID: PMC- 2010419, Issue 1 Side Effects C hanges the DE VICE state to SUNI4x622_PRESENT A ctivating a Device: suni 4x622A ctivate This func tion re stores th e state of a device a fter a de- activate.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 59 Document ID: PMC- 2010419, Issue 1 4.4 Device Read and W rite Reading from Dev ice Registers: suni4x62 2Read This func tion reads a reg ister of a spec ific S /UNI-4x622 dev ice by provid ing the reg ister num ber .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 60 Document ID: PMC- 2010419, Issue 1 Failure = 0 V alid S tates SUNI4x622_PRESE.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 61 Document ID: PMC- 2010419, Issue 1 Inputs deviceHandle : device handle (from .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 62 Document ID: PMC- 2010419, Issue 1 Reading and Sett ing the Section T race Mess age : suni4x 622SOHT raceMsg This function re triev es and sets the se ction tra ce messag e (J0) in th e Sonet/SDH S ection Trac e Buffer .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 63 Document ID: PMC- 2010419, Issue 1 SUNI4x622_ERR_INVALID_CHAN V alid S tates .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 64 Document ID: PMC- 2010419, Issue 1 Forcing LOS: suni4x622S OHForceLOS When the enab le flag is set, t his funct ion forces a loss of s ignal co ndition in the da ta stream .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 65 Document ID: PMC- 2010419, Issue 1 SUNI4x622_ERR_INVALID_ARG V alid S tates S.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 66 Document ID: PMC- 2010419, Issue 1 Side Effects None Reading the K1K 2 By te: suni4x622LOHReadK 1K2 This func tion reads the K1K2 by te from the line overhead.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 67 Document ID: PMC- 2010419, Issue 1 Reading the S 1 By te: suni4x622LOHR eadS1 This func tion reads the S1 by te from the line ov erhead.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 68 Document ID: PMC- 2010419, Issue 1 Inputs deviceHandle : device handle (from .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 69 Document ID: PMC- 2010419, Issue 1 Retriev ing and Setting t he Path T race Messages : suni4x62 2POHT raceMsg This func tion re trieves a nd sets the curren t path tr ace messag e in th e Sonet/SDH Path T race Buf fer .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 70 Document ID: PMC- 2010419, Issue 1 V alid S tates SUNI4x622_ACTIVE, SUNI4x622_INACTIVE Side Effects None Writ ing the C2 By te: suni4x622TPOH WriteC 2 This func tion write s the C2 byte into th e path overh ead.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 71 Document ID: PMC- 2010419, Issue 1 Writ ing SS Bit s: suni4x622TPOH Writ eSS This func tion write s the passed SS bits (SS[1 :0]) in t he SS bit pos itions.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 72 Document ID: PMC- 2010419, Issue 1 Pro totype INT4 suni4x622THPPForceB3(sSUNI.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 73 Document ID: PMC- 2010419, Issue 1 Inputs deviceHandle : device handle (from .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 74 Document ID: PMC- 2010419, Issue 1 Outpu ts None Retur ns Success = SUNI4x622.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 75 Document ID: PMC- 2010419, Issue 1 ppyldcfg : (poin ter to) pay load config u.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 76 Document ID: PMC- 2010419, Issue 1 Inputs deviceHandle : device handle (from .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 77 Document ID: PMC- 2010419, Issue 1 Outpu ts None Retur ns Success = SUNI4x622.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 78 Document ID: PMC- 2010419, Issue 1 4.10 Automatic P rotection Configuration The Automati c Protect ion Configura tion section is respon sible for con figuring the S/UNI -4x622 to use the APS ports.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 79 Document ID: PMC- 2010419, Issue 1 Configuring the Source Channel for the Giv en Channel T ransmit Path: suni4x622T PCfg The function is used to co ntr ol the sou rce chann el for the transm it path.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 80 Document ID: PMC- 2010419, Issue 1 deviceHandle, UINT1 link) Inputs deviceHan.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 81 Document ID: PMC- 2010419, Issue 1 Configuring ISR Processing: suni4x6 22ISRC.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 82 Document ID: PMC- 2010419, Issue 1 Pro totype INT4 suni4x622SetMask(sSUNI4x62.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 83 Document ID: PMC- 2010419, Issue 1 pmask : (poin ter to) m ask structure Outp.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 84 Document ID: PMC- 2010419, Issue 1 Outpu ts None Retur ns Success = SUNI4x622.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 85 Document ID: PMC- 2010419, Issue 1 Outpu ts None Retur ns Success = SUNI4x622.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 86 Document ID: PMC- 2010419, Issue 1 Outpu ts pmask : (poin ter to) upd ated m .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 87 Document ID: PMC- 2010419, Issue 1 Outpu ts None Retur ns Success = SUNI4x622.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 88 Document ID: PMC- 2010419, Issue 1 Outpu ts None Retur ns Success = SUNI4x622.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 89 Document ID: PMC- 2010419, Issue 1 Outpu ts pmask : (poin ter to) upd ated m .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 90 Document ID: PMC- 2010419, Issue 1 Outpu ts None Retur ns Success = SUNI4x622.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 91 Document ID: PMC- 2010419, Issue 1 Outpu ts pmask : (poin ter to) upd ated m .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 92 Document ID: PMC- 2010419, Issue 1 Retur ns Success = SUNI4x622_SUCCESS Failu.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 93 Document ID: PMC- 2010419, Issue 1 Side Effects May change the opera tion of .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 94 Document ID: PMC- 2010419, Issue 1 Clearing APS Interrupt Enable Mask: suni4x62 2ClrMaskA PS This func tion clea rs the cont ents of the APS interrupt m ask registers o f the S/UNI- 4x622 device.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 95 Document ID: PMC- 2010419, Issue 1 Interrupt-Serv ice Routine: suni4x6 22ISR This functio n reads the st ate of the inter rup t reg isters in the S/UNI- 4x622 and stores them in an ISV .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 96 Document ID: PMC- 2010419, Issue 1 V alid S tates SUNI4x622_ACTIVE Side Effec.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 97 Document ID: PMC- 2010419, Issue 1 pstatusSOH : ( poi nte r to) SOH s tat us .
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 98 Document ID: PMC- 2010419, Issue 1 Retur ns Success = SUNI4x622_SUCCESS Failu.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 99 Document ID: PMC- 2010419, Issue 1 SUNI4x622_ERR_INVALID_CHAN SUNI4x622_ERR_I.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 100 Document ID: PMC- 2010419, Issue 1 V alid S tates SUNI4x622_ACTIVE, SUNI4x622_INACTIVE Side Effects None Getting the Device Count s: suni4x622GetCount sLOH This function re trieves al l the LOH counts.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 101 Document ID: PMC- 2010419, Issue 1 Side Effects None Getting the Device Count s: suni4x622GetCount sPYLD This function re triev es all th e PYLD counts.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 102 Document ID: PMC- 2010419, Issue 1 Enabling Line Loopbacks: suni4 x622DiagLineLoop This func tion clea rs / sets a Line Loopb ack.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 103 Document ID: PMC- 2010419, Issue 1 Pro totype INT4 suni4x622DiagDataLoop(sSU.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 104 Document ID: PMC- 2010419, Issue 1 channel : channel num ber enable : sets l.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 105 Document ID: PMC- 2010419, Issue 1 V alid S tates SUNI4x622_ACTIVE Side Effe.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 106 Document ID: PMC- 2010419, Issue 1 Side Effects None Notify ing the Applicat.
PM5358 S/UNI-4x 622 Driver Manual Application Program ming Interface Proprietary and Confi dential to PM C-Sierra, Inc. 107 Document ID: PMC- 2010419, Issue 1 Notify ing the Application of FIFO Ev ent.
PM5358 S/UNI-4x 622 Driver Manual Hardware Interfa ce Proprietary and Confi dential to PM C-Sierra, Inc. 108 Document ID: PMC- 2010419, Issue 1 5 H A RDW A R E I NTERF ACE The S/UNI -4x622 driv er interf aces direc tly with the USER’ s hardware.
PM5358 S/UNI-4x 622 Driver Manual Hardware Interfa ce Proprietary and Confi dential to PM C-Sierra, Inc. 109 Document ID: PMC- 2010419, Issue 1 Polling a Bit: sy sSuni4x622PollBit This function s imply polls a register m asked data until it is zero or tim es out.
PM5358 S/UNI-4x 622 Driver Manual Hardware Interfa ce Proprietary and Confi dential to PM C-Sierra, Inc. 1 10 Document ID: PMC- 2010419, Issue 1 Failure = <a ny other v alue> Pseudocode Begin in.
PM5358 S/UNI-4x 622 Driver Manual Hardware Interfa ce Proprietary and Confi dential to PM C-Sierra, Inc. 1 1 1 Document ID: PMC- 2010419, Issue 1 End Remov ing the ISR Handler: sy sSuni4x622ISRHandlerRemov e This func tion disab les Interr upt proce ssing for t his device.
PM5358 S/UNI-4x 622 Driver Manual RTOS Interfac e Proprietary and Confi dential to PM C-Sierra, Inc. 1 12 Document ID: PMC- 2010419, Issue 1 6 RT OS I NTERF ACE The S/UNI- 4x622 driver requi res the use of som e R TOS resources.
PM5358 S/UNI-4x 622 Driver Manual RTOS Interfac e Proprietary and Confi dential to PM C-Sierra, Inc. 1 13 Document ID: PMC- 2010419, Issue 1 Pro totype void sysSuni4x622MemSet(UINT1 *pdst, UINT1 *psrc.
PM5358 S/UNI-4x 622 Driver Manual RTOS Interfac e Proprietary and Confi dential to PM C-Sierra, Inc. 1 14 Document ID: PMC- 2010419, Issue 1 Failure = <a ny other v alue> Getting an ISV B uffer:.
PM5358 S/UNI-4x 622 Driver Manual RTOS Interfac e Proprietary and Confi dential to PM C-Sierra, Inc. 1 15 Document ID: PMC- 2010419, Issue 1 Returning a DPV Buf fer: sy sSuni4x622DPVBuff erRtn This function re turns a DPV buf fer to th e R TOS when the info rmation in the block is no longer needed by the DPR.
PM5358 S/UNI-4x 622 Driver Manual RTOS Interfac e Proprietary and Confi dential to PM C-Sierra, Inc. 1 16 Document ID: PMC- 2010419, Issue 1 6.4 Preemption Disabling Preemption : sy sSuni4x622PreemptDis able This routine prev ents the calling task from being preem pted.
PM5358 S/UNI-4x 622 Driver Manual Porting the S/UNI- 4x622 Driv er Proprietary and Confi dential to PM C-Sierra, Inc. 1 17 Document ID: PMC- 2010419, Issue 1 7 P ORTING THE S/UNI-4 X 622 D RIVER This section outlines h ow to port th e S/UNI- 4x622 device driver t o your hardwar e and OS platform .
PM5358 S/UNI-4x 622 Driver Manual Porting the S/UNI- 4x622 Driv er Proprietary and Confi dential to PM C-Sierra, Inc. 1 18 Document ID: PMC- 2010419, Issue 1 Procedure 1: Porting Driv er OS Extensions The OS extensions encapsula te all OS spec ific se rvices a nd data ty pes used by the d riv er .
PM5358 S/UNI-4x 622 Driver Manual Porting the S/UNI- 4x622 Driv er Proprietary and Confi dential to PM C-Sierra, Inc. 1 19 Document ID: PMC- 2010419, Issue 1 sysSuni4x622ISRHandlerIntInstall In stalls.
PM5358 S/UNI-4x 622 Driver Manual Porting the S/UNI- 4x622 Driv er Proprietary and Confi dential to PM C-Sierra, Inc. 120 Document ID: PMC- 2010419, Issue 1 SUNI4x622_DPR_TASK_STACK_SZ DPR task stack .
PM5358 S/UNI-4x 622 Driver Manual Appendix A: Coding Conventions Proprietary and Confi dential to PM C-Sierra, Inc. 121 Document ID: PMC- 2010419, Issue 1 A PPENDIX A: C ODING C ONVENTIONS This sec tion descr ibes the cod ing conv entions used in the im plementation of al l PMC- Sierra dri ver s oftware .
PM5358 S/UNI-4x 622 Driver Manual Appendix A: Coding Conventions Proprietary and Confi dential to PM C-Sierra, Inc. 122 Document ID: PMC- 2010419, Issue 1 Type Case Naming convention Examples Function.
PM5358 S/UNI-4x 622 Driver Manual Appendix A: Coding Conventions Proprietary and Confi dential to PM C-Sierra, Inc. 123 Document ID: PMC- 2010419, Issue 1 Functions API Functions • Naming of the API.
PM5358 S/UNI-4x 622 Driver Manual Appendix A: Coding Conventions Proprietary and Confi dential to PM C-Sierra, Inc. 124 Document ID: PMC- 2010419, Issue 1 T able 44: File Na ming Convention s API (Module and Device Managem ent) suni4x622_api.
PM5358 S/UNI-4x 622 Driver Manual Appendix B: Error Codes Proprietary and Confi dential to PM C-Sierra, Inc. 125 Document ID: PMC- 2010419, Issue 1 A PPENDIX B: E RROR C ODES The follow i ng desc ribe.
PM5358 S/UNI-4x 622 Driver Manual Appendix C: S/UNI-4x622 Event s Proprietary and Confi dential to PM C-Sierra, Inc. 126 Document ID: PMC- 2010419, Issue 1 A PPENDIX C: S/UNI-4 X 622 E VENTS Section O.
PM5358 S/UNI-4x 622 Driver Manual Appendix C: S/UNI-4x622 Event s Proprietary and Confi dential to PM C-Sierra, Inc. 127 Document ID: PMC- 2010419, Issue 1 Path Ov erhead Event s (RPOH) Error Code Des.
PM5358 S/UNI-4x 622 Driver Manual Appendix C: S/UNI-4x622 Event s Proprietary and Confi dential to PM C-Sierra, Inc. 128 Document ID: PMC- 2010419, Issue 1 Payload Event s (PYLD) Error Code Descriptio.
PM5358 S/UNI-4x 622 Driver Manual Appendix C: S/UNI-4x622 Event s Proprietary and Confi dential to PM C-Sierra, Inc. 129 Document ID: PMC- 2010419, Issue 1 Error Code Description packet SUNI4x622_EVEN.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 130 Document ID: PMC- 2010419, Issue 1 L IST OF T ERMS APPLICA TION: Refers to pro tocol softw are used in a real system as well as val idation softw are written to v alidate the S/UNI- 4x622 driver on a v alidatio n platform .
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 131 Document ID: PMC- 2010419, Issue 1 A CRONYMS API: Applicat ion Prog ramming Interface APS: Automatic Protection.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 132 Document ID: PMC- 2010419, Issue 1 I NDEX A api functions suni4x622Acti vate-58 suni4x622Add-34, 55, 56, 57, 58.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 133 Document ID: PMC- 2010419, Issue 1 suni4x622RPCfg-78 suni4x622RPOHSDCf g-65 suni4x622RPOHSFCfg-64 suni4x622RPOH.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 134 Document ID: PMC- 2010419, Issue 1 SUNI4x622_EVENT_INTF_SYS_FUNR-129 SUNI4x622_EVENT_INTF_SYS_TPRTY-129 SUNI4x6.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 135 Document ID: PMC- 2010419, Issue 1 suni4x622_strs. h-124 suni4x622_typs.h-124 src file suni4x622_api.c-124 suni4x622_aps.c -124 suni4x622_diag.c-124 suni4x622_hw.
PM5358 S/UNI-4x 622 Driver Manual Proprietary and Confi dential to PM C-Sierra, Inc. 136 Document ID: PMC- 2010419, Issue 1 sSUNI4x622_CFG_RPOH-36, 38 sSUNI4x622_CFG_SD-44, 65 sSUNI4x622_CFG_SF-44, 64.
Un punto importante, dopo l’acquisto del dispositivo (o anche prima di acquisto) è quello di leggere il manuale. Dobbiamo farlo per diversi motivi semplici:
Se non hai ancora comprato il PMC-Sierra PM5358 S/UNI 4x622 è un buon momento per familiarizzare con i dati di base del prodotto. Prime consultare le pagine iniziali del manuale d’uso, che si trova al di sopra. Dovresti trovare lì i dati tecnici più importanti del PMC-Sierra PM5358 S/UNI 4x622 - in questo modo è possibile verificare se l’apparecchio soddisfa le tue esigenze. Esplorando le pagine segenti del manuali d’uso PMC-Sierra PM5358 S/UNI 4x622 imparerai tutte le caratteristiche del prodotto e le informazioni sul suo funzionamento. Le informazioni sul PMC-Sierra PM5358 S/UNI 4x622 ti aiuteranno sicuramente a prendere una decisione relativa all’acquisto.
In una situazione in cui hai già il PMC-Sierra PM5358 S/UNI 4x622, ma non hai ancora letto il manuale d’uso, dovresti farlo per le ragioni sopra descritte. Saprai quindi se hai correttamente usato le funzioni disponibili, e se hai commesso errori che possono ridurre la durata di vita del PMC-Sierra PM5358 S/UNI 4x622.
Tuttavia, uno dei ruoli più importanti per l’utente svolti dal manuale d’uso è quello di aiutare a risolvere i problemi con il PMC-Sierra PM5358 S/UNI 4x622. Quasi sempre, ci troverai Troubleshooting, cioè i guasti più frequenti e malfunzionamenti del dispositivo PMC-Sierra PM5358 S/UNI 4x622 insieme con le istruzioni su come risolverli. Anche se non si riesci a risolvere il problema, il manuale d’uso ti mostrerà il percorso di ulteriori procedimenti – il contatto con il centro servizio clienti o il servizio più vicino.
