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.