Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 18 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,12 @@
# Horus

[![License](http://img.shields.io/:license-gpl-blue.svg?style=flat)](http://opensource.org/licenses/GPL-2.0) [![Build Status](https://travis-ci.org/bq/horus.svg)](https://travis-ci.org/bq/horus) [![Google Group](https://img.shields.io/badge/-Google%20Group-lightgrey.svg)](https://groups.google.com/forum/?hl=en#!forum/ciclop-3d-scanner)

## News of these fork:

01 - Ago - 2015 .- Never more change the possition of the patther on calibration! Just put in front of the camera, adjust camera and the calibration engine will do the rest.

## Whay is Horus?

Horus is a general solution for 3D scanning. It provides graphic user interfaces for connection, configuration, control, calibration and scanning. It is ready to use with Open Source [Ciclop 3D Scanner](https://github.com/bq/ciclop).

This project has been developed in [Python](https://www.python.org/) language and it is distributed under [GPL v2](https://www.gnu.org/licenses/gpl-2.0.html) license.
Expand All @@ -16,6 +21,15 @@ More interest links are shown below:
* [Documentation](http://diwo.bq.com/en/documentation-ciclop-and-horus/) [[es](http://diwo.bq.com/documentation-ciclop-and-horus/)]


## What's these fork?

These fork is my interpretation of what should be, and how should it work Horus, a fantastis software for controlling laser scanner based on Ciclops by BQ.

At the moment I'm working on get the finest calibration possible, and make Horus more cominicative to try to understand it better.

Also I'm working on porting Horus to Synology NAS and Raspberry Pi. I have both working, but I have to finish the instrucctions.


## Installation

###### Last stable version: 0.1.2.4
Expand All @@ -34,7 +48,7 @@ More interest links are shown below:
|:------------------:|:---------:|:--------:|:------------------------------------:|
| ![][debian-logo] | Debian | 8 | [link](doc/installation/debian.md) |
| ![][raspbian-logo] | Raspbian | RPi2 | [link](doc/installation/raspbian.md) |

| ![][synology-logo] | Synology | DSM 5.0 | [link](doc/installation/synology.md) |

## Development

Expand Down Expand Up @@ -65,4 +79,5 @@ NOTE: *dmg* packages only can be generated in Mac OS X
[windows-logo]: doc/images/windows.png
[macosx-logo]: doc/images/macosx.png
[debian-logo]: doc/images/debian.png
[raspbian-logo]: doc/images/raspbian.png
[raspbian-logo]: doc/images/raspbian.png
[synology-logo]: doc/images/synology.png
Binary file added doc/images/synology.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
153 changes: 153 additions & 0 deletions doc/installation/synology.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,153 @@
# Horus installation in Synology DSM ![][synology-logo]

[return to Home](../../README.md)

Firts of all, you need a Synology Nas updated, with ssh access with root credentials. [Guide](http://forum.synology.com/wiki/index.php/Enabling_the_Command_Line_Interface)

Then, you have to Install [Debian Chroot](https://synocommunity.com/package/debian-chroot) adding the Synocomunity repo. As they says:

Step 1:- Log into your NAS as administrator and go to Main Menu → Package Center → Settings and set Trust Level to Synology Inc. and trusted publishers.

Step 2:- In the Package Sources tab, click Add, type SynoCommunity as Name and http://packages.synocommunity.com/ as Location and then press OK to validate.

Step 3:- Go back to the Package Center and enjoy SynoCommunity's packages in the Community tab.


At these point, we have two methods to install:


### The easy one (Automatic and recomended)

Open a ssh connection with your synology Nas and follow these instrucctions:

```bash
ssh root@<yournas>.local -p XXXX

/var/packages/debian-chroot/scripts/start-stop-status chroot

### Now we are in the console of Debian Chroot

cd
wget https://github.com/javivi001/horus/blob/develop/syno-horus.sh
bash syno-horus.sh

### Make coffe and take patience, but everything will work with only a pair of cuestions at beginig
```
Enjoy Horus!!!




### The manual one


Open a ssh connection as the other method:

```bash
ssh root@<yournas>.local -p XXXX

/var/packages/debian-chroot/scripts/start-stop-status chroot

... Now we are in the console of Debian Chroot ...
```


Update packages:

```bash
apt-get update && apt-get upgrade -y && apt-get dist-upgrade -y
```


Install Locales and configure it:

```bash
apt-get install locales
dpkg-reconfigure locales
```


Install Basic comands and eviroment dependences:

```bash
apt-get install git gitk -y
apt-get install python2.7 python-pip python-wxgtk3.0 python-serial python-opengl python-pyglet python-numpy python-scipy python-matplotlib libdc1394-utils libdc1394-22 -y
pip install -U pip setuptools
```


Install a desktop suite:

```bash
apt-get install lxde -y
```


Install request for compilling Open CV:

```bash
apt-get install build-essential cmake make git gcc g++ gfortran libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev python-dev python-numpy \
libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libjasper-dev libdc1394-22-dev libv4l-dev libeigen3-dev -y
```

Install an VNC Server that allow OpenGL over X11

```bash
apt-get install vnc4server libgl1-mesa-swx11-dev-y

Start:$ vncserver -geometry 10280x1024 -depth 24 :1 && export DISPLAY=':1'
Stop:$ vncserver -kill :1
```


Let's start compilling and installing custom OpenCV:

```bash
cd /root/
git clone https://github.com/bq/opencv.git
cd opencv
mkdir release
cd release
cmake -D CMAKE_C_FLAGS=-m32 -D CMAKE_CXX_FLAGS=-m32 -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/usr/local -D WITH_TBB=ON -D BUILD_NEW_PYTHON_SUPPORT=ON \
-D WITH_V4L=ON -D WITH_FFMPEG=OFF -D WITH_OPENGL=OFF -D BUILD_opencv_gpu=OFF -D BUILD_opencv_gpu=OFF -D BUILD_opencv_ocl=OFF -D BUILD_opencv_nonfree=OFF \
-D BUILD_opencv_stitching=OFF -D BUILD_opencv_superres=OFF -D BUILD_opencv_ts=OFF -D BUILD_opencv_videostab=OFF ..
make
make install
```


And now it's time to Horus:

```bash
cd /root/
git clone https://github.com/bq/horus.git

or if you prefer my fort:

git clone https://github.com/javivi001/horus.git
cd horus
python src/horus.py
```

Enjoy Horus!!!


### IMPORTANT : Check yor kernel modules if you have in /lib/modules

You will nedd to add modules (in these order, very important!):

/lib/modules/videodev.ko
/lib/modules/v4l2-int-device.ko
/lib/modules/v4l2-common.ko
/lib/modules/uvcvideo.ko
/lib/modules/usbserial.ko
/lib/modules/ftdi_sio.ko

If you don't have it, you can crosscompile in other pc with the synology chaintools or try to croscompile in the Debian Chroot (these work for me)

Ask me your questions!!!


Regards!!!

[synology-logo]: ../images/synology.png
Binary file added res/images/pattern-position-center.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading