Notice: If touchscreen registry does not show WLAN, please change language to force reload, then it should appear.
- V3 introduced a new webcam system, incompatible with V2. 0.80.1 will ignore autoconfiguration from V2 image but server will still work.
- V4 fixed a problem with network-manager preventing connections to network to work.
- V5 improved webcam configuration. Now allows setting resolution and frame rate from printer webcam configuration.
- V6 fixes wifi issues, adds screensaver control.
- V7 wifi management improved, packages updated
- V8 based on stretch, first Raspberry Pi 3+ compatible image.
Installing the Image
After you have downloaded the image, you need to unpack the zip file. It will show you a .img file, which you need to copy to your SD card. For this you need a 4 GB SD card or bigger. On a 4 GB card you have only 2 GB free space left, so a bigger card is a good idea. Our preferred size is 32 GB, which offers a good compromise between space and price. Also bigger cards live longer as we have more blocks to write to.
To copy the file to your SD card, follow the steps described here:
Shut down any running instance and place your newly created image in your Raspberry Pi and boot. If you have a HDMI display connected, you will already see the front end. At this point you have probably no internet connection and also no license entered (required for printer front end). So what you see is the registration page instead. Later it will directly boot into the normal front end.
The first thing to do is connecting the Raspberry Pi to your internet. The way that always works is using an ethernet connection. It will get a IP from your DHCP server and you can connect to it using http://
If you have a working touchscreen already, you can configure your WLAN directly on the display.
The last solution is using a smartphone or laptop with WLAN. Initially the image is configured to run as access point. So check your WLAN access points and select RepetierServer and connect using the password 12345678. The server only talks once a minute with os to get latest wifi status. So it might take a few minutes for changed settings to be seen correctly. Then open http://repetier-server.local/ or http://10.10.10.1 if your device does not understand bonjour protocol and go to Global Settings WLAN. There you can select your WLAN access point. After the connection is established, the Raspberry Pi access point will stop working and you have to access the server with the new IP it got from your network. In case of using http://repetier-server.local/ you connection will reestablish as soon as your device is back in your home network.
Next thing you should login to your Raspberry Pi command shell using ssh. For users unfamiliar with ssh – this is a protocol to gain access to the server on a command line level like cmd.exe in windows. If you are a windows user, you will most likely not have a ssh command. You can download and use http://www.putty.org for this. So connect with user pi and password raspberry to the commandline.
Now you are logged in as user pi. For security reasons, you should change the default password to something only you know. To change the password, use the “passwd” command. When finsihed, you can log out (ctrl+D).
It is a good idea, to configure your DHCP server (normally part of your router configuration) to always assign the same IP number. This is done by assigning a static IP to the MAC address. You find the raspberry MAC address in our web front end on the home page. Scroll to the bottom and you see for every network device the matching MAC address you should use in your router.
Now plug in your printer and start configuring your first printer as described in the server manual.
Special Cases / Troubleshooting
WLAN connection problems
The automatic wlan setup is a complex issue especially if a router changes channels (automatic channel selection) or if the signal gets lost from time to time. First thing to check is what channels your router uses and what channels you can receive. By default the pi will only listen on channels 1-11. Channels 12 and 13 are only allowed in special regions, so select your region if you need them. If you live in such a region your router might also use this channel or if it automatically selects the channel even switch between visible and invisible channels so your pi might disappear from network.
The other issue is an unstable connection. The server monitors connection and when wifi signal is broken it goes to access point mode or tries to reconnect if the ssid is visible. Unfortuantely, if then the connect fails, we assume password is incorrect and delete the connection. So you would need to reenter password to connect again. You can disable this behaviour if you login using ssh and run:
sudo nano /usr/local/Repetier-Setup/bin/manageWifiAccess
and search for
connect) prepareConnect nmcli connection up "$P1" &> /dev/null ret=$? if [ $ret == 0 ] ; then echo "OK" else nmcli connection delete "$P1" ifname $WLAN &> /dev/null echo "Failed" fi ;;
and put a # before the “nmcli connection delete” line and save. This will prevent loss of password and tries to reconnect everytime it sees your router until it succeeds again.
If you have no display, you should not start x environment and web browser since this only costs RAM you could better use.
So in that case, log in and edit .bashrc in your home directory:
Go the end of the file and comment the end like this:
#if ! pgrep "xinit" > /dev/null #then # xinit -- -nocursor & #fi
And on next reboot the x server will not start.
Depending on how you have mounted the display, you may need to rotate the screen. To do this, login and run
sudo nano /boot/config.txt
and search for a line
# Rotate screen 180° lcd_rotate=2
A value of 0 is no rotation, 2 = 180°.
Non HDMI Display
There are several cheap LCD displays available, that you can simply put on the Raspberry Pi header pins instead of using
the HDMI connector. Especially small displays with resolutions up to 480×320 pixel use this way. In that case
the images need to be rendered in a frame buffer that gets send via spi to the display. If you have such
a display, follow the instructions of your display vendor to configure the display. After a final reboot the
printer front end should then start automatically.
Disable Display Power Saving
In the screensaver settings you can activate/deactivate the hardware screensaver, that turns the display off. Some users report that sometimes
the active hardware screensaver does not come back. This is a function from Linux/X11 and we only set the timeout using the xset command. If that
is the case, please disable hardware screensaver. Your image will still darken after timeout, just not try to disable the hardware light as it would
try to do with hardware screen saver. If someone has a hint what prevents linux from wakeup the screen, please let us know.
The image is preconfigured to handle a USB or Raspberry Pi webcam. We have implemented an autodetect for webcams. To configure it, simply go to Printer Settings Webcam and select the webcam at the bottom and click Assign.
It will start the webcam server and fill in the correct settings. If you have unplugged the webcam, the webcam server will start automatically when you plug in the webcam. Additionally you can set webcam resolution and framerate. Consider that higher resolutions and frame rates need more bandwidth and CPU usage. If this causes any problems like delays or blank screens, reduce them.
Webcam does not work
Some users seem to have no webcam support with current settings. Send on console
/usr/bin/v4l2-ctl --list-formats-ext -d /dev/video0
to see what modes your webcam supports. Then edit /usr/local/Repetier-Setup/etc/webcam.conf to use one of the resolution/frame rate combination that your webcam supports. After that reboot the Pi so the changes take effect.
Import from USB Stick
Initially the server is preconfigured to import files from a USB stick. Just insert a USB stick and it will
auto mount the drive. If you then select the import function it will show the files on the USB stick.