Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ipatch/kegcop
🍻 An iOS app monitoring kegerators using BLE (Bluetooth 4.0) communicating to a microcontroller.
https://github.com/ipatch/kegcop
bluno kegcop kegerator microcontroller objective-c
Last synced: about 1 month ago
JSON representation
🍻 An iOS app monitoring kegerators using BLE (Bluetooth 4.0) communicating to a microcontroller.
- Host: GitHub
- URL: https://github.com/ipatch/kegcop
- Owner: ipatch
- License: mit
- Created: 2012-06-11T07:01:04.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-08-10T03:05:03.000Z (over 1 year ago)
- Last Synced: 2024-04-14T23:59:42.372Z (8 months ago)
- Topics: bluno, kegcop, kegerator, microcontroller, objective-c
- Language: Objective-C
- Homepage: http://ipatch.github.io/KegCop/
- Size: 21.2 MB
- Stars: 10
- Watchers: 4
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- License: LICENSE.txt
Awesome Lists containing this project
README
# KegCop [](https://travis-ci.org/ipatch/KegCop)
[](http://www.youtube.com/watch?v=1a6hxUb3zfU)
## Objective
The purpose of this software is to create user accounts for a kegerator, and have a **_root_** account which receives donations from the users for the beer they drink. To find out more information about the project check out the [wiki](https://github.com/ipatch/KegCop/wiki)
## How does it work
An iOS device, i.e. iPhone / iPod Touch will connect to a Bluno via Bluetooth 4.0 Low Energy sending serial information to the microcontroller which will communicate with flow sensor(s) and a solenoid cut off valve. The iOS device will be the user interface for the entire operation, storing account information along with how many credits a particular user will have.
## Build
As of August 29, 2019, I'm building **KegCop.app** using Xcode Version 10.1 (10B61) for iOS 9.3.x deployed to a iPod Touch 5th generation model.
> The iPod Touch 5th Gen has the same screen size and specs as iPhone 5 and 5s, which is useful to know when building using **Simulator.app**.
## License and Copyright
All code is offered under the MIT license, unless otherwise noted. Please see LICENSE.txt for
the full license. All code and documentation are Copyright 2015 to present, Chris Jones unless otherwise noted.
## Contributing
I would love for someone to make a branch and start editing some code. My Objective-C skills leave a lot to be desired. So if you have a great idea, don't hesitate to download the code and contribute. There is a guide for contributing, [here](https://github.com/ipatch/KegCop/wiki/Contribute)
### Contributing > Maintenance
To fix vulnerable **pods** or various pages GitHub find vulnerable
```shell
pod outdated
echo "update outdated pods"
pod install [OUTDATED_POD]
```
### Contributing > Troubleshooting
Reverting from nuclear 🤯 git changes
#### Workaround > git
god forbid‚™️ I `merge` then `push` a branch into master that I did not mean to, perform the below steps
```shell
git reset --hard [tag/branch/commit id]
echo "reset local working branch, ie. [master] to one of the specified fields"
git push [remote(s)] -f
echo "[remote] can be `origin` or `upstream`"
echo "NOTE: the above two step should revert a brach local and remote from nuclear changes"
```
### Contributing > [Website](http://ipatch.github.io/KegCop/)
```shell
http://ipatch.github.io/KegCop/
```
There is a git branch **gh-pages-src** that contains a node project to build a website using github pages for the aboe listed URL, that branch src does not correlate to the main objc src for the actual iOS app, but only serves a purpose to be the directory / src for the accompanying website.
## Installation
- Clone this repo, then build for your device using Xcode.
- Load the following sketch on your Bluno, from [here](https://github.com/ipatch/KegCop/blob/master/KegCop-Bluno-sketch.c)
cheers 🍻
[@ipatch](https://github.com/ipatch)
[@truckmonth](https://twitter.com/truckmonth)