Updating Revised Device References

When a revision project is created all the contents except device categorisations are copied over from the source project. If device reference designators have changed with the revised netlist much of the project setup, such as connections and constant pins, may now be associated with an incorrect reference designator. To handle this all device references within the project are modified upon creation. The references are prefixed with (ORIGINAL) to make it clear that this referred to a device in the source project and will require updating. This often leaves a new revision project with a large number of errors. As devices are successfully matched and suggestions are accepted in the Revision Checklist many of these references are automatically updated to use the correct reference designator based on the accepted matches.

Any references to devices which were uncategorised in the source project, or to devices where suggestions were either not found or rejected by the user will need to be updated manually. Connections, constant pins and functional tests will most commonly need to be updated manually. One of the final steps in the revision process is to manually update any remaining invalid references. Items instructing the user to do this appear in the Revision Checklist during the Invalid References stage.

Working through any project errors in Errors Pane is often the best approach for updating any remaining invalid references. Many elements in XJDeveloper with an invalid reference will be shown as red in the UI. Edit the affected items and update the device/pin to be the correct device/pin. In some cases elements may need to be removed and re-added with the correct devices/pins. Comparing the schematics for the source and revision project can aid in selecting the changed references.

Any device reference designators in XJRunner test conditions will not have been modified. These will require manual checking and updating in a revision. Any references to boards by name may also need updating if the revised board name differs from the source board name.

Device reference designators and board names may also appear in XJEase code files. These must be updated manually by the user. Check the Errors Pane for details of any files with invalid references. If the file is shared between the source and revision projects then updating its contents may break the source project. In this case renaming the board or recategorising the device using a new copy of the file may be a better solution.