Dmitry Shalnoff's Git Repository - ETG_Helmet/blob - README.md

   1 # ETG Helmet, Electronic Tour Guide Bike/Segway Headset
   2
   3 This is an experimental version of the Electronic Guide, designed specifically for use with tour groups during bicycle or segway rides.
   4
   5 The device operates by analyzing the user's location, direction, and speed of travel. It automatically compiles a narrative that adjusts in real-time as the style of the ride changes. This ensures that the narrative remains engaging and relevant to the listener's experience.
   6
   7 Moreover, the device facilitates communication between the ride leader and all group members. By creating the network, the devices enable an exchange of audo messages and communication.
   8
   9 The unique algorithm creates a non-linear narrative. By maintaining a common thread that ties all the stories together and ensures that the group remains engaged throughout the journey."
  10
  11 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/IMG_2030.jpeg)
  12
  13 ## Enclosure
  14
  15 The device's enclosure is fully designed using OpenSCAD. This approach allows for the easy modification of basic dimensions and the placement of elements, making it adaptable to meet the requirements of various projects.
  16
  17 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/helmet__tor_bigger_moreheight__.png)
  18 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/helmet__tor_bigger_moreheight__1.png)
  19 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/helmet__tor_bigger_moreheight__2.png)
  20 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/helmet__tor_bigger_moreheight__3.png)
  21 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/helmet__tor_bigger_moreheight__4.png)
  22 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/helmet__tor_bigger_moreheight__5.png)
  23
  24 ## Hardware
  25
  26 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/IMG_2563.jpg)
  27 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/IMG_2564.jpg)
  28
  29 ## Installation
  30
  31 Note: All of the following must be done on the Omega2+ module unless otherwise noted. Flashing and setting up SSH access to the device is out of scope of this description. Please refer to the ![original documentation](https://docs.onion.io/omega2-docs/omega2p.html) if necessary.
  32
  33 ssh to Omega and install necessary utils
  34
  35         opkg update
  36         opkg install mc
  37
  38         mcedit /etc/opkg/distfeeds.conf
  39
  40                 # unremark
  41                         src/gz reboot_base http://downloads.lede-project.org/snapshots/packages/mipsel_24kc/base
  42                         src/gz reboot_packages http://downloads.lede-project.org/snapshots/packages/mipsel_24kc/packages
  43                 opkg update
  44                 opkg install usbutils screen alsa-lib libsndfile alsa-utils madplay openssh-sftp-server libxml2 e2fsprogs socat netcat sox espeak lftp
  45
  46 copy files from SOFTWARE/OMEGA2 in /root/ on Omega
  47
  48 add 'etg' service in init.d
  49
  50         #!/bin/sh /etc/rc.common
  51
  52         START=99
  53
  54         start() {
  55                 mkdir /tmp/ETGPID/
  56                 cd /root/
  57                 ./run.sh 2>&1 > /dev/null
  58                 echo $! > /tmp/ETGPID/run
  59         }
  60
  61         stop() {
  62                 for pid in $(ls /tmp/ETGPID/)
  63                 do
  64                         kill $(cat /tmp/ETGPID/$pid)
  65                         echo "killed $pid"
  66                 done
  67         }
  68
  69 disable default console (probably not required) ([community topic](https://community.onion.io/topic/1112/resolved-disable-the-serial-console-that-s-messing-up-my-serial-comms/3))
  70
  71         /etc/inittab
  72                 # ::askconsole:/bin/ash --login
  73
  74                 maybe in new version
  75                         # ::askconsole:/usr/libexec/login.sh
  76
  77 activate it
  78
  79         /etc/init.d/etg enable
  80
  81 set your client-server settings in settings.sh
  82
  83         mcedit settings.sh
  84         or
  85         vi settings.sh
  86
  87 add your playback logic in player.sh
  88
  89         playFile <your_current_file.mp3>
  90
  91 reboot and enjoy :)
  92
  93 ## Troubleshooting
  94
  95 check buttons
  96
  97         ./fast-gpio bgread 0xf800d echo
  98
  99 test GPS on device
 100
 101         cat /dev/ttyS1
 102
 103 kill etg service
 104
 105         /etc/init.d/etg stop
 106
 107 stop it alternatively
 108
 109         for pid in $(ls /tmp/ETGPID/); do kill $(cat /tmp/ETGPID/$pid); echo "killed $pid"; done
 110
 111 100% CPU usage isuue, disable wifimanager ([community topic](http://community.onion.io/topic/1902/wifimanager-over-90-cpu-usage-omega2p))
 112
 113         /etc/init.d/wifimanager stop; /etc/init.d/wifimanager disable; killall wifimanager; rm /etc/rc.d/S79wifimanager
 114
 115 ## To do
 116
 117         - Optimise sound recording, connect USB SND via DC-DC decoupler, remove filtering
 118         - Upgrade HW to LiFePO battery, remove USB boost converter
 119
 120 ## Assembled devices and testing
 121
 122 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/IMG_2288.jpg)
 123 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/IMG_2292.jpg)
 124 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/IMG_2302.jpg)
 125 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/IMG_2289.jpg)
 126
 127 ![ETG Helmet](https://shalnoff.com/pics/2024/ETG_Helmet/IMG_6063.jpg)
 128
 129 ## License
 130
 131 Copyright © 2019 Dmitry Shalnov [electronictourguide.com] [interplaymedium.org]
 132
 133 Licensed under the Apache License, Version 2.0 (the "License");
 134 you may not use this files except in compliance with the License.
 135 You may obtain a copy of the License at
 136
 137     http://www.apache.org/licenses/LICENSE-2.0
 138
 139 Unless required by applicable law or agreed to in writing, software
 140 distributed under the License is distributed on an "AS IS" BASIS,
 141 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 142 See the License for the specific language governing permissions and
 143 limitations under the License.
 144
 145
 146
 147