How to configure Single Interface and Multiple Interface in Adopisoft Pisowifi System

 Single interface setup

Multiple interface Setup.
It could be multiple VLAN, multiple USB TO LAN. or multiple LAN port kung maraming builtin-in ethernet port ang ubuntu PC/Mini PC mo and last is combination of VLAN and USB TO LAN.

1. Multiple USB TO LAN

                                         This connection uses 2 USB TO LAN. The eth1 is configured as 10.0.0.1 and the other is 20.0.0.1

Here is the admin configuration:

Go to network then interface then eth1                          Go to network then eth2

    check enable captive portal                                           check enable captive portal 

    set maximum hops allowed to 1                                    set maximum hops allowed to 1

    uncheck dynamic ip address                                         uncheck dynamic ip address

    set static to 10.0.0.1                                                      set static to 20.0.0.1

    set network segment to 20                                            set network segment to 20

    check Use System DNS Server                                    check Use System DNS Server

    Check Enable DHCP Server on this Interface              Check Enable DHCP Server on this Interface

    DHCP Pool Start 10.0.0.10                                           DHCP Pool Start 20.0.0.10

    DHCP Pool End:10.0.15.254                                        DHCP Pool End:20.0.15.254

2. Multiple VLAN only

Here is admin configuration:

Go to Network then VLAN Setup                                        Go to Network then VLAN Setup
    then eth0.22:                                                                             then eth0.23          

    Click create VLAN                                                                      Click create VLAN

    Check Enable Captive Portal                                                     Check Enable Captive Portal

    Set Maximum Hops Allowed to 1                                               Set Maximum Hops Allowed to 1

    Set Parent interface to eth0                                                       Set Parent interface to eth0

    Set VLAN ID/Tag to 22                                                               Set VLAN ID/Tag to 23

    Uncheck Dynamic IP Address                                                    Uncheck Dynamic IP Address  

    Set Static IP Address to 22.0.0.1                                               Set Static IP Address to 23.0.0.1

    Set Network Prefix to 20                                                            Set Network Prefix to 20

    Check Use System DNS Server                                                Check Use System DNS Server

    Check Enable DHCP Server on this Interface                           Check Enable DHCP Server on this Interface

    Set DHCP Pool Start 22.0.0.10                                                 Set DHCP Pool Start 23.0.0.10

    Set DHCP Pool End to 22.0.15.254                                          Set DHCP Pool End to 23.0.15.254

    Click create VLAN                                                                     Click create VLAN

Go to Network then VLAN Setup                                        Go to Network then VLAN Setup
    then eth0.24:                                                                             then eth0.25          

    Click create VLAN                                                                      Click create VLAN

    Check Enable Captive Portal                                                     Check Enable Captive Portal

    Set Maximum Hops Allowed to 1                                               Set Maximum Hops Allowed to 1

    Set Parent interface to eth0                                                       Set Parent interface to eth0

    Set VLAN ID/Tag to 24                                                               Set VLAN ID/Tag to 25

    Uncheck Dynamic IP Address                                                    Uncheck Dynamic IP Address  

    Set Static IP Address to 24.0.0.1                                               Set Static IP Address to 25.0.0.1

    Set Network Prefix to 20                                                            Set Network Prefix to 20

    Check Use System DNS Server                                                Check Use System DNS Server

    Check Enable DHCP Server on this Interface                           Check Enable DHCP Server on this Interface

    Set DHCP Pool Start 24.0.0.10                                                 Set DHCP Pool Start 25.0.0.10

    Set DHCP Pool End to 24.0.15.254                                          Set DHCP Pool End to 25.0.15.254

    Click create VLAN                                                                     Click create VLAN

3. Combination of VLAN and USB TO LAN

4. VLAN directly to AP - No VLAN capable switch/managed switch or no VLAN capable Router

You can still use VLAN if you dont have a VLAN capable router or a VLAN capable switch but have a VLAN capable AP such as TL-EAP110 and TL-EAP225. Remember VLAN on AP's portal must be enabled.

You can also use switch when using VLAN capable AP. But all AP must have VLAN capable or else connecting Access Point(AP) via AP mode on switch will give then free internet because they will be connected directly to ISP.

Bridges (br0,br1,br2...)
Combining2 or more interface into single network and shares single IP subnet.The purpose is to have same portal IP throughout different interfaces. Their individual IP is discarded and uses the subnet of the bridge interface.This may also be used when grouping different network into single network found on the same location base on their purpose and use.
Below is sample of a bridge network where vlan22(eth0.22) and wlan0(Builtin wifi) are bridge together via 10.0.0.1/20 network.

