You will have a fully packed bag when you received your OAK Appliance eLite RPi-CM
Unpacking it
Connect the power supply and cables
The final connection should be like this
Power up the OAK Appliance eLite RPi-CM
Power up the OAK Appliance, the system will be booting up in 30 seconds. there is a power status green LED, and one green LED for the status of the port 1 to 4 and the port 5 to 8.
Configure the OAK Appliance eLite RPi-CM and IPPBX functions
The OAK Appliance is configured with DHCP, you can refer to here to find out what is the IP address that your router or GW assigned to the OAK appliance. Once you have the IP address, point your web browser to https://youripaddress and accept the connections of SSL. Please be noticed that the OAK Appliance GUI uses a self-signed CA key, you can accept it by directly and ignore the warning of the browser.
For the details of how to configure IPPBX functions through GUI, please refer to below two links
The OAK eLite supports IEEE802.3AT mode POE power supply, it provides a 5V/2A power feeds RPi 3B+ or 4B module. Please follow below steps to power up your module with POE power supply.
Connect POE cable of OAK eLite to your RPi3B+ or 4B POE header like below shows
Once the POE cable inserted, plug the OAK eLite module to RPi3B+ or 4B as below shows
Connect your POE power supply and plug RJ45 cable to RPi3B+ or 4B, the OAK eLite module should start booting up.
Be noticed that, you don’t have to plug the USB power cable of RPi3B+ or 4B once you connected POE.
Power up with extra 9V – 12V power supply
The OAK eLite also support boot up from an extra 9V – 12V DC power supply, you can plug it to OAK eLite DC jack as below shows (inner is positive electrode)
Be noticed that, you don’t have to plug the USB power cable of RPi3B+ or 4B once you connected DC jack.
Boot up OAK eLite with SwitchPi experience firmware
RPi3B+ Switchpi OAK eLite firmware – switchpi-oakelite-with-gui-1.0.1.img.zip fromhere. The firmware currently version is 1.0.1, built-in Asterisk-13.20, and Dahdi-2.11.1.
Put the downloaded firmware to a Linux distro PC, then following below steps to clone it to an 8G SD card (we strongly suggested to use a class 10 HC SD card such as below SanDisk one), insert micro SD card to your PC with a USB SD card adaptor, the Linux will recognized it like /dev/sda or /dev/sdb which depends on your OS how many drives, you can check it out with command “dmesg”, we are using the /dev/sdb in here.
Configure your OAK eLite module through SwitchPi GUI
The OAK eLite RPi3B+ SSH login default static IP address is 192.168.1.99/24, the default username/password is pi/raspberry
The OAK eLite RPi4B uses DHCP to get an IP address, check here to find out where you can get the IP address assigned by your GW or router. the default username/password is pi/raspberry
The OAK eLite WEB GUI default username/password is admin/admin123
Please reference to these links for how to configure OAK eLite module
OAK Appliance PRO is a new generation of open-source designed IPPBX (PABX) system that is more powerful, more stable, and faster performing than OAK Appliance.
The main CPU of the OAK Appliance PRO is based on 64bits RK3399, that is
6 cores CPU, Dual-core Cortex-A72 up to 1.8GHz, Quad-core Cortex-A53 up to 1.4GHz
64 bits width dual-channel 2G DDR4 RAM
Onboard 16G eMMC
USB 3.0
WIFI interface
1000Mbps Ethernet supports
With the most advanced improvement of PCB design, the CPU multi-core performance is around 200% faster than OAK Appliance eLite.
Modular designed interface PRI/E1(OAK PRI module, two E1 modules supported, up to 64 Asterisk channels), FXS, FXO module interface, you can change it by your own configuration.
OAKEC-128 DSP echo cancellation module supported
Details
RK3399 6 core 64bits CPU, up to 1.8GHZ each core
16G eMMC (5.1)
2G DDR4 RAM with 64 bits data bus (dual channels)
Onboard RTC supported, 1F super capacitor to store the date of RTC circuit, no battery included, best safety for the air shipping
Modular designed E1 PRI, FXS and FXO slot 1, easily to switch them, 4G, Lora module is coming soon
Modular designed E1 PRI, FXS and FXO slot 2, easily to switch them, 4G, Lora module is coming soon
DSP EC module, ITU-T G.168 standard, 128ms tails remove, check here out for the performance of OAKEC DSP based EC module
The OAK PRO analog Raspberry Pi module is a revolution version of OAK and OAKR2, it adds a DSP chip to implement the echo cancelation algorithm, significantly improved the voice quality on traditional PSTN network to VoIP phones. It also supports one(1) built-in low power FXS module and one (1) FXO module.
The OAK PRO module is compatibles with all versions of Asterisk using the DAHDI driver framework. Asterisk and DAHDI are available for free from the Asterisk.org website.
The OAK RPO module supports Raspberry Pi 4B, 3B+, Pi 3.
Specifications:
One DSP chip for 128ms ITU-G168 standard echo cancelation
One (1) FXO plus one (1) low power SwitchPi Stone FXS and FXO analog port
The OAK Appliance eLite is modularization designed which means you can plug the FXS or FXO module to its slots, therefore, to figure out which module is plugged to which slot is the most important thing before power up eLite. The reason is that, if you connect the PSTN line to an FXS module, that will easily to break the FXS module.
There are two LEDs on the front panel, “LED 1” and “LED 2”, “LED 1” means the slot 1 of OAK Appliance eLite, “LED 2” means the slot 2 of OAK Appliance eLite. If the LED 1 shows up Green, which means an FXS module has plugged into the slot 1 of OAK Appliance eLite, If the LED 1 shows up Orange, which means an FXO module has plugged into the slot 1 of OAK Appliance eLite, the LED 2 has same definitions.
Below is a detailed picture that shows the 4 status of LED 1 and LED 2 to match the module which installed in slot 1 and slot 2
The DSP and SYS LEDs
The DSP LED shows up with green if you have plugged the OAKVE-32 or OAKVE-128 DSP echo cancelation module.
The SYS LED will be blinking after the system is booting up
OAK Appliance eLite is a new generation of open source designed IPPBX (PABX) system that is more powerful, more stable, and faster performing than OAK Appliance.
The main CPU of the OAK Appliance eLite is based on a quad-core Cortex-A53 H5 with a new generation Mali-G52 GPU, onboard 8G eMMC, 1G DDR3 RAM with 32 bits data bus improved.
With the most advanced improvement of PCB design, the CPU multi-core performance is around 20% faster than OAK Appliance.
Modular designed interface FXS, FXO module interface, you can change it by your own configuration.
OAKEC-32 DSP echo cancellation module supported
Details
Mainboard
All winner H5 Quad core 64bits CPU, up to 1.2GHZ
8G eMMC
1G DDR3 RAM with 32 bits data bus
Onboard RTC supported, 1Fsuper capacitor to store the date of RTC circuit, no battery included, best safety for the air shipping
Modular designed FXS FXO slot 1, easily to switch them, 4G, Lora module is coming soon
Modular designed FXS FXO slot 2, easily to switch them, 4G, Lora module is coming soon
DSP EC module, ITU-T G.168 standard, 128ms tails remove, check here out for the performance of OAKEC DSP based EC module
1000/100/10 Mbps Ethernet
USB 2.0
Reset button, focus the main board to reset
SD card slot, supports up to 64G SD card
Interfaces
1 OAK Stone 4 FXS module, 4 channels FXS interface. Best improved power consumption and heat radiation
2 OAK Stone 4 FXO module, 4 channels FXO interface.
3 P1 to P8 is the RJ11 interfaces. P1 to P4 to connect to PSTN, P5 to P8 to phones.
8. 1000/100/10 Gbps Ethernet
9. USB 2.0
Fully loaded
Modules
OAKVE-32 DSP module
OAKVC-32
OAKVE-32 is a plug and play with ITU G.168 standard echo cancellation module, up to 32 channels, 128ms tails removing.
Dimensions(W x D) (4.5 x 3 cm) Weight • 0.4 oz (11 g) (OAKVC-32) Environmental • Operating temperature: 0 to 40ºC (32 to 104°F) • Storage temperature: -25 to 70ºC (-13 to 158°F) • Relative humidity: 5 to 85% noncondensing operating; 5 to 95% noncondensing, nonoperating
OAK Stone 4 FXO module
OAK Stone 4 FXO is an interface that connects to a trunk line, like the one from your service provider. It receives a ringing voltage and battery from FXS devices. FXO interfaces are used to connect your PBX to the PSTN.
OAK Stone 4 FXO is a quad FXO interface module for the OAK Appliance eLite. The OAK Stone 4 FXO module allows the OAK Appliance eLite to terminate four analog telephone lines (POTS) per module. Because of the modular design, a user can activate additional ports at any time with more OAK Stone 4 FXO or OAK Stone 4 FXS daughter cards. OAK Stone 4 FXO module passes all the call features any standard analog telephone line will support. Worldwide certifications are pending. OAK Stone 4 FXO Features: 4 Port FXO Resource Module Compatible with OAK Appliance Lite PABX (IPPBX)
OAK Stone 4 FXS module
OAK Stone 4 FXS (Foreign Exchange Station) module allows the OAK Appliance eLite to terminate four analog telephones per module. Because of the modular design, a user can activate additional ports at any time with more OAK Stone 4 FXS daughter cards. OAK Stone 4 FXS module passes all the call features any standard analog telephone line will support. Worldwide certifications are pending. OAK Stone 4 FXS Features and Functions Allows the OAK Appliance eLite to terminate four analog telephones per module Modular Design Activate additional ports at any time with more OAK Stone 4 FXS daughter cards
To recover the OAK Appliance you have to preparing an 8G at least SD card, a 16G at least USB flash disk. Also, the USB flash disk has to formatted to vfat or ext4 to support bigger than 4G file in single.
Download the recovery image from this link, and the OAK Appliance 1.0.1 version firmware from this link. After downloading the image, use this https://www.balena.io/etcher/ SD writing tool to burn the recovery image to an 8G at least SD card, copy the OAK Appliance image to a USB flash disk after unzipping it.
When done, open the OAK Appliance enclosure, insert the recovery SD card to the SD slot as below picture shows position
SD Card slot poistion
Plug the power and ethernet cable of OAK appliance, the OAK Appliance will try to booting up the recovery image from SD card, wait up 50 seconds, try to SSH log into it with 192.168.4.98, username/password pi/pi.
Plug the USB flash disk to OAK Appliance, the OAK Appliance should be recognized it as below shows
[ 12.267134] usb 2-1: new high-speed USB device number 2 using ehci-platform [ 12.434215] usb-storage 2-1:1.0: USB Mass Storage device detected [ 12.435974] scsi host0: usb-storage 2-1:1.0 [ 14.078740] scsi 0:0:0:0: Direct-Access Lexar USB Flash Drive 1100 PQ: 0 ANSI: 6 [ 14.079803] sd 0:0:0:0: Attached scsi generic sg0 type 0 [ 14.080498] sd 0:0:0:0: [sda] 250068992 512-byte logical blocks: (128 GB/119 GiB) [ 14.081585] sd 0:0:0:0: [sda] Write Protect is off [ 14.081598] sd 0:0:0:0: [sda] Mode Sense: 43 00 00 00 [ 14.082680] sd 0:0:0:0: [sda] Write cache: enabled, read cache: enabled, doesn't support DPO or FUA [ 14.090422] sda: [ 14.094997] sd 0:0:0:0: [sda] Attached SCSI removable disk
Mount it to /mnt folder like below shows
root@OAK-APP-Lite:~# mount /dev/sda /mnt/ root@OAK-APP-Lite:~# cd /mnt/ root@OAK-APP-Lite:/mnt# ls -l -rwxr-xr-x 1 root root 3847225344 Jan 3 2019 switchpi-oakapp-1.0.1.img -rwxr-xr-x 1 root root 596906364 Mar 18 2019 switchpi-oakapp-1.0.1.img.zip
And then use the DD command to burn it to the OAK Appliance eMMC disk, make sure you use the correct mmc device id, as the OAK Appliance recognized SD and eMMC to same device but different ID, for the OAK Appliance, the ID mostly is 2, and should like below shows(you might have an 8G eMMC, but the ID should same to 4G)
The above command will take about 2 minutes to finish, when done, it looks like below
917+1 records in 917+1 records out 3847225344 bytes (3.8 GB, 3.6 GiB) copied, 182.244 s, 21.1 MB/s
Then umount the USB flash disk, power off the OAK Appliance with commands
root@OAK-APP-Lite:/mnt# cd root@OAK-APP-Lite:~# umount /mnt/ root@OAK-APP-Lite:~# poweroff
Wait up to 30 seconds, unplug the power supply and remove the SD card, and start again OAK Appliance, you should get the OAK Appliance fully recovered.
What’s the next
You can follow this link to configure your OAK Appliance again.
Leave your message to below if you have any trouble when you try to recover your OAK Appliance
Add an outgoing call rule that makes the outgoing calls from the internal phone
The example scenario is:
Internal phone: extension number 6001, suppose you have created in part 1
Analog external FXO: PSTN lines 1, suppose you have created in part 1
Dial 010000 to access external PSTN line, also strip the first digital 0, therefore the PSTN line will only can see 10000
Go to the Call Routing -> Outgoing Calling Routing -> New Calling Rule, the Create New Calling Rule will show up as below
Create New Calling Rule
The name is ToPSTN, fill up the Number Starts With to 0, selected the Any Length, then click the Call Routing button that located the top middle
Select the Select Primary & Fallover External Lines, and choose the Primary External Line to you have created an external PSTN line that as the above picture shows. Also, fill up the Strip field to 1 that means to remove the first digital 0 in our test scenario defined. Click Save button.
ToPSTN calling rule is created
Go to the PBX Configuration -> select the 6001 and click the edit icon
change the Outgoing Calling Rule Set to that you just created ToPSTN, then click Save, and Click the Apply Changes, the system will prompt you to reboot the device, reboot it, you should able to dial 010000 to get the call go to outside.
You will have a fully packed bag when you received your OAK Appliance
Unpacking it
Connect the power supply and cables
Power up the OAK Appliance
Power up the OAK Appliance, the system will be booting up in 30 seconds. there is a power status green LED, and two orange LEDs for the status of the port 1 to 4 and the port 5 to 8
The module of port 1 to 4 detected, therefore the Port 1 to 4 status orange LED is swithed on
Configure the OAK Appliance and IPPBX functions
The OAK Appliance configured the static IP address in the default status, The default GUI IP address is 192.168.4.98, point your web browser to https://192.168.4.98 and accept the connections of SSL.
GUI OF OAK APPLIANCE
The GUI default username and password is admin/admin, also, you have to change the default password when you are log into GUI in the first time. Enter the admin/admin and press “Log In button, the system will prompt you to change the default password
It is focused on to change the default password
Click “Update Password” button and log into the GUI with the new password, the main GUI of OAK Appliance will appeared
Main GUI of OAK Appliance
A quick example for how to add SIP, analog extensions
Go to the PBX Configuration -> Phone Extensions -> VoIP extension table -> New VoIP extension
Fill up the Caller ID Number to 6000, Password to 6000, and leave the rest of parameters to defaults
Click Save, You will have a 6000 extension added in the Extension Table list
Extension 6000 added
Add the external FXO extensions. Go to the Analog Extension Table -> New Analog Extension
Fill up the Caller ID Name to 6001, and select the Analog station to Port 5, leave the rest of parameters to default
Click Save, You will have an 6001 extension added in the Analog Extension Table list
Analog extension 6001 added
Then add the 6002, 6003, 6004 with port 6, 7, and 8, the final results will like below
Final extensions list
Add a incoming route to route all external PSTN calls to the analog extension 6001.
Go to main menu PBX Configurations -> External Lines
Then click the Analog External Line -> New Analog external line
Fill up the External Line Name to PSTN, select Channels 1, 2, 3 and 4, leave the rest of parameters to default
Click Save, you will have it in the New Analog External Line Table list
Go to main menu Call Routing -> Incoming calling Rules -> New incoming calling rules
Incoming Calling RulesSelect the External Line to PSTN that we created, Time of dAY Route to None as we didn’t create one, The number Starts With to “s” to accept all the calls, Put the Destination to Analog extension 6001 which we created
Click Save, you will have a new incoming call rule created
Now, We have finished all the requirements from the test scenario, it is time to reboot the OAK Appliance to enable all the configures. Click the menu of the left of the top button “Apply Changes”, the OAK Appliance will ask you to reboot the PBX
Click Reboot Now, the system is going to reboot, and that will take 30 seconds.
Connect the external PSTN line to Port FXO (1 to 4) RJ45 one port, and try to call your external PSTN number, you will receive the call from analog extension 6001.
The OAK Appliance System GUI
We provide a system configuration GUI for the OAK Appliance system configuring, status monitoring, terminal console.
The default system GUI link is https://192.168.4.98:9090, username and password is pi/pi
The login GUI of OAK ApplianceSystem statusA consol of GUI that let you configure your OAK Appliance in command mode
