byteWIKI

https://www.bytesatwork.io/wp-content/uploads/2020/04/Bildschirmfoto-2020-04-20-um-19.49.20-e1587405063724.jpg

About the company

_images/bytes.png

bytes at work is a modern Swiss Technology company specialized in industrial computing. Our focus lies on the development of hardware and embedded software, as well as customizing Linux systems. The entire development life cycle takes place in-house with transparent project management and customer involvement. This significantly reduces both development time and development costs.

We have years of experience in developing coordinated hardware and software solutions – from the prototype to the final product. We make your system usable end-to-end for your needs.

Our philosophy

Hardware and software for industrial computers have to fulfill an immense range of demanding challenges. They are used in completely different areas of industries and they have to be able to adapt unique and specific tasks. Our employees pay particular attention to each and every customer. That is why our products and services meet and even exceed our customers expectations.

We from bytes at work are aware that the current persistent industrial development also has its darker side. This is our motivation to be exemplary in terms of use of resources. No wonder that unconditional reliability, long service life and low power consumption are main features of all our products.

https://www.bytesatwork.io/wp-content/uploads/2020/04/Bildschirmfoto-2020-04-20-um-19.46.24.jpg

Unboxing byteDEVKIT STM32MP1

This guide delivers new users a brief overview of the package content and the functions of our byteDEVKIT STM32MP1. When unboxing you should find the following components:

  • The byteDEVKIT STM32MP1 with a 5-inch touchscreen display
https://www.bytesatwork.io/wp-content/uploads/2020/04/unboxing_2kl.jpg
  • The SOM STM32MP1x

Note

The SOM STM32MP1x is already connected with the byteDEVKIT STM32MP1.

https://www.bytesatwork.io/wp-content/uploads/2020/04/unboxing_4kl.jpg
  • The power supply for the byteDEVKIT STM32MP1
https://www.bytesatwork.io/wp-content/uploads/2020/04/unboxing_8kl.jpg
  • The USB serial cable for the byteDEVKIT STM32MP1
https://www.bytesatwork.io/wp-content/uploads/2020/04/unboxing_9kl.jpg
  • micro-SD card with preinstalled Linux
https://www.bytesatwork.io/wp-content/uploads/2020/04/unboxing_10kl.jpg

Technical overview byteDEVKIT STM32MP1

  • The byteDEVKIT STM32MP1 offers the following connectors on the front side:
    • USB 2.0
    • RJ45 Ethernet 1 Gbit
    • USB OTG
    • Power connector
https://www.bytesatwork.io/wp-content/uploads/2020/04/unboxing_7kl.jpg
  • You find the extension on the backside. The byteDEVKIT STM32MP1 offers:
    • 40 pin header compatible for the rasperry pi
    • 60 pin header with all the needed signals: I2C, SPI, CAN, UART, I2S, LDC, GPIO and PWM
https://www.bytesatwork.io/wp-content/uploads/2020/04/unboxing_5kl.jpg
  • The micro-SD card slot contains a micro-SD card with preinstalled Linux OS:
https://www.bytesatwork.io/wp-content/uploads/2020/04/unboxing_11kl.jpg

Note

The micro-SD card is already slotted to the byteDEVKIT STM32MP1.

https://www.bytesatwork.io/wp-content/uploads/2020/04/Bildschirmfoto-2020-04-20-um-19.41.44.jpg

Unboxing Video Tutorial

First start byteDEVKIT STM32MP1

This guide helps with the first start of the byteDEVKIT STM32MP1:

Connecting the Hardware and first Booting

  • Prepare the USB serial cable for connection
  • Locate the black cable of the serial connector.
https://www.bytesatwork.io/wp-content/uploads/2020/04/wiring_2kl.jpg

Caution

Connect the serial cable to the byteDEVKIT STM32MP1 as shown. The black cable must point towards the USB OTG connector.

https://www.bytesatwork.io/wp-content/uploads/2020/04/wiring_3kl.jpg
  • Connect the USB connector with USB port of your computer or laptop.
  • Connect the ethernet RJ45 with the byteDEVKIT STM32MP1.
https://www.bytesatwork.io/wp-content/uploads/2020/04/wiring_5kl.jpg
  • Plug in the power socket.
  • Connect the power supply cable to the power slot of the byteDEVKIT STM32MP1.
