RI Title
RI logo


Reference the following when editing the Digital Pattern Common File Format (CFF) file directly that is saved out by the Digital Translation Tool via the File > Save menu.. Details may be subject to change, please contact [email protected] if you have any questions.



Guru Attributes
ri.sys.ObjClass=RiDigitalPattern
ri.sys.ObjFormat=cff
ri.test.Device The device family
ri.sys.DevicePins The pins family
ri.sys.Title Descriptor
ri.sys.Name File name

CFF Paragraphs
:INFO
version=
source=aFullPathName the file this came from
sourceData=fileData

:DESCRIPTION " any string " Entered by the user at any time

:SIGNALS Maps names and types along with groups
signal,
name=clock, signal name used in this file
type=, out,in,scanClock,scanStb,scanAux,scanExpect,scanDrive

group,
name=,
signals= semicolon separated list of signal names

:PATTERNS " pattern section "

one more pattern multi-lines make up the body of a :PATTERNS paragraph

pattern,
name=
size= optional integer for the number of vectors
type= pattern|scan|device
version= optional any user string
signals=all group name or semicolon separated list
v=10101; actual vectors or commands semicolon separated
10101 one per line

Vector format. Each is separated by a semicolon

vector data
10100010;
all signals must be present.

special command used for low level control of pins
first character in a line must be a !
last character in the line must be a semicolon unless this is the last line in a pattern

!nop
!stop
!hold n n in decimal integer ( 20 bits equilvalent ) repeats following vector
!dmsk b drive enable mask b is binary enable of the signals
!cmsk b compare enable mask b is binary enable of the signals
!tmsk b tristate enable mask b is binary enable of the signals
!tset b select timing set b ( 4 bits 0 to 15)
!map b select the scan map register (3 bits 0 to 7)
!comment b b is a string
!override signals=aList
selects which signals are enabled
!override scanMap=aName
selects the hardware scan format
!override type=serialScan
starts the scan mode
!marker b b is a string, used as a text marker not used by the hardware
!endScan exits the scan mode

Control bits commands may follow a special cmd on the same line
values are latched
clk ~clk clock pins enable
drv ~drv enable drive data
exp ~exp expect load enable
cmp ~cmp compare enable
cap ~cap capture enable
tri ~tri tristate enable
ts0 subset 0 of the selected scan set
ts1 subset 1 of the selected scan set

Vectors
1, H resolve to the integer 1
0,X,L resolve to the integer 0

vectors should be left justified if the entire field is not used. Applies to hex, binary and base64

Measurement Format

An measurement is the contents of a message sent to a viewer containing measured or other
data which is to be compared to the current viewed data

:MEASUREMENT, "example, where logic analyzer data is to be added"
name=pattern, pattern name or 'status' if this is the fail status pattern
signals=list,
overSample=4, number of samples per pattern vector
sampleOffset=2.5 delay between samples and pattern. Positive is later
trigger=2445 "vector location of the trigger in pattern vectors"
triggerMode=, vector or fail
size=1024 "number of vectors"
v=1011010; "vectors"
1100101;
0000000

Defining a device register as a pattern

:PATTERN,
name=,
type=device,
format=binary|hex|device
v=; first vector, semicolon separated

Device Vector format
type:writeSpec:readMask;
colon separated, semicolon terminated unless last
one definition per line
type
spi size
jtag sir size
jtag sdr size
i2c size
dut formatName size
dut registerName
in all cases size is on ACSII integer for number of bits to process

writeSpec
for binary or hex formats this is a left justified pattern
0100101 or 3FACD undefined trailing bits are set to 0
for device format this is a | separated list of fieldName=value
fieldName=fieldValue|fieldName=fieldValue

readMask
an optional field which indicates the bits to be captured during a read
character per bit format, right justified, Undefined bits are set to 0.
H,L = compare value
X is don't compare
1 = capture
0 no capture
2..9 indicates a repeat of the following character
can be a field name in the register format in which case all bits in the
field are captured ( set to 1)

Examples
spi 16:011011