Common misconception:
Wag ka nang mag create ng bridge kung isa lang naman ang member ng bridge.Additional process lang po yan sa system. Mag bridge ka lang kung ang purpose mo is pagsamahin ang 2 or more interface na member sa bridge para iisang IP lang sila. Example sa madalas na bini bridge ay ang builtin wifi na  i-bridge mo sa isa sa mga existing vlan mo para iisang IP network segment/portal sila.

How to Upgrade from Lite to Business without reflashing?

 1. Revoke your LITE license. This is required.Login to your vendor machines admin portal 10.0.0.1/admin then under Device Information, revoke your Lite license.

2. Install Business version via debian file.
Here are the link for different types of Board.

Please update your system by going to System then Devices then paste this link into remote debian file provided box.Dont download .Just copy and paste the link.

For 5.1.3 and above,go to System then Software Updates

For Ubuntu PC

https://github.com/AdoPiSoft/Releases/releases/download/v5.1.5/adopisoft-5.1.5-amd64-node-v16.4.0.deb

For OPI/RPI(armhf) Business:

https://github.com/AdoPiSoft/Releases/releases/download/v5.1.5/adopisoft-5.1.5-armhf-node-v16.4.0.deb

For OPI/RPI Lite(armhf lite)

https://github.com/AdoPiSoft/Releases/releases/download/v5.1.5/adopisoft-5.1.5-lite-armhf-node-v16.4.0.deb

For arm64 board(Nanopi R2S) Business

https://github.com/AdoPiSoft/Releases/releases/download/v5.1.5/adopisoft-5.1.5-arm64-node-v16.4.0.deb

For arm64 board INanopi R2s) LITE

https://github.com/AdoPiSoft/Releases/releases/download/v5.1.5/adopisoft-5.1.5-lite-arm64-node-v16.4.0.deb

3. Hard restart the machine.After restart , activate the new business license.
There are 2 kinds of Business license:

AdoPiSoft Business (Lifetime) - Php 3,150

Unlimited users

Unlimited Sub Vendos

Full Features

AdoPiSoft Business 1 Year Subscription - Php 499

Unlimited users

Unlimited Sub Vendos

Full Features

To avail, go to here: https://www.adopisoft.com/activation

Using Termius to connect to your device via SSH

 1. Install termius via playstore apps
2.connect to your vendo machine. vendo machine Portal 10.0.0.1 should be accessible.Make sure ssh is enabled on your vendo machine. Go back to guide.
3 Open termius apps

4. Click the + sign to add device

5. Follow this:
alias:type RPI4, OPI one,OPI PC or kung anong board ang gamit mo
hostname or IP address: 10.0.0.1
port:22
check ssh
username: check the guide
password: check the guide
then press CHECK on top right side

6. A device is generated , click that device to open it. 
7. On terminal type your command example sudo nano /etc/resolv.conf
8. When editing file such as resolv.conf, used the 3 dotted line on top right of the phones keyboard to access the arrow left, arrow right, arrrow up ang arrow down. The CTRL key is also beside the 3 dotted line.
To edit, position your cursor at the end of the line using arrow key then press backspace
To save just press CTRL then press O then ENTER
To exit file and return to terminal press  CTRL then press X

Safeguarding Your Adopisoft Account: Essential Security Tips

 Here at AdoPiSoft, we take the security of your accounts very seriously. To ensure the continued safe operation of your vending machines and manager accounts, we kindly ask you to follow these important security practices:

1. Unique Passwords:

Never use the same password for your Adopisoft manager account, vending machine credentials, and email address. This creates a single point of failure; if one password is compromised, both accounts are at risk.

Create strong, unique passwords for both accounts. A strong password should be at least 12 characters long and include a combination of uppercase and lowercase letters, numbers, and symbols.

These are the 3 accounts for managing adopisoft:

I. The adopisoft manager account, accessible through http://manager.adopisoft.com, acts as the central hub for managing your wifi vendo business. Here, you can create and manage user accounts, monitor sales reports, and manage machines and licenses,sub-vendo credit, and ECASH payments.

II. For individual machine control, you can access each vendo machine's local web interface through a web browser at http://10.0.0.1/admin on your local network. This interface allows you to view real-time machine status, adjust local settings, and potentially troubleshoot any connectivity issues.

