Manuals/SHR/ru

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Введение в SHR)
Line 11: Line 11:
  
 
'''SHR'''  (Stable Hybrid Release)  существует для того, что бы дать вам образ корневой файловой системы, который вы сможете легко установить в свой аппарат и использовать его ежедневно, как телефон или КПК. Существует множество собранных программ, которые могут быть установлены по желанию пользователя, их так же могут использовать разработчики, как базовые образы для своих релизов. '''SHR unstable'''  - тестовая среда, используемая до того, как станет стабильным, а также тестовая площадка для релизов [[FSO]]. '''SHR testing''' предоставляет максимальную стабильность для каждодневного применения.
 
'''SHR'''  (Stable Hybrid Release)  существует для того, что бы дать вам образ корневой файловой системы, который вы сможете легко установить в свой аппарат и использовать его ежедневно, как телефон или КПК. Существует множество собранных программ, которые могут быть установлены по желанию пользователя, их так же могут использовать разработчики, как базовые образы для своих релизов. '''SHR unstable'''  - тестовая среда, используемая до того, как станет стабильным, а также тестовая площадка для релизов [[FSO]]. '''SHR testing''' предоставляет максимальную стабильность для каждодневного применения.
 
Если заметите неточности в этом руководстве, пожалуйста, исправьте. Вопросы и пожелания на английском языке можно отправить на vanous @ penguin . cz. Спасибо =)
 
  
 
==Установка==
 
==Установка==

Revision as of 07:46, 5 October 2010

Contents

Введение в SHR

Добро пожаловать в SHR, дистрибутив разрабатываемый сообществом для (не только) телефонов Openmoko, HTC Dream, PalmPré и Nokia n900.

SHR

SHR (Stable Hybrid Release) существует для того, что бы дать вам образ корневой файловой системы, который вы сможете легко установить в свой аппарат и использовать его ежедневно, как телефон или КПК. Существует множество собранных программ, которые могут быть установлены по желанию пользователя, их так же могут использовать разработчики, как базовые образы для своих релизов. SHR unstable - тестовая среда, используемая до того, как станет стабильным, а также тестовая площадка для релизов FSO. SHR testing предоставляет максимальную стабильность для каждодневного применения.

Установка

Получение SHR

Вам необходимо загрузить два файла для вашей версии телефона: ядро и корневую файловую систему. В зависимости от того, как вы будете устанавливать, во внутреннюю NAND_Flash/ru или на microSD карту, необходимо скачать файлы .jffs2 для NAND или .tar.gz для microSD.

- Ядро можно взять по ссылка ниже. Названия файлов начинаются с uImage-...

- Образы файловых систем, для NAND: full-om-gta0_.jffs2, для µSD: full-om-gta0_.tar.gz

Это полные образы. Вы также можете выбрать образы с меньшим количеством предустановленных пакетов, отмеченные, как легкие.

GTA02 Neo FreeRunner
GTA01 Neo 1973
От легкого образа к полному

Если вы прошили легкий образ и хотите обновить его до полного - выполните:

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk
Модули ядра

Образы файловых систем упомянутые выше (.jffs2, .tar.gz), уже содержать свежие модули ядра.

Используйте свежие модули ядра только в том случае, если хотите прошить только новое ядро, а всю файловую систему. Модули можно скачать с той же страницы, что и само ядро (даты должны совпадать). Используйте sftp, что бы загрузить модули на свой FreeRunner через usb соединение. Запустите gzip, что бы распаковать файлы:

# gzip -dc modules-...tar.gz | tar -xf - -C /

Установка в flash память

Если необходимо установить SHR во встроенную память вашего Freerunner(NAND), вам надо скачать файлы корневой файловой системы( .jffs2 ), которые указаны выше, и прошить телефон с помощью утилиты dfu-util.

Посмотрите Flashing the Neo FreeRunner для детальной информации по процедуре прошивки и Dfu-util для информации о dfu-util.

NOTE: Батарея должна быть заряжена (в достаточном объеме) перед прошивкой NAND. Симптомы недостаточной зарядки: строка состояния "####" останавливается во время прошивки. Если это произошло, зарядите батарею и повторите процедуру позднее.


Команды для прошивки файловой системы и ядра:

Отметьте, что при использовании sudo могут возникнуть проблемы.

Не используйте sudo с dfu-util. Удостоверьтесь, что вы root, перед использованием dfu-util!

для GTA02 Neo FreeRunner:

# dfu-util -d 0x1d50:0x5119 -a rootfs -R -D full-om-gta02.jffs2
# dfu-util -d 0x1d50:0x5119 -a kernel -R -D uImage-om-gta02-latest.bin

для GTA01 Neo 1973:

# dfu-util -d 0x1457:0x5119 -a rootfs -R -D full-om-gta01.jffs2
# dfu-util -d 0x1457:0x5119 -a kernel -R -D uImage-om-gta01-latest.bin

Установка на microSD карту

Установка на карту microSD зависит от загрузчика, который вы используете, uBoot или Qi.

Проще говоря, разница между загрузчиками состоит в том, каким образом вам необходимо подготовить вашу карту microSD и файлы:

  • Если используется uBoot, Необходимо сделать два раздела. Первый - небольшой, с файловой системой FAT16 или ext2, на нем размещается ядро (uImage-om-gta02-latest.bin) и второй раздел с файловой системой ext2 или ext3 куда вы распакуете образ корневого раздела (shr-image-om-gta02.tar.gz).
  • Если используется Qi, вам нужен только один раздел с файловой системой ext2 на вашей µSD карте куда вы распакуете образ корневого раздела (shr-image-om-gta02.tar.gz). В этом случае загрузчик Qi будет искать в каталоге /boot файл, называемый uImage-GTA02.bin .

Посетите следующие ссылки для детальной информации:

Версия SHR

Что бы узнать версию SHR, которая установлена, выполните:

cat /etc/shr-version
NOTE: Помните, что выполнение opkg update;opkg upgrade не изменяет версию SHR. Только перепрошивка новым образом может изменить версию SHR.


Запуск SHR

Первая загрузка

SHR Boot Splash screen

Загрузка

Обычно первая загрузка занимает немного больше времени, чем обычно, т.к. некоторые приложения проводят инициализационные настройки. Рекомендуется перезагрузить телефон после первой загрузки (и после инициализации), что бы удостовериться, что все пакеты инициализировались правильно.

Первичные настройки

Во время первого запуска, мастер настройки запустится автоматически проведет пользователя через базовые этапы настройки рабочего окружения Enlightenment. Эти шаги разняться с развитием Enlightenment и SHR, на этом этапе выбираются настройки языка и профиль рабочего окружения. Профиль позволяет выбрать предустановленные настройки отображения рабочего стола. Если вы не уверены, выберите Illume-SHR.

language selection
theme selection

Мастер настройки SHR

После инициализационных настроек запустится мастер настроек SHR, который позволит вам задать пароль сепрпользователя и настройки телефонной сети.

Screenshot TBD

First look

Desktop screen

Illume desktop is the default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelf or by using the < left or right > arrows in the Top Shelf. You can access Task switcher, Illume Settings and more by tapping on the Top Shelve - the shelve will open up by sliding down.


Клавиатура

Keyboard comes up automagically when a text field is tapped or you can also toggle the keyboard by it's icon or 'alpha' in the Top Shelve. In the Keyboard, dictionary switcher is the arrow-up on left side, alternative keyboard layouts are under the ABC button on the right. The Default keyboard has English dictionary enabled. For Space quick slide left-to-right, for Enter, quick slide up-down, to quick change keyboard layout quick slide down-up. While typing with a dictionary enabled keyboard, possible word options start appearing in the keyboard's upper part or more word options are available under the arrow-up on the left. When happy with the word, tap it, it will be pasted into the text field with a space attached. The Keyboard and dictionary can easily be localized.

Копировать - Вставить

In E based applications (for example the phone suite (messages)) tap and hold down for over two seconds. Select-Paste menu will pop up. By pressing Select, you can now swipe through the text to select desirable part. Tap and hold down again, Copy-Cut-Cancel menu will appear to Copy to clipboard. Another long tap will provide Select-Paste for Paste.

In Gtk based application you can use keyboard for Ctrl-C (Copy) and Ctrl-V (Paste).

In the Vala Terminal you can select by keyboard swipe and for Paste there is a icon in the menu bar of this application.

Будильник

Приложение будильника (установленное по умолчанию) позволяет задать единоразовое или повторяющееся срабатывание будильника. Если вы задали время срабатывания будильника и выключили свой Openmoko Freerunner - в указанное время телефон включится и будильник сработает.

Телефонные приложения

Среди прочего, в SHR установлено 4 основных телефонных приложения: Dialer, Contacts, Messages и Phone log.

Dialer
Contacts
Messages
Phone log

Настройка приложений

Настройки SHR запускаются нажатием на иконку Settings рабочего стола. Настройки Illume доступны в ниспадающей верхней панели, необходимо нажать на иконку с логотипом SHR.

Верхняя панель с иконкой настройки Illume

Аппаратные кнопки

Кнопка включения питания

The PWR (Power) button is mapped to start Quick Settings screen (Illume System menu in older versions) on a short press.

Mapping of the PWR button be configured via the Illume Settings-> Input -> Key Bindings.

Pressing the Power button for longer then 8 seconds will force a complete power down of the device. This is hardconfigured in the kernel.

The Quick Settings screen provides several toggles: Airplane mode, Phone profiles, Power settings and Power buttons.

Дополнительная кнопка

The AUX (Auxiliary) button is mapped to toggle on/off the SHR Idle screen. Mapping of this button is configured in /etc/phonefsod.conf

idle_screen = aux,lock

You can configure the Idle Screen to come up even during active phone call by adding phone to the setting:

idle_screen = aux,lock, phone

The Idle Screen shows current date and time, missed calls and messaged and also what FSO resources are currently being requested - used.

Замена экрана простоя

If you with to use the previous simple LOCKED screen instead of the new standard Idle Screen

Edit /etc/phonefsod.conf to this:

# when to show idle screen
# ...
# idle_screen = aux,lock
idle_screen =

You need to restart phonefsod to make the change happen.

Also, change key mapping for the AUX button by setting Illume Settings -> Input -> Key Bindings, bind the key XF86Phone to Desktop Simple Lock

Первые шаги

Right after installation and first boot you might want to do a few initial steps like adjusting the call volume and some other tasks.

Звук - громкость звонка

During the first phone call please use the Volume and Mic sliders on the Active Call Screen and adjust them to fit your preferences. When you have found good settings, terminate the test call and reboot the phone. The new improved settings will then be used for all in- and outgoing calls thereafter.

Сетевое подключение

Establish network connection and SSH into your phone. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read USB Networking. For Wifi, you can use Network Manager

Инициализация базы данных opkg

Инициализация базы данных opkg необходима для установки приложений из репозиториев SHR или других источников, например, opkg.org. Когда будете в сети, выполните:

opkg update

Поиск в базе данных opkg может занимать длительное время. Это можно ускорить, если скопировать содержимое базы в в текстовый файл, а потом просто искать в нем с помощью grep. Это можно проделать единожды, либо после каждого обновления opkg:

opkg list > packages.txt

Теперь можно быстро искать по имени пакета, например navit:

grep navit packages.txt

SwapSpace

When the RAM is used up, applications get killed. This is particularly bad while doing opkg upgrade. Therefore you might want to create a swap space. Read SwapSpace article.

Настройки

Настройки SHR

SHR Settings

SHR Settings is the main setting application of SHR. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

Please refer to this section about a better way to manage preventing screen dim or suspend.

While some settings are persistent over reboots, others are not.

Главный экран

The main screen is divided into eight categories, which contain several modules. Every SHR Settings module has a specified task - for example controlling the GSM antenna power, setting the time etc.

Телефон

Here you can set if the GSM antenna is on and if your phone number is shown when you call someone.

GSM In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After a while, a list of operators should pop up.

You can't connect to operators marked [forbidden].

Selecting an operator from the list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

Call

Phone settings


List providers

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

Phoneutils

For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to set the right country code for your location. (for example 420 for Czech republic) for more info, please go to: http://wiki.openmoko.org/wiki/Phone_Prefixes

SIM

Here you can view some informations about your SIM card and clean phone and messagebooks.

Профили

Here you can select the current profile, which the device should use to determine ring tone etc.

Current profile

Here you can adjust properties of the currently used profile.

To change the ring tone, click the "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting a sid tune as the ring tone, there are available controls to select tune number from the file.

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

Profiles
Ringtones

Подключения

Connectivity top
Connectivity bottom

WiFi

With the "WiFi radio" toggle you can set, if the wifi module is powered. WiFi radio has to be turned on before trying to connect to a WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

GPRS

To enter APN, login and password fields, just click on the actual value (default: "internet"). Your phone provider can provide the required configuration options.

NOTE: You can also use Mokonnect to manage your GPRS connection


USB

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

Bluetooth

To power up Bluetooth module, switch the "Bluetooth radio" toggle to "On". After that, the "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

Питание

Battery

This module displays informations about battery state - charge, voltage, remaining time etc. To update the data, click the "Update" button.

Here you can also force enable 500mA charging.

Display

With this slider you can easily set the backlight brightness.

NOTE: This setting isn't permanent over sessions. At boot backlight is set back to 80%.


Power

Power
Timeouts

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

Timeouts

Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend.

NOTE: Configuration behavior has been changed due to FSO rewrite.


Old behavior (delete by Apr 1st):

Here (Timeouts screen of SHR Settings) you can set up values of idle timeouts used by the device. This setting changes parameters in /etc/frameworkd.conf :

[fsodevice.kernel_idle]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

New behavior:

Storing of this setting via D-bus calls is not supported in the new API of Vala rewrite of FSO2. SHR Settings doesn't have a setting for this. Configurable values are now stored in /etc/freesmartphone/conf/GTA02/fsodeviced.conf but you can keep your own config file in your home directory:

~/.fsodeviced.conf

Внешний вид

Theming

Neo theme

The Apperance section allows you to change between installed themes. To install more themes, see also Installing themes.

You can change finger size - this will mainly effect vertical spacing between widgets.

Switching between engines:

E can be switched to use different engines. The default engine is x11. Alternative engine x11-16 is not supported and results in buggy behavior of several applications, for example the phone suite or Ventura browser.

Changing Splash screen is also possible in this module. To install more splash screens, see also Installing splash themes.

GPS

GPS
GPS Satelite details

GPS

By default, GPS is turned on only when requested by an application. That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

GPS information

This page can be used to monitor GPS status. You either have to turn GPS on manually or start another application to enable the GPS.

You can also view information about every visible satellite and check, which are used for getting a fix. To do that, click "Satellite details".

Remove AGPS data If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo. Assisted GPS (aGPS) support GPS receiver to find position by non-satellite information.

Дата/время

Date & Time

Time

Here you can view and set the time. By default, the time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click the "OK" button.

Date

This module displays the current date.

Остальное

Others

PIM

Pim data are stored in opimd domains. Every opimd domain has different backends to store its data to. The domain reads data from every backend and writes data to the default backend. This elector allows you to choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

Services

The services selector is listing scripts from /etc/init.d/ directory.

After clicking on a servis, you can either start, restart or stop the service and view the result.

Services
Services debug screen


Userspace backups

Here you can either archive or restore your files and configurations.

Настройки illume

The Illume desktop can be easily customized - slide the top shelf down and tap the Settings icon (SHR Logo).

Illume settings (SHR Logo icon) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to view more options on the right hand side.

The little applets in the top shelf (for example Battery, GSM, Bluetooth etc.) are called shelf gadgets and you can configure whether they are visible (on the front part of the top shelf) or hidden (you can access them by sliding the top shelf) through Illume Settings -> Display -> Shelf gadget.

Some setting screens are not resized properly to fit the phone's display - for example the Wallpapper setting. This is a known bug already reported upstream.


Локализация

Ручная локализация SHR

Setting Language

Окружение рабочего стола

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in the Illume top shelf go to Settings (SHR Logo) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep eglibc-locale-

And install the language of your choice (for example czech):

opkg install eglibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable of your desktop.

Приложения

If you wish to have other applications localized, you need to install translation for each of them (presuming it is available):

This will install czech localization for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

Окружение терминала

Для локализации терминального окружения (ssh) установите переменные LANG и LC_ALL в файле /etc/profile, например для Русского языка:

export LANG=ru_RU
export LC_ALL=ru_RU

Клавиатура и словари Illume

The Illume keyboard offers English dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and the English one is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

Dutch terminal virtual keyboard

Furthermore you can install a different keyboard with a layout which fits your language or alternatives for the default keyboards like the numerical one. The localized Illume keyboards are available in the SHR repository under the name illume-keyboard-LANG.

Note that sometimes after an upgrade of Illume has taken place, these keyboards have to be installed again before they become available again. Removing these packages will restore the availability of the respective original keyboards.

German (and Austria) Language

See Configure_SHR_for_German-speaking_use for detailed customization for german speaking.

Дата и время

The local timezone is automatically retrieved from the GSM network.

create a symlink named /etc/localtime which points to the appropriate file in /usr/share/zoneinfo. For example, if you're in France., the following command will link the correct zoneinfo file to your /etc/localtime, giving you the correct time:

ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime

Afterwards, edit /etc/timezone if necessary [?]

Local timezone work instantly for the current boot when:

TZ="Europe/Paris"
export TZ

For a permanent timezone change edit /etc/profile and change to:

TZ="Europe/Paris"

Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

Is this better?:

hwclock --utc --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

Ресурсы FSO

FSO контролирует каждое устройство. Устройства называются ресурсами. Если программа желает использовать устройство, то можно обратиться к этому ресурсу через d-bus, FSO сделает это, или вы можете задействовать ресурс вручную. После того, как запрос ресурса будет выполнен, FSO отключит устройство. Ручной запрос ресурса может быть выполнен с помощью SHR Setting или команды fsoraw. (Применение fsoraw быстрее и лучше использования команд d-bus)

opkg install fsoraw

Пример использования fsoraw:

fsoraw -r Display mokomaze

Смотрите FSO Resources для большей информации по использованию следующих ресурсов:

Wifi

Пока этот ресурс задействован нет eth0 и wifi модуль полностью отключен. Используйте Mokonnect настройки сетей, он автоматически включит Wifi если необходимо.

Bluetooth

Необходимо обратиться к этому ресурсу, что бы задействовать модуль bluetooth.

GPS

Демон fso-gpsd ждет подключений от gsmd, автоматически включая и выключая устройство. Как только появляется подключение, он включает GSM. В SHR Settings можно полностью выключить GPS

SHR Settings -> GPS -> Manual > Off

GSM

Необходимо обратиться к этому ресурсу, что бы включить модуль GSM.

Display

Если обратиться к этому ресурсу, то суспенд будет выключенным, и включится экран.

CPU

Если обратиться к этому ресурсу, то суспенд будет выключен. Экран будет чистым.

Test

Тестовый ресурс.

UsbHost

При обращении к этому ресурсу USB переключится в режим хоста.

Accelerometer

Необходимо обратиться к этому ресурсу, что бы включить акселерометр.

Network manager

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

The connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. The Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable it after use.

Mokonnect
Mokonnect Wifi
Mokonnect Wifi Scan


Bluetooth

Bluetooth can be used for several different applications - file transfer (OBEX), networking, input devices (HIDD), music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better than for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if the bluetooth headset is not around, making it quite difficult to use.

In the SHR repositories are applications ready to be installed (by opkg) that already do provide bluetooth support. This means that they request the bluetooth resource automatically, can search bluetooth devices around, help you with pairing and can perhaps even reconnect bluetooth headset upon resume from suspend. From applications that have some bluetooth support some are for example Launcher (home screen launcher and phone suite), Podboy (podcast player), Elmtooth (bluetooth manager). In order to set up bluetooth for phone calls, some manual setup from bellow is still required.

Bluez3 - вручную без D-Bus

If you want to use the bluetooth device directly, you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On. You can also make the bluetooth device visible here.

Работы с файлами через OBEX

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) does not exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
	00:16:41:F5:A5:BC	laptop

Then send the file onto bluetooth address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

Подключение bluetooth клавиатуры

hidd --search
Editors note: This is the old bluez3 way, but it works. New bluez4 way will replace this.

Bluez4 - D-Bus based way

SHR uses bluez4 which is completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see Manually using Bluetooth for detailed information about using bluetooth and also for a list of supported devices.

Подключение

Emtooth менеджер bluetooth соединений. Позволяет задавать bluetooth имя устройства, подключение/отключать, настройки видимости устройства и др. Что бы установить Emtooth, выполните:

opkg install emtooth

Emtooth начнет поиск доступных устройств, двойное нажатие на строке с именем найденного устройства начнет процесс подключения.

GSM с bluetooth гарнитурой

Чтобы использовать bluetooth гарнитуру для совершения телефонных звонков, необходимо выполнить несколько простых действий.

1). Ваша bluetooth гарнитура должна быть сперва подключена.

2). Добавьте вашу bluetooth гарнитуру в настройки FSO.


NOTE: Все звонки будут идти через гарнитуру. После старта и каждого суспенда гарнитура должна быть переподключена.


Настройка FSO

Сейчас мы должны сказать frameworkd, что у нас есть гарнитура bluetooth. Параметры гарнитуры должны быть заданы в:

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Параметры bt-headset-enabled и bt-headset-address смотрите opreferences/schema/phone.yaml для понимания.

Теперь надо перезапустить FSO, что бы изменения вступили в силу.

# /etc/init.d/frameworkd restart

Пример чьего-то /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98
Переподключение гарнитуры

Возможно вам понадобиться вручную задействовать гарнитуру в самом начала и после суспенда:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

Где xx_xx_xx_xx_xx_xx адрес гарнитуры, например:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Сейчас гарнитура должна работать.

System Customizing

Установка тем splash screen

List available splash screen themes

opkg list | grep splash-theme

Install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Appearance -> Splash settings. Here you can preview installed themes and change the default one.

Установка тем

Every theme is made of several components (a theme for illume, theme for the phone applications, theme for etk and so on). There is a SHR metapackage for each theme that allows installing the complete theme in one go.

List available SHR theme metapackages:

opkg list | grep shr-theme

Install one of the available themes

opkg install shr-theme-gry

Then go to SHR Settings -> Appearance -> Elementary Settings. Here you can preview installed themes and choose the preferred one.

The Illume screen requires to change theme via Settings (SHR Logo) -> Look -> Theme. Here you can preview installed themes and choose the preferred one.

Включение курсора мыши

edit line 143 of /etc/X11/Xserver and erase -nocursor

ARGS="$ARGS"


Случайные ошибки

Нет иконок, не работает GSM и т.д. - скорее всего это из-за ошибок на µSD карте. Извлеките карту и исправьте проблему через картридер или загрузитесь из nand смонтируйте карту в режиме для чтения и запустите fsck:

fsck.ext2 /dev/mmcblk0p1

GSM modem 1024 suspend bug

The calypso GSM modem suffers a known 1024 hardware bug that causes unreliable GSM function. To work it around, SHR by default doesn't suspend the modem completely. If you have undertaken a fix for this bug you can extend your battery time by enabling the modem to fully suspend when possible.

Edit the following in /etc/frameworkd.conf file:

ti_calypso_deep_sleep = always

Then restart framework or reboot the phone.

Сообщения об ошибках

SHR находится в разработке. Если нашли ошибку, пожалуйста, сообщите о ней SHR. Приложите к своему сообщению логи из:

/var/log/

Что бы сообщить об ошибке, зайдите на http://shr-project.org/trac/report

Проверьте, известно ли уже об этой ошибке. Если нет, добавьте, будьте максимально точны в заголовке и описании, при каких условиях это произошло и т.д. Если уже есть упоминание об этой ошибке, посмотрите, возможно вы можете добавить более свежую информацию.

Дополнительная Информация

Посетите:

Personal tools

Contents

Введение в SHR

Добро пожаловать в SHR, дистрибутив разрабатываемый сообществом для (не только) телефонов Openmoko, HTC Dream, PalmPré и Nokia n900.

SHR

SHR (Stable Hybrid Release) существует для того, что бы дать вам образ корневой файловой системы, который вы сможете легко установить в свой аппарат и использовать его ежедневно, как телефон или КПК. Существует множество собранных программ, которые могут быть установлены по желанию пользователя, их так же могут использовать разработчики, как базовые образы для своих релизов. SHR unstable - тестовая среда, используемая до того, как станет стабильным, а также тестовая площадка для релизов FSO. SHR testing предоставляет максимальную стабильность для каждодневного применения.

Если заметите неточности в этом руководстве, пожалуйста, исправьте. Вопросы и пожелания на английском языке можно отправить на vanous @ penguin . cz. Спасибо =)

Установка

Получение SHR

Вам необходимо загрузить два файла для вашей версии телефона: ядро и корневую файловую систему. В зависимости от того, как вы будете устанавливать, во внутреннюю NAND_Flash/ru или на microSD карту, необходимо скачать файлы .jffs2 для NAND или .tar.gz для microSD.

- Ядро можно взять по ссылка ниже. Названия файлов начинаются с uImage-...

- Образы файловых систем, для NAND: full-om-gta0_.jffs2, для µSD: full-om-gta0_.tar.gz

Это полные образы. Вы также можете выбрать образы с меньшим количеством предустановленных пакетов, отмеченные, как легкие.

GTA02 Neo FreeRunner
GTA01 Neo 1973
От легкого образа к полному

Если вы прошили легкий образ и хотите обновить его до полного - выполните:

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk
Модули ядра

Образы файловых систем упомянутые выше (.jffs2, .tar.gz), уже содержать свежие модули ядра.

Используйте свежие модули ядра только в том случае, если хотите прошить только новое ядро, а всю файловую систему. Модули можно скачать с той же страницы, что и само ядро (даты должны совпадать). Используйте sftp, что бы загрузить модули на свой FreeRunner через usb соединение. Запустите gzip, что бы распаковать файлы:

# gzip -dc modules-...tar.gz | tar -xf - -C /

Установка в flash память

Если необходимо установить SHR во встроенную память вашего Freerunner(NAND), вам надо скачать файлы корневой файловой системы( .jffs2 ), которые указаны выше, и прошить телефон с помощью утилиты dfu-util.

Посмотрите Flashing the Neo FreeRunner для детальной информации по процедуре прошивки и Dfu-util для информации о dfu-util.

NOTE: Батарея должна быть заряжена (в достаточном объеме) перед прошивкой NAND. Симптомы недостаточной зарядки: строка состояния "####" останавливается во время прошивки. Если это произошло, зарядите батарею и повторите процедуру позднее.


Команды для прошивки файловой системы и ядра:

Отметьте, что при использовании sudo могут возникнуть проблемы.

Не используйте sudo с dfu-util. Удостоверьтесь, что вы root, перед использованием dfu-util!

для GTA02 Neo FreeRunner:

# dfu-util -d 0x1d50:0x5119 -a rootfs -R -D full-om-gta02.jffs2
# dfu-util -d 0x1d50:0x5119 -a kernel -R -D uImage-om-gta02-latest.bin

для GTA01 Neo 1973:

# dfu-util -d 0x1457:0x5119 -a rootfs -R -D full-om-gta01.jffs2
# dfu-util -d 0x1457:0x5119 -a kernel -R -D uImage-om-gta01-latest.bin

Установка на microSD карту

Установка на карту microSD зависит от загрузчика, который вы используете, uBoot или Qi.

Проще говоря, разница между загрузчиками состоит в том, каким образом вам необходимо подготовить вашу карту microSD и файлы:

  • Если используется uBoot, Необходимо сделать два раздела. Первый - небольшой, с файловой системой FAT16 или ext2, на нем размещается ядро (uImage-om-gta02-latest.bin) и второй раздел с файловой системой ext2 или ext3 куда вы распакуете образ корневого раздела (shr-image-om-gta02.tar.gz).
  • Если используется Qi, вам нужен только один раздел с файловой системой ext2 на вашей µSD карте куда вы распакуете образ корневого раздела (shr-image-om-gta02.tar.gz). В этом случае загрузчик Qi будет искать в каталоге /boot файл, называемый uImage-GTA02.bin .

Посетите следующие ссылки для детальной информации:

Версия SHR

Что бы узнать версию SHR, которая установлена, выполните:

cat /etc/shr-version
NOTE: Помните, что выполнение opkg update;opkg upgrade не изменяет версию SHR. Только перепрошивка новым образом может изменить версию SHR.


Запуск SHR

Первая загрузка

SHR Boot Splash screen

Загрузка

Обычно первая загрузка занимает немного больше времени, чем обычно, т.к. некоторые приложения проводят инициализационные настройки. Рекомендуется перезагрузить телефон после первой загрузки (и после инициализации), что бы удостовериться, что все пакеты инициализировались правильно.

Первичные настройки

Во время первого запуска, мастер настройки запустится автоматически проведет пользователя через базовые этапы настройки рабочего окружения Enlightenment. Эти шаги разняться с развитием Enlightenment и SHR, на этом этапе выбираются настройки языка и профиль рабочего окружения. Профиль позволяет выбрать предустановленные настройки отображения рабочего стола. Если вы не уверены, выберите Illume-SHR.

language selection
theme selection

Мастер настройки SHR

После инициализационных настроек запустится мастер настроек SHR, который позволит вам задать пароль сепрпользователя и настройки телефонной сети.

Screenshot TBD

First look

Desktop screen

Illume desktop is the default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelf or by using the < left or right > arrows in the Top Shelf. You can access Task switcher, Illume Settings and more by tapping on the Top Shelve - the shelve will open up by sliding down.


Клавиатура

Keyboard comes up automagically when a text field is tapped or you can also toggle the keyboard by it's icon or 'alpha' in the Top Shelve. In the Keyboard, dictionary switcher is the arrow-up on left side, alternative keyboard layouts are under the ABC button on the right. The Default keyboard has English dictionary enabled. For Space quick slide left-to-right, for Enter, quick slide up-down, to quick change keyboard layout quick slide down-up. While typing with a dictionary enabled keyboard, possible word options start appearing in the keyboard's upper part or more word options are available under the arrow-up on the left. When happy with the word, tap it, it will be pasted into the text field with a space attached. The Keyboard and dictionary can easily be localized.

Копировать - Вставить

In E based applications (for example the phone suite (messages)) tap and hold down for over two seconds. Select-Paste menu will pop up. By pressing Select, you can now swipe through the text to select desirable part. Tap and hold down again, Copy-Cut-Cancel menu will appear to Copy to clipboard. Another long tap will provide Select-Paste for Paste.

In Gtk based application you can use keyboard for Ctrl-C (Copy) and Ctrl-V (Paste).

In the Vala Terminal you can select by keyboard swipe and for Paste there is a icon in the menu bar of this application.

Будильник

Приложение будильника (установленное по умолчанию) позволяет задать единоразовое или повторяющееся срабатывание будильника. Если вы задали время срабатывания будильника и выключили свой Openmoko Freerunner - в указанное время телефон включится и будильник сработает.

Телефонные приложения

Среди прочего, в SHR установлено 4 основных телефонных приложения: Dialer, Contacts, Messages и Phone log.

Dialer
Contacts
Messages
Phone log

Настройка приложений

Настройки SHR запускаются нажатием на иконку Settings рабочего стола. Настройки Illume доступны в ниспадающей верхней панели, необходимо нажать на иконку с логотипом SHR.

Верхняя панель с иконкой настройки Illume

Аппаратные кнопки

Кнопка включения питания

The PWR (Power) button is mapped to start Quick Settings screen (Illume System menu in older versions) on a short press.

Mapping of the PWR button be configured via the Illume Settings-> Input -> Key Bindings.

Pressing the Power button for longer then 8 seconds will force a complete power down of the device. This is hardconfigured in the kernel.

The Quick Settings screen provides several toggles: Airplane mode, Phone profiles, Power settings and Power buttons.

Дополнительная кнопка

The AUX (Auxiliary) button is mapped to toggle on/off the SHR Idle screen. Mapping of this button is configured in /etc/phonefsod.conf

idle_screen = aux,lock

You can configure the Idle Screen to come up even during active phone call by adding phone to the setting:

idle_screen = aux,lock, phone

The Idle Screen shows current date and time, missed calls and messaged and also what FSO resources are currently being requested - used.

Замена экрана простоя

If you with to use the previous simple LOCKED screen instead of the new standard Idle Screen

Edit /etc/phonefsod.conf to this:

# when to show idle screen
# ...
# idle_screen = aux,lock
idle_screen =

You need to restart phonefsod to make the change happen.

Also, change key mapping for the AUX button by setting Illume Settings -> Input -> Key Bindings, bind the key XF86Phone to Desktop Simple Lock

Первые шаги

Right after installation and first boot you might want to do a few initial steps like adjusting the call volume and some other tasks.

Звук - громкость звонка

During the first phone call please use the Volume and Mic sliders on the Active Call Screen and adjust them to fit your preferences. When you have found good settings, terminate the test call and reboot the phone. The new improved settings will then be used for all in- and outgoing calls thereafter.

Сетевое подключение

Establish network connection and SSH into your phone. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read USB Networking. For Wifi, you can use Network Manager

Инициализация базы данных opkg

Инициализация базы данных opkg необходима для установки приложений из репозиториев SHR или других источников, например, opkg.org. Когда будете в сети, выполните:

opkg update

Поиск в базе данных opkg может занимать длительное время. Это можно ускорить, если скопировать содержимое базы в в текстовый файл, а потом просто искать в нем с помощью grep. Это можно проделать единожды, либо после каждого обновления opkg:

opkg list > packages.txt

Теперь можно быстро искать по имени пакета, например navit:

grep navit packages.txt

SwapSpace

When the RAM is used up, applications get killed. This is particularly bad while doing opkg upgrade. Therefore you might want to create a swap space. Read SwapSpace article.

Настройки

Настройки SHR

SHR Settings

SHR Settings is the main setting application of SHR. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

Please refer to this section about a better way to manage preventing screen dim or suspend.

While some settings are persistent over reboots, others are not.

Главный экран

The main screen is divided into eight categories, which contain several modules. Every SHR Settings module has a specified task - for example controlling the GSM antenna power, setting the time etc.

Телефон

Here you can set if the GSM antenna is on and if your phone number is shown when you call someone.

GSM In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After a while, a list of operators should pop up.

You can't connect to operators marked [forbidden].

Selecting an operator from the list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

Call

Phone settings


List providers

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

Phoneutils

For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to set the right country code for your location. (for example 420 for Czech republic) for more info, please go to: http://wiki.openmoko.org/wiki/Phone_Prefixes

SIM

Here you can view some informations about your SIM card and clean phone and messagebooks.

Профили

Here you can select the current profile, which the device should use to determine ring tone etc.

Current profile

Here you can adjust properties of the currently used profile.

To change the ring tone, click the "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting a sid tune as the ring tone, there are available controls to select tune number from the file.

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

Profiles
Ringtones

Подключения

Connectivity top
Connectivity bottom

WiFi

With the "WiFi radio" toggle you can set, if the wifi module is powered. WiFi radio has to be turned on before trying to connect to a WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

GPRS

To enter APN, login and password fields, just click on the actual value (default: "internet"). Your phone provider can provide the required configuration options.

NOTE: You can also use Mokonnect to manage your GPRS connection


USB

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

Bluetooth

To power up Bluetooth module, switch the "Bluetooth radio" toggle to "On". After that, the "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

Питание

Battery

This module displays informations about battery state - charge, voltage, remaining time etc. To update the data, click the "Update" button.

Here you can also force enable 500mA charging.

Display

With this slider you can easily set the backlight brightness.

NOTE: This setting isn't permanent over sessions. At boot backlight is set back to 80%.


Power

Power
Timeouts

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

Timeouts

Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend.

NOTE: Configuration behavior has been changed due to FSO rewrite.


Old behavior (delete by Apr 1st):

Here (Timeouts screen of SHR Settings) you can set up values of idle timeouts used by the device. This setting changes parameters in /etc/frameworkd.conf :

[fsodevice.kernel_idle]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

New behavior:

Storing of this setting via D-bus calls is not supported in the new API of Vala rewrite of FSO2. SHR Settings doesn't have a setting for this. Configurable values are now stored in /etc/freesmartphone/conf/GTA02/fsodeviced.conf but you can keep your own config file in your home directory:

~/.fsodeviced.conf

Внешний вид

Theming

Neo theme

The Apperance section allows you to change between installed themes. To install more themes, see also Installing themes.

You can change finger size - this will mainly effect vertical spacing between widgets.

Switching between engines:

E can be switched to use different engines. The default engine is x11. Alternative engine x11-16 is not supported and results in buggy behavior of several applications, for example the phone suite or Ventura browser.

Changing Splash screen is also possible in this module. To install more splash screens, see also Installing splash themes.

GPS

GPS
GPS Satelite details

GPS

By default, GPS is turned on only when requested by an application. That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

GPS information

This page can be used to monitor GPS status. You either have to turn GPS on manually or start another application to enable the GPS.

You can also view information about every visible satellite and check, which are used for getting a fix. To do that, click "Satellite details".

Remove AGPS data If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo. Assisted GPS (aGPS) support GPS receiver to find position by non-satellite information.

Дата/время

Date & Time

Time

Here you can view and set the time. By default, the time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click the "OK" button.

Date

This module displays the current date.

Остальное

Others

PIM

Pim data are stored in opimd domains. Every opimd domain has different backends to store its data to. The domain reads data from every backend and writes data to the default backend. This elector allows you to choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

Services

The services selector is listing scripts from /etc/init.d/ directory.

After clicking on a servis, you can either start, restart or stop the service and view the result.

Services
Services debug screen


Userspace backups

Here you can either archive or restore your files and configurations.

Настройки illume

The Illume desktop can be easily customized - slide the top shelf down and tap the Settings icon (SHR Logo).

Illume settings (SHR Logo icon) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to view more options on the right hand side.

The little applets in the top shelf (for example Battery, GSM, Bluetooth etc.) are called shelf gadgets and you can configure whether they are visible (on the front part of the top shelf) or hidden (you can access them by sliding the top shelf) through Illume Settings -> Display -> Shelf gadget.

Some setting screens are not resized properly to fit the phone's display - for example the Wallpapper setting. This is a known bug already reported upstream.


Локализация

Ручная локализация SHR

Setting Language

Окружение рабочего стола

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in the Illume top shelf go to Settings (SHR Logo) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep eglibc-locale-

And install the language of your choice (for example czech):

opkg install eglibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable of your desktop.

Приложения

If you wish to have other applications localized, you need to install translation for each of them (presuming it is available):

This will install czech localization for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

Окружение терминала

Для локализации терминального окружения (ssh) установите переменные LANG и LC_ALL в файле /etc/profile, например для Русского языка:

export LANG=ru_RU
export LC_ALL=ru_RU

Клавиатура и словари Illume

The Illume keyboard offers English dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and the English one is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

Dutch terminal virtual keyboard

Furthermore you can install a different keyboard with a layout which fits your language or alternatives for the default keyboards like the numerical one. The localized Illume keyboards are available in the SHR repository under the name illume-keyboard-LANG.

Note that sometimes after an upgrade of Illume has taken place, these keyboards have to be installed again before they become available again. Removing these packages will restore the availability of the respective original keyboards.

German (and Austria) Language

See Configure_SHR_for_German-speaking_use for detailed customization for german speaking.

Дата и время

The local timezone is automatically retrieved from the GSM network.

create a symlink named /etc/localtime which points to the appropriate file in /usr/share/zoneinfo. For example, if you're in France., the following command will link the correct zoneinfo file to your /etc/localtime, giving you the correct time:

ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime

Afterwards, edit /etc/timezone if necessary [?]

Local timezone work instantly for the current boot when:

TZ="Europe/Paris"
export TZ

For a permanent timezone change edit /etc/profile and change to:

TZ="Europe/Paris"

Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

Is this better?:

hwclock --utc --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

Ресурсы FSO

FSO контролирует каждое устройство. Устройства называются ресурсами. Если программа желает использовать устройство, то можно обратиться к этому ресурсу через d-bus, FSO сделает это, или вы можете задействовать ресурс вручную. После того, как запрос ресурса будет выполнен, FSO отключит устройство. Ручной запрос ресурса может быть выполнен с помощью SHR Setting или команды fsoraw. (Применение fsoraw быстрее и лучше использования команд d-bus)

opkg install fsoraw

Пример использования fsoraw:

fsoraw -r Display mokomaze

Смотрите FSO Resources для большей информации по использованию следующих ресурсов:

Wifi

Пока этот ресурс задействован нет eth0 и wifi модуль полностью отключен. Используйте Mokonnect настройки сетей, он автоматически включит Wifi если необходимо.

Bluetooth

Необходимо обратиться к этому ресурсу, что бы задействовать модуль bluetooth.

GPS

Демон fso-gpsd ждет подключений от gsmd, автоматически включая и выключая устройство. Как только появляется подключение, он включает GSM. В SHR Settings можно полностью выключить GPS

SHR Settings -> GPS -> Manual > Off

GSM

Необходимо обратиться к этому ресурсу, что бы включить модуль GSM.

Display

Если обратиться к этому ресурсу, то суспенд будет выключенным, и включится экран.

CPU

Если обратиться к этому ресурсу, то суспенд будет выключен. Экран будет чистым.

Test

Тестовый ресурс.

UsbHost

При обращении к этому ресурсу USB переключится в режим хоста.

Accelerometer

Необходимо обратиться к этому ресурсу, что бы включить акселерометр.

Network manager

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

The connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. The Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable it after use.

Mokonnect
Mokonnect Wifi
Mokonnect Wifi Scan


Bluetooth

Bluetooth can be used for several different applications - file transfer (OBEX), networking, input devices (HIDD), music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better than for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if the bluetooth headset is not around, making it quite difficult to use.

In the SHR repositories are applications ready to be installed (by opkg) that already do provide bluetooth support. This means that they request the bluetooth resource automatically, can search bluetooth devices around, help you with pairing and can perhaps even reconnect bluetooth headset upon resume from suspend. From applications that have some bluetooth support some are for example Launcher (home screen launcher and phone suite), Podboy (podcast player), Elmtooth (bluetooth manager). In order to set up bluetooth for phone calls, some manual setup from bellow is still required.

Bluez3 - вручную без D-Bus

If you want to use the bluetooth device directly, you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On. You can also make the bluetooth device visible here.

Работы с файлами через OBEX

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) does not exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
	00:16:41:F5:A5:BC	laptop

Then send the file onto bluetooth address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

Подключение bluetooth клавиатуры

hidd --search
Editors note: This is the old bluez3 way, but it works. New bluez4 way will replace this.

Bluez4 - D-Bus based way

SHR uses bluez4 which is completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see Manually using Bluetooth for detailed information about using bluetooth and also for a list of supported devices.

Подключение

Emtooth менеджер bluetooth соединений. Позволяет задавать bluetooth имя устройства, подключение/отключать, настройки видимости устройства и др. Что бы установить Emtooth, выполните:

opkg install emtooth

Emtooth начнет поиск доступных устройств, двойное нажатие на строке с именем найденного устройства начнет процесс подключения.

GSM с bluetooth гарнитурой

Чтобы использовать bluetooth гарнитуру для совершения телефонных звонков, необходимо выполнить несколько простых действий.

1). Ваша bluetooth гарнитура должна быть сперва подключена.

2). Добавьте вашу bluetooth гарнитуру в настройки FSO.


NOTE: Все звонки будут идти через гарнитуру. После старта и каждого суспенда гарнитура должна быть переподключена.


Настройка FSO

Сейчас мы должны сказать frameworkd, что у нас есть гарнитура bluetooth. Параметры гарнитуры должны быть заданы в:

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Параметры bt-headset-enabled и bt-headset-address смотрите opreferences/schema/phone.yaml для понимания.

Теперь надо перезапустить FSO, что бы изменения вступили в силу.

# /etc/init.d/frameworkd restart

Пример чьего-то /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98
Переподключение гарнитуры

Возможно вам понадобиться вручную задействовать гарнитуру в самом начала и после суспенда:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

Где xx_xx_xx_xx_xx_xx адрес гарнитуры, например:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Сейчас гарнитура должна работать.

System Customizing

Установка тем splash screen

List available splash screen themes

opkg list | grep splash-theme

Install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Appearance -> Splash settings. Here you can preview installed themes and change the default one.

Установка тем

Every theme is made of several components (a theme for illume, theme for the phone applications, theme for etk and so on). There is a SHR metapackage for each theme that allows installing the complete theme in one go.

List available SHR theme metapackages:

opkg list | grep shr-theme

Install one of the available themes

opkg install shr-theme-gry

Then go to SHR Settings -> Appearance -> Elementary Settings. Here you can preview installed themes and choose the preferred one.

The Illume screen requires to change theme via Settings (SHR Logo) -> Look -> Theme. Here you can preview installed themes and choose the preferred one.

Включение курсора мыши

edit line 143 of /etc/X11/Xserver and erase -nocursor

ARGS="$ARGS"


Случайные ошибки

Нет иконок, не работает GSM и т.д. - скорее всего это из-за ошибок на µSD карте. Извлеките карту и исправьте проблему через картридер или загрузитесь из nand смонтируйте карту в режиме для чтения и запустите fsck:

fsck.ext2 /dev/mmcblk0p1

GSM modem 1024 suspend bug

The calypso GSM modem suffers a known 1024 hardware bug that causes unreliable GSM function. To work it around, SHR by default doesn't suspend the modem completely. If you have undertaken a fix for this bug you can extend your battery time by enabling the modem to fully suspend when possible.

Edit the following in /etc/frameworkd.conf file:

ti_calypso_deep_sleep = always

Then restart framework or reboot the phone.

Сообщения об ошибках

SHR находится в разработке. Если нашли ошибку, пожалуйста, сообщите о ней SHR. Приложите к своему сообщению логи из:

/var/log/

Что бы сообщить об ошибке, зайдите на http://shr-project.org/trac/report

Проверьте, известно ли уже об этой ошибке. Если нет, добавьте, будьте максимально точны в заголовке и описании, при каких условиях это произошло и т.д. Если уже есть упоминание об этой ошибке, посмотрите, возможно вы можете добавить более свежую информацию.

Дополнительная Информация

Посетите: