CAD Sync
The CAD sync pushes your bike's geometry and linkage pivot points into your CAD environment as named variables. Onshape is supported via a Variable Studio, and SolidWorks via the syn add-in.
Geometry Variables
Geometry values are synced per size. Each variable is named syn_<property>_s<size> where size starts at 1. For example, a bike with three sizes would create syn_reach_s1, syn_reach_s2, and syn_reach_s3.
| Variable | Description | Units |
|---|---|---|
syn_reach |
Reach | mm |
syn_stack |
Stack | mm |
syn_hta |
Head tube angle | deg |
syn_htl |
Head tube length | mm |
syn_fork_length |
Fork length (axle to crown) | mm |
syn_offset |
Fork offset (rake) | mm |
syn_lower_headset |
Lower headset stack height | mm |
syn_trail |
Trail | mm |
syn_htt |
Head tube top (virtual) | mm |
syn_fc |
Front center | mm |
syn_rc |
Rear center (chainstay length) | mm |
syn_cs |
Chainstay length | mm |
syn_wheelbase |
Wheelbase | mm |
syn_sta_eff |
Effective seat tube angle | deg |
syn_sta_act |
Actual seat tube angle | deg |
syn_stl |
Seat tube length | mm |
syn_nsh |
Nominal sag height | mm |
syn_insertion |
Seatpost insertion | mm |
syn_bb_drop |
Bottom bracket drop | mm |
syn_bb_height |
Bottom bracket height | mm |
syn_bb_offset |
Bottom bracket offset | mm |
syn_upper_headset |
Upper headset stack height | mm |
syn_stem_length |
Stem length | mm |
syn_stem_spacers |
Stem spacer stack | mm |
syn_stem_stack |
Stem stack height | mm |
syn_bar_height |
Bar height (rise) | mm |
syn_seated_fit |
Seated fit | mm |
Shock Variables
| Variable | Description | Units |
|---|---|---|
syn_shock_length |
Base shock eye-to-eye length | mm |
syn_shock_ext_length |
Shock extension length (e.g. trunnion offset) | mm |
syn_shock_compression |
Current shock compression (user-adjustable, default 0) | mm |
syn_total_shock_length_active |
Active total length (synced as shock length + extension length) | mm |
syn_shock_compression defaults to 0 mm and is intended to be adjusted by the user in the Variable Studio. syn_total_shock_length_active is set as a formula (#syn_shock_length + #syn_shock_ext_length - #syn_shock_compression) and updates automatically as you change the compression value.
Offset Variables
Two offset variables are provided to shift linkage point coordinates into positive space. Linkage points can have negative coordinates relative to the bottom bracket, which does not work well with CAD length parameters. Onshape and SolidWorks use the offsets differently, as described below.
| Variable | Default | Description |
|---|---|---|
syn_x_offset |
500 mm | Shift applied to point X values |
syn_y_offset |
100 mm | Shift applied to point Y values |
In Onshape, these offsets are baked into the point values — each point's X and Y coordinates have the offset pre-applied. If you need the original coordinate, subtract the offset from the synced value.
In SolidWorks, the point values are not shifted. The offsets are only used by Draw Linkage Points, described under SolidWorks Setup.
Linkage Point Variables
Linkage points are synced as syn_p<index>_x and syn_p<index>_y. All coordinates are relative to the bottom bracket origin. In Onshape they are shifted by the offset values above; in SolidWorks they are not.
| Index | Variable | Description |
|---|---|---|
| 0 | syn_p0_x, syn_p0_y |
Bottom bracket (BB) |
| 1 | syn_p1_x, syn_p1_y |
Rear wheel |
| 2 | syn_p2_x, syn_p2_y |
Shock mount 1 (frame end) |
| 3 | syn_p3_x, syn_p3_y |
Shock mount 2 (linkage end) |
| 4 | syn_p4_x, syn_p4_y |
Frame – Link 1 pivot |
| 5 | syn_p5_x, syn_p5_y |
Link 1 – Link 2 pivot |
| 6 | syn_p6_x, syn_p6_y |
Link 2 – Link 3 pivot |
| 7 | syn_p7_x, syn_p7_y |
Link 3 – Frame pivot |
| 8 | syn_p8_x, syn_p8_y |
Link 4 start |
| 9 | syn_p9_x, syn_p9_y |
Link 4 – Link 5 pivot |
| 10 | syn_p10_x, syn_p10_y |
Link 5 end |
| 11 | syn_p11_x, syn_p11_y |
Idler |
| 12 | syn_p12_x, syn_p12_y |
Brake mount pivot |
| 13 | syn_p13_x, syn_p13_y |
Brake arm end |
| 14 | syn_p14_x, syn_p14_y |
DAQ sensor 1 |
| 15 | syn_p15_x, syn_p15_y |
DAQ sensor 2 |
Common Linkage Configurations
Not all points are used in every linkage type:
- Single pivot (2-bar): Points 0, 1, 2, 3
- 4-bar: Points 0–7 plus shock mounts (2, 3)
- 6-bar: Points 0–10 plus shock mounts (2, 3)
Unused points will have a value of 0 (plus the offset, in Onshape).
Onshape Setup
When you trigger a sync, a Variable Studio named syn is created automatically in your Onshape document. The variables are immediately available for use in Part Studios and Assemblies.
To reference a variable in a dimension or feature, use the # prefix — for example #syn_reach_s1 or #syn_p4_x.
SolidWorks Setup
The syn add-in needs SolidWorks 2018 or later. It syncs the variables into your part as global variables. A full sync only writes values that have changed, then lists what changed. Each size keeps a record of its synced values in a syn_synced_values custom property, so a value you type by hand into a size that is not active is not noticed by the next sync. In SolidWorks, the linkage point variables hold the real coordinates relative to the bottom bracket, without the offsets.
The sync writes into whichever part is active. If that part has no syn variables yet, Sync All Variables asks first, in a dialog that names the part. Cancel leaves the part unchanged.
Draw Linkage Points
Draw Linkage Points gives you a ready-made sketch of every linkage point, already linked to the synced variables. Each point is dimensioned by an equation, so when you sync, the sketch moves with it. The sketch uses the values last synced to your part, so sync first if you have changed the bike in syn. If a linkage point variable is missing, the command asks whether to sync the variables first; Cancel stops it with nothing written.
Run the command with no sketch open and pick a plane or planar face for the new sketch. The Right Plane is selected by default. Every run draws into a new sketch, so running it again gives you a second set of points. If a sketch is open for editing, the command asks you to close it first ("Close the sketch, then run Draw Linkage Points to pick a plane.").
The command also joins the points into a polygon for each link, and draws a 20 mm circle at each point where a link pivots on the frame. These are construction lines and circles, so they guide your design without becoming part of a feature's profile. They follow the points when you sync, so they make a good starting point for your frame and link sketches.
The bottom bracket is drawn as a fixed point at the origin, with no relation to any other point. A pivot concentric with it is drawn as its own separate point, so it can move away later. A point at (0, 0) that your linkage does not use is skipped.
The points sit at their real coordinates relative to the sketch origin. The small construction point is the offset datum: it sits at -syn_x_offset, -syn_y_offset, and every point except the bottom bracket is dimensioned from it so the dimensions stay positive. The command creates syn_x_offset and syn_y_offset with the defaults above if your part does not have them yet, and never overwrites them. If your part already has syn_x_offset or syn_y_offset, each must be a plain number of millimetres, or the command stops before drawing anything. If a point lies more than syn_x_offset behind or syn_y_offset below the origin (500 mm and 100 mm by default), the command stops and names it: raise syn_x_offset or syn_y_offset and run it again.
If SolidWorks fails part way through, the command tells you where it stopped and closes the sketch. The partial sketch stays in your part: delete it and run the command again.
Updating the Add-in
When a new version of the add-in is out, the add-in finds it when it checks for updates, and a box appears after a syn command finishes. It names the new version and yours, for example "syn Linkage 2.1.0 is available. You have 2.0.0.", then warns:
For the smoothest update, save your work and close SOLIDWORKS before you click Install in the installer. If SOLIDWORKS stays open, the installer may ask you to close it, or Windows may finish the update the next time you restart your computer.
The download link is in the box too, and you can select and copy it.
- Install update downloads the installer in the background, checks that it is exactly the released file, then starts it. The box shows "Downloading…" while it works and closes once the installer opens.
- Copy link copies the link to your clipboard, so you can paste it into any browser.
- Skip this version stops the box appearing for that version. Your choice is saved on this computer for your Windows account only. Link Info still shows the version, and you can always download it from syn.bike/downloads.
- Later closes the box, and it comes back the next time SolidWorks starts. While a download runs, this button reads Cancel: clicking it, or closing the box, just stops the download.
Windows asks for permission before the installer makes any changes. Without administrator rights, you will need an administrator's credentials. If you run SolidWorks as administrator, the installer runs with the same rights and Windows does not ask. The installer will not put an older version over a newer one.
If SolidWorks is still open
The installer never closes SolidWorks for you, so you cannot lose unsaved work to it. If SolidWorks is open when you click Install, the installer may list it as using files that need updating. You can then:
- save your work, close SolidWorks and click Retry, and the update finishes straight away;
- click Ignore, and Windows finishes the update the next time you restart your computer.
If the installer does not ask, the update may instead finish the next time you restart your computer.
If the download fails
If the add-in cannot download, check or start the installer, the box says "Could not download the update. Copy the link, or open it in your browser." and offers:
- Copy link, so you can paste it into a browser yourself;
- Open in browser, which opens the link in your default browser. If no browser opens, it copies the link instead, so you can paste it into a browser yourself.
Skip this version and Later are still there and work as before.
Run the installer you downloaded to update. Two things you may run into:
- SolidWorks running as administrator. The browser opens as administrator too, and some browsers refuse to run that way or warn about it. Use Copy link and paste the link into a browser you opened yourself.
- A SmartScreen warning. For an installer you download with a browser, Windows SmartScreen may warn about a new release for a while after it comes out, until it has been downloaded enough times. Click More info, then Run anyway. Install update does not go through SmartScreen.
Version 1.0.1
The 1.0.1 add-in does not show this box. Link Info shows the new version there: download it from syn.bike/downloads and run the installer.