Skip to content
Bartlomiej Ceglik edited this page Mar 11, 2023 · 15 revisions

Welcome in oiyshTerminal - Logo

Important! Although oiyshTerminal was created for our boat it is not limited to boats alone. Every time the word boat is used feel free to substitute it with home, RV, car, dinghy or whatever else you choose to use it for. Most of the features currently included are boat specific but you are free to modify them to your needs or create your own. With that out of the way...

What is oiyshTerminal ?

Imagine your boat has an onboard computer that has access to all the information about the boat you wish it to have and displays it in the way you wish it too. For a lot of sailors it sounds futuristic and/or expensive, but this is exactly what oiyshTerminal was created for. The software part is free and open-source and the hardware can be created easily and cheaply* or also for free. The basic functionality requires only a smartphone. We provide the base puzzles that you can either use as is or modify to your liking.

OiyshTerminal is not a black box solution. Depending on which functionalities you choose to implement you might need to put some of the pieces of the puzzle together. This is done on purpose as we believe that everyone with minimal amount of effort, regardless of the level of technical knowledge they have, is able to do it. This approach ensures that you have at least basic knowledge of the system you are using. It will give you at minimum the ability to troubleshoot it if needed and perhaps also enough confidence to explore further and expand the system to your specific needs.

If you are not willing to put in the minimal effort this is probably not a project for you and we hope you can afford 'off the shelve solutions' and their installation fees.

ko-fi

Practical use cases

( again some of these are boat specific but the system can be used elsewhere as well )

Puzzles of oiyshTerminal

Software side

You can find detailed installation information on respective wiki pages

Communication channels and aggregations of data

There is no limits or restriction what communication channels you can use in this project. Supported and preferred protocols are mqtt / websocket. In the core of yss is Node-RED which simplify adding new channels of communication. If you use cMqtt2Mysql you will have data base as a dependency installed so aggregation of data is automatic from mqtt layer to database. If you will use yss you don't need to make any UI you can use yss-multisvg to make it with no codding if you want.

Hardware

Required:

Android phone is your base here (especially if there is no RasberryPi corner in the shop next to you ) Phones are all around us. Easy thing to buy in nearest shop if you don't have an old one laying in the drawer already. It has a screen, build in GPS and UPS, WiFi, no cables no connectors no corrosion. (minimum :P) For boat specific needs it should be one with magnetometer (compass)

Optional:

Depending on the functionalities you might need some jellybean parts e.g.

  • esp family development board (esp8266, esp32, wemos, nodeMCU etc)
  • relays
  • cables
  • servos
  • sensors
  • resistors
  • etc

Most of them are extremely cheap ( couple of $) or can be salvaged from things you already have. More details in particular use case descriptions.


Some examples and videos of use cases


Can help

Contact me or ko-fi

Wiki is a good place to start...

Clone this wiki locally