III. Finally, a separate email account, accessed through your preferred email provider's webmail interface or email client, is crucial for receiving important notifications from AdoPiSoft. This could include system updates, account verification messages, license activation, revoke and license transfer, or even critical alerts about your vendo machines. Remember, the specific server details for accessing your email will depend on the email provider you use (e.g., Gmail- https://mail.google.com/mail/, Yahoo Mail - https://mail.yahoo.com/, etc.).

By effectively utilizing these three accounts, you can maintain control over your wifi vendo business, ensuring smooth operation and maximizing your profits.

2. Secure Login Practices:

Always log out of your AdoPiSoft manager account after each session or use incognito mode(CTRL+SHIFT+N in Chrome). This is especially important if you are using a public computer or a shared device.

Do not share your login credentials with anyone. This includes employees, colleagues, or anyone else.

Enable two-factor authentication (2FA) for your email account. This adds an extra layer of security by requiring a second verification code in addition to your password when logging in.

3. Public and Shared Devices:

Avoid logging in to your AdoPiSoft manager account on public computers or shared devices. If absolutely necessary, ensure you log out completely and clear your browsing history before leaving the device.

By following these simple security practices, you can help to protect your AdoPiSoft accounts and vending machines from unauthorized access.

Additional Tips:

Be cautious about clicking on suspicious links or downloading attachments from unknown senders. Phishing scams can attempt to steal your login credentials.

If you believe your password has been compromised, change it immediately for both your Adopisoft manager account and your email address.

Securing your account is a collaborative effort between you and Adopisoft. We are committed to providing a secure platform, but your active participation is crucial in safeguarding your information. By following these security best practices, you not only protect your data but also contribute to the overall security of the Adopisoft community.

Together, we can create a stronger and more secure environment for everyone.

By following these simple security practices, you can significantly reduce the risk of unauthorized access to your Adopisoft account and protect your valuable data.

If you have any questions or require further assistance with securing your accounts, please don't hesitate to contact Adopisoft support.

Thank you for your cooperation in maintaining a secure environment for everyone using Adopisoft.

Adopisoft Subvendo Credits

 Kung walang subvendo credit, lahat ng coinslot sa lahat ng interface ay makikita during insert coins, Kung may naka assign na subvendo credit naman kung ilang subvendo na may subvendo credit ang nasa isang interface, yun din lang ang makikita during insert coin, kung isa lang  automatic auto select coinslot.Yung walang credit sa specific interface na iyon ay di mo makikita at di mo na magagamit ang subvendo dahil hinaluan mo na ng may credit.

What is subvendo credit?
ang subvendo credit ay para sa mga existing coinslot na gustong maging auto select coinslot ang mga subvendo.

ang auto select coinslot ay magwowork lang kung naka separate interface ang bawat subvendo

ang subvendo ay free at magagamit mo yan kaagad kung tama ang setup and configration.

ang subvendo credit ay hindi license

ang auto select coinslot ay magwowork lang kung naka separate interface ang bawat subvendo at merong subvendo credit ang bawat subvendo sa bawat interface.

Advanced Sub Vendo Capabilities:

1. auto select coin slot if one coin slot is assigned in every interface

2. capability to have different rates in every sub vendo

3. Sub vendo credit is P399 for additional sub vendo with separate rates from the free basic version. You need to separate the sub vendo interface before you activate the advanced sub vendo on that separate interface or else you might need to buy sub vendo credits to all of your available coinslot whether its main or sub.

If your having 2 or more coinslot using the 10.0.0.1 interface, you need to buy credits to all of your availalbe coinslot or else you cannot use the rest of the coinslot whether its main os sub in that interface without assigning sub vendo credit to it

Please separate the interface and assign sub vendo credit to that interface so that your main interface is still free to use without needing a sub vendo credits

Example of Using subvendo credit:

Ex vlan22 10.0.0.1

       Subvendo Coinslot A

       Subvendo Coinslot B

     usb to lan 20.0.0.1

       subvendo coinslot C

     usb to LAN 30.0.0.1

        subvendo coinslot D

     vlan23 40.0.0.1

        subvendo coinslot E

        subvendo coinslot F

Scenario1: wala kang sub vendo credit.During insert coin lahat ng coinslot lalabas from A to F

Scenario2: may sub vendo credit ka at naka activated sa C

           Kapag sa ABDEF ka naka connect , lalabas lahat ng coinslot ABDEF except C.

           Kapag sa C ka naka connect C lang ang lalabas.

Scenario3: may sub vendo credit ka at sa coinslot E lang naka activate

           Kapag sa ABCD ka naka connect, lalabas ang coinslot ABCD.

           Kapag sa E ka naka connect, E lang ang lalabas. Yung F ay madidisable at hindi mo magagamit hanggat hindi mo linalagyan ng sub vendo credit

