AudiculaPi Files

AudiculaPi v20150110- the tiny media server for your Raspberry Pi

based on
  _______                     ________        __
 |       |.-----.-----.-----.|  |  |  |.----.|  |_
 |   -   ||  _  |  -__|     ||  |  |  ||   _||   _|
 |_______||   __|_____|__|__||________||__|  |____|
          |__| W I R E L E S S   F R E E D O M
 -----------------------------------------------------
 *  BARRIER BREAKER 14.07 (Barrier Breaker, r43862)  *
 -----------------------------------------------------
    
Features:
* Minimalistic system, installed and running on a just 256MB sized SD card
* AudiculaPi provides a detailed Web Browser GUI with multi language support
* Uses recent linux kernel 3.12.35 provided by github.com/raspberrypi/linux 

Already preinstalled:
* MPD, Musi Player Daemon - Internet Radio / MP3 /OGG / FLAC etc. player
  (with IR & bluetooth remote control support, LCD support based on PyDPF)
* IPTV / DVB-T/S/C recorder with TVHeadEnd 3.9 (resp. MuMuDVB 2)
* SAMBA
* SSH/SFTP Server
* MiniDLNA
* Shairport
* Avahi
* OpenVPN
* WebCAM Video Streaming with mjpeg-streamer
* NTP client / server
* WLAN client and / or access point
* Homeautomation now with Domoticz (http://www.domotocz.com) 


Many, many additional packages are available via web based GUI installation powered by OpenWRT repository !

======================================================================
Quick AudiculaPi HowTo:
	1. installation of 200MB sized image:
	   a) Windows see at http://elinux.org/RPi_Easy_SD_Card_Setup
	   b) Linux: insert SD card into you card reader device and call "dmesg" and note which device has been detected:
	      e.g. "sd 8:0:0:0: [sdd] 3897344 512-byte logical blocks: (1.99 GB/1.85 GiB)"
            here the device is /dev/sdd
             
            sudo dd if=./AudiculaPi.img  of./dev/[sdcard device as above, e.g.sdd] bs=1M
            
	   c) I recommend to create a 3rd partion (ext4 filesystem) on your SD CARD using rest of available SD card space e.g. for your media files.
	   On Linux use fdisk /dev/sdd and mkfs.ext4 /dev/sdd3 (depends on above dmesg output) or gparted (GNOME) resp. partitionmanager (KDE)


======================================================================
1. AudiculaPi default access

	- Username: root
	- Password: [empty]

- LAN: AudiculaPi's LAN interface is configured as dhcp client.
	   For static IP adress assignment change settings in /etc/config/network

- for first connection setup  (LAN with DHCP required!) you are able to connect via
	"telnet [RPI's IP ADRESS]" 
	"http://[RPI's IP ADRESS]" - to change password.
	"https://[RPI's IP ADRESS]" - to change password.
        "ssh root@[RPI's IP ADRESS]" after password has changed/set.

	When password has been changed telnet connection is disabled but ssh connection is available !
	On Windows putty as client for telnet / ssh connections is recommended (http://www.chiark.greenend.org.uk/~sgtatham/putty/)

- other web interfaces available when already installed service is running

	"http://[RPI's IP ADRESS]:8080" to connect to domoticz
	"http://[RPI's IP ADRESS]:8200" to connect to minidlna
	"http://[RPI's IP ADRESS]:9981" to connect to tvheadend
	"http://[RPI's IP ADRESS]:PORT" to connect to mjpeg-streamer (change port to e.g. 8081 when 8080 is already used, see /etc/config/mjeg-streamer)
	
- Wifi Driver: Recent default installation provides Ralink usb kernel driver only. Other drivers are are provided by the packetmanager
	For installation of other usb wifi drivers you have to use LAN interface first 
	   (see chpater 3. for details).
	   For Wifi network setup use LUCI Web Interface(http://[RPI's IP ADRESS])

- When RPI network access is available (try 'ping [RPI's IP ADRESS]') enter in your desired webbroswer 
	http://[RPI's IP ADRESS]. 
	Ingnore security warning because https certificate of rpi can't be verified
	
-	See also http://wiki.openwrt.org/doc/networking/network.interfaces
			 http://wiki.openwrt.org/doc/uci/network

2. AudiculaPi Services:

  Not all available services a started during reboot in default configuration. 
  Please check WebGUI -> menu system -> systemstart or -> menu services ...
  
3. How to install additional & available kernel drivers and packages:

- Web Interface: Menu System -> Packagemanager
	Don't forget to click on "Update" first, to update repository.
	Many WIFI drivers are available.

- Other Media/DVB drivers: Only the DVB Dib 7000 driver is preinstalled
  Download recent precompiled package drivers archive kernel_3_12_35_drivers.tar.bz2 available at SF/AudiculaPi_20150110
  To identify the required drivers for your desired DVB HW, I recommend to use raspbian / Ubuntu:
  1. Connect your usb dvb hardware on ubuntu / raspbian system
  2. open console and enter 'lsmod |grep dvb'
  3. The listed drivers have to be copied to /lib/modules/3.12.35/
  4. try modprobe e.g. for my Dib7000 "modprobe dvb-usb-dib0700"
  5. adapt /etc/modules.d/dvb-usb for autoload of dvb driver

- (ssh)console: Use the packetmanager  opkg update
  opkg list |grep kmod
  opkg install kmod[your desired driver]

   Keep in mind the available memory of root partition on your SD-Card may be low:
   try "df -h" 

4. USB Pendrive:
	Filesystem Vfat, ext4, and linux swap are supported. 
	When connected the drive is automatically mounted and available at e.g. /mnt/media.
   
5. Bluetooth Remote Controller:
	My thumbnail sized Bluetooth dongle from "HAMA" has just to be connected before startup.
	After boot of system the dongle is "flashing" and you can "see" a AudiculaPi device with other bluetooth devices.
	
	Then MPD can be controlled with my Nokia 300 mobile phone.
	As client you have to install remuco:
	http://code.google.com/p/remuco/wiki/GettingStarted

6. Recent MPD configuration	(/etc/mpd.conf)
	- music folder is assigned to /mnt/media/music
	- I recommend to create a 3rd partion on your SD-CARD (/dev/mmcblk0p3) to be mounted to /mnt/media (see installation hints)
	- MPD database, logfiles etc. are assigned to /mnt/media/mpd
  
  If you want to use same configuration ,copy all your mp3/ogg/flac music files
	to your usb drive's root folder called "music" (subfolders are allowed) and 
	create a folder called	"mpd" in usb drive root directory.

7. TVHeadEnd setup:
   Initial scan has failed for me, hence we use w_scan (already installed) to get 1st tuning data:
   Set the option for the country, in this case germany(DE)
 
    w_scan -cDE -x >/root/dvb/de-all

    Finally in TVHeadEnd set the file path in "General Settings / DVB Scan files path" to:
    /root/dvb-scan/de-all.
    
    Now dvb scan and tuning works fine for me.

	
8. WebCAM
	Recently only the uvc kernel driver for webcam is installed.
	To install other e.g. gcspa usb webcam drivers see chapter 3 / 1.
	Hint: mjpegstreamer service during startup is disabled by default, see chapter 2.

	
9. OpenWrt specific distribution questions:
	Please see wiki at 
	http://wiki.openwrt.org/doc/start