search

Pmatsol58 / VyperCE6.1

This Marlin fork has the goal of adapting the Creality Community Edition to the Anycubic Vyper
GNU General Public License v3.0
40 stars 6 forks source link

readme

Community firmware for Anycubic Vyper

Downloads

At present there are no binary downloads since the STM license conditions for some of the libraries used restrict execution to STM devices only, the Vyper mainboard uses a non-STM device. You may take this source and build for your board but it is your responsibility to ensure it is running in accordance with the license conditions.

Development and compile-it-yourself

If you have the Platform.io plugin installed in Visual Studio code you can open the folder to start compiling with the code. Please note if you have previously compiled the Anycubic source and followed their instructions then you will have a modified ArduinoSTM32 framework and this will give an error during the compile, please rename or delete the framework file and the correct version should be downloaded and compiled successfully. Framework file can be found here:

C:\Users\<user>\.platformio\packages\framework-arduinoststm32@4.10900.200819

There are several configurations for the build of the source and they can be found at line 75 onwards of the configuration.h file:

// %%%% Options for building Vyper image %%%%

// select build type here
//#define VYPER_BUILD         // standard
#define VYPER_BUILD_LA      // with linear advance and junction deviation enabled
//#define VYPER_BUILD_LA_T    // as above but with uart connection to TMC2209's for x, y, z and z2
//#define VYPER_BUILD_LA_TE   // as above but with software serial connection to e stepper

// Leave undefined to home Z using two Z sensors (stock configuration)
//#define VYPER_NOZZLE_HOMING // home Z using nozzle sensor at middle of bed

// NOTE to use nozzle sensor any adjustable Z sensors must be set to maximum
// extended length so sensor is detected before nozzle reaches bed

Most users will probably want to use the VYPER_BUILD_LA option since this runs on the stock main board and gives the extra linear advance and junction deviation options for better prints (once calibrated).

The _T and _TE options are for use with a modified main board where the main board has been user modified to add uart connections to the TMC2209 drivers.

There are also two options for homing of the Z axis;

  1. The standard way as used by Anycubic which uses the two Z axis photo sensors, one on each side, to determine the home position of each of the Z axes. The home sequence is lift Z to avoid anything on the bed, move head on X gantry until the X limit switch is triggered and stop, move bed towards back of printer until the Y limit switch is triggered and stop, the z motors lower the axis until the sensor associated with each motor is triggered to stop that motor, so each motor is independant, e.g. left motor triggers left sensor and stops, right motor continues until right sensor triggers and stops.
  2. The alternative way which uses the nozzle probe sensor to determine the home position of the Z axes at the centre of the bed. The home sequence here is the same as for the standard way above except after the Y limit is triggered the head is moved to the centre of the bed, the Z motors then lower the head until the left Z sensor is triggered, the Z motors continue until the nozzle probe is triggered, i.e. bed is detected, and both Z motors stop, the Z motors will raise the head slightly and then lower it again until the bed is again detected, this is the home position for Z.

There are advantages and disadvantages to using the nozzle as Z home position, the mesh values will be closer to 0 and thus will show less red or blue but homing will not complete without a working sensor. Also the Z 'flags' used to trigger the Z axis sensors need to be lower than the nozzle, this is the case with fixed flags but the adjustable ones MUST be set to protrude as far below as possible else the nozzle will impact the bed.

Purpose of this community firmware

Initially started with the goal of providing an alternative firmware for the Anycubic Vyper motherboard

Once upstream Marlin supports the strain gauge, currently being whipped into shape in this PR @Sebazzz has submitted, the future of this project will probably be:

Community firmware support & communities

Get in touch with the developers! We have our own Discord server.

Anycubic Vyper Community

Creality CR-6 communities

The following CR-6 communities exist:

Communities hosted by Creality:

Other communities:

General Marlin support

For general Marlin support, please check:

Reporting issues

Credits

The current core Community firmware dev team consists of:

We stand on the shoulders of giants. Don't forget to send your love upstream too!

License

Marlin and the Community Firmware is published under the GPL license because we believe in open development. The GPL comes with both rights and obligations. Whether you use Marlin firmware as the driver for your open or closed-source product, you must keep Marlin open, and you must provide your compatible Marlin source code to end users upon request. The most straightforward way to comply with the Marlin license is to make a fork of Marlin on Github, perform your modifications, and direct users to your modified fork.

While we can't prevent the use of this code in products (3D printers, CNC, etc.) that are closed source or crippled by a patent, we would prefer that you choose another firmware or, better yet, make your own.