PSoC Creator 4.0 – Schematic Description Files | Cypress Semiconductor
PSoC Creator 4.0 – Schematic Description Files
This is my last “new feature” article for PSoC Creator 4.0. I am getting ready to do a bunch more in our next release! This one is about a pair of new files that complement the schematic file (TopDesign.cysch).
Regular users of the tool know how useful it is to make design changes in the schematic file without writing a line of C code. You can change the initial conditions of a PWM or change the speed of a UART and a rebuild just makes it happen. It is tricky, though, to track changes to a design when they are made graphically so we now enable you to save text-based (XML format) descriptions alongside the schematic source file.
There are actually two files with different extensions. The CYVIS file records the visual features in the schematic; features like shape position and size, line color, width, and style, text location and content, and so on. The CYSEM file records the semantic meaning of the design such as the component instances, wires, and parameter values. You can use these files to compare designs. The CYVIS file tells you if something has been moved, added, removed, re-sized, re-colored or otherwise cosmetically changed. The CYSEM files tells you if the design has a material change and helps you track down where it occurred.
You enable the creation of these files from the Project-Properties dialog…
Let’s take a simple design to show you how it works. Here I have a clock driving a PWM. Next to it I have a modified design where the PWM compare value has been changed (you cannot see that) and an annotation modified accordingly.
When I compare the visual files I see just one change. The original documents the annotation like this.
<Annotation shapeName="Shape_2" zorder="2">
<Location x="344.4896" y="319.9385" />
<Text>PWM_1: 50% Duty Cycle</Text>
<SolidBrush color="0, 0, 0" />
<Font value="Microsoft Sans Serif, 10pt" />
<TextAlignment value="TopLeft" />
In the new file the change is <Text>PWM_1: 25% Duty Cycle</Text>.
In the semantic file you can see the edit that was invisible in the schematic file.
In the new file the change is pretty obvious.
You can compare the files in any editor or diff tool that you like – one that understands XML is a real bonus – and you have a great way to compare designs, track revision changes, and work in teams with less risk of using the wrong, or an out of date, schematic.