Magicbit Core Safety guide

STARTER GUIDE
www.magicbit.cc

Welcome to the world of Magicbit
Magicbit is a feature rich, easy to use and cost effective platform made for
everyone. The inbuilt functionalities of Magicbit provide a unique advantage for
users to learn and practice a wide range of application areas such as robotics,
programming, Internet of Things(IoT) and electronics.
Magicbit is an innovation ecosystem with hardware, software, mobile app,
content, community and partners. Integrated solutions can be developed more
easily while exploring cross platform options such as programing with any other
software or connecting to any cloud IoT platform.
A frequently asked question about Magicbit is "How many innovations can I
develop with Magicbit?" The answer to that would be "It has no limits". Your
creativity and innovative mindset has to decide the number of innovations you
can do. After all, the world needs more solutions with technology to resolve
some of the burning problems faced by the mankind. Making technology
accessible and available to everyone is the passion Magicbit team would like to
share with everyone.
So, Welcome to the world of Magicbit !!! Let's start your journey of innovation.

Index
Background................................................................................................... 01
Programming Magicbit.................................................................................. 02
Magicbit Layout............................................................................................. 03
Magicbit Modules.......................................................................................... 05
Getting Started.............................................................................................. 08
Magicblocks.io.............................................................................................. 09
Setup Magicblocks........................................................................................ 10
Configure Magicbit........................................................................................ 11
Playground.................................................................................................... 12
Magicblocks Interface................................................................................... 13
Hello Magicbit................................................................................................ 15
Smart Light.................................................................................................... 17
Light meter.................................................................................................... 19
Weather Station............................................................................................ 21
Talking Bot.................................................................................................... 23
What is Next.................................................................................................. 25
Supported Platforms..................................................................................... 26
Magicbit Pinout............................................................................................. 27
Important....................................................................................................... 07

Background 01
Magicbit Core is a tiny programmable computer which takes inputs from the
environment, process them and drive outputs according to the programmed logic.
You can find dozens of these type of tiny programmable computers in washing
machines, Televisions, Microwave ovens and many more devices. These tiny
computers are mostly either microcontrollers or system on chips (SoC).
There are three main components of a system (even for us humans) Inputs,
Output and Processor.
Sensors act as Input to listen to physical world and convert physical property to
an electrical signal. some examples are temperature, light & movement sensors.
Actuators act as Output to the physical world again to convert back electrical
signal to a physical property like sound, light or movement.
Microcontrollers or SoC get inputs from sensors and drive output according to
pre programmed logic. As an example, a light sensor sends light level to Magicbit
and it turns on a bulb when dark or you can use temperature sensor reading to
turn on a fan.
You can make amazing things by programming these tiny computers. It's all
about your creativity to make a useful outputs from inputs. We, as Magicbit is
here to make the process simple for you.

Programming Magicbit
MicroPython
02
Arduino is C/C++ based language with a large community all
around the world with lot of free resources
magicbit.cc/arduino
Magicblocks.io is an IoT platform to create IoT projects in
minutes for both beginners and experts
magicbit.cc/magicblocks
MicroPython is a programming language compatible with
Python 3. It's a smart way to start learning Python
magicbit.cc/micropython
MagicCode is specially designed for kids to start learning
programming with visual blocks. It's based on Scratch 3
magicbit.cc/magiccode
Age 12+
Age 12+
Age 12+
Age 8-16

Magicbit Front 03
Potentiometer
Rotate to change a value Buzzer
Play sounds
LDR
Light sensor
Battery Connector
Plug the battery holder
OLED Display
128x64 pixel display
Crocodile Clip Holes
Attach crocodile clips
Push Buttons
Digital inputs for Magicbit
Expansion Port
More connectivity options

Reset
Button
LED
Indicators
Flash Button
Need for programming
Micro USB
Connect to computer &
Power Magicbit
Motor Driver
Connect 2x Motors
ESP32 Module
Brain of the Magicbit
Module Connectors
Plug modules
04
Magicbit Rear

Blue Ext Module
Magicbit Modules
Proximity Sensor
Tilt Sensor
RGB LED
Black Ext Module
Motion Sensor
Detect the motion of
a human or an animal
Identify close objects
without contact
Create a combination of
Red, Blue & Green lights
Connector to plug the
soil Moisture and ultrasonic
sensors to Magicbit
Detect the incline or
motion of an object
Connector to plug the
servo motor to Magicbit
Digital Signal Range :5m Digital/Analog Signal Range :5cm
Digital Signal
05
Neo Pixel

Servo Motor
Magicbit Modules
IR Receiver
Ultrasonic Sensor
IR Emitter
Soil Moisture Sensor
Temp.& Humi.Sensor
06
Detect signals from
an IR remote
Transmit IR signal
patterns
Measure temperature and
humidity in environment
A motor to control the
angle of rotation
Measure the distance
for a target object
Determine the moisture
level in soil
Temp- 0-50°C Humidity 20%-80%
Range : 2cm to 4m Analog Signal Range : 0-3V
Range 0-180 degrees

Modules should be plugged to connectors aligning the logo printed on the
sensor module with the display side on Magicbit.
Connector should be plugged in by matching the connector color in
module with the printed color on board.
Important
Recommended for age 8 years and above.
Magicbit is operated with a Voltage of 3.3V and should be handled with
care to avoid any damage to user and the device.
Following batteries can be used based on your battery holder selection.
1x 18650 Li-ion battery
3x AA Alkaline Battery
07