:Patterns
pattern,name=burst1,type=device,v=;
spi 16:110100;
spi 23:1001001001;
spi: 3:101
pattern,name=burst2,type=device,v=;
dut tune:field1=4|field2=3;
dut primary 8:10100000

WGL Timing & Waveform

:TIMING
name=tp0
period=100.0nS
edge,name=e2,time=90.0ns
edge,name=e3,time=20.0ns
edge,name=e1,time=40.0ns
edge,name=e0,time=0.0 s
:WAVEFORM
name=tp0
char,signal=P_SCAN_B,name=?,wave=forceData=e0
char,signal=P_RESET_B,name=?,wave=forceUp=e0;forceData=e1;forceUp=e2
char,signal=P_SCLK,name=?,wave=forceDn=e0;forceData=e1;forceDn=e2
char,signal=P_MOSI,name=?,wave=forceData=e0
char,signal=P_SEB,name=?,wave=forceData=e0
char,signal=P_MISO,name=?,wave=expectX=e0;expectData=e3;expectX=e1


Fixed Time Method
RZ = Return to Zero (used for clock, 11111111 when clocking, 000000 to stop clock)
NRZ = Not Return to Zero
DNRZ = Delayed Not Return To Zero (One timing edge set to a time value in nanoseconds)
Timing Edge = e0 = 3ns

Everything DNRZ unless its a clock, which is RZ




Example Cff File

AW106Q
:INFO
version=1
source=S:\CustomersA-L\Freescale\design_stuck_debug.wgl
sourceDate=Mon Sep 20 12:53:24 PDT 2010
:DESCRIPTION
Pattern file from WGL data
:SIGNALS
signal,name=P_SCAN_B,type=in,pstate=initialp[N]
signal,name=P_RESET_B,type=in,pstate=initialp[N]
signal,name=P_SCLK,type=in,pstate=initialp[N]
signal,name=P_MOSI,type=in,pstate=initialp[N]
signal,name=P_SEB,type=in,pstate=initialp[N]
signal,name=P_MISO,type=out
signal,name=P_SCLK,type=scanClock
signal,name=P_SEB,type=scanStb
signal,name=P_MOSI,type=scanDrive
signal,name=P_MISO,type=scanExpect
:TIMING
name=tp0
period=100.0nS
edge,name=e2,time=90.0ns
edge,name=e3,time=20.0ns
edge,name=e1,time=40.0ns
edge,name=e0,time=0.0 s
:WAVEFORM
name=tp0
char,signal=P_SCAN_B,name=?,wave=forceData=e0
char,signal=P_RESET_B,name=?,wave=forceUp=e0;forceData=e1;forceUp=e2
char,signal=P_SCLK,name=?,wave=forceDn=e0;forceData=e1;forceDn=e2
char,signal=P_MOSI,name=?,wave=forceData=e0
char,signal=P_SEB,name=?,wave=forceData=e0
char,signal=P_MISO,name=?,wave=expectX=e0;expectData=e3;expectX=e1
:PATTERNS
pattern,name=Chain_Scan_test,type=scan,version=1,size=0,
signals=P_SCAN_B;P_RESET_B;P_SCLK;P_MOSI;P_SEB;P_MISO,v=
!comment Pattern 0 Vector 0 TesterCycle 0;
01000X;
!comment Pattern 0 Vector 1 TesterCycle 1;
01000X;
!comment Pattern 0 Vector 2 TesterCycle 2;
01001X;
01001X;
!marker name=OREG1_sts000000_000005;
!override signals=P_SCLK+P_MOSI+P_SEB+P_MISO;
!override scanMap=scan1;
!override type=serialScan;
111X;
101X;
111X;
101X;
111X;
111X;

101X;
111X;
1000;
001X;
001X;
!marker name=OREG1_sts000000_000009;
1111;
1011;
1110;
1010;

1011;
1110;
1011;
1110;
!endScan csda
:CHECKSUM
818683
zzo00

PrintEmail Link
https://roos.com/docs/RBEH-A28UC8
ROOS INSTRUMENTS CONFIDENTIAL AND PROPRIETARY
©2015-2024 Roos Instruments, Inc. All rights reserved.