Party Robotics Bartendro B107V1 User manual
BartendroTM
www.partyrobocs.com
Getting Started Guide
Model Nos.
B107V1
B115V1
B7 / B15 Kits
Please Read Before Operang
EDITION
v 1.1
Important Precauons
• Notintendedformedicaluse.
• Electronicsmaybesensevetostacdissipaon.Observeproper
precauonsforhandling.
• Donot“hot-swap”Dispenserswhilesystemispowered.
• PlugnetworkingdevicesintoRaspberryPionly.PluggingthemintoRJ45
connectorsontheRouterBoardwillcausedamage.
• Itisnotrecommendedtokeepcleartubingimmersedinliquidforex-
tendedperiodsofme.
• Beigetube(insidetheDispensers)lifeisapproximatedtobe500hours
ofuse.
• Ifstoringlongtermwithoutuse,removebeigetubingfromdispensersto
extendtubelife.
• Dispensersmayneedtobeperiodicallyre-calibratedastubingwears.
• Pleasedrinkanduseresponsibly.
Specicaons
MaxFlowrate:700mL/min
MotorOperangVoltage:24V
MinimumDispenseVolume:2mL
Repeatability:±1mL
DispenserCurrentConsumponat24V:350mATypical,500mAmax
SystemCurrentConsumponat24V:0.5AIdle,3AAlldispenserson(B7)
0.5AIdle,6AAlldispenserson(B15)
MaxCableLengthtoRouterBoard:10
BartendroTM
www.partyrobocs.com2
Congratulaons!
Youareoneoftherstownersofanewenablingpieceoftech-
nology.TheseprecisionBartendroTMDispensersandelectronics
arethesameaswhatgointoBartendroTMcocktailbots.Theappli-
caonsdon’tstopatcocktailsthough,peoplehavebeencoming
upwithlotsofideasfromsno-conestohydroponics.Whatwill
youcomeupwith?Shareyourprojectsat:
www.partyrobocs.com/community/sharing
B7 / B15 Kits
www.partyrobocs.com
BartendroTM
3
What’s Included:
B7 B15 Part No. Item
715A007V1BartendroTMDispenserWithLiquidSensor
(includestwocompressionnuts)
11M101V1AChopsck(tubingreplacementtool)
11A017V1BartendroTMRouterBoard(withhardware)
11E004V1RaspberryPi(RPI)
11E007V1SDCard
11E005V1USBWiFiDongle
11E009V124V,200WPowerSupplywithPowerCord
11A014V1PowerAdapterCable
11TXXXV1FoodGradeTubing(about5perdispenser)
48M102V1StandardBoleTopper
25M103V1LargeBoleTopper
12M104V1ExtraLargeBoleTopper
715M105V1BoleTopperCap
715M033V1TubingKeeper
715A009V1LiquidSensorAdapter
B7 / B15 Kits
Quick Start Instrucons
You will need:
AC Outlet
Device with Web Browser (phone, tablet, laptop, etc)
Wired Networking Router (for soware updates)
Computer (for soware updates)
Hardware Setup:
1. Make sure the Raspberry Pi is securely connected to the Router
Board and is supported with standos. Take care not to damage the
header if removing the board. (gentle rocking works best)
2. Aach the provided SD Card and USB WiFi dongle to the RPI.
3. Connect Dispensers to the Router Board using the provided ether-
net cables. Note that ethernet cables are only used for convenience
and commonality, the ethernet protocol is not used. Do not plug
ethernet devices into any ethernet port other than the one on RPI.
4. Port numbers on the Router Board should be noted when plugging
into a new Dispenser. The numbers can oponally be wrien down in
the white box on the back of each dispenser.
5. First, connect the Power Adapter Cable, Router Board and Power
Supply to each other. Then, plug the power supply into the AC outlet.
This will power the system on and reduce potenal sparking.
6. Once the Dispenser’s LEDs begin to fade in and out (about 1 min-
ute), the system is ready for use. If they don’t get to this state, see the
Troubleshoong secon on page 8.
7. Mount the dispensers appropriatly. See dimensions on page 7.
8. Aach clear tubing to the dispensers using the provided compres-
sion nuts. Make sure to budget about 5 per pump. Cut an angle into
the boom of the Dispenser’s input tubing to prevent it from aach-
ing to the boom of the boles. See video at partyrobocs.com/docs.
9. Clear tubing cannot be aached directly to liquid sensors, so use
Liquid Sensor Adapters in between making sure to use the port that
is farthest from the board. Use the black Tubing Keepers to keep both
the Dispenser input tubing and liquid sensor tubing neatly together.
www.partyrobocs.com4
BartendroTM B7 / B15 Kits
www.partyrobocs.com 5
BartendroTM B7 / B15 Kits
Geng Started with the User Interface
Connect to your bot:
1. Using a WiFi enabled device, nd the “bartendro” WiFi network by
looking for it in your sengs and connect to it.
2. Once connected (up to ~30 sec the rst me) you will need to go to
a web browser, such as Chrome, and type in any web addess. You will
automacally be redirected to the Bartendro user interface (UI).
3. The main menu may or may not have drinks populated. To tell the
bot which ingredients are present, you will need to log into the admin
screen. You may do this by either searching for the hidden link at the
boom le corner of the main menu, or typing bartendro/admin in
the address bar of your browser.
When prompted use the default:
Name: bartendro
Password: boozemeup
Note: Your login name and password can be modied by changing a le on
the Raspberry Pi. Instrucons on page 7.
Once connected to Bartendro you will have access to the following:
Admin
Admin - Dispensers: Controls ingredient selecon for each dispenser
from a drop down menu. Ingredients come from the “booze” tab.
Choose wisely, your drink opons depend on it! Note that taking
manual control comes with responsibility. The “clean” buon will
indescriminitely dispense all of your booze if pressed by accident and
you will be a sad panda. Each dispenser can indivudially be toggled on
and o by using the “turn on”/”turn o” buons and small incre-
ments can be dispensed using the “dispense 10mL” buon (helpful
when priming). The “liquid levels” buon forces a check of liquid
levels, but this only works if the feature is enabled. See page 7.
Admin - Drinks: Displays the drink list and allows you to make your
own custom recipes. Select “add booze” and pick from the list of
ingredients. The minimum number of parts is 1 and parts should be
whole numbers, or will otherwise be rounded. All elds are required.
Make sure to press save for your drink to be stored.
www.partyrobocs.com6
BartendroTM B7 / B15 Kits
Admin - Booze: Displays the ingredient opons and allows you to add
your own custom ingredients. Adding the type, whether alcohol or
sweetness / tartness will allow for customizaons in the drink menu.
Admin - Opons: Useful mostly for soware updates - your modied
database le can be saved to your local machine, so when a new
image is used, your database with saved drinks can be restored.
Admin - Liquid Out: Liquid sensing is disabled by default. To turn
this feature on, follow the steps on page 7. Once enabled, each
dispenser’s threshold for “out” and “low” can be set manually as
desired. Simply, insert liquid sensor tube into a bole or glass of wa-
ter with the desired level and set the corresponding threshold.
Main Menu
Menu: This is where your drinks are available for selecon. The list
automacally updates depending on what is loaded in the dispensers
screen. Note that the menu may appear dierently depending on the
number of dispensers detected.
Menu - Drink Customizaon: Aer you select your drink from the
menu a second screen will display allowing you to customize your
drink. You will have the opon to modify size, and depending on the
ingredients, strength and sweetness / tartness.
Cleaning and Maintenance
All tubing should be cleaned regularly.
1. Empty what remains in the tubes by turning on the dispensers. You
may use the “turn on,” “dispense 10mL” or “clean” buon to do this.
2. Fill a pitcher with hot soapy water and place the input tubes in it
aer they’ve been drained. Place a separate container underneath
the spout to collect the soapy water. Press the “clean” buon on the
admin > dispensers screen and this will cycle through each dispenser.
3. Repeat step 2 but with clean water in the pitcher. Sanizing solu-
ons may also be used.
4. Finally, run the clean cycle again with no liquids. This will empty the
tubes and prepare the bot for for its next use.
The inner beige dispenser tubing should be replaced aer 500 hours
of use and removed if storing for prolonged periods of me.
www.partyrobocs.com 7
BartendroTM B7 / B15 Kits
Geng under the hood:
There are several sengs that aren’t exposed through the UI yet but
can be changed by modifying the cong.py le on the Raspberry Pi.
Things like: use of liquid level sensors, display units, default size, taster
buons, the requirement to be logged in to dispense, etc.
To modify these sengs:
1. Plug an ethernet cable from the RPI into a wired networking router.
We’ve dissabled the ability to do this wirelessly for security reasons.
2. Use a terminal window on a Mac or Linux box, or use a program like
puy.exe in Windows to SSH into the bot. You may want to log into
your networking router to discover the RPI’s IP address.
Once connected,
login as: bartendro
password: hackme!
You can use vi to edit:
bartendro@bartendro~$vibartendro/ui/cong.py
Save the le and power cycle for changes to take eect.v
See partyrobocs.com/docs for more detail.
Dispenser Mounng Interface
1.28
1.28
2.560
2.560
R1.50
1.57
.43
.50
Panel thickness should be 3/32” or less.
Use 4-40 or M3 screws.
All dimensions in inches.
www.partyrobocs.com8
BartendroTM B7 / B15 Kits
Troubleshoong
Dispenser LEDs are blue / green / blank aer power up
This is normal, LEDs will remain in this mode unl proper
communicaon with dispensers is established (about 1 min).
If not geng there, make sure SD card is properly seated.
Dispenser LEDs are ashing red
A current limit has been triggered on a dispenser, press the
“reset” buon in the admin > dispensers page to restore
proper operaon. Check tubes for blockage.
Air bubbles in tubes, or dripping
This is a sealing issue. Make sure tubing properly protrudes
from the grey compression nuts by about 1/4”. The chopsck
tool is handy for this. Make sure the compression nuts are
ghtened so that only one or two threads are visible.
Drinks not showing up in Main Menu
Check to make sure an ingredient is selected and saved for
each dispenser and that there is a drink that uses those
ingredients. If liquid level sensors are enabled and liquid
level tubes are inserted in lile or no liquid, the menu will be
blank.
Sll Having Issues?
Try searching the forums at partyrobocs.com/forums. Post
your quesons so that others may learn from your issues. If
stuck, email us at: support@partyrobocs.com
More documentaon at:
www.partyrobocs.com/docs
Warranty
We’re here for you! If you have made modicaons to your
hardware or soware and are having technical issues, we will
be glad to aempt to resolve them with you. If an item was
damaged in shipping, or is otherwise defecve or malfunc-
oning, please email us right away and we will do our best to
make things right on a case-by-case basis.
This manual suits for next models
1
Table of contents
Other Party Robotics Dispenser manuals
