This will guide you through the process of setting up a new machine to work with OpenPnP. Since every machine is different you may find that not every part of this document is applicable to your machine, but it should provide a good starting point for getting your machine up and running.
In recent versions of OpenPnP, the [[Issues and Solutions]] system can guide you through most of the machine setup process. The system already covers most of the difficult configuration steps, more are continuously being added. Many of the suggested solutions are automatic, or can be configured interactively, some even with graphical guidance:
Whenever OpenPnP starts up, or when you press Find Issues & Solutions, it will scan your configuration for any issues and solutions. A notifier dot will appear on the tab, when unresolved items are present. The system is very flexible, you can skip over steps and proceed to the next. OpenPnP will keep monitoring your configuration and list issues as long as unsolved. It will also detect issues if they are (re-) introduced later.
Consider the [[Issues and Solutions]] system as a more up-to-date/smarter alternative to the Table of Contents of this Wiki. Instead of working linearly through this document, follow [[Issues and Solutions]] and then use the blue information buttons to link back to this Wiki for details.
NOTE: The Wiki still contains information for many of the older versions of OpenPnP and/or legacy ways of setting things up manually, including hacking the machine.xml
. It is no longer recommended to do so!
The following is left for older versions of OpenPnP, and for those steps and use cases that are not yet covered by [[Issues and Solutions]].
You should follow the steps in the order they are listed in this guide since many of the steps depend on previous steps.
- [[Before You Start|Setup and Calibration: Before You Start]]
- [[Machine Setup|Setup and Calibration: Machine Setup]]
- [[Driver Setup|Setup and Calibration: Driver Setup]]
- [[Axes Setup|Machine Axes]]
- [[Top Camera Setup|Setup and Calibration: Top Camera Setup]]
- [[Steps Per Mm|Setup and Calibration: Steps Per Mm]]
- [[Nozzle Setup|Setup and Calibration: Nozzle Setup]]
- [[Actuators|Setup and Calibration: Actuators]]
- [[Vacuum Setup|Setup and Calibration: Vacuum Setup]]
- [[Bottom Camera Setup|Setup and Calibration: Bottom Camera Setup]]
- [[Park Location|Setup and Calibration: Park Location]]
- [[Discard Location|Setup and Calibration: Discard Location]]
- [[Feeders|Setup and Calibration: Feeders]]
- [[Bottom Vision|Setup and Calibration: Bottom Vision]]
- [[Vacuum Sensing|Setup and Calibration: Vacuum Sensing]]
- [[Camera Lighting|Setup and Calibration: Camera Lighting]]
- [[Next Steps|Setup and Calibration: Next Steps]]
Previous Step | Jump To | Next Step |
---|---|---|
Table of Contents | Before You Start |