Getting Started
02
Connect the Magicbit to the computer
via USB cable.
When using for the first time, Magicbit self-check
program will run on the device displaying different
features.
Download and install Magicbit upload tool with
drivers
https://magicbit.cc/downloads/
01
03
08

Magicblocks.io 09
Visual code builder
Block based programming or visual coding is a popular concept to
develop solutions with ease. Magicbblocks.io is a cloud based IoT
software which can be used to program Magicbit and develop
solutions. Even a novice in programming can use this to develop a
solution following a logical sequence to connect the blocks.
Powered by Node-RED
Magicblocks.io was developed based on Node-RED open source
framework. This provides some powerful integrations to APIs, Social
media, Google services and many more. The customized blocks for
Magicbit can be used to integrate Magicbit easily. The software has
device management function and it supports Magicbit and other ESP
32 based hardware as well.
From beginner to expert
Magicblocks is a fast way to learn solution integration for a beginner.
Complex applications can be developed with custom programming.
The blocks can be custom coded with java script functions. Therefore it
can be even used for expert level solution designing.

Setup Magicblocks
Sign Up & Login
Visit https://magicblocks.io and click signup to register as a new user.
When you fill & submit the basic details, you will get the activation link via
email.
Click on the link in the email to activate the account.
Once activated, you can login to the account in magicblocks.io
Click on "Start Playground" after login. Playground is the workspace to
create logic using different functional blocks.
You can add coupon code provided with Magcbit to activate your standard
subscription under the subscriptions tab. With standard subscription, you will
have unlimited session time while you are working with Magicblocks. After
you logout from the session, it will be automatically stopped after 1 hour.
START
PLAYGROUND
10

Configure Magicbit
STEP 1 :
Login to Magicblocks account and open the Device Manger tab
STEP 2 :
Click on button and new device dialog will popup
STEP 3 :
Add a Name and keep other fields with default values. Click on save changes
Upload magicblocks firmware using the uploader
Add your WiFi network SSID (name) and password
Connect to Magicbit WiFi network and wait for a beep sound
Click on 'Finish' button to complete the configuration
STEP 4:
Click on the configure button and refer to the below instructions
1.
2.
3.
4.
STEP 1 :
If everything fine, you can see wireless mark on your Magicbit
display. If you get an error please check SSID & password are
correct or playground is running.
11

A node’s configuration can be edited by double clicking on
the block. If a node has any undeployed changes, it displays
a blue circle above it. If there are errors with its configuration, it displays a red
triangle.
Playground
The playground is a hosted instance of a customized version of the open
source, Node-Red . On the left you will find the palette with all the blocks.
Once you have created your program, the Deploy button on the top right
corner will be used to update and save all your changes.
Blocks or Nodes
Blocks are the basic units of creating logic. There are many blocks for different
functions in the palette. Blocks can be added to the workspace by dragging
them from the palette.
Wire
Nodes are wired together by pressing the left-mouse button on a node’s port,
followed by dragging to the destination node and releasing the mouse button.
+
12

Palette
Magicblocks Interface
Playground
Create logic using visual programming
Workspace
Sidebar
13

Device Manger
Add, edit, configure &
view hardware devices
Dashboard
Create dashboards to
visualize data
14
Magicblocks Interface

Hello Magicbit
Inject block is used to input data to another block. Double click
on inject block to see the properties. Change Payload to String and type Hello
Magicbit. Click done.
Display text on Magicbit
Say hello to your Magicbit. You can display any text on your
Magicbit display.
STEP 1 :
Power up your Magicbit using USB cable and get connected to Magicblocks
cloud. Check page 11 to configure Magicbit for Magicblocks.
STEP 2 :
Open playground and drag following blocks to workspace from the block pallet.
Display block sends text data to Magicbit OLED display. Open
properties and set Device ID of your Magicbit. Device ID can be found on your
account Device Manager.
15
Your first project, OLED, Inject node
Level :
Time : 30 mins

STEP 3 :
Connect Inject block with Display block using a wire. Drag your mouse from
small square on Inject to small square on Display block.
Drag from here to display block
STEP 4 :
Click Deploy button to apply all changes. You can see the blue color dot on
blocks disappearing after correctly deployed.
STEP 5 :
Once above steps are completed, you will see a connected mark under the
Display block. Click switch (small square) at the left side of Inject block to see
the Magic.
Activity
Change payload, add text to 'Topic' field in inject block and check the result
16

Smart Light
Add two Inject blocks to workspace. Change Payload to
boolean and set true for one block and false for other block.
Digital Out block from Magicbit blocks to change pin status of
the Magicbit. You can input 1 or true to turn on a pin and 0 or false to turn off a
pin. Open properties and set Device ID and Pin to LED Green(16) .
Control a LED through internet
Control the onboard LEDs on Magicbit via internet. Try different
patterns with colors.
STEP 1 :
Power up your Magicbit using USB cable and get connected to Magicblocks
cloud. Check page 11 to configure Magicbit for Magicblocks.
STEP 2 :
Open playground and drag following blocks to workspace from the block pallet.
17