https://www.bytesatwork.io/wp-content/uploads/2020/04/wiring_7kl.jpg
  • A green LED on the backside of the byteDEVKIT STM32MP1 indicates the status of the power supply.

Attention

Your byteDEVKIT STM32MP1 is powered up, when the green LED lights up. If the LED doesn´t light up, check the connection of the power socket.

https://www.bytesatwork.io/wp-content/uploads/2020/04/wiring_8kl.jpg
  • The 5-inch touchscreen display shows the bytes at work-logo when booting.

Hint

The booting procedure will take a few seconds.

https://www.bytesatwork.io/wp-content/uploads/2020/04/wiring_9kl.jpg
  • Now you can access the byteDEVKIT STM32MP1 with your laptop.

Hint

For further information refer to: “Bring-up_byteDEVKIT_STM32MP1”.

https://www.bytesatwork.io/wp-content/uploads/2020/04/wiring_10kl.jpg

Bring-up byteDEVKIT STM32MP1

How do I connect to byteDEVKIT using the serial console?

  • Use the serial port to connect the byteDEVKIT STM32MP1:
    • Connect the debug cable with the byteDEVKIT STM32MP1 and your computer/laptop
    • Start a serial communication program on your computer/laptop (‹putty›, ‹minicom› or something else)
    • Set to 115200, 8N1, no flow control
    • login with: user: “root” and password: “rootme”

LINUX

  • Start PuTTY
https://www.bytesatwork.io/wp-content/uploads/2020/04/Putty_1.png
  • Click “Serial”
  • Change “Serial line” to “/dev/ttyUSB0”
  • Change “Speed” to 115200
  • Navigate to “Serial” in the menu “Connection”

Hint

make sure you have Data bits set to 8, Stop bits set to 1, Parity to None, Flow control to None

  • Click “Open”
  • Power up the byteDEVKIT STM32MP1
https://www.bytesatwork.io/wp-content/uploads/2020/04/Putty_2.png
  • Once the login prompt appears, login with user “root” and password “rootme”
https://www.bytesatwork.io/wp-content/uploads/2020/04/Putty_3.png

Note

You are now succesfully connected to the byteDEVKIT STM32MP1

WINDOWS

  • Connect the USB serial adapter to the computer
  • Windows installs the driver automatically (if the windows doesn´t install the driver reconnect the serial adapter cable)
  • Open device manager and navigate to “Ports (COM & LPT)”
  • The serial adapter shows up in the device tree: “Prolific USB-to-Serial Comm Port (COM7)”
  • “COM7” is your serial port
  • Install a serial terminal application, e.g. PuTTY (version 0.59 and newer) https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
  • Start PuTTY
https://www.bytesatwork.io/wp-content/uploads/2020/04/Putty_4.png
  • Click “Serial”
  • Change “Serial line” to serial port you found in device manager
  • Change “Speed” to 115200
  • Navigate to “Serial” in the menu “Connection”

Hint

make sure you have Data bits set to 8, Stop bits set to 1, Parity to None, Flow control to None

  • Click “Open”
Power up the byteDEVKIT STM32MP1
https://www.bytesatwork.io/wp-content/uploads/2020/04/Putty_5.png
Once the login prompt appears, login with user “root” and password “rootme”
https://www.bytesatwork.io/wp-content/uploads/2020/04/Putty_6.png

Note

You are now succesfully connected to the byteDEVKIT STM32MP1

How to install additional software using apt

Hint

Follow the link for additional information about “apt”: https://help.ubuntu.com/community/AptGet/Howto

  1. Connect the embedded device’s ethernet to your LAN
  2. Run: apt-get update
  3. Run: apt-cache search <software component> to search for available packages e.g.: apt-cache search nodejs
https://www.bytesatwork.io/wp-content/uploads/2020/05/apt-cache_nodejs.png
  1. Run: apt-get install <software component> to install additional software e.g.: apt-get install nodejs
https://www.bytesatwork.io/wp-content/uploads/2020/05/apt-get_install_wide.png https://www.bytesatwork.io/wp-content/uploads/2020/04/Bildschirmfoto-2020-04-20-um-19.41.44.jpg

Software Development

The entire development lifecycle is done in-house with transparent project management and customer involvement. We have proven experience in a wide range of industries, including industrial automation and custom solutions for consumer electronics. This section helps you step by step initiating the software development process:

2. How do you install the toolchain?

2.1 byteENGINE STM32MP1x

Download the Toolchain and install it

./poky-bytesatwork-glibc-x86_64-bytesatwork-minimal-image-cortexa7t2hf-neon-vfpv4-bytedevkit-toolchain-3.0.2.sh

2.2 byteENGINE AM335x

Download the Toolchain and install it

./poky-bytesatwork-glibc-x86_64-bytesatwork-minimal-image-armv7at2hf-neon-bytepanel-emmc-toolchain-3.0.2.sh

Hint

If you encounter problems when trying to install the toolchain, make sure the downloaded toolchain is executable. Run chmod +x /<path>/<toolchain-file>.sh to make it executable.

3. How do you use the toolchain?

3.1 byteENGINE STM32MP1x

Source the installed Toolchain:

source /opt/poky-bytesatwork/3.0.2/environment-setup-cortexa7t2hf-neon-vfpv4-poky-linux-gnueabi

Check if Cross-compiler is available in environment:

echo $CC

You should see the following output:

arm-poky-linux-gnueabi-gcc -mthumb -mfpu=neon-vfpv4 -mfloat-abi=hard -mcpu=cortex-a7 -fstack-protector-strong -D_FORTIFY_SOURCE=2 -Wformat -Wformat-security -Werror=format-security --sysroot=/opt/poky-bytesatwork/3.0.2/sysroots/cortexa7t2hf-neon-vfpv4-poky-linux-gnueabi

Crosscompile the source code, e.g. by:

$CC helloworld.c -o helloworld

Check generated binary:

file helloworld

The output that is shown in prompt afterwards:

helloworld: ELF 32-bit LSB pie executable, ARM, EABI5 version 1

3.2 byteENGINE AM335x

Source the Toolchain

source /opt/poky-bytesatwork/3.0.2/environment-setup-armv7at2hf-neon-poky-linux-gnueabi

Check if Cross-compiler is available in environment:

echo $CC

You should see the following output:

arm-poky-linux-gnueabi-gcc -march=armv7-a -mthumb -mfpu=neon -mfloat-abi=hard --sysroot=/opt/poky-bytesatwork/3.0.2/sysroots/armv7at2hf-neon-poky-linux-gnueabi

Cross-compile the source code, e.g. by:

$CC helloworld.c -o helloworld

Check generated binary:

file helloworld

The output that is shown in prompt afterwards:

helloworld: ELF 32-bit LSB pie executable, ARM, EABI5 version 1

4. How to bring your binary to the target?

  1. Connect the embedded device’s ethernet to your LAN
  2. determine the embedded target ip address by ip addr show
https://www.bytesatwork.io/wp-content/uploads/2020/05/ip_addr_show_28.png
  1. scp your binary, e.g. hello world to the target by scp helloworld root@<ip address of target>:/tmp
https://www.bytesatwork.io/wp-content/uploads/2020/05/scp2.png
  1. run chmod +x on the target to make your binary executable: chmod +x /<path>/<binary name>
  2. run your binary on the target: /<path>/<binary name>

6. How do you flash the Image?

Attention

  • You need is a micro-SD card with minimal 8GB capacity.
  • All existing data on the micro-SD card will be lost.
  • Do not format the micro-SD card before flashing.

6.1 byteDEVKIT

  • Yocto 3.0

    WINDOWS

    Unzip the <file.wic.gz> (e.g. with 7-zip)
Write the resulting <file.wic> to the uSD-card with a tool like Roadkils Disk Image: https://www.roadkil.net/program.php?ProgramID=12

    LINUX

    gunzip -c <file.wic.gz> | dd of=/dev/mmcblk<X> bs=8M conv=fdatasync status=progress

Hint

To improve write performance, you could use bmap-tools under Linux:

bmaptool copy <file.wic.gz> /dev/mmcblk<X>

  • Yocto 2.7

    WINDOWS

    Unzip the <file.raw.gz> (e.g. with 7-zip)
Write the resulting <file.raw> to the uSD-card with a tool like Roadkils Disk Image: https://www.roadkil.net/program.php?ProgramID=12

    LINUX

    gunzip -c <file.raw.gz> | dd of=/dev/mmcblk<X> bs=8M conv=fdatasync status=progress