scenario 4 : Kapag may sub vendo credit ka at naka activate sa E at sa F, kapag kokonek sa sa ABCD, ABCD lang ang lalabas. Kapag sa E at F ka kokonek, E at F lang ang lalabas.

https://www.youtube.com/watch?v=ujP1PEORMRo&t=23s

https://www.youtube.com/watch?v=vdTa-Mr8glE&pp=ygURYWR2YW5jZWQgc3VidmVuZG8%3D

Sample of your Subvendo list na naka install sa ibat ibang interface at pwedeng bilhan ng subvendo credit para maging auto select:

Sample Pre-requisite Network Topology to use Auto Select coinslot feature:

Auto Select Coinslot Network Topology (Enlarge It)

Configuring Network Setup of Adopisoft

 Here are possible scenarios that you can configure assuming 1 USB to LAN, 1 VLAN ID 22
1.separate network:
   USB To LAN-10.0.0.1 assuming your USB to LAN is eth1
   VLAN ID 22- 20.0.0.1
   if USB TO LAN is the main interface
or

USB to LAN - 20.0.0.1 assuming your USB to LAN is eth1
VLAN ID 22- 10.0.0.1
if VLAN ID 22 is the main interface

2.Combined network using bridge-Network bridging is a process of connecting multiple communication networks or network segments into a single, unified network.It's achieved using a network bridge, a hardware device that filters and forwards data packets based on their Media Access Control (MAC) addresses.In short 2 or more multiple network will use and joined into single network/IP.Their individual IP will be discarded.

VLAN ID 22-22.0.0.1
USB to LAN- 20.0.0.1
Bridge(br0)-10.0.0.1  is the main interface resulting from combining USB to LAN and VLAN ID 22







Let's configure the separate network where USB to LAN is the main interface:

Go to network then interface then eth1

    check enable captive portal

    set maximum hops allowed to 1

    uncheck dynamic ip address

    set static to 10.0.0.1

    set network segment to 20

    check Use System DNS Server

    Check Enable DHCP Server on this Interface

    DHCP Pool Start 10.0.0.10

    DHCP Pool End:10.0.15.254

Go to Network then VLAN Setup:

    Click create VLAN

    Check Enable Captive Portal

    Set Maximum Hops Allowed to 1

    Set Parent interface to eth0

    Set VLAN ID/Tag to 22

    Uncheck Dynamic IP Address

    Set Static IP Address to 20.0.0.1

    Set Network Prefix to 20

    Check Use System DNS Server

    Check Enable DHCP Server on this Interface

    Set DHCP Pool Start 20.0.0.10

    Set DHCP Pool End to 20.0.15.254

    Click create VLAN then hard restart the machine

Lets configure the separate network where VLAN ID 22 is the main interface:

Go to network then interface then eth1

    check enable captive portal

    set maximum hops allowed to 1

    uncheck dynamic ip address

    set static to 20.0.0.1

    set network segment to 20

    check Use System DNS Server

    Check Enable DHCP Server on this Interface

    DHCP Pool Start 20.0.0.10

    DHCP Pool End:20.0.15.254

Go to Network then VLAN Setup:

    Click create VLAN

    Check Enable Captive Portal

    Set Maximum Hops Allowed to 1

    Set Parent interface to eth0

    Set VLAN ID/Tag to 22

    Uncheck Dynamic IP Address

    Set Static IP Address to 10.0.0.1

    Set Network Prefix to 20

    Check Use System DNS Server

    Check Enable DHCP Server on this Interface

    Set DHCP Pool Start 10.0.0.10

    Set DHCP Pool End to 10.0.15.254

    Click create VLAN then hard restart the machine

Lets configure the Combined network of VLAN 22(eth0.22) and USB TO LAN(eth1)

Go to network then interface then eth1

    check enable captive portal

    set maximum hops allowed to 1

    uncheck dynamic ip address

    set static to 20.0.0.1

    set network segment to 20

    check Use System DNS Server

    Check Enable DHCP Server on this Interface

    DHCP Pool Start 20.0.0.10

    DHCP Pool End:20.0.15.254

Go to Network then VLAN Setup:

    Click create VLAN

    Check Enable Captive Portal

    Set Maximum Hops Allowed to 1

    Set Parent interface to eth0

    Set VLAN ID/Tag to 22

    Uncheck Dynamic IP Address

    Set Static IP Address to 22.0.0.1

    Set Network Prefix to 20

    Check Use System DNS Server

    Check Enable DHCP Server on this Interface

    Set DHCP Pool Start 22.0.0.10

    Set DHCP Pool End to 22.0.15.254

    Click create VLAN 

