Instruction/ maintenance manual of the product PM5358 S/UNI 4x622 PMC-Sierra
Go to page 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.
An important point after buying a device PMC-Sierra PM5358 S/UNI 4x622 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought PMC-Sierra PM5358 S/UNI 4x622 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data PMC-Sierra PM5358 S/UNI 4x622 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, PMC-Sierra PM5358 S/UNI 4x622 you will learn all the available features of the product, as well as information on its operation. The information that you get PMC-Sierra PM5358 S/UNI 4x622 will certainly help you make a decision on the purchase.
If you already are a holder of PMC-Sierra PM5358 S/UNI 4x622, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime PMC-Sierra PM5358 S/UNI 4x622.
However, one of the most important roles played by the user manual is to help in solving problems with PMC-Sierra PM5358 S/UNI 4x622. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device PMC-Sierra PM5358 S/UNI 4x622 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
