AudiculaPi Files

AudiculaPi v20160313- the tiny media / homeautomation server for your Raspberry Pi A/B/B+

based on
  _______                     ________        __
 |       |.-----.-----.-----.|  |  |  |.----.|  |_
 |   -   ||  _  |  -__|     ||  |  |  ||   _||   _|
 |_______||   __|_____|__|__||________||__|  |____|
          |__| W I R E L E S S   F R E E D O M
 -----------------------------------------------------
 -----------------------------------------------------
 *     CHAOS CALMER (Chaos Calmer , r49004)          *
 *              AUDICULA PI R20160313                *
 -----------------------------------------------------
    
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 Linux kernel 3.18.27

Already preinstalled:
* Homeautomation with Domoticz (http://www.domoticz.com) - latest release version v3.4834
  Tested with HW: RFXtrx433E USB 433.92MHz Transceiver by RFXCom and Z-Wave Plus USB Stick ZME_UZB1 by Z-Wave.me
* MPD, Musi Player Daemon - Internet Radio / MP3 /OGG / FLAC etc. player
  (with LCD support based on PyDPF)
* pianod
* SAMBA
* SSH/SFTP Server
* MiniDLNA
* Shairport
* Avahi
* OpenVPN
* WebCAM Video Streaming with mjpeg-streamer
* NTP client / server
* WLAN client and / or access point
* ... countless other gadgets, use web based packet manager 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]:PORT" to connect to pianod
	"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: Sorry , not possible for this version due to several kernel compiler error after make kernel_menuconfig

- (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. 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.

6. 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.

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