fabtotum / fablin

The FABtotum Personal Fabricator Firmware, a Marlin derivate made to support hybrid manufacturing and digital acquisition

                    FABlin Firmware
                    ===============

for FABtotum Personal Fabricator and FABtotum Core platforms

This is FABlin, a Marlin derivative firmware. Marlin was originally created by Erik Zalm (https://github.com/ErikZalm/Marlin). The changes made are focused on multipurpose personal fabrication and hardware characteristics of the FABtotum Personal Fabricator such as 3D/4 Axis milling, 3D/4 axis scanning, Touch-probing and the Totumduino Board I/Os capabilities.

Compiling

with Arduino IDE

To correctly compile the firmware with Arduino you must set the folder where this repository is checked out as Arduino's sketchbook folder inside Arduino's preferences. Alternatively you can manually copy the FABlin/libraries/SmartComm folder into your current sketchbook's libraries folder.

For further info refer to https://www.arduino.cc/en/Guide/Environment#toc7.

with PlatformIO

A default platformio.ini file with correct directories definitions is now included in the repository. To compile the firmware simply run:

platformio run

inside this repository's root folder. To upload the firmware on the board or flash it directly into it refer to platformio documentation. platformio.ini has a default definition for using an AVRISP-mk2 usb programmer. To directly flash the firmware onto TOTUMduino using that defintion, run:

platformio run -t program

Latest Changes

Version 1.1.1.3

• Fix power supply issues in Laser Heads
• Fix M999 behavior with pending temperature errors
• Fix M42 command output

Version 1.1.1.2

• More stable temperature readings on edge and error conditions

Version 1.1.1.1

• Fix heaters not working inside PID tuning procedure (M303 command)
• Fix missing bed temperature readings with some toolheads
• Better stability when reconfiguring tools and installing new heads
• Fix M563 output when the bed's thermistor is active without the bed heater being so

Version 1.1.1

• Add support functions for Fabtotum Laser Head PRO
• Added support for head-installed external probe, M746 S2 selects it
• Expanded G38 for external-probing with movement on all the three axes
• Better emergency stop in case of head faults
• M793 S0 can be issued to shut-down all head lines and functions
• Changes in tool configuration
  • M563 accepts multiple values per parameter, e.g. M563 P0 D0 H0:1
  • Revised heaters numbering:
    • 0: bed heater
    • 1: head heater
    • 4: bed temp sensor with disabled heater
    • 5: head temp sensor with disabled heater
  • Revised M563 command output
• Added support for a motor driver (drive n.3) through bed pins; no DIR pin available

For the complete changelog, see ChangeLog.

Contributors

FABlin is possible thanks to the contributions by:

• Simone Cociancich
• Marco Rizzuto
• Daniel Kesler
• imarin2
• Krios Mane
• Enrico Ambrosini
• Wolfgang Meyerle

fablin's Issues

No need to wait after Wire.requestFrom().

In the file "FABlin/Marlin/Marlin_main.cpp", in the function "I2C_read()" there is a timeout with millis() after the Wire.requestFrom(). However, there is nothing to wait for.
Explanation: Common-mistakes#1

Since the return value of Wire.endTransmission() is not tested, the test for Wire.requestFrom() could perhaps be omitted as well:

  Wire.requestFrom(SERIAL_ID_ADDR, 1);    // request 1 bytes from slave device SERIAL_ID_ADDR
  return( (char) Wire.read());      // return a byte as character
}

When the Wire.requestFrom() needs a check for a valid I2C transaction, it could be like this:

  Wire.requestFrom(SERIAL_ID_ADDR, 1);    // request 1 bytes from slave device SERIAL_ID_ADDR
  if(Wire.available() != 1)       // request for 1 bytes failed ?
  {
    return('?');      // return a byte as character
  }
  else
  {
    return( (char) Wire.read());      // return a byte as character
  }
}

Undocumented fabtotum code 747

It not shown in the list of codes but it within the effective code.

G38 stops before making contact

In the latest version 1.0.0095, external z-probe (continuity probe) does not work properly.
When enabled with "M746 S1" and started with G38. The z-axis starts moving up a few centimeters and stops without touching the external probe.
Version 1.0.0094 works without any problems.

G28 fails when z_max is hit.

Legitimate probes failing

From time to time the probing procedure reports a failed sample, even though the probe actually did stopped on an obstacle. The problem affect run_fast_z_probe, where probing is verified by:

if (READ(Z_MIN_PIN) != Z_MIN_ENDSTOP_INVERTING) {
  return true;
} else {
  return false;
}

It's possible that Z_MIN be unstable because of conversion from an analogue value which may still be too near the threshold when Z_MIN triggers. To fix this it should be necessary to run the verification multiple time.

Version 1.0.0098.1 is unavailable to install

The latest version of the FABlin firmware (1.0.0098.1) for classic FAB-UI is unavailable via update or in the drop-down menu on the recovery page. (/recovery/flash.php).
The latest version available is 1.0.0098.

G28 homing is in the wrong direction.

Symptoms:
Zmin endstop hit message is displayed even if M119 reports all Endstops as Open.

conditions:
-Reset the controller
-V 1.00.8 installed
-enter G28

Workaround:
-enter G27
-enter G28 (will slightly crash at Z_MAX