6.2 bytePANEL

  • Yocto 3.0

    WINDOWS

    Unzip the <file.wic.gz> (e.g. with 7-zip)
Write the resulting <file.wic> to the uSD-card with a tool like Roadkils Disk Image: https://www.roadkil.net/program.php?ProgramID=12

    LINUX

    gunzip -c <file.wic.gz> | dd of=/dev/mmcblk<X> bs=8M conv=fdatasync status=progress

Hint

To improve write performance, you could use bmap-tools under Linux:

bmaptool copy <file.wic.gz> /dev/mmcblk<X>

  • Yocto 2.7

    WINDOWS

    Unzip the <file.sdimg.gz> (e.g. with 7-zip)
Write the resulting <file.sdimg> to the uSD-card with a tool like Roadkils Disk Image[https://www.roadkil.net/program.php?ProgramID=12]

    LINUX

    gunzip -c <file.sdimg.gz> | dd of=/dev/mmcblk<X> bs=8M conv=fdatasync status=progress

7. How do you build an image?

7.1 byteDEVKIT

  • Yocto 3.0

    Use repo to download all necessary repositories:

    repo init -u https://github.com/bytesatwork/bsp-platform-st.git -b zeus
repo sync

    If those commands are completed successfully, the following command will setup a Yocto Project environment for byteDEVKIT:

    MACHINE=bytedevkit DISTRO=poky-bytesatwork EULA=1 . setup-environment build

    The final command builds the development image:

    bitbake bytesatwork-minimal-image

    The output is found in:

    tmp/deploy/images/bytedevkit

Hint

For additional information about yocto images and howto build them, please visit: https://www.yoctoproject.org/docs/3.0/mega-manual/mega-manual.html#brief-building-your-image

  • Yocto 2.7

    Use repo to download all necessary repositories:

    repo init -u https://github.com/bytesatwork/bsp-platform-st.git -b warrior
repo sync

    If those commands are completed successfully, the following command will setup a Yocto Project environment for byteDEVKIT:

    MACHINE=bytedevkit DISTRO=poky-bytesatwork EULA=1 . setup-environment build

    The final command builds the development image:

    bitbake devbase-image-bytesatwork

    The output is found in:

    tmp/deploy/images/bytedevkit

7.2 bytePANEL

  • Yocto 3.0

    Use repo to download all necessary repositories:

    repo init -u https://github.com/bytesatwork/bsp-platform-ti.git -b zeus
repo sync

    If those commands are completed successfully, the following command will setup a Yocto Project environment for bytePANEL:

    MACHINE=bytepanel DISTRO=poky-bytesatwork EULA=1 . setup-environment build

    the final command builds the development image:

    bitbake bytesatwork-minimal-image

    The output is found in:

    tmp/deploy/images/bytepanel

Hint

For additional information about yocto images and howto build them, please visit: https://www.yoctoproject.org/docs/3.0/mega-manual/mega-manual.html#brief-building-your-image

  • Yocto 2.7

    Use repo to download all necessary repositories:

    repo init -u https://github.com/bytesatwork/bsp-platform.git -b warrior
repo sync

    If those commands are completed successfully, the following command will setup a Yocto Project environment for bytePANEL:

    MACHINE=bytepanel DISTRO=poky-bytesatwork EULA=1 . setup-environment build

    the final command builds the development image:

    bitbake devbase-image-bytesatwork

    The output is found in:

    tmp/deploy/images/bytepanel

7.3 How to modify the image

  • bytesatwork delivers tips for customizing an image

The image recipes can be found in sources/meta-bytesatwork/recipes-core/images

This is relative to where you started you repo command to check out all the sources.

Edit the minimal-image recipe bytesatwork-minimal-image.bb

Add the desired software-package to IMAGE_INSTALL variable, for example add net-tools to bytesatwork-minimal-image.bb

Rebuild the image by:

bitbake bytesatwork-minimal-image

7.4 How to rename the image

  • If you want to rename or copy an image, simple rename or copy the image recipe by:

    cp bytesatwork-minimal-image.bb customer-example-image.bb

7.5 Troubleshooting

  • Image size is to small

    If you encounter that your image size is to small to install additional software, please have a look at the IMAGE_ROOTFS_SIZE variable under meta-bytesatwork/recipes-core/images/bytesatwork-minimal-image.bb. Increase the size if necessary.

8. How do you build a toolchain?

8.1 byteDEVKIT

  • Yocto 3.0

    repo init -u https://github.com/bytesatwork/bsp-platform-st.git -b zeus
repo sync

    If those commands are completed successfully, the following command will setup a Yocto Project environment for byteDEVKIT:

    MACHINE=bytedevkit DISTRO=poky-bytesatwork EULA=1 . setup-environment build

    The final command builds an installable toolchain:

    bitbake bytesatwork-minimal-image -c populate_sdk

  • Yocto 2.7

    repo init -u https://github.com/bytesatwork/bsp-platform-st.git -b warrior
repo sync

    If those commands are completed successfully, the following command will setup a Yocto Project environment for byteDEVKIT:

    MACHINE=bytedevkit DISTRO=poky-bytesatwork EULA=1 . setup-environment build

    The final command builds an installable toolchain:

    bitbake devbase-image-bytesatwork -c populate_sdk

8.2 bytePANEL

  • Yocto 3.0

    repo init -u https://github.com/bytesatwork/bsp-platform-ti.git -b zeus
repo sync

    If those commands are completed successfully, the following command will setup a Yocto Project environment for bytePANEL:

    MACHINE=bytepanel DISTRO=poky-bytesatwork EULA=1 . setup-environment build

    The final command builds an installable toolchain:

    bitbake bytesatwork-minimal-image -c populate_sdk

  • Yocto 2.7

    repo init -u https://github.com/bytesatwork/bsp-platform.git -b warrior
repo sync

    If those commands are completed successfully, the following command will setup a Yocto Project environment for bytePANEL:

    MACHINE=bytepanel DISTRO=poky-bytesatwork EULA=1 . setup-environment build

    The final command builds an installable toolchain:

    bitbake devbase-image-bytesatwork -c populate_sdk

8.3 How to modify your toolchain

Currently the bytesatwork toolchain is generated out of the bytesatwork-minimal-image recipe. If you want to add additional libraries and development headers to customize the toolchain, you need to modify the bytesatwork-minimal-image recipe. It can be found under sources/meta-bytesatwork/recipes-core/images

For example if you want to develop your own ftp client and you need libftp and the corresponding header files, edit the recipe bytesatwork-minimal-image.bb and add ftplib to the IMAGE_INSTALL variable.

This will provide the ftplib libraries and development headers in the toolchain. After adding additional software components, the toolchain needs to be rebuilt by:

bitbake bytesatwork-minimal-image -c populate_sdk

The newely generated toolchain will be available under:

tmp/deploy/sdk

For additional information, please visit: https://www.yoctoproject.org/docs/3.0.2/overview-manual/overview-manual.html#cross-development-toolchain-generation

8.4 Troubleshooting

ERROR: bytesatwork-minimal-image-1.0-r0 do_populate_sdk: Unable to install packages. Command '/home/daniel/workspace/bytesatwork/yocto/ti-m2-zeus/build/tmp/work/bytepanel_emmc-poky-linux-gnueabi/bytesatwork-minimal-image/1.0-r0/recipe-sysroot-native/usr/bin/apt-get  install --force-yes --allow-unauthenticated openssh-ssh openssh-sshd apt dpkg coreutils base-passwd dhcp-client target-sdk-provides-dummy shadow openssh-scp packagegroup-core-standalone-sdk-target packagegroup-core-boot vim openssh-sftp-server run-postinsts' returned 100:
Reading package lists...
Building dependency tree...
Reading state information...
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:

The following packages have unmet dependencies:
 target-sdk-provides-dummy : Conflicts: coreutils
E: Unable to correct problems, you have held broken packages.
https://www.bytesatwork.io/wp-content/uploads/2020/04/Bildschirmfoto-2020-04-20-um-19.41.44.jpg

Hardware Development

We provide the development for a wide range of embedded systems, from small-scale embedded components to sophisticated embedded systems with increased security requirements. Our engineers are certified hardware experts and provide long experience in business.

byteENGINE AM335x

byteENGINE STM32MP1x

https://www.bytesatwork.io/wp-content/uploads/2020/04/Bildschirmfoto-2020-04-20-um-19.41.44.jpg