Go to Network then Bridge:

    set maximum hops allowed to 1

    check enable captive portal

    Select  Ports/Interface to bridge:

        Check eth1,wlan0,eth0.22

    uncheck dynamic IP address

    set static to 10.0.0.1

    set network segment to 20

    check Use System DNS Server

    Check Enable DHCP Server on this Interface

    DHCP Pool Start 10.0.0.10

    DHCP Pool End:10.0.15.254

     Click create Bridge and hard restart

Troubleshoot Coinslot problem

 1. May credit na P1.00 pagka press ng insert coin kahit waala pang hinuhulog na coins.
Solution: May 2 slider switch sa likod ng coinslot, paki angat lang po ng sagad

With P1.00 credit everytime you press insert coin
Solution: there are 2 slider switch at the back of a coinslot. Make sure it is both switched upward.

2. Yung credit ng isang P5 na coin ay piso. Ganun din ang isang P10 na coin.
Solution: uncheck Block FAST Insert kung naka powercut setup po kayo. Ang Block Fast insert ay para sa mga naka SET PIN.

The 5 coin and the 10 coin produces 1 credit
solution: uncheck Block fast insert if your using powercut setup. Enabling Block fast insert will work only when using SET PIN.

3. Minsan may mga coins na pumasok pero hindi nagcredit. 
Solution: Try LOOP sa coinslot reading type. Mas minimize ang di nagcredit sa LOOP. From my observation and testing although depende pa rin sa coinslot.

Sometimes coins inserted doesn't credit
Solution: Try LOOP.This will minimize not credited coins.Its from my observation and testing although it depends on coin slot.

Here are more probable culprits for the unrecognized coins:

• Dirty or faulty sensor: Dust, debris, or a malfunctioning sensor can prevent proper coin detection.
• Loose connections: A loose wire connecting the coin slot to the machine can disrupt communication.
• Incorrect calibration: The coin slot might be programmed to recognize specific sizes and weights, and if the calibration is off, it might reject valid coins.
• Foreign objects: Sometimes, objects like pins or washers can get stuck in the mechanism, causing jams and disrupting coin recognition.

Here's a troubleshooting approach:

1. Check for blockages: See if any foreign objects are stuck in the coin slot.
2. Clean the sensor: Use a can of compressed air to gently blow out any dust or debris.
3. Verify power supply: Ensure the coin slot is receiving the correct voltage (usually 12V DC).

4. Check Pin Assignment vs sa kung saan nakasaksak na pin sa board(the position of the wire where it is inserted on the pin. By default PIN3 for white wire and PIN5 for relay in the assignment at dapat sa PIN3 at PIN5 din sakasaksak sa board (and at the same time, it should be inserted on pin3 and pin5 of the board.
coinslot white wire - responsible for pulse reading
relay pin - responsible for blocking coinslot kapag naghulog ng coins na di pumipindot ng insert coins

5. Yung isang P5 peso coin ang reading ay P4 o kaya ang isang P10 peso coin ang reading ay P9 o kaya ang isang P20 na coin, ang reading ay 19
Solution:
By default ito ang payment portal pulse settings
1 pulse = P1.00
5 pulse = P5.00

10 pulse = P10.00

20 pulse = P20.00

Yung P20pulse for P20.00, paki lagay dahil may mga oras na ang reading ng isang P10 coins ay nagiging doble 20(dalawang P10 coins kahit isa lang P10 hinulog)

Paki lagay na rin ang mga ito kung kulang ng isa as stated on the problem above.
4 pulse = P5
9 pulse = P10
19 pulse = P20

Kung kulang ng 2 ang isang coins na hinulog paki dagdag ito:
3 pulse = P5
8 pulse = P10
18 pulse = P20

6. Kung hindi talaga nagke credit at wala ang problema sa mga nabanggit sa taas, 2 lang yan sira na ang specific pin3 ng board at pwede mo siyang ilipat sa iba. At pangalawa sira na talaga ang lahat ng pin ng board-magpalit ka na ng board.

Ito ang mga pin na pwedeng lipatan 3,5,7,11,13,15,16,18 kung di gumagamit ng CB
Kung OPI one 3,5,7 lang kung naka official Ado custom board

Kung naka RPI board ka pwede ang mga ito kung di ka gumagamit ng custom board 3,5,8,11,12,13,15,16,18,19,21,23,24,26,29,31.32,33,36,